NOWOŚĆ 📢 Black Friday: nasza oferta na start kończy się 30 listopada. Do 70% zniżki na pierwszy miesiąc, na każdą grę!Zobacz plany
Black FridayDo 70% zniżki na pierwszy miesiąc, do 30 listopadaKoniec za 9 dni 02 godz. 49 minBlack FridayDo 70% zniżki na pierwszy miesiąc, do 30 listopadaKoniec za 9 dni 02 godz. 49 minBlack FridayDo 70% zniżki na pierwszy miesiąc, do 30 listopadaKoniec za 9 dni 02 godz. 49 min

Jak hostować bota Discord4J 24/7

Hosting botów DiscordZaktualizowano 6 lis 202612 min czytania

Aby hostować bota Discord4J 24/7, uruchamiasz go na maszynie, która jest zawsze włączona: na VPS z Linuksem z usługą systemd, która startuje go ponownie, gdy się zatrzyma, albo w planie dla botów w hostingu botów Discord PlayNHost (od 1,99 USD miesięcznie), gdzie przesyłasz jeden uruchamialny jar, wklejasz token i klikasz Start. W naszym teście bot Discord4J 3.3.3 zużył ok. 126 MB pamięci na Javie 21 i dostał odpowiedź Discorda 2,6 sekundy po uruchomieniu. Discord4J to biblioteka, nie program, więc najpierw budujesz swojego bota do jara na własnym komputerze. Kroki w PlayNHost:

  1. Na stronie Hosting botów Discord kliknij Utwórz serwer przy wybranym planie. W oknie zamówienia odpowiedz na pytanie Na jaką platformę jest Twój bot? wyborem Discord i wybierz Javę.
  2. Na swoim komputerze zbuduj bota z użyciem poniższego pom.xml: mvn package zapisze target/bot.jar z Discord4J w środku.
  3. Otwórz swój serwer w panelu. Karta Skonfiguruj swojego bota w sekcji Przegląd otwiera się na kroku Połącz z Discord. Jej pierwszy krok, Co działa, powinien pokazywać Ten bot uruchamia Java Bot.; kliknij ten krok, aby to sprawdzić, a potem Dalej.
  4. W kroku Połącz z Discord wklej token w polu Wklej token swojego bota, kliknij Połączenie, a potem Tak, dalej.
  5. W kroku Uprawnienia zaznacz Mój kod tego używa tylko dla uprzywilejowanych intentów, o które prosi twój kod (bot poniżej żadnego nie potrzebuje), kliknij Dodaj na serwer Discord, a potem Dalej.
  6. W kroku Twój kod kliknij Prześlij pliki i prześlij bot.jar do głównego folderu.
  7. Na stronie Bot, w panelu Kod, sprawdź, czy Plik startowy to bot.jar, a Runtime to Java 21 (recommended), albo Java 17 lub 25. Jeśli zmienisz Plik startowy, kliknij obok Zapisz; nowy Runtime zapisuje się od razu po wybraniu.
  8. Kliknij Uruchom bota i obserwuj Console. Gdy twój bot wypisze Logged in as ..., karta pokaże Twój bot jest online na Discordzie.

Tworzenie bota i jego tokena opisuje artykuł Jak stworzyć bota Discord i zdobyć jego token, a typ bota Javy ogólnie artykuł Jak hostować bota Discord w Javie. Ta strona dotyczy samego Discord4J: czego używa na serwerze i co warto wiedzieć przed hostowaniem.

Co zmierzyliśmy

BibliotekaWersjaPamięć po starcieOd uruchomienia do odpowiedzi DiscordaRozmiar jara
Discord4J3.3.3126 MB2,6 s37 MB
JDA6.7.091 MB1,5 s19 MB
Sama Java 21, bez biblioteki21.0.12.138 MBbrak0,0 MB

Jak: na naszym własnym węźle, w jednorazowym kontenerze skonfigurowanym jak plan dla botów z 1 GB (obraz Javy 21 i dokładne polecenie java naszego typu bota Javy) każdy bot logował się fałszywym tokenem, który Discord odrzucał; pamięć to pamięć rezydentna 15 sekund po tej odpowiedzi, czas startu liczy się od uruchomienia do odpowiedzi, a każda wartość to mediana uruchomień od 2 do 4.

To wartości minimalne: brak serwerów, brak członków w pamięci podręcznej, jeszcze bez otwartej sesji gateway. Twój własny kod i liczba serwerów, na których jest bot, dochodzą do tego, a skrypt startowy pozwala stercie Javy urosnąć do 80 procent planu (zobacz niżej). Porównaj liczby z planami w hostingu botów Discord i wybierz według tego, co robi twój bot.

Minimalny bot Discord4J

Rejestruje komendę slash /ping, odpowiada na nią Pong!, czyta token z DISCORD_TOKEN (taką nazwę nadaje mu panel) i wypisuje linię gotowości. Nie potrzebuje żadnego uprzywilejowanego intentu. Dwa pliki:

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);
        }
    }
}

Zbuduj go z Mavenem 3.9 i JDK 17 lub nowszym:

mvn package
java -jar target/bot.jar

Druga linia to test na twoim komputerze: bez tokena wypisuje No DISCORD_TOKEN found. i się zatrzymuje, co dowodzi, że jar startuje i znajduje klasę główną. Prześlij target/bot.jar. jar-with-dependencies z maven-assembly-plugin wkłada Discord4J i wszystko, czego potrzebuje, do tego jednego jara; w Gradle to samo daje wtyczka Shadow. maven.compiler.release 17 daje jar, który działa na wszystkich trzech wersjach Javy oferowanych przez panel.

Linia Logged in as ... przełącza znacznik w sekcji Przegląd na Online na Discordzie. Zaproś bota przyciskiem Dodaj na serwer Discord, zanim wypróbujesz /ping: Jak zaprosić bota Discord na serwer.

Gdy token jest błędny

W naszym teście, z fałszywym tokenem, logowanie Discord4J zakończyło się takim błędem:

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

Bot powyżej przechwytuje odrzucony token (HTTP 401) i zamiast stack trace wypisuje Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart., po czym kończy działanie z kodem wyjścia 1. Gdy uruchomiliśmy go z fałszywym tokenem, najpierw pojawiły się trzy linie ostrzeżeń SLF4J:, pierwsza zaczyna się od SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".; dotyczą logowania, nie tokena (zobacz Logi niżej). Aby to naprawić, otwórz Discord Developer Portal, swoją aplikację, Bot i kliknij Reset Token; Discord pokazuje nowy token tylko raz. Na naszej stronie Bot, w panelu Discord, kliknij Zastąp token, wklej go, kliknij Zapisz token, a potem Zrestartuj teraz. Gdy Discord odrzuci sprawdzenie zapisanego tokena, panel pokazuje Discord go nie przyjął.

Co warto wiedzieć o Discord4J na serwerze

  • Wersje: Discord4J 3.3.3 ukazał się 19 sierpnia 2026. Linia 3.3 jest bieżąca, a 3.2 dostaje tylko poprawki utrzymaniowe. Discord4J 3.3.3 jest skompilowany dla Javy 8, więc działa na każdym Runtime oferowanym przez panel (Java 17, 21 lub 25); buduj z release nie nowszym niż wybrany runtime.
  • Jeden jar, nic nie jest instalowane na serwerze. Typ bota Javy nie ma źródła Git ani pola Pakiety: uruchamia java -jar na twoim Pliku startowym, więc wszystko, czego używa bot, musi być w jarze. Aby zaktualizować bota, prześlij nowy jar.
  • Limit pamięci: skrypt startowy uruchamia Javę z -XX:MaxRAMPercentage=80.0 i garbage collectorem G1, więc sterta może zajmować do 80 procent pamięci planu, a reszta procesu ma miejsce. Gdy sterta się zapełni, Java wypisuje java.lang.OutOfMemoryError, a panel pokazuje Twojemu botowi zabrakło pamięci.
  • Intenty: Discord4J łączy się ze wszystkimi nieuprzywilejowanymi intentami, o ile nie wybierzesz innych. Przykład !ping z README Discord4J czyta treść wiadomości, co wymaga uprzywilejowanego intentu Message Content: włącz go w Developer Portal, zażądaj go w kodzie przez DiscordClient.create(token).gateway().setEnabledIntents(IntentSet.nonPrivileged().or(IntentSet.of(Intent.MESSAGE_CONTENT))) i zaznacz dla niego Mój kod tego używa w naszym kroku Uprawnienia. Bez niego Discord wysyła botowi pustą treść wiadomości, poza wiadomościami prywatnymi i wiadomościami, które wspominają bota. Komenda slash, jak wyżej, nie potrzebuje żadnego z tych kroków. Zobacz Napraw błąd „Used disallowed intents” w bocie Discord.
  • Logi: Discord4J loguje przez Reactor, który używa SLF4J, gdy SLF4J jest w jarze, a Discord4J przynosi SLF4J ze sobą. Bez biblioteki logowania z tyłu, jak w pom.xml powyżej, SLF4J wypisuje przy starcie trzy linie ostrzeżeń, ostatnia to SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details., a potem odrzuca własne linie logów Discord4J, razem z błędami. Twoje linie System.out nadal widać w Console. Aby zobaczyć linie Discord4J, dodaj bibliotekę logowania; dokumentacja Discord4J poleca Logback.
  • Niech main() czeka. Discord4J jest reaktywny: jego logowanie to Mono, które łączy się dopiero, gdy coś je zasubskrybuje. Przykłady z jego README kończą main() wywołaniem gateway.onDisconnect().block() albo block() na withGateway(...), które czekają, dopóki bot jest połączony. Bot powyżej używa withGateway(...).block().
  • Rejestrowanie komend przy każdym starcie jest w porządku. Discord traktuje utworzenie komendy o nazwie, której twoja aplikacja już używa, jako aktualizację tej komendy, więc bot powyżej nie mnoży kopii /ping.
  • Awarie: gdy bot kończy działanie, jak ten powyżej przy odrzuconym tokenie, panel od razu uruchamia go ponownie. Jeśli zatrzyma się znowu w ciągu minuty, pozostaje zatrzymany, a Console podaje powód.

Hostowanie samodzielnie na VPS z Linuksem

VPS potrzebuje tylko środowiska Javy, bo jar budujesz na własnym komputerze. Na Debianie 13 lub Ubuntu 24.04 zainstaluj Javę 21; Debian 12 ma Javę 17, która też uruchomi powyższy jar:

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

Utwórz użytkownika dla bota i skopiuj jar na serwer (na przykład przez scp), a potem do jego folderu:

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

Trzymaj token poza kodem, w pliku, który może czytać tylko root:

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

Utwórz /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

Uruchom go teraz i przy każdym starcie systemu, a potem śledź jego wyjście:

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

Restart=always uruchamia bota ponownie 5 sekund po tym, jak się zakończy lub padnie, ale nie po zatrzymaniu go przez systemctl stop. Na VPS -XX:MaxRAMPercentage to udział w pamięci całej maszyny, więc zmniejsz go, jeśli działają tam inne programy. Aby zaktualizować, skopiuj nowy jar nad stary i uruchom sudo systemctl restart mybot.

Samodzielny hosting czy plan dla botów

Na VPS, którym zarządzasz sam, zajmujesz się:

  • Aktualizacjami i bezpieczeństwem systemu operacyjnego oraz aktualizacjami Javy.
  • Kopiowaniem każdego nowego jara, plikiem usługi, plikiem tokena i jego uprawnieniami.
  • Czytaniem journalctl, żeby sprawdzić, dlaczego bot się zatrzymał.
  • Kopiami zapasowymi wszystkiego, co zapisuje twój bot.

W zamian VPS uruchomi wszystko, co na nim zainstalujesz.

W planie dla botów PlayNHost robi to za ciebie panel:

  • Java 17, 21 lub 25 z listy wyboru, z ustawionym limitem sterty i garbage collectorem.
  • Token sprawdzany w Discordzie przed zapisem, przechowywany w postaci zaszyfrowanej i przekazywany twojemu kodowi jako DISCORD_TOKEN.
  • Link zaproszenia z wybranymi przez ciebie uprawnieniami i karta Uprzywilejowane intenty, która sprawdza, które są włączone w twoim Developer Portal.
  • Ponowne uruchomienie bota po awarii i baner nad Console, gdy zabraknie mu pamięci.
  • Przesyłanie z przeglądarki i kopie zapasowe z panelu.

Najczęstsze pytania

Mój bot Discord4J jest online, ale !ping nic nie robi. Dlaczego?

Bo treść wiadomości jest pusta. Discord4J domyślnie żąda tylko nieuprzywilejowanych intentów, a czytanie treści wiadomości na serwerach wymaga Message Content, uprzywilejowanego intentu. Włącz go w Developer Portal i zażądaj przez setEnabledIntents, jak pokazano wyżej, albo użyj komendy slash, takiej jak /ping w bocie z tej strony, która nie potrzebuje uprzywilejowanego intentu.

Discord4J czy JDA w PlayNHost?

Oba działają na tym samym typie bota Javy, z tego samego rodzaju jara. Tabela powyżej zawiera pamięć, którą zmierzyliśmy dla każdego. Prawdziwa różnica to styl: Discord4J opiera się na Reactorze, więc łączysz w łańcuch Mono i Flux, a JDA używa listenerów i callbacków. Wybierz ten, którego kod czytasz łatwiej. Kroki dla JDA: Jak hostować bota Discord w Javie.

Którą wersję Javy wybrać dla Discord4J?

Javę 21, zalecaną, chyba że twój własny kod wymaga 25. Sam Discord4J działa od Javy 8, więc ograniczeniem jest release, z którym budujesz: jar zbudowany dla nowszej Javy, niż działa na serwerze, zatrzymuje się z UnsupportedClassVersionError. Wybierz nowszy Runtime albo buduj z niższym release.

Dlaczego mój jar Discord4J jest taki duży?

Bo zawiera wszystko: Discord4J przynosi Reactor, Netty, Jackson i własne moduły głosowe, a build z jar-with-dependencies pakuje je wszystkie. Jar w naszym teście miał 37 MB. To miejsce na dysku w twoim planie; pamięć zużywana przez działającego bota jest w tabeli powyżej.

Gotowy, by twój bot Discord4J działał całą dobę? Zobacz plany w hostingu botów Discord.

Twój bot działa już gdzie indziej? Przenieś go do nas

NASZE OSTATNIE WPISY