Aby hostować bota Pycord 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 w planie dla botów w hostingu botów Discord PlayNHost (od 1,99 USD miesięcznie), gdzie wgrywasz kod, wklejasz token i klikasz Uruchom. W naszym teście bot na Pycord 2.8.1 zużył około 51 MB pamięci i połączył się z Discordem około 1,1 sekundy po uruchomieniu. Pycord instaluje się jako py-cord, ale importuje się jako discord, czyli pod tą samą nazwą co discord.py, więc wpisz tylko jedną z tych dwóch bibliotek. Kroki w PlayNHost:
- Na stronie hostingu botów Discord 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łącz, 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.txtzawierającypy-cord, 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) znajdziesz w Jak hostować bota Discord w Pythonie. Ta strona opisuje to, co jest inne w Pycord.
Co zmierzyliśmy
Uruchomiliśmy każdą bibliotekę Discord dla Pythona na naszych serwerach, w tej samej konfiguracji z Pythonem 3.12, której używa plan dla botów, z limitem pamięci 1 GB:
| Biblioteka | Wersja | Pamięć w spoczynku | Od startu do odpowiedzi Discorda |
|---|---|---|---|
| Pycord | 2.8.1 | 51 MB | 1.1 s |
| discord.py | 2.7.1 | 48 MB | 1.0 s |
| nextcord | 3.2.0 | 47 MB | 1.0 s |
| disnake | 2.12.2 | 47 MB | 0.9 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 wartość, jaką proces zajmował 15 sekund po odrzuceniu tokena przez Discord, a czas startu liczymy 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 zbuforował członków, zużywa więcej, zależnie od bota.
Co to oznacza dla planu: minimalny bot na Pycord zajmuje około jednej dziesiątej 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 na Pycord
Odpowiada na /ping za pomocą slash command i wypisuje linię gotowości. Token czyta z DISCORD_TOKEN, czyli nazwy, którą panel nadaje Twojemu kodowi.
requirements.txt
py-cord>=2.8,<3
bot.py
import os
import discord
bot = discord.Bot()
@bot.event
async def on_ready():
print(f"Logged in as {bot.user}")
@bot.slash_command(name="ping", description="Check that the bot answers")
async def ping(ctx: discord.ApplicationContext):
await ctx.respond("Pong!")
bot.run(os.environ["DISCORD_TOKEN"])
discord.Bot to własna klasa Pycord dla slash commands. Rejestruje /ping w Discordzie sama przy każdym połączeniu, ponieważ auto_sync_commands jest domyślnie włączone, więc nie trzeba pisać żadnego kroku synchronizacji. Linia Logged in as przełącza znacznik w sekcji Przegląd na Online na Discordzie.
Jeśli token jest błędny
Gdy Discord odrzuca token, Pycord 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ę linią discord.errors.LoginFailure: Improper token has been passed. i bot się zatrzymuje. Panel odczytuje tę linię: znacznik pokazuje Problem z tokenem, a baner mówi Discord nie przyjął tokena twojego bota. Nowy token pobierzesz w Discord Developer Portal: Twoja aplikacja, Bot, Reset Token (pokazuje się 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 Pycord
- Nazwa instalacji i nazwa importu się różnią. Instalujesz
py-cordi piszeszimport discord. discord.py instaluje moduł o tej samej nazwie,discord, więc obie biblioteki nie mogą współistnieć. Własny poradnik Pycord mówi, żeby najpierw odinstalować discord.py, i ostrzega, że odinstalowanie discord.py po zainstalowaniu py-cord może powodować problemy. - Przenoszenie serwera z discord.py na Pycord. Nasze serwery instalują pakiety w folderze
.locali nigdy nie usuwają pakietu, który wyjmiesz zrequirements.txt, więc discord.py zostałby obok Pycord. W Files usuń folder.locali plik.pnh/packages.state, a potem naciśnij Uruchom: wszystko zrequirements.txtzainstaluje się od nowa, bez discord.py. - Wersja Pythona. Pycord 2.8.1 obsługuje Pythona od 3.10 do 3.14. Runtime w panelu Kod oferuje dokładnie te wersje, z 3.12 jako domyślną, więc każdy wybór działa.
- Intents.
discord.Bot()używa domyślnych intentów, wśród których nie ma żadnego uprzywilejowanego, a slash commands żadnego nie potrzebują. Komendy z prefiksem, takie jak!ping, wymagająintents.message_content = Truew Twoim kodzie i włączonego Message Content Intent w Developer Portal. Jeśli kod o niego prosi, a w Portalu jest wyłączony, Discord odrzuca logowanie. Zobacz Napraw błąd „Used disallowed intents” w bocie Discord. - Zostaw on_connect wolne. Automatyczna rejestracja działa we własnym
on_connectbota. Jeśli sam zdefiniujeszon_connect, dokumentacja Pycord każe wywołać w nimawait bot.sync_commands(), inaczej Twoje komendy przestaną się aktualizować. Kod startowy umieść won_ready, jak wyżej. - Logowanie jest wyłączone, dopóki go nie włączysz.
run()w Pycord nie konfiguruje logowania, więc Python pokazuje tylko ostrzeżenia i błędy biblioteki, a nie jej linie informacyjne, takie jak logowanie do Discorda. Wypisz własną linię gotowości, jak wyżej, albo wywołajlogging.basicConfig(level=logging.INFO), żeby zobaczyć, co robi biblioteka. - Voice. Dla kanałów głosowych wpisz
py-cord[voice]wrequirements.txtzamiastpy-cord.
Hostuj sam na VPS z Linuksem
W Debianie lub Ubuntu zainstaluj Pythona, utwórz użytkownika i folder dla bota oraz zainstaluj Pycord w środowisku wirtualnym:
sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/pycord-bot bot
sudo cp bot.py requirements.txt /opt/pycord-bot/
sudo chown bot: /opt/pycord-bot/bot.py /opt/pycord-bot/requirements.txt
sudo -u bot python3 -m venv /opt/pycord-bot/venv
sudo -u bot /opt/pycord-bot/venv/bin/pip install -r /opt/pycord-bot/requirements.txt
Token umieść w pliku, który może czytać tylko root. Utwórz /etc/pycord-bot.env poleceniem sudo nano /etc/pycord-bot.env, wpisz jedną linię, DISCORD_TOKEN= a po niej swój token, zapisz plik i uruchom sudo chmod 600 /etc/pycord-bot.env.
Następnie utwórz /etc/systemd/system/pycord-bot.service:
[Unit]
Description=Pycord Discord bot
Wants=network-online.target
After=network-online.target
[Service]
User=bot
WorkingDirectory=/opt/pycord-bot
EnvironmentFile=/etc/pycord-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/pycord-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 pycord-bot
sudo journalctl -u pycord-bot -f
PYTHONUNBUFFERED=1 sprawia, że print() trafia do dziennika od razu, a nie dopiero wtedy, gdy zapełni się bufor. Aby zaktualizować bota, skopiuj nowe pliki, uruchom ponownie linię z pip install i sudo systemctl restart pycord-bot.
Własny serwer czy plan dla botów
| Twój własny VPS | Plan dla botów PlayNHost | |
|---|---|---|
| Python | Wersja dostarczana przez Twoją dystrybucję; sam ją instalujesz i aktualizujesz | Wybierz od 3.10 do 3.14 w Runtime |
| Pakiety | Po każdej zmianie uruchamiasz pip install | Instalowane przy starcie po zmianie requirements.txt lub wersji Pythona oraz przy pierwszym starcie w dzień po ostatniej instalacji |
| 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 zabezpieczasz sam | Przechowywany w postaci zaszyfrowanej, sprawdzany w Discordzie po wklejeniu, przekazywany Twojemu kodowi jako DISCORD_TOKEN |
| Błędy | Czytasz dziennik | Baner w konsoli wskazuje przyczynę, na przykład zły token lub brakujący intent |
| Aktualizacje systemu, zapora, SSH | Robisz je sam | Nie Twoja sprawa |
Najczęstsze pytania
Czy mogę mieć Pycord i discord.py w tym samym bocie?
Nie. Obie instalują moduł discord, więc jedna nadpisuje drugą. Zostaw tylko py-cord w requirements.txt. Jeśli serwer wcześniej uruchamiał discord.py, usuń .local i .pnh/packages.state w Files, aby pakiety zainstalowały się od nowa na czysto.
Dlaczego /ping nie pojawia się na moim serwerze?
Sprawdź, czy bot został dodany przez Dodaj na serwer Discord i czy konsola pokazuje linię Logged in as: Pycord rejestruje komendę przy połączeniu. Na czas testów przekaż debug_guilds=[your_server_id] do discord.Bot(): komendy powstają wtedy tylko na tym serwerze, a według dokumentacji Discorda komendy serwerowe aktualizują się natychmiast.
Czy Pycord to to samo co discord.py?
Nie. Pycord zaczął jako fork discord.py i zachowuje sporą część jego API, takiego jak discord.Client i discord.ext.commands, ale slash commands są inne: @bot.slash_command i ctx.respond() w Pycord, app_commands i wywołanie synchronizacji w discord.py. Kod napisany dla jednej nie zawsze działa w drugiej.
Czy bot na Pycord zmieści się w najmniejszym planie?
Tak. Przy około 51 MB w naszym teście minimalny bot na Pycord zajmuje około jednej dziesiątej planu STARTER o pojemności 0,5 GB. Przejdź na wyższy plan, gdy Twój bot tego potrzebuje: duże serwery, których członków buforuje, pliki lub obrazy, które obsługuje, albo dane, które trzyma w pamięci.
Gotowy, by uruchomić swojego? Wybierz plan w hostingu botów Discord i wgraj swojego bota na Pycord.



