Aby hostować bota disnake 24/7, uruchom go na maszynie, która jest stale włączona, zamiast na swoim komputerze: na VPS z Linuksem z usługą systemd, jeśli hostujesz go sam, albo w planie botów w PlayNHost Discord bot hosting (od 1,99 USD miesięcznie), gdzie wgrywasz kod, wklejasz token i klikasz Start. W naszym teście bot na disnake 2.12.2 zajął około 47 MB pamięci i połączył się z Discordem około 0,9 sekundy po uruchomieniu. disnake prosi o przypięcie jego wersji, a na serwerze, który sam aktualizuje pakiety, ma to znaczenie. Kroki w PlayNHost:
- Na stronie Discord bot hosting kliknij Utwórz serwer przy wybranym planie. W oknie zamówienia na pytanie Na jaką platformę jest Twój bot? odpowiedz Discord i wybierz 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 żadnego nie potrzebuje), kliknij Dodaj na serwer Discord, a potem Dalej.
- W kroku Twój kod kliknij Prześlij pliki i prześlij
bot.pyorazrequirements.txtz przypiętą liniądisnake, albo kliknij Połącz Git. - Jeśli twój główny plik nie nazywa się
bot.py, ustaw Plik startowy na stronie Bot, w panelu Kod, i kliknij Zapisz. - Kliknij Uruchom bota i obserwuj Console. Gdy twój bot wypisze
Logged in as ..., karta pokaże Twój bot jest online na Discordzie.
Ogólne kroki dla Pythona (runtime, pakiety, linie konsoli) opisuje Jak hostować bota Discord w Pythonie. Ta strona omawia to, co jest inne w disnake.
Co zmierzyliśmy
Każdą bibliotekę Discord dla Pythona uruchomiliśmy 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 |
|---|---|---|---|
| disnake | 2.12.2 | 47 MB | 0,9 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 |
| hikari | 2.7.0 | 61 MB | 1,3 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 tyle, ile proces zajmował 15 sekund po odrzuceniu tokena przez Discord, a czas startu liczy się od uruchomienia do tej odpowiedzi, więc obejmuje jedną podróż do Discorda. Każda wartość 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 disnake zajmuje niewielką część planu STARTER o pojemności 0,5 GB. Dobierz plan do tego, co twój bot trzyma w pamięci, a nie do biblioteki.
Minimalny bot disnake
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
disnake==2.12.*
bot.py
import os
import disnake
from disnake.ext import commands
bot = commands.InteractionBot()
@bot.event
async def on_ready():
print(f"Logged in as {bot.user}")
@bot.slash_command(description="Check that the bot answers")
async def ping(inter: disnake.ApplicationCommandInteraction):
await inter.response.send_message("Pong!")
bot.run(os.environ["DISCORD_TOKEN"])
commands.InteractionBot to bot disnake wyłącznie dla komend aplikacji, bez prefiksu do ustawienia. Sam rejestruje /ping w Discordzie po połączeniu. Linia Logged in as sprawia, że znacznik w sekcji Przegląd zmienia się na Online na Discordzie.
Gdy token jest błędny
Gdy Discord odrzuci token, disnake zgłasza ten błąd (tekst, który wypisał nasz testowy bot):
LoginFailure: Improper token has been passed.
Przy bot.run() traceback kończy się jako disnake.errors.LoginFailure: Improper token has been passed. i bot się zatrzymuje. Panel czyta tę linię: znacznik pokazuje Problem z tokenem, a baner mówi Discord nie przyjął tokena twojego bota. Weź nowy token w Discord Developer Portal: twoja aplikacja, Bot, Reset Token (jest pokazywany tylko raz). Kliknij Zastąp token w banerze, potem Zastąp token w panelu Discord, wklej go i uruchom bota ponownie. Zobacz Jak stworzyć bota Discord i zdobyć jego token.
Co host powinien wiedzieć o disnake
- Przypnij wersję. README disnake mówi, że biblioteka nie do końca stosuje wersjonowanie semantyczne, i zaleca przypięcie wersji minor, na przykład
disnake==2.12.*lubdisnake~=2.12.2. Na naszych serwerach liczy się to podwójnie: skrypt startowy uruchamiapip install -Udla twojegorequirements.txt, gdy się zmieni, oraz ponownie przy pierwszym starcie dobę po ostatniej instalacji, więc nieprzypięta liniadisnakemoże sama przejść na nowe wydanie. Z przypięciem dostajesz poprawki w obrębie 2.12 i sam wybierasz, kiedy przejść wyżej. - Import to disnake. Instalujesz
disnakei piszeszimport disnake; nie instaluje modułudiscord, więc nie nadpisuje discord.py ani Pycord. Mimo to trzymaj wrequirements.txttylko bibliotekę, której używa twój kod. - Wersja Pythona. disnake 2.12 wymaga Pythona 3.10 lub nowszego. Runtime w panelu Kod oferuje 3.10 do 3.14, z 3.12 jako domyślną, więc każdy wybór działa.
- Synchronizacja komend usuwa to, czego twój kod nie definiuje. Domyślnie disnake synchronizuje komendy globalne i serwerowe i może usunąć w Discordzie komendy, których twój kod już nie ma (
allow_command_deletion). Drugi program zalogowany tym samym botem, na przykład testowa kopia na twoim komputerze, traci swoje komendy, gdy zsynchronizuje się kopia serwera. Do testów użyj osobnej aplikacji. - Podgląd synchronizacji. Przekaż
command_sync_flags=commands.CommandSyncFlags(sync_commands_debug=True)doInteractionBot(). disnake wypisze wtedy, co synchronizuje, nawet gdy logowanie nie jest skonfigurowane, więc linie pojawią się w Console. - Intents. Domyślne intenty nie zawierają żadnego uprzywilejowanego, a komendy slash żadnego nie potrzebują. Komendy z prefiksem w
commands.Botwymagająintents.message_content = Truew twoim kodzie 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.
Hostuj go sam na VPS z Linuksem
Na Debianie lub Ubuntu zainstaluj Pythona, utwórz użytkownika i folder dla bota oraz zainstaluj disnake w środowisku wirtualnym:
sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/disnake-bot bot
sudo cp bot.py requirements.txt /opt/disnake-bot/
sudo chown bot: /opt/disnake-bot/bot.py /opt/disnake-bot/requirements.txt
sudo -u bot python3 -m venv /opt/disnake-bot/venv
sudo -u bot /opt/disnake-bot/venv/bin/pip install -r /opt/disnake-bot/requirements.txt
Umieść token w pliku, który może czytać tylko root. Utwórz /etc/disnake-bot.env poleceniem sudo nano /etc/disnake-bot.env, wpisz jedną linię, DISCORD_TOKEN= i twój token, zapisz plik i uruchom sudo chmod 600 /etc/disnake-bot.env.
Potem utwórz /etc/systemd/system/disnake-bot.service:
[Unit]
Description=disnake Discord bot
Wants=network-online.target
After=network-online.target
[Service]
User=bot
WorkingDirectory=/opt/disnake-bot
EnvironmentFile=/etc/disnake-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/disnake-bot/venv/bin/python bot.py
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 disnake-bot
sudo journalctl -u disnake-bot -f
PYTHONUNBUFFERED=1 sprawia, że print() trafia do dziennika od razu, a nie dopiero gdy zapełni się bufor. Tutaj nic nie aktualizuje się samo: aby przejść na nowszy disnake, zmień przypiętą wersję, uruchom ponownie linię pip install i sudo systemctl restart disnake-bot.
Własny serwer czy plan botów
| Twój własny VPS | Plan botów PlayNHost | |
|---|---|---|
| Python | Wersja dostarczana przez twoją dystrybucję; instalujesz ją i aktualizujesz sam | Wybierz 3.10 do 3.14 w Runtime |
| Pakiety | Po każdej zmianie uruchamiasz pip install | Instalowane przez pip install -U przy starcie po zmianie requirements.txt lub wersji Pythona oraz przy pierwszym starcie dobę po ostatniej instalacji, w granicach twoich przypięć |
| Restarty | Twoja jednostka systemd | Uruchamiany ponownie po awarii; zostaje zatrzymany z podaniem powodu, jeśli ulegnie awarii ponownie w ciągu minuty |
| Token | Plik, który chronisz sam | Przechowywany zaszyfrowany, sprawdzany w Discordzie przy wklejeniu i przekazywany twojemu kodowi jako DISCORD_TOKEN |
| Błędy | Czytasz dziennik | Baner w konsoli nazywa przyczynę, na przykład błędny token lub brakujący intent |
| Aktualizacje systemu, zapora, SSH | Twoja sprawa | Nie twoje zadanie |
Najczęstsze pytania
Mój bot disnake przestał działać po restarcie bez żadnej zmiany. Dlaczego?
Jeśli w requirements.txt stoi tylko disnake, instalacja pakietów przy pierwszym starcie dobę po poprzedniej mogła przenieść go na nowsze wydanie, a disnake nie obiecuje, że wydania minor są wolne od zmian łamiących zgodność. Przypnij przetestowaną wersję, na przykład disnake==2.12.*, i uruchom bota ponownie: pakiety zainstalują się ponownie, bo plik się zmienił.
Dlaczego /ping nie pojawia się na moim serwerze?
Sprawdź, czy bot został dodany przez Dodaj na serwer Discord i czy konsola pokazuje Logged in as. Podczas testów przekaż test_guilds=[your_server_id] do InteractionBot(), tak jak robią to własne przykłady disnake: komendy powstają wtedy na tym serwerze, a dokumentacja Discorda mówi, że komendy serwerowe aktualizują się natychmiast.
Czy kod disnake jest taki sam jak kod discord.py?
Podobny, ale nie taki sam. disnake zachowuje składnię i strukturę discord.py 2.0 pod nazwą disnake, ale ma własne komendy slash: @bot.slash_command z inter.response.send_message(), a opcje są odczytywane z parametrów funkcji. Przy przejściu zmień importy i kod komend.
Czy bot disnake mieści się w najmniejszym planie?
Tak. Przy około 47 MB w naszym teście minimalny bot disnake zostawia większość planu STARTER o pojemności 0,5 GB dla twojego kodu. Przejdź wyżej, gdy sam bot tego potrzebuje: duże serwery, których członków zapisuje w pamięci podręcznej, pliki lub obrazy, które przetwarza, albo dane, które trzyma w pamięci.
Gotowy, by uruchomić swojego? Wybierz plan na stronie Discord bot hosting i prześlij swojego bota disnake.



