Ejecución del bot en segundo plano¶

En este artículo

• Preparación del entorno
• Método 1. screen - lanzamiento rápido (para pruebas y desarrollo)
• Método 2. systemd - estándar de Linux para servicios (recomendado)
• Método 3. PM2 - gestor de procesos (para Node.js, pero admite Python)
• Comparación de métodos

Para que un bot de Python (o cualquier otro) se ejecute de forma continua, se reinicie automáticamente tras un fallo y se inicie después de un reinicio del servidor, el simple hecho de ejecutar python main.py no es suficiente. Necesitas un servicio de fondo completo.

A continuación, se presentan tres métodos probados: desde el sencillo screen hasta el de nivel industrial systemd. Elige según tus necesidades.

Preparación del entorno¶

1. Coloca el código del bot, por ejemplo, en /home/user/bot:

   mkdir -p /home/user/bot && cd /home/user/bot
   

2. Crea y activa un entorno virtual para aislar las dependencias:

   python3 -m venv venv
   source venv/bin/activate
   

3. Instala las dependencias:

   pip install -r requirements.txt
   # Si el archivo no existe, instálalas manualmente, ej. pip install python-telegram-bot
   

4. Prueba el lanzamiento manual:

   python main.py
   

sudo adduser --disabled-login botuser
sudo chown -R botuser:botuser /home/user/bot

Método 1. screen - lanzamiento rápido (para pruebas y desarrollo)¶

Pros: lo más fácil para empezar.
Cons: no se reinicia tras un error o reinicio — no es apto para producción.

Instalación:

sudo apt update && sudo apt install screen -y

Lanzamiento:

screen -S bot  # crear una sesión con nombre
source venv/bin/activate
python main.py

Gestión:

Método 2. systemd - estándar de Linux para servicios (recomendado)¶

Pros: autoinicio, reinicio ante errores, registro (logging), integración con el sistema.
Cons: requiere escribir un archivo de configuración.

1. Crea un archivo de unidad:
   

   sudo nano /etc/systemd/system/bot.service
   

2. Pega la configuración (¡adapta las rutas y el usuario!):
   

   [Unit]
   Description=Telegram Bot Service
   After=network.target
   StartLimitIntervalSec=30
   StartLimitBurst=5
   
   [Service]
   Type=simple
   User=botuser                 # ← ¡se recomienda que no sea root!
   Group=botuser
   WorkingDirectory=/home/user/bot
   ExecStart=/home/user/bot/venv/bin/python /home/user/bot/main.py
   Restart=always
   RestartSec=10
   Environment="PYTHONUNBUFFERED=1"  # para que los logs no se queden en el búfer
   
   # Seguridad (opcional, pero recomendado)
   NoNewPrivileges=true
   PrivateTmp=true
   ProtectSystem=strict
   ProtectHome=true
   ReadWritePaths=/home/user/bot/data/  # si el bot necesita acceso a datos
   
   [Install]
   WantedBy=multi-user.target
   

3. Habilita el servicio:
   

   sudo systemctl daemon-reload
   sudo systemctl enable bot.service   # autoinicio al arrancar
   sudo systemctl start bot.service    # iniciar ahora
   

4. Comprueba el estado y los logs:
   

   sudo systemctl status bot.service
   journalctl -u bot.service -f --since "1 hour ago"
   

Método 3. PM2 - gestor de procesos (para Node.js, pero admite Python)¶

Pros: simplicidad, logs integrados, monitorización, interfaz web.
Cons: requiere Node.js, es excesivo para bots de Python sencillos.

Instalación:

# Instalar Node.js y npm (si no están instalados)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

# Instalar PM2 de forma global
sudo npm install -g pm2

Inicia el bot de Python:

cd /home/user/bot
pm2 start main.py --name "my-bot" --interpreter ./venv/bin/python

Comandos útiles:

Comparación de métodos¶