Чтобы запустить бота Pycord 24/7, держите его на машине, которая всегда включена, а не на своём ПК: на Linux VPS со службой systemd, если вы хостите сами, или на тарифе для ботов в хостинге Discord-ботов PlayNHost (от US$1.99 в месяц), где вы загружаете код, вставляете токен и нажимаете «Запустить». В нашем тесте бот на Pycord 2.8.1 занял около 51 МБ памяти и дозвонился до Discord примерно через 1.1 секунды после запуска. Pycord устанавливается как py-cord, но импортируется как discord, то есть под тем же именем, что и discord.py, поэтому укажите только одну из двух библиотек. Шаги в PlayNHost:
- На странице хостинга Discord-ботов нажмите Создать сервер у нужного тарифа. В окне заказа ответьте на вопрос Для какой платформы ваш бот?, выбрав Discord, и укажите Python.
- Откройте свой сервер в панели. Карточка Настройка бота в разделе Обзор открывается на шаге Подключение к Discord. Первый шаг, Что запускается, должен показывать Этот бот запускает Python Bot.; нажмите на этот шаг, чтобы проверить, затем Продолжить.
- На шаге Подключение к Discord вставьте токен в поле Вставьте токен бота, нажмите Подключить, затем Да, продолжить.
- На шаге Разрешения отметьте Мой код это использует только для привилегированных интентов, которые запрашивает ваш код (бот ниже не нуждается ни в одном), нажмите Добавить на сервер Discord, затем Продолжить.
- На шаге Ваш код нажмите Загрузить файлы и загрузите
bot.pyиrequirements.txt, в котором указанpy-cord, либо нажмите Подключить Git. - Если ваш главный файл называется не
bot.py, задайте Файл запуска на странице Бот, на вкладке Код, и нажмите Сохранить. - Нажмите Запустить бота и откройте Console, чтобы следить за запуском. Когда бот выведет
Logged in as ..., на карточке появится Ваш бот онлайн в Discord.
Общие шаги для Python (среда выполнения, пакеты, строки консоли) описаны в статье Как запустить Discord-бота на Python. Эта страница о том, что отличается в Pycord.
Что мы измерили
Мы запустили каждую библиотеку Discord для Python на собственных серверах, в той же конфигурации с Python 3.12, какую использует тариф для ботов, с лимитом памяти 1 ГБ:
| Библиотека | Версия | Память в покое | От запуска до ответа Discord |
|---|---|---|---|
| Pycord | 2.8.1 | 51 МБ | 1.1 с |
| discord.py | 2.7.1 | 48 МБ | 1.0 с |
| nextcord | 3.2.0 | 47 МБ | 1.0 с |
| disnake | 2.12.2 | 47 МБ | 0.9 с |
| hikari | 2.7.0 | 61 МБ | 1.3 с |
| Только Python | 3.12 | 9 МБ |
Как мерили: самая маленькая программа, которая загружает библиотеку и входит с поддельным токеном, установленная так, как наши серверы устанавливают пакеты. Память показывает, сколько занимал процесс через 15 секунд после того, как Discord отклонил токен, а время запуска считается от старта до этого ответа, поэтому включает один обмен с Discord. Каждое значение это медиана трёх запусков после разогревочного. Это нижняя граница: бот, который подключился, вошёл на серверы и кэшировал участников, занимает больше, и насколько именно, зависит от бота.
Что это значит для тарифа: минимальный бот на Pycord занимает около десятой части тарифа STARTER на 0.5 ГБ. Подбирайте тариф по тому, что ваш собственный бот держит в памяти, а не по библиотеке.
Минимальный бот на Pycord
Он отвечает на /ping слэш-командой и выводит строку готовности. Токен он читает из DISCORD_TOKEN, под этим именем панель передаёт его вашему коду.
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 это собственный класс Pycord для слэш-команд. Он сам регистрирует /ping в Discord при каждом подключении, потому что auto_sync_commands по умолчанию включён, так что писать шаг синхронизации не нужно. Строка Logged in as переключает метку в разделе Обзор на Онлайн в Discord.
Если токен неверный
Когда Discord отклоняет токен, Pycord выбрасывает такую ошибку (текст, который вывел наш тестовый бот):
LoginFailure: Improper token has been passed.
При bot.run() трассировка заканчивается строкой discord.errors.LoginFailure: Improper token has been passed., и бот останавливается. Панель читает эту строку: метка показывает Проблема с токеном, а баннер сообщает Discord не принял токен вашего бота. Получите новый токен в Discord Developer Portal: ваше приложение, Bot, Reset Token (он показывается один раз). Нажмите Заменить токен в баннере, затем Заменить токен на вкладке Discord, вставьте его и снова запустите бота. См. Как создать Discord-бота и получить его токен.
Что хосту нужно знать о Pycord
- Имя для установки и имя для импорта различаются. Вы устанавливаете
py-cordи пишетеimport discord. discord.py устанавливает модуль с тем же именем,discord, поэтому вместе они существовать не могут. В собственном руководстве Pycord сказано сначала удалить discord.py и предупреждается, что удаление discord.py после установки py-cord может вызвать проблемы. - Перенос сервера с discord.py на Pycord. Наши серверы устанавливают пакеты в папку
.localи никогда не удаляют пакет, который вы убрали изrequirements.txt, поэтому discord.py остался бы рядом с Pycord. В разделе Files удалите папку.localи файл.pnh/packages.state, затем нажмите Запустить: всё изrequirements.txtустановится заново, уже без discord.py. - Версия Python. Pycord 2.8.1 поддерживает Python с 3.10 по 3.14. Среда выполнения на вкладке Код предлагает именно эти версии, по умолчанию 3.12, так что подойдёт любой выбор.
- Intents.
discord.Bot()использует интенты по умолчанию, среди которых нет привилегированных, а слэш-командам они не нужны. Префиксным командам вроде!pingнужныintents.message_content = Trueв вашем коде и включённый Message Content Intent в Developer Portal. Если код запрашивает его, а в Portal он выключен, Discord отклоняет вход. См. Как исправить «Used disallowed intents» у вашего Discord-бота. - Не занимайте on_connect. Автоматическая регистрация выполняется во встроенном
on_connectбота. Если вы определяетеon_connectсами, в документации Pycord сказано вызывать в нёмawait bot.sync_commands(), иначе ваши команды перестанут обновляться. Код запуска помещайте вon_ready, как выше. - Логирование выключено, пока вы его не включите.
run()в Pycord не настраивает логирование, поэтому Python показывает только предупреждения и ошибки библиотеки, но не её информационные строки, например о входе. Выводите собственную строку готовности, как выше, или вызовитеlogging.basicConfig(level=logging.INFO), чтобы видеть, что делает библиотека. - Голосовые. Для голосовых каналов укажите
py-cord[voice]вrequirements.txtвместоpy-cord.
Запуск на своём Linux VPS
В Debian или Ubuntu установите Python, создайте пользователя и папку для бота и установите Pycord в виртуальное окружение:
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
Положите токен в файл, который может читать только root. Создайте /etc/pycord-bot.env командой sudo nano /etc/pycord-bot.env, напишите одну строку, DISCORD_TOKEN= и после неё ваш токен, сохраните файл и выполните sudo chmod 600 /etc/pycord-bot.env.
Затем создайте /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
Запустите его сейчас и при каждой загрузке системы, а затем следите за его выводом:
sudo systemctl daemon-reload
sudo systemctl enable --now pycord-bot
sudo journalctl -u pycord-bot -f
PYTHONUNBUFFERED=1 заставляет print() попадать в журнал сразу, а не когда заполнится буфер. Чтобы обновить бота, скопируйте новые файлы, снова выполните строку с pip install и sudo systemctl restart pycord-bot.
Свой сервер или тариф для ботов
| Ваш собственный VPS | Тариф для ботов PlayNHost | |
|---|---|---|
| Python | Версия из вашего дистрибутива; устанавливаете и обновляете вы сами | Выберите с 3.10 по 3.14 в разделе Среда выполнения |
| Пакеты | Вы запускаете pip install после каждого изменения | Устанавливаются при запуске после изменения requirements.txt или версии Python, а также при первом запуске через день после последней установки |
| Перезапуски | Ваш юнит systemd | Запускается снова после сбоя; если сбой повторится в течение минуты, остаётся остановленным с указанием причины |
| Токен | Файл, который вы защищаете сами | Хранится в зашифрованном виде, проверяется в Discord при вставке и передаётся вашему коду как DISCORD_TOKEN |
| Ошибки | Вы читаете журнал | Баннер в консоли называет причину, например неверный токен или отсутствующий интент |
| Обновления системы, брандмауэр, SSH | Ваша забота | Не ваша забота |
Частые вопросы
Можно ли использовать Pycord и discord.py в одном боте?
Нет. Обе библиотеки устанавливают модуль discord, поэтому одна перезаписывает другую. Оставьте только py-cord в requirements.txt. Если на сервере раньше работал discord.py, удалите .local и .pnh/packages.state в разделе Files, чтобы пакеты установились заново начисто.
Почему /ping не появляется на моём сервере?
Проверьте, что бот добавлен через Добавить на сервер Discord и что в консоли есть строка Logged in as: Pycord регистрирует команду при подключении. На время тестов передайте debug_guilds=[your_server_id] в discord.Bot(): тогда команды создаются только на этом сервере, а по документации Discord команды сервера обновляются мгновенно.
Pycord и discord.py это одно и то же?
Нет. Pycord начинался как форк discord.py и сохраняет значительную часть его API, например discord.Client и discord.ext.commands, но слэш-команды у них разные: @bot.slash_command и ctx.respond() в Pycord, app_commands и вызов синхронизации в discord.py. Код, написанный для одной библиотеки, не всегда работает на другой.
Поместится ли бот на Pycord в самый маленький тариф?
Да. При примерно 51 МБ в нашем тесте минимальный бот на Pycord занимает около десятой части тарифа STARTER на 0.5 ГБ. Переходите на старший тариф, когда этого требует сам бот: крупные серверы, участников которых он кэширует, файлы или изображения, которые он обрабатывает, или данные, которые он держит в памяти.
Готовы запустить своего? Выберите тариф на странице хостинга Discord-ботов и загрузите своего бота на Pycord.



