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

Статья 58 из 141

Гайды

Как запустить Telegram-бота на VPS: systemd, Docker и вебхук

Бот на домашнем компьютере выключается вместе с ним. На VPS бот работает круглосуточно, перезапускается после сбоя и сам стартует после перезагрузки сервера.

Пример ниже для бота на Python с aiogram 3. Для других библиотек меняется только команда запуска.

Для бота с небольшой нагрузкой достаточно младшего тарифа: 1 vCPU и 1–2 ГБ RAM.

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

Окно терминала
apt update
apt install -y python3 python3-venv python3-pip git

Создайте отдельного пользователя. Запускать бота от root небезопасно:

Окно терминала
adduser --disabled-password --gecos "" bot
Окно терминала
su - bot
git clone https://github.com/ваш_аккаунт/ваш_бот.git app
cd app
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

Создайте файл /home/bot/app/.env:

BOT_TOKEN=123456:ABC...

Закройте его от чтения другими пользователями и не добавляйте в git:

Окно терминала
chmod 600 .env
echo ".env" >> .gitignore

В коде читайте токен из окружения:

import os
bot = Bot(token=os.environ["BOT_TOKEN"])

Проверьте запуск вручную: .venv/bin/python bot.py. Остановите бота через Ctrl+C и вернитесь в root: exit.

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

[Unit]
Description=Telegram bot
After=network-online.target
Wants=network-online.target
[Service]
User=bot
WorkingDirectory=/home/bot/app
EnvironmentFile=/home/bot/app/.env
ExecStart=/home/bot/app/.venv/bin/python bot.py
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target

Включите и запустите:

Окно терминала
systemctl daemon-reload
systemctl enable --now tgbot

Полезные команды:

Окно терминала
systemctl status tgbot # статус
journalctl -u tgbot -f # логи в реальном времени
systemctl restart tgbot # перезапуск после обновления кода

Restart=always поднимет бота, если он упадёт из-за ошибки.

Окно терминала
su - bot -c "cd app && git pull && .venv/bin/pip install -r requirements.txt"
systemctl restart tgbot

Автоматический деплой при пуше в репозиторий: GitHub Actions.

Если у бота есть база данных или Redis, удобнее Docker Compose. Установка Docker: Docker на VPS.

Dockerfile:

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "bot.py"]

docker-compose.yml:

services:
bot:
build: .
env_file: .env
restart: unless-stopped

Запуск и логи:

Окно терминала
docker compose up -d --build
docker compose logs -f bot

Polling — бот сам спрашивает Telegram о новых сообщениях. Не нужен домен и открытые порты. Для большинства ботов это лучший вариант.

Вебхук — Telegram сам присылает сообщения на ваш сервер. Нужен домен с HTTPS. Подходит для ботов с большой нагрузкой.

Для вебхука бот слушает локальный порт, например 8080, а Nginx принимает HTTPS и передаёт запросы боту:

server {
server_name bot.example.com;
location /webhook {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}

Сертификат: Let’s Encrypt. Настройка Nginx: Nginx на VPS.

Telegram отправляет вебхуки только на порты 443, 80, 88 и 8443.

Симптом Причина
Conflict: terminated by other getUpdates request бот запущен дважды: на компьютере и на сервере, или две копии на сервере
Бот не стартует, KeyError: 'BOT_TOKEN' не подключён EnvironmentFile или ошибка в пути к .env
После перезагрузки сервера бот не работает не выполнен systemctl enable
Бот периодически падает без ошибок закончилась память: free -h, journalctl -k | grep -i oom