Статья 58 из 141
Гайды
Как запустить Telegram-бота на VPS: systemd, Docker и вебхук
Бот на домашнем компьютере выключается вместе с ним. На VPS бот работает круглосуточно, перезапускается после сбоя и сам стартует после перезагрузки сервера.
Пример ниже для бота на Python с aiogram 3. Для других библиотек меняется только команда запуска.
Для бота с небольшой нагрузкой достаточно младшего тарифа: 1 vCPU и 1–2 ГБ RAM.
Подготовка сервера
Заголовок раздела «Подготовка сервера»Подключитесь по SSH и установите Python:
apt updateapt install -y python3 python3-venv python3-pip gitСоздайте отдельного пользователя. Запускать бота от root небезопасно:
adduser --disabled-password --gecos "" botКод и зависимости
Заголовок раздела «Код и зависимости»su - botgit clone https://github.com/ваш_аккаунт/ваш_бот.git appcd apppython3 -m venv .venv.venv/bin/pip install -r requirements.txtТокен в .env, а не в коде
Заголовок раздела «Токен в .env, а не в коде»Создайте файл /home/bot/app/.env:
BOT_TOKEN=123456:ABC...Закройте его от чтения другими пользователями и не добавляйте в git:
chmod 600 .envecho ".env" >> .gitignoreВ коде читайте токен из окружения:
import osbot = Bot(token=os.environ["BOT_TOKEN"])Проверьте запуск вручную: .venv/bin/python bot.py. Остановите бота через Ctrl+C и вернитесь в root: exit.
Автозапуск через systemd
Заголовок раздела «Автозапуск через systemd»Создайте /etc/systemd/system/tgbot.service:
[Unit]Description=Telegram botAfter=network-online.targetWants=network-online.target
[Service]User=botWorkingDirectory=/home/bot/appEnvironmentFile=/home/bot/app/.envExecStart=/home/bot/app/.venv/bin/python bot.pyRestart=alwaysRestartSec=5
[Install]WantedBy=multi-user.targetВключите и запустите:
systemctl daemon-reloadsystemctl 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.
Вариант с Docker
Заголовок раздела «Вариант с Docker»Если у бота есть база данных или Redis, удобнее Docker Compose. Установка Docker: Docker на VPS.
Dockerfile:
FROM python:3.12-slimWORKDIR /appCOPY requirements.txt .RUN pip install --no-cache-dir -r requirements.txtCOPY . .CMD ["python", "bot.py"]docker-compose.yml:
services: bot: build: . env_file: .env restart: unless-stoppedЗапуск и логи:
docker compose up -d --builddocker compose logs -f botPolling или вебхук
Заголовок раздела «Polling или вебхук»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 |