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:
- 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.
- 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.
- W kroku Połącz z Discord wklej token w polu Wklej token swojego bota, kliknij Połączenie, a potem Tak, dalej.
- 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.
- W kroku Twój kod kliknij Prześlij pliki i prześlij
bot.pyorazrequirements.txtz wpisemhikari, albo kliknij Połącz Git. - 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. - 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:
| Biblioteka | Wersja | Pamięć w spoczynku | Od startu do odpowiedzi Discorda |
|---|---|---|---|
| hikari | 2.7.0 | 61 MB | 1.3 s |
| discord.py | 2.7.1 | 48 MB | 1.0 s |
| Pycord | 2.8.1 | 51 MB | 1.1 s |
| nextcord | 3.2.0 | 47 MB | 1.0 s |
| disnake | 2.12.2 | 47 MB | 0.9 s |
| Sam Python | 3.12 | 9 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
hikarisprawia, że pip instaluje 2.6.0, ostatnie wydanie dla 3.10. Zhikari>=2.7,<3pip 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 zModuleNotFoundError: 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łympython, więc widzisz to ostrzeżenie, a bot działa normalnie. Aby je ukryć, przekażsuppress_optimization_warning=Truedohikari.GatewayBot(). Na własnym VPS możesz zamiast tego dodać-O. - Logowanie i baner są domyślnie włączone.
GatewayBotustawia logowanie na poziomieINFOi wypisuje baner hikari. Własna linia przy połączeniu sharda toshard is ready: ...; wskaźnik w panelu nie liczy tej linii jako online, więc wypisz własną linięLogged in asjak wyżej. - Sprawdza aktualizacje. Domyślnie
run()pyta PyPI o najnowszego hikari i logujeA 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_CONTENTwintents=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 VPS | Plan botów PlayNHost | |
|---|---|---|
| Python | Wersja z twojej dystrybucji, która dla hikari 2.7 musi być 3.11 lub nowsza | Wybierz 3.11, 3.12, 3.13 lub 3.14 w Runtime |
| Pakiety | Po każdej zmianie sam uruchamiasz pip install | Instalowane przy starcie po zmianie requirements.txt lub wersji Pythona oraz przy pierwszym starcie dzień po ostatniej instalacji |
| Restarty | Twoja jednostka systemd | Uruchamiany ponownie po awarii; zostaje zatrzymany z podaniem przyczyny, jeśli ponownie ulegnie awarii w ciągu minuty |
| Token | Plik, który chronisz sam | Przechowywany w postaci zaszyfrowanej, sprawdzany w Discordzie po wklejeniu, przekazywany twojemu kodowi jako DISCORD_TOKEN |
| Flagi Pythona | Dodaj -O w ExecStart | Działa ze zwykłym python |
| Aktualizacje systemu, zapora, SSH | Robisz to sam | To 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.



