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 hikari 24/7

Hosting botów DiscordZaktualizowano 6 lis 202610 min czytania

Aby hostować bota hikari 24/7, uruchom go na maszynie, która stale działa, zamiast na swoim komputerze: na VPS z Linuksem z usługą systemd, jeśli hostujesz go sam, albo na planie botów w hostingu botów Discord PlayNHost (od 1,99 USD miesięcznie), gdzie wgrywasz kod, wklejasz token i klikasz Start. W naszym teście bot hikari 2.7.0 zużył około 61 MB pamięci i połączył się z Discordem około 1,3 sekundy po uruchomieniu. hikari 2.7 wymaga Pythona 3.11 lub nowszego i nie ma własnego frameworka do komend, więc ta strona zawiera komendę slash napisaną samym hikari. Kroki w PlayNHost:

  1. Na stronie Hosting botów Discord kliknij Utwórz serwer przy wybranym planie. W oknie zamówienia odpowiedz na Na jaką platformę jest Twój bot? wybierając Discord i Python.
  2. 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 Python Bot.; kliknij ten krok, aby to sprawdzić, a potem Dalej.
  3. W kroku Połącz z Discord wklej token w polu Wklej token swojego bota, kliknij Połączenie, a potem Tak, dalej.
  4. 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 nie potrzebuje żadnego), kliknij Dodaj na serwer Discord, a potem Dalej.
  5. W kroku Twój kod kliknij Prześlij pliki i prześlij bot.py oraz requirements.txt z wpisem hikari, albo kliknij Połącz Git.
  6. Na stronie Bot, w panelu Kod, zostaw Runtime ustawiony na Python 3.12 (recommended) albo wybierz 3.11, 3.13 lub 3.14 (nie 3.10), ustaw Plik startowy, jeśli to nie jest bot.py, i kliknij Zapisz.
  7. Kliknij Uruchom bota i obserwuj Console. Gdy bot wypisze Logged in as ..., karta pokaże Twój bot jest online na Discordzie.

Ogólne kroki dla Pythona (pakiety, linie konsoli) opisuje Jak hostować bota Discord w Pythonie. Ta strona omawia to, co jest inne w hikari.

Co zmierzyliśmy

Uruchomiliśmy każdą bibliotekę Discord dla Pythona na własnych serwerach, w tej samej konfiguracji Pythona 3.12, której używa plan botów, z limitem pamięci 1 GB:

BibliotekaWersjaPamięć w spoczynkuOd startu do odpowiedzi Discorda
hikari2.7.061 MB1.3 s
discord.py2.7.148 MB1.0 s
Pycord2.8.151 MB1.1 s
nextcord3.2.047 MB1.0 s
disnake2.12.247 MB0.9 s
Sam Python3.129 MB

Jak: najmniejszy program, który ładuje bibliotekę i loguje się fałszywym tokenem, zainstalowany tak, jak instalują go nasze serwery. Pamięć to wartość, którą proces zajmował 15 sekund po odrzuceniu tokenu przez Discord, a czas startu liczy się od uruchomienia do tej odpowiedzi, więc obejmuje jedną wizytę w Discordzie. Każda liczba to mediana z trzech uruchomień po uruchomieniu rozgrzewkowym. To dolna granica: bot, który się połączył, dołączył do serwerów i zapisał w pamięci podręcznej członków, zużywa więcej, w stopniu zależnym od bota.

Co to znaczy dla planu: minimalny bot hikari zużywa niewielką część planu STARTER o pojemności 0.5 GB. Dobierz plan do tego, co twój własny bot trzyma w pamięci, a nie do biblioteki.

Minimalny bot hikari

Odpowiada na /ping komendą slash i wypisuje linię gotowości. Token czyta z DISCORD_TOKEN, czyli z nazwy, którą panel nadaje twojemu kodowi.

requirements.txt

hikari>=2.7,<3

bot.py

import os

import hikari

bot = hikari.GatewayBot(token=os.environ["DISCORD_TOKEN"])


@bot.listen()
async def register_commands(event: hikari.StartedEvent) -> None:
    application = await bot.rest.fetch_application()
    await bot.rest.set_application_commands(
        application=application.id,
        commands=[bot.rest.slash_command_builder("ping", "Check that the bot answers")],
    )
    print(f"Logged in as {bot.get_me()}")


@bot.listen()
async def on_command(event: hikari.CommandInteractionCreateEvent) -> None:
    if event.interaction.command_name == "ping":
        await event.interaction.create_initial_response(
            hikari.ResponseType.MESSAGE_CREATE, "Pong!"
        )


bot.run()

hikari wybiera zdarzenie na podstawie typu przy każdym listenerze. Gdy wszystkie shardy wystartują (StartedEvent), bot wysyła do Discorda listę swoich komend przez set_application_commands, co zastępuje globalne komendy bota tą listą, a potem wypisuje linię gotowości. CommandInteractionCreateEvent przychodzi za każdym razem, gdy ktoś użyje komendy. Linia Logged in as przełącza wskaźnik w sekcji Przegląd na Online na Discordzie.

Gdy token jest błędny

Gdy Discord odrzuca token, hikari zgłasza ten błąd (tekst, który wypisał nasz testowy bot):

UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot

To hikari.errors.UnauthorizedError, zgłaszany przez pierwsze żądanie hikari do Discorda przy starcie bota, po czym bot się zatrzymuje. Sprawdź token na stronie Bot, w panelu Discord: kliknij Sprawdź teraz, a jeśli pojawi się Discord go nie przyjął, skopiuj nowy token w Discord Developer Portal, Bot, Reset Token, wklej go przez Zastąp token i uruchom bota ponownie. Zobacz Jak stworzyć bota Discord i zdobyć jego token.

Co host musi wiedzieć o hikari

  • Python 3.11 lub nowszy. hikari 2.7.0 wymaga Pythona 3.11 lub późniejszego; README podaje od 3.11 do 3.15. Na Pythonie 3.10 zwykła linia hikari sprawia, że pip instaluje 2.6.0, ostatnie wydanie dla 3.10. Z hikari>=2.7,<3 pip odmawia: konsola pokazuje błąd pipa i [PlayNHost] pip could not install everything in requirements.txt., a jeśli hikari nigdy nie zainstalowano na serwerze, bot zatrzymuje się potem z ModuleNotFoundError: No module named 'hikari'. W Runtime działa każdy wybór poza 3.10.
  • Bez wbudowanego frameworka do komend. hikari daje zdarzenia i REST API Discorda; README odsyła do lightbulb, tanjun, crescent i arc w sprawie komend. Bot powyżej sam rejestruje swoją komendę przy każdym starcie, co README nazywa dość spammy; sugeruje handler komend albo sprawdzanie, by komendy były wysyłane tylko wtedy, gdy się zmieniły. Framework to jedna dodatkowa linia w requirements.txt.
  • Ostrzeżenie przy każdym starcie. hikari loguje You are running on optimization level 0 (no optimizations) i sugeruje -O. Na serwerze PlayNHost skrypt startowy uruchamia twój plik startowy zwykłym python, więc widzisz to ostrzeżenie, a bot działa normalnie. Aby je ukryć, przekaż suppress_optimization_warning=True do hikari.GatewayBot(). Na własnym VPS możesz zamiast tego dodać -O.
  • Logowanie i baner są domyślnie włączone. GatewayBot ustawia logowanie na poziomie INFO i wypisuje baner hikari. Własna linia przy połączeniu sharda to shard is ready: ...; wskaźnik w panelu nie liczy tej linii jako online, więc wypisz własną linię Logged in as jak wyżej.
  • Sprawdza aktualizacje. Domyślnie run() pyta PyPI o najnowszego hikari i loguje A newer version of hikari is available, gdy jest nowszy. bot.run(check_for_updates=False) to wyłącza.
  • Intenty. Domyślnie są to wszystkie intenty, które nie są uprzywilejowane. Czytanie treści wiadomości wymaga hikari.Intents.MESSAGE_CONTENT w intents= i włączonego Message Content Intent w Developer Portal. Jeśli twój kod o niego prosi, a w Portalu jest wyłączony, Discord odrzuca logowanie. Zobacz Napraw błąd „Used disallowed intents” w bocie Discord.

Własny hosting na VPS z Linuksem

Najpierw sprawdź wersję Pythona: python3 --version musi pokazać 3.11 lub nowszą. Debian 12 ma 3.11, Ubuntu 24.04 ma 3.12, a Debian 13 ma 3.13; Ubuntu 22.04 ma 3.10, za starą dla hikari 2.7. Potem zainstaluj Pythona, utwórz użytkownika i folder dla bota i zainstaluj hikari w środowisku wirtualnym:

sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/hikari-bot bot
sudo cp bot.py requirements.txt /opt/hikari-bot/
sudo chown bot: /opt/hikari-bot/bot.py /opt/hikari-bot/requirements.txt
sudo -u bot python3 -m venv /opt/hikari-bot/venv
sudo -u bot /opt/hikari-bot/venv/bin/pip install -r /opt/hikari-bot/requirements.txt

Umieść token w pliku, który może czytać tylko root. Utwórz /etc/hikari-bot.env poleceniem sudo nano /etc/hikari-bot.env, wpisz jedną linię, DISCORD_TOKEN= i swój token, zapisz plik i uruchom sudo chmod 600 /etc/hikari-bot.env.

Następnie utwórz /etc/systemd/system/hikari-bot.service. Uruchamia Pythona z -O, tak jak zaleca README hikari dla produkcji:

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

[Service]
User=bot
WorkingDirectory=/opt/hikari-bot
EnvironmentFile=/etc/hikari-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/hikari-bot/venv/bin/python -O bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Uruchom usługę teraz i przy każdym starcie systemu, a potem śledź jej wyjście:

sudo systemctl daemon-reload
sudo systemctl enable --now hikari-bot
sudo journalctl -u hikari-bot -f

PYTHONUNBUFFERED=1 sprawia, że print() trafia do dziennika od razu, a nie dopiero po zapełnieniu bufora. Aby zaktualizować bota, skopiuj nowe pliki, uruchom ponownie linię pip install i sudo systemctl restart hikari-bot.

Własny hosting czy plan botów

Twój własny VPSPlan botów PlayNHost
PythonWersja z twojej dystrybucji, która dla hikari 2.7 musi być 3.11 lub nowszaWybierz 3.11, 3.12, 3.13 lub 3.14 w Runtime
PakietyPo każdej zmianie sam uruchamiasz pip installInstalowane przy starcie po zmianie requirements.txt lub wersji Pythona oraz przy pierwszym starcie dzień po ostatniej instalacji
RestartyTwoja jednostka systemdUruchamiany ponownie po awarii; zostaje zatrzymany z podaniem przyczyny, jeśli ponownie ulegnie awarii w ciągu minuty
TokenPlik, który chronisz samPrzechowywany w postaci zaszyfrowanej, sprawdzany w Discordzie po wklejeniu, przekazywany twojemu kodowi jako DISCORD_TOKEN
Flagi PythonaDodaj -O w ExecStartDziała ze zwykłym python
Aktualizacje systemu, zapora, SSHRobisz to samTo nie twoja sprawa

Pytania, które ludzie zadają

Czy potrzebuję lightbulb, tanjun, crescent lub arc?

Nie. Sam hikari potrafi rejestrować komendy slash i na nie odpowiadać, jak pokazuje bot powyżej. Framework to gotowy handler komend, więc nie piszesz sam rejestracji i routingu, gdy komend jest więcej niż kilka. Dodaj go do requirements.txt; zainstaluje się przy następnym starcie.

Dlaczego /ping nie pojawia się na moim serwerze?

Sprawdź, czy bota dodano przez Dodaj na serwer Discord i czy konsola pokazuje Logged in as: komenda jest rejestrowana tuż przed tą linią. Podczas testów przekaż guild=your_server_id do set_application_commands: komenda powstanie wtedy tylko na tym serwerze, a dokumentacja Discorda mówi, że komendy serwerowe aktualizują się natychmiast.

Czy ostrzeżenie o optymalizacji to problem?

Nie. Mówi ono, że Python działa bez -O, opcji, która usuwa instrukcje assert i inne kontrole wyłącznie do debugowania, a którą hikari sugeruje dla szybkości. Twój bot działa bez niej. Ukryj ostrzeżenie przez suppress_optimization_warning=True.

Czy bot hikari zmieści się w najmniejszym planie?

Tak. Przy około 61 MB w naszym teście minimalny bot hikari zostawia większość planu STARTER o pojemności 0.5 GB na twój własny kod. Przejdź na większy plan, gdy potrzebuje tego sam bot: duże serwery, których członków zapisuje w pamięci podręcznej, pliki lub obrazy, które przetwarza, albo dane trzymane w pamięci.

Gotowy uruchomić swojego? Wybierz plan w hostingu botów Discord i wgraj swojego bota hikari.

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

NASZE OSTATNIE WPISY