Статья 59 из 141
Гайды
Как запустить Discord-бота на VPS 24/7: discord.py, systemd, Docker и логи
Discord-бот работает, пока запущен его процесс. На домашнем компьютере он выключается вместе с компьютером. На VPS бот работает круглосуточно, перезапускается после сбоя и сам стартует после перезагрузки сервера.
Пример ниже для бота на Python с discord.py 2.7. Для бота на discord.js меняются только установка зависимостей и команда запуска, об этом в конце статьи.
Боту не нужны домен и открытые порты: он сам подключается к серверам Discord. Для небольшого бота хватит младшего тарифа.
| Ресурс | Минимум | Комментарий |
|---|---|---|
| vCPU | 1 | |
| RAM | 512 МБ – 1 ГБ | больше, если бот работает с голосом или большими серверами |
| Диск | 5 ГБ |
Токен и intents
Заголовок раздела «Токен и intents»- Откройте Developer Portal, выберите приложение, вкладка Bot.
- Нажмите Reset Token и скопируйте токен. Discord показывает его один раз.
- В разделе Privileged Gateway Intents включите те intents, которые нужны боту. Для команд с префиксом вроде
!pingнужен Message Content Intent.
Привилегированных intents три: Presence, Server Members и Message Content. Их нужно включить и в портале, и в коде. Если бот состоит больше чем в 100 серверах, для этого нужна верификация бота в Discord.
Токен даёт полный доступ к боту. Не публикуйте его в git и в чатах. Если токен утёк, сразу сбросьте его в портале.
Подготовка сервера
Заголовок раздела «Подготовка сервера»Подключитесь по SSH и установите Python:
apt updateapt install -y python3 python3-venv python3-pip gitСоздайте отдельного пользователя без входа в shell:
adduser --system --group --home /opt/discordbot --shell /usr/sbin/nologin discordbotКод бота
Заголовок раздела «Код бота»Склонируйте свой репозиторий в /opt/discordbot/app или создайте файлы вручную. Минимальный bot.py:
import loggingimport os
import discordfrom discord.ext import commandsfrom dotenv import load_dotenv
load_dotenv()TOKEN = os.getenv("DISCORD_TOKEN")if not TOKEN: raise SystemExit("DISCORD_TOKEN не задан: проверьте файл .env")
intents = discord.Intents.default()intents.message_content = True # привилегированный intent, включается в Developer Portal
bot = commands.Bot(command_prefix="!", intents=intents)
@bot.eventasync def on_ready(): logging.getLogger("discord").info("Бот запущен как %s", bot.user)
@bot.command()async def ping(ctx): await ctx.send("pong")
bot.run(TOKEN, log_level=logging.INFO)requirements.txt:
discord.pypython-dotenvТокен в .env
Заголовок раздела «Токен в .env»Создайте /opt/discordbot/app/.env:
DISCORD_TOKEN=ВАШ_ТОКЕНchown -R discordbot:discordbot /opt/discordbotchmod 600 /opt/discordbot/app/.envecho ".env" >> /opt/discordbot/app/.gitignoreВиртуальное окружение
Заголовок раздела «Виртуальное окружение»cd /opt/discordbot/appsudo -u discordbot python3 -m venv .venvsudo -u discordbot .venv/bin/pip install -r requirements.txtАвтозапуск через systemd
Заголовок раздела «Автозапуск через systemd»Создайте /etc/systemd/system/discordbot.service:
[Unit]Description=Discord botAfter=network-online.targetWants=network-online.target
[Service]Type=simpleUser=discordbotGroup=discordbotWorkingDirectory=/opt/discordbot/appEnvironmentFile=/opt/discordbot/app/.envExecStart=/opt/discordbot/app/.venv/bin/python bot.pyRestart=on-failureRestartSec=10NoNewPrivileges=trueProtectSystem=fullPrivateTmp=true
[Install]WantedBy=multi-user.targetsystemctl daemon-reloadsystemctl enable --now discordbotsystemctl status discordbotRestart=on-failure перезапустит бота через 10 секунд после падения. enable включает автозапуск после перезагрузки сервера. Последние три строки в [Service] ограничивают права процесса.
При рабочем токене в журнале появится строка Бот запущен как с именем бота, а бот станет онлайн в Discord.
Как выглядят ошибки токена
Заголовок раздела «Как выглядят ошибки токена»Мы проверили сервис без настоящего токена. Если .env пустой, бот завершится с понятным сообщением, а systemd будет пытаться его перезапустить:
systemd[1]: Started discordbot.service - Discord bot.python[18373]: DISCORD_TOKEN не задан: проверьте файл .envsystemd[1]: discordbot.service: Main process exited, code=exited, status=1/FAILUREsystemd[1]: discordbot.service: Failed with result 'exit-code'.Если токен неверный или сброшен, Discord отклонит вход:
python[18382]: raise LoginFailure('Improper token has been passed.') from excpython[18382]: discord.errors.LoginFailure: Improper token has been passed.journalctl -u discordbot -f # в реальном времениjournalctl -u discordbot --since today # за сегодняjournalctl -u discordbot -n 100 --no-pager # последние 100 строкdiscord.py пишет в журнал подключения, переподключения и ошибки в командах. Чтобы журнал не занимал весь диск, ограничьте его размер в /etc/systemd/journald.conf параметром SystemMaxUse=500M и выполните systemctl restart systemd-journald.
Обновление
Заголовок раздела «Обновление»cd /opt/discordbot/appsudo -u discordbot git pullsudo -u discordbot .venv/bin/pip install -r requirements.txt --upgradesystemctl restart discordbotВыполняйте git pull от пользователя discordbot, которому принадлежат файлы. Иначе git откажется работать с ошибкой dubious ownership.
Вариант с Docker
Заголовок раздела «Вариант с Docker»Docker удобен, если рядом с ботом работает база данных или Redis. Установка: Docker на VPS.
Dockerfile:
FROM python:3.12-slimWORKDIR /appCOPY requirements.txt .RUN pip install --no-cache-dir -r requirements.txtCOPY bot.py .RUN useradd --create-home botUSER botCMD ["python", "-u", "bot.py"]compose.yaml:
services: bot: build: . env_file: .env restart: unless-stopped logging: driver: json-file options: max-size: "10m" max-file: "3"Флаг -u отключает буферизацию вывода Python, иначе логи появятся с задержкой. Блок logging ограничивает размер логов контейнера.
docker compose up -d --builddocker compose psdocker compose logs -f botБез токена контейнер уходит в перезапуск, а в логах видна причина:
NAME IMAGE COMMAND SERVICE STATUSdiscordbot discordbot-bot "python -u bot.py" bot Restarting (1) 1 second agodiscordbot | DISCORD_TOKEN не задан: проверьте файл .envОбновление: git pull, затем docker compose up -d --build.
Запускайте бота одним способом: или systemd, или Docker. Две копии с одним токеном будут отвечать на каждую команду дважды.
Бот на discord.js
Заголовок раздела «Бот на discord.js»Для бота на Node.js установите Node.js по инструкции Node.js на VPS, затем в каталоге бота выполните npm ci --omit=dev. В сервисе systemd замените строку запуска:
ExecStart=/usr/bin/node index.jsТокен читайте из process.env.DISCORD_TOKEN. Остальное не меняется: тот же EnvironmentFile, Restart и journalctl.
Частые проблемы
Заголовок раздела «Частые проблемы»| Симптом | Причина и решение |
|---|---|
LoginFailure: Improper token has been passed. |
токен неверный, сброшен или скопирован с пробелом. Сбросьте его в портале и обновите .env |
PrivilegedIntentsRequired |
intent включён в коде, но не включён на вкладке Bot в Developer Portal |
| Бот онлайн, но не видит текст сообщений | не включён Message Content Intent в портале или intents.message_content = True в коде |
| Бот отвечает дважды | запущены две копии: на компьютере и на сервере или через systemd и Docker одновременно |
| После перезагрузки сервера бот офлайн | не выполнен systemctl enable discordbot |
| Бот периодически падает без ошибок | закончилась память: free -h, journalctl -k | grep -i oom, добавьте swap |