Где разместить Telegram bot на Python: обзор решений

Дополнительные примеры конфигураций и вариантов деплоя с подробными пояснениями.

Развёртывание через Docker и docker-compose

Использование контейнеризации избавляет от проблем с зависимостями и окружением. Пример Dockerfile для бота на python-telegram-bot с webhook:

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

Файл docker-compose.yml:

version: '3.8'
services:
  bot:
    build: .
    ports:
      - "8443:8443"
    environment:
      - BOT_TOKEN=${BOT_TOKEN}
    restart: always

После сборки запуск выполняется командой docker-compose up -d. В выводе терминала видно:

Creating network "mybot_default" with the default driver
Creating mybot_bot_1 ... done

Логи бота доступны через docker logs -f mybot_bot_1.

Использование Nginx в качестве обратного прокси для webhook

Если требуется закрыть прямой доступ к порту бота и добавить SSL, перед ботом ставится Nginx. Конфигурация:

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate /etc/ssl/certs/cert.pem;
    ssl_certificate_key /etc/ssl/private/key.pem;

    location /webhook {
        proxy_pass http://127.0.0.1:8443;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

После перезагрузки Nginx бот принимает вебхуки только через защищённое соединение. Проверка статуса вебхука:

$ curl https://api.telegram.org/botTOKEN/getWebhookInfo
{"ok":true,"result":{"url":"https://example.com/webhook","has_custom_certificate":false,"pending_update_count":0,"last_error_date":0,"last_error_message":"","max_connections":40,"ip_address":"192.0.2.1"}}

Деплой на Google Cloud Run (бессерверный контейнер)

Cloud Run запускает контейнеры на основе запросов. Подходит для webhook-ботов. Dockerfile такой же, но приложение должно слушать порт из переменной PORT. Файл cloudbuild.yaml для автоматического деплоя:

steps:
  - name: 'gcr.io/cloud-builders/docker'
    args: ['build', '-t', 'gcr.io/$PROJECT_ID/bot', '.']
  - name: 'gcr.io/cloud-builders/docker'
    args: ['push', 'gcr.io/$PROJECT_ID/bot']
  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
    entrypoint: gcloud
    args: ['run', 'deploy', 'bot', '--image', 'gcr.io/$PROJECT_ID/bot', '--region', 'us-central1', '--platform', 'managed', '--allow-unauthenticated', '--set-env-vars', 'BOT_TOKEN=your_token']

После выполнения Cloud Run выдаёт URL вида https://bot-xxxx-uc.a.run.app. Установка вебхука:

curl -X POST "https://api.telegram.org/botTOKEN/setWebhook?url=https://bot-xxxx-uc.a.run.app/webhook"

{"ok":true,"result":true,"description":"Webhook was set"}

Использование Supervisor вместо systemd

На серверах без systemd или для дополнительного контроля применяется Supervisor. Конфигурация:

[program:telegram_bot]
command=/usr/bin/python3 /home/bot/bot.py
directory=/home/bot
user=www-data
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/bot.log

Файл помещается в /etc/supervisor/conf.d/bot.conf, затем:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start telegram_bot

Проверка состояния:

supervisorctl status
telegram_bot                    RUNNING   pid 12345, uptime 0:10:00

Подключение базы данных (PostgreSQL) для сохранения состояний

Для ботов, хранящих данные пользователей, удобно использовать PostgreSQL. Подключение через SQLAlchemy:

from sqlalchemy import create_engine, Column, Integer, String
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import sessionmaker

DATABASE_URL = os.getenv("DATABASE_URL")
engine = create_engine(DATABASE_URL)
Base = declarative_base()

class User(Base):
    __tablename__ = 'users'
    id = Column(Integer, primary_key=True)
    telegram_id = Column(Integer, unique=True)

Base.metadata.create_all(engine)
Session = sessionmaker(bind=engine)
session = Session()

# Использование в обработчике
async def start(update, context):
    user = session.query(User).filter_by(telegram_id=update.effective_user.id).first()
    if not user:
        user = User(telegram_id=update.effective_user.id)
        session.add(user)
        session.commit()
    await update.message.reply_text("Вы зарегистрированы")

В requirements.txt добавляется sqlalchemy и psycopg2-binary. Переменная DATABASE_URL задаётся в окружении (например, на Render или Railway).

Настройка логгирования с ротацией

Для долго работающих ботов полезно настроить ротацию логов, чтобы они не занимали весь диск.

import logging
from logging.handlers import RotatingFileHandler

handler = RotatingFileHandler('bot.log', maxBytes=1024*1024, backupCount=5)
handler.setFormatter(logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'))
logger = logging.getLogger(__name__)
logger.addHandler(handler)
logger.setLevel(logging.INFO)

# Пример вывода лога
logger.info("Бот запущен")

2025-03-01 12:00:00,000 - __main__ - INFO - Бот запущен