Перейти к содержимому

Статья 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 ГБ
  1. Откройте Developer Portal, выберите приложение, вкладка Bot.
  2. Нажмите Reset Token и скопируйте токен. Discord показывает его один раз.
  3. В разделе Privileged Gateway Intents включите те intents, которые нужны боту. Для команд с префиксом вроде !ping нужен Message Content Intent.

Привилегированных intents три: Presence, Server Members и Message Content. Их нужно включить и в портале, и в коде. Если бот состоит больше чем в 100 серверах, для этого нужна верификация бота в Discord.

Токен даёт полный доступ к боту. Не публикуйте его в git и в чатах. Если токен утёк, сразу сбросьте его в портале.

Подключитесь по SSH и установите Python:

Окно терминала
apt update
apt 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 logging
import os
import discord
from discord.ext import commands
from 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.event
async 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.py
python-dotenv

Создайте /opt/discordbot/app/.env:

DISCORD_TOKEN=ВАШ_ТОКЕН
Окно терминала
chown -R discordbot:discordbot /opt/discordbot
chmod 600 /opt/discordbot/app/.env
echo ".env" >> /opt/discordbot/app/.gitignore
Окно терминала
cd /opt/discordbot/app
sudo -u discordbot python3 -m venv .venv
sudo -u discordbot .venv/bin/pip install -r requirements.txt

Создайте /etc/systemd/system/discordbot.service:

[Unit]
Description=Discord bot
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=discordbot
Group=discordbot
WorkingDirectory=/opt/discordbot/app
EnvironmentFile=/opt/discordbot/app/.env
ExecStart=/opt/discordbot/app/.venv/bin/python bot.py
Restart=on-failure
RestartSec=10
NoNewPrivileges=true
ProtectSystem=full
PrivateTmp=true
[Install]
WantedBy=multi-user.target
Окно терминала
systemctl daemon-reload
systemctl enable --now discordbot
systemctl status discordbot

Restart=on-failure перезапустит бота через 10 секунд после падения. enable включает автозапуск после перезагрузки сервера. Последние три строки в [Service] ограничивают права процесса.

При рабочем токене в журнале появится строка Бот запущен как с именем бота, а бот станет онлайн в Discord.

Мы проверили сервис без настоящего токена. Если .env пустой, бот завершится с понятным сообщением, а systemd будет пытаться его перезапустить:

systemd[1]: Started discordbot.service - Discord bot.
python[18373]: DISCORD_TOKEN не задан: проверьте файл .env
systemd[1]: discordbot.service: Main process exited, code=exited, status=1/FAILURE
systemd[1]: discordbot.service: Failed with result 'exit-code'.

Если токен неверный или сброшен, Discord отклонит вход:

python[18382]: raise LoginFailure('Improper token has been passed.') from exc
python[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/app
sudo -u discordbot git pull
sudo -u discordbot .venv/bin/pip install -r requirements.txt --upgrade
systemctl restart discordbot

Выполняйте git pull от пользователя discordbot, которому принадлежат файлы. Иначе git откажется работать с ошибкой dubious ownership.

Docker удобен, если рядом с ботом работает база данных или Redis. Установка: Docker на VPS.

Dockerfile:

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY bot.py .
RUN useradd --create-home bot
USER bot
CMD ["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 --build
docker compose ps
docker compose logs -f bot

Без токена контейнер уходит в перезапуск, а в логах видна причина:

NAME IMAGE COMMAND SERVICE STATUS
discordbot discordbot-bot "python -u bot.py" bot Restarting (1) 1 second ago
discordbot | DISCORD_TOKEN не задан: проверьте файл .env

Обновление: git pull, затем docker compose up -d --build.

Запускайте бота одним способом: или systemd, или Docker. Две копии с одним токеном будут отвечать на каждую команду дважды.

Для бота на 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