НОВОЕ 📢 Чёрная пятница: стартовая акция заканчивается 30 ноября. Скидка до 70% на первый месяц!Посмотреть тарифы
Чёрная пятницаСкидка до 70% на первый месяц, акция по 30 ноябряДо конца 9 дн. 02 ч 49 минЧёрная пятницаСкидка до 70% на первый месяц, акция по 30 ноябряДо конца 9 дн. 02 ч 49 минЧёрная пятницаСкидка до 70% на первый месяц, акция по 30 ноябряДо конца 9 дн. 02 ч 49 мин

Как запустить бота Discord4J 24/7

Хостинг Discord-ботовОбновлено 6 нояб. 2026 г.12 мин чтения

Чтобы запустить бота Discord4J 24/7, его нужно держать на машине, которая всегда включена: на Linux VPS со службой systemd, которая запускает бота снова, когда он останавливается, или на тарифе для ботов в хостинге Discord-ботов PlayNHost (от US$1.99 в месяц), где вы загружаете один исполняемый jar, вставляете токен и нажимаете «Запустить». В нашем тесте бот на Discord4J 3.3.3 занял около 126 МБ памяти на Java 21 и получил ответ Discord через 2,6 секунды после запуска. Discord4J является библиотекой, а не программой, поэтому сначала вы собираете бота в jar на своём компьютере. Шаги в PlayNHost:

  1. На странице Хостинг Discord-ботов нажмите Создать сервер на нужном тарифе. В окне заказа на вопрос Для какой платформы ваш бот? ответьте Discord и выберите Java.
  2. На своём компьютере соберите бота с помощью pom.xml ниже: mvn package создаст target/bot.jar с Discord4J внутри.
  3. Откройте свой сервер в панели. Карточка Настройка бота в разделе Обзор открывается на шаге Подключение к Discord. Первый шаг, Что запускается, должен показывать Этот бот запускает Java Bot.; нажмите на этот шаг, чтобы проверить, затем Продолжить.
  4. На шаге Подключение к Discord вставьте токен в поле Вставьте токен бота, нажмите Подключение, затем Да, продолжить.
  5. На шаге Разрешения отметьте Мой код это использует только для тех привилегированных интентов, которые запрашивает ваш код (боту ниже они не нужны), нажмите Добавить на сервер Discord, затем Продолжить.
  6. На шаге Ваш код нажмите Загрузить файлы и загрузите bot.jar в основную папку.
  7. На странице Бот в блоке Код проверьте, что Файл запуска называется bot.jar, а в поле Среда выполнения выбрано Java 21 (recommended), либо Java 17 или 25. Если вы меняете Файл запуска, нажмите рядом Сохранить; новая Среда выполнения сохраняется сразу, как только вы её выберете.
  8. Нажмите Запустить бота и следите за Console. Когда бот выведет Logged in as ..., карточка покажет Ваш бот онлайн в Discord.

Как создать бота и его токен, объяснено в статье Как создать Discord-бота и получить его токен, а про тип бота Java в целом написано в статье Как запустить Discord-бота на Java. Эта страница о самом Discord4J: что он использует на сервере и что стоит знать перед запуском.

Что мы измерили

БиблиотекаВерсияПамять после запускаОт запуска до ответа DiscordРазмер jar
Discord4J3.3.3126 МБ2,6 с37 МБ
JDA6.7.091 МБ1,5 с19 МБ
Только Java 21, без библиотеки21.0.12.138 МБнет0,0 МБ

Как мы измеряли: на нашем собственном узле, в одноразовом контейнере, настроенном как тариф для ботов на 1 ГБ (образ Java 21 и точная команда java нашего типа бота Java), каждый бот входил с поддельным токеном, который Discord отклонял; память здесь означает резидентную память через 15 секунд после этого ответа, время старта считается от запуска до ответа, а каждое значение является медианой запусков с 2 по 4.

Это нижние границы: без серверов, без кэшированных участников, пока без открытой сессии gateway. Ваш собственный код и число серверов, на которых находится бот, добавляются к ним, а стартовый скрипт позволяет куче Java расти до 80 процентов тарифа (см. ниже). Сравните числа с тарифами на странице Хостинг Discord-ботов и выбирайте по тому, что делает ваш бот.

Минимальный бот на Discord4J

Он регистрирует слэш-команду /ping, отвечает на неё Pong!, читает токен из DISCORD_TOKEN (под таким именем его выдаёт панель) и выводит строку о готовности. Привилегированные интенты ему не нужны. Два файла:

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>bot</artifactId>
  <version>1.0</version>
  <properties>
    <maven.compiler.release>17</maven.compiler.release>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>
  <dependencies>
    <dependency>
      <groupId>com.discord4j</groupId>
      <artifactId>discord4j-core</artifactId>
      <version>3.3.3</version>
    </dependency>
  </dependencies>
  <build>
    <finalName>bot</finalName>
    <plugins>
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <version>3.7.1</version>
        <configuration>
          <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
          </descriptorRefs>
          <appendAssemblyId>false</appendAssemblyId>
          <archive>
            <manifest>
              <mainClass>Bot</mainClass>
            </manifest>
          </archive>
        </configuration>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>

src/main/java/Bot.java

import discord4j.core.DiscordClient;
import discord4j.core.event.domain.interaction.ChatInputInteractionEvent;
import discord4j.core.event.domain.lifecycle.ReadyEvent;
import discord4j.discordjson.json.ApplicationCommandRequest;
import discord4j.rest.http.client.ClientException;
import reactor.core.publisher.Mono;

public class Bot {
    public static void main(String[] args) {
        String token = System.getenv("DISCORD_TOKEN");
        if (token == null || token.isBlank()) {
            System.out.println("No DISCORD_TOKEN found. Paste your bot token on the Bot page, then restart.");
            System.exit(1);
        }

        ApplicationCommandRequest ping = ApplicationCommandRequest.builder()
                .name("ping")
                .description("Replies with Pong!")
                .build();

        try {
            DiscordClient.create(token).withGateway(gateway -> {
                // Creating a command that already exists updates it, so this is safe on every start.
                Mono<Void> register = gateway.getRestClient().getApplicationId()
                        .flatMap(appId -> gateway.getRestClient().getApplicationService()
                                .createGlobalApplicationCommand(appId, ping))
                        .then();

                Mono<Void> ready = gateway.on(ReadyEvent.class, event -> Mono.fromRunnable(() ->
                        System.out.println("Logged in as " + event.getSelf().getUsername())))
                        .then();

                Mono<Void> commands = gateway.on(ChatInputInteractionEvent.class, event -> {
                    if (event.getCommandName().equals("ping")) {
                        return event.reply("Pong!");
                    }
                    return Mono.empty();
                }).then();

                return register.and(ready).and(commands);
            }).block();
        } catch (RuntimeException e) {
            if (ClientException.isStatusCode(401).test(e)) {
                System.out.println("Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart.");
            } else {
                e.printStackTrace();
            }
            System.exit(1);
        }
    }
}

Соберите его с Maven 3.9 и JDK 17 или новее:

mvn package
java -jar target/bot.jar

Вторая строка служит проверкой на вашем компьютере: без токена она выводит No DISCORD_TOKEN found. и останавливается, что доказывает: jar запускается и находит главный класс. Загрузите target/bot.jar. Сборка jar-with-dependencies из maven-assembly-plugin кладёт Discord4J и всё, что ему нужно, в этот единственный jar; в Gradle то же самое делает плагин Shadow. Значение maven.compiler.release 17 даёт jar, который работает на всех трёх версиях Java, предлагаемых панелью.

Именно строка Logged in as ... переключает индикатор на вкладке Обзор на Онлайн в Discord. Пригласите бота кнопкой Добавить на сервер Discord, прежде чем пробовать /ping: Как пригласить Discord-бота на сервер.

Если токен неверный

В нашем тесте с поддельным токеном вход Discord4J завершился такой ошибкой:

ClientException: GET /gateway/bot returned 401 Unauthorized with response {code=0, message=401: Unauthorized}

Бот выше перехватывает отклонённый токен (HTTP 401) и вместо stack trace выводит Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart., после чего завершается с кодом выхода 1. Когда мы запускали его с поддельным токеном, сначала появились три строки предупреждений SLF4J:, первая начинается с SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".; они относятся к логированию, а не к токену (см. «Логи» ниже). Чтобы исправить, откройте Discord Developer Portal, своё приложение, Bot и нажмите Reset Token; Discord показывает новый токен только один раз. На нашей странице Бот в блоке Discord нажмите Заменить токен, вставьте его, нажмите Сохранить токен, затем Перезапустить сейчас. Если Discord отклоняет проверку сохранённого токена, блок показывает Discord его не принял.

Что нужно знать о Discord4J на сервере

  • Версии: Discord4J 3.3.3 вышел 19 августа 2026 года. Ветка 3.3 актуальная, а 3.2 получает только сопровождение. Discord4J 3.3.3 скомпилирован для Java 8, поэтому его запустит любая Среда выполнения, которую предлагает панель (Java 17, 21 или 25); собирайте с release не новее выбранной среды.
  • Один jar, на сервере ничего не устанавливается. У типа бота Java нет источника Git и поля Пакеты: он запускает java -jar на вашем Файл запуска, поэтому всё, что использует бот, должно лежать внутри jar. Чтобы обновить бота, загрузите новый jar.
  • Лимит памяти: стартовый скрипт запускает Java с -XX:MaxRAMPercentage=80.0 и сборщиком мусора G1, так что куча может занять до 80 процентов памяти тарифа, а остальной части процесса хватает места. Если куча заполнится, Java выведет java.lang.OutOfMemoryError, а панель покажет Вашему боту не хватило памяти.
  • Интенты: Discord4J подключается со всеми непривилегированными интентами, если вы не выберете другие. Пример !ping из README Discord4J читает текст сообщений, а для этого нужен привилегированный интент Message Content: включите его в Developer Portal, запросите в коде через DiscordClient.create(token).gateway().setEnabledIntents(IntentSet.nonPrivileged().or(IntentSet.of(Intent.MESSAGE_CONTENT))) и отметьте для него Мой код это использует на нашем шаге Разрешения. Без него Discord присылает боту пустой текст сообщения, кроме личных сообщений и сообщений, где упомянут бот. Слэш-команде, как выше, ничего из этого не нужно. См. Как исправить «Used disallowed intents» у вашего Discord-бота.
  • Логи: Discord4J пишет логи через Reactor, который использует SLF4J, если SLF4J есть в jar, а Discord4J приносит SLF4J с собой. Без библиотеки логирования за ним, как в pom.xml выше, SLF4J при старте выводит три строки предупреждений, последняя из них SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details., а затем отбрасывает собственные строки логов Discord4J, включая ошибки. Ваши строки System.out по-прежнему видны в Console. Чтобы видеть строки Discord4J, добавьте библиотеку логирования; документация Discord4J рекомендует Logback.
  • Заставьте main() ждать. Discord4J реактивный: его вход представляет собой Mono, который подключается, когда на него кто-то подпишется. Примеры в его README заканчивают main() вызовом gateway.onDisconnect().block() или block() у withGateway(...), и они ждут, пока бот подключён. Бот выше использует withGateway(...).block().
  • Регистрировать команды при каждом запуске можно. Discord считает создание команды с именем, которое ваше приложение уже использует, обновлением этой команды, поэтому бот выше не копит копии /ping.
  • Сбои: когда бот завершается, как бот выше при отклонённом токене, панель сразу запускает его снова. Если он остановится ещё раз в течение минуты, он останется остановленным, а Console покажет причину.

Запуск самостоятельно на Linux VPS

VPS нужна только среда Java, потому что jar вы собираете на своём компьютере. На Debian 13 или Ubuntu 24.04 установите Java 21; в Debian 12 есть Java 17, и она тоже запускает jar выше:

sudo apt update
sudo apt install openjdk-21-jre-headless
java -version

Создайте пользователя для бота и скопируйте jar на сервер (например, через scp), затем в его папку:

sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp bot.jar /opt/mybot/
sudo chown -R mybot: /opt/mybot

Храните токен вне кода, в файле, который может читать только root:

sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env

Создайте /etc/systemd/system/mybot.service:

[Unit]
Description=Discord4J bot
Wants=network-online.target
After=network-online.target

[Service]
User=mybot
WorkingDirectory=/opt/mybot
EnvironmentFile=/etc/mybot.env
ExecStart=/usr/bin/java -XX:MaxRAMPercentage=80.0 -jar /opt/mybot/bot.jar
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Запустите службу сейчас и при каждой загрузке, затем следите за её выводом:

sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f

Restart=always запускает бота снова через 5 секунд после того, как он завершился или упал, но не после того, как вы остановили его командой systemctl stop. На VPS -XX:MaxRAMPercentage задаёт долю памяти всей машины, поэтому уменьшите его, если там работают другие программы. Чтобы обновить бота, скопируйте новый jar поверх старого и выполните sudo systemctl restart mybot.

Свой сервер или тариф для ботов

На VPS, которым вы управляете сами, на вас лежит:

  • Обновление и безопасность операционной системы, а также обновление Java.
  • Копирование каждого нового jar, файл службы, файл с токеном и его права.
  • Чтение journalctl, чтобы выяснить, почему бот остановился.
  • Резервные копии всего, что хранит ваш бот.

Взамен VPS запускает всё, что вы на неё установите.

На тарифе для ботов PlayNHost это делает панель:

  • Java 17, 21 или 25 из списка, с уже заданными лимитом кучи и сборщиком мусора.
  • Токен, который проверяется в Discord перед сохранением, хранится в зашифрованном виде и передаётся вашему коду как DISCORD_TOKEN.
  • Ссылка-приглашение с выбранными вами правами и карточка Привилегированные интенты, которая проверяет, какие из них включены в вашем Developer Portal.
  • Повторный запуск бота после сбоя и баннер над Console, когда ему не хватает памяти.
  • Загрузка из браузера и резервные копии из панели.

Частые вопросы

Мой бот на Discord4J онлайн, но !ping ничего не делает. Почему?

Потому что текст сообщения пустой. Discord4J по умолчанию запрашивает только непривилегированные интенты, а чтение текста сообщений на серверах требует Message Content, привилегированного интента. Включите его в Developer Portal и запросите через setEnabledIntents, как показано выше, или используйте слэш-команду вроде /ping в боте на этой странице: ей привилегированный интент не нужен.

Discord4J или JDA в PlayNHost?

Оба работают на одном и том же типе бота Java, из одного и того же вида jar. В таблице выше указана память, которую мы измерили для каждого. Настоящее различие в стиле: Discord4J построен на Reactor, поэтому вы связываете в цепочку Mono и Flux, а JDA использует слушатели и колбэки. Выберите тот, чей код вам легче читать. Шаги для JDA: Как запустить Discord-бота на Java.

Какую версию Java выбрать для Discord4J?

Java 21, рекомендуемую, если только вашему коду не нужна 25. Сам Discord4J работает начиная с Java 8, поэтому ограничение задаёт release, с которым вы собираете: jar, собранный для более новой Java, чем на сервере, останавливается с UnsupportedClassVersionError. Выберите более новую Среда выполнения или соберите с меньшим release.

Почему мой jar с Discord4J такой большой?

Потому что в нём лежит всё: Discord4J приносит Reactor, Netty, Jackson и собственные голосовые модули, а сборка jar-with-dependencies упаковывает их все. Jar в нашем тесте весил 37 МБ. Это место на диске вашего тарифа; память, которую занял работающий бот, указана в таблице выше.

Готовы запустить своего бота на Discord4J круглосуточно? Посмотрите тарифы на странице Хостинг Discord-ботов.

Ваш бот уже у другого хостинга? Перенесите его к нам

ПОСЛЕДНИЕ БЛОГИ