Exécuter le bot en arrière-plan¶

Dans cet article

• Préparation de l'environnement
• Méthode 1. screen - lancement rapide (pour les tests et le développement)
• Méthode 2. systemd - le standard Linux pour les services (recommandé)
• Méthode 3. PM2 - gestionnaire de processus (pour Node.js, mais supporte Python)
• Comparaison des méthodes

Pour qu'un bot Python (ou tout autre langage) s'exécute de manière continue, redémarre automatiquement en cas d'échec et démarre après un redémarrage du serveur, le simple fait de lancer python main.py ne suffit pas. Vous avez besoin d'un véritable service d'arrière-plan.

Voici trois méthodes éprouvées : de la simple commande screen au standard industriel systemd. Choisissez celle qui correspond à vos besoins.

Préparation de l'environnement¶

1. Placez le code du bot, par exemple dans /home/user/bot :

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

2. Créez et activez un environnement virtuel pour isoler les dépendances :

   python3 -m venv venv
   source venv/bin/activate
   

3. Installez les dépendances :

   pip install -r requirements.txt
   # Si le fichier n'existe pas — installez-les manuellement, ex: pip install python-telegram-bot
   

4. Testez le lancement manuel :

   python main.py
   

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

Méthode 1. screen - lancement rapide (pour les tests et le développement)¶

Avantages : le plus simple pour débuter.
Inconvénients : ne redémarre pas après un crash ou un redémarrage — ne convient pas pour la production.

Installation :

sudo apt update && sudo apt install screen -y

Lancement :

screen -S bot  # créer une session nommée
source venv/bin/activate
python main.py

Gestion :

Méthode 2. systemd - le standard Linux pour les services (recommandé)¶

Avantages : démarrage automatique, redémarrage en cas d'erreur, journalisation, intégration au système.
Inconvénients : nécessite la rédaction d'un fichier de configuration.

1. Créez un fichier d'unité :
   

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

2. Collez la configuration (adaptez les chemins et l'utilisateur !) :
   

   [Unit]
   Description=Telegram Bot Service
   After=network.target
   StartLimitIntervalSec=30
   StartLimitBurst=5
   
   [Service]
   Type=simple
   User=botuser                 # ← recommandé : ne pas utiliser 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"  # pour que les logs ne soient pas mis en mémoire tampon
   
   # Sécurité (optionnel, mais recommandé)
   NoNewPrivileges=true
   PrivateTmp=true
   ProtectSystem=strict
   ProtectHome=true
   ReadWritePaths=/home/user/bot/data/  # si le bot a besoin d'accéder à des données
   
   [Install]
   WantedBy=multi-user.target
   

3. Activez le service :
   

   sudo systemctl daemon-reload
   sudo systemctl enable bot.service   # démarrage automatique au boot
   sudo systemctl start bot.service    # démarrage immédiat
   

4. Vérifiez le statut et les logs :
   

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

Méthode 3. PM2 - gestionnaire de processus (pour Node.js, mais supporte Python)¶

Avantages : simplicité, logs intégrés, monitoring, interface web.
Inconvénients : nécessite Node.js, peut être excessif pour de simples bots Python.

Installation :

# Installer Node.js et npm (si pas déjà installés)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

# Installer PM2 globalement
sudo npm install -g pm2

Lancez le bot Python :

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

Commandes utiles :

Comparaison des méthodes¶