Exécution du 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 — standard Linux pour les services (recommandé)
• Méthode 3. PM2 — gestionnaire de processus (pour Node.js, mais prend en charge Python)
• Comparaison des méthodes

Pour qu'un bot Python (ou tout autre langage) s'exécute en continu, redémarre automatiquement en cas d'échec et redémarre après un redémarrage du serveur, il ne suffit pas simplement de lancer python main.py. Vous avez besoin d'un service en arrière-plan à part entière.

Voici trois méthodes éprouvées : de la simple commande screen à systemd de niveau industriel. Choisissez en fonction de 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
   # If the file does not exist — install manually, e.g., 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émarrer.
Inconvénients : ne redémarre pas après un plantage ou un redémarrage — non adapté à la production.

Installation :

sudo apt update && sudo apt install screen -y

Lancement :

screen -S bot  # create a named session
source venv/bin/activate
python main.py

Gestion :

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

Avantages : démarrage automatique, redémarrage en cas d'erreur, journalisation, intégration système.
Inconvénients : nécessite la rédaction d'une 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                 # ← recommended not 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"  # so logs aren't buffered
   
   # Sécurité (optionnel, mais recommandé)
   NoNewPrivileges=true
   PrivateTmp=true
   ProtectSystem=strict
   ProtectHome=true
   ReadWritePaths=/home/user/bot/data/  # if the bot needs data access
   
   [Install]
   WantedBy=multi-user.target
   

3. Activez le service :
   

   sudo systemctl daemon-reload
   sudo systemctl enable bot.service   # autostart on boot
   sudo systemctl start bot.service    # start now
   

4. Vérifiez l'état et les journaux :
   

   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 prend en charge Python)¶

Avantages : simplicité, journaux intégrés, surveillance, interface web.
Inconvénients : nécessite Node.js, excessif pour les bots Python simples.

Installation :

# Install Node.js and npm (if not already installed)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

# Install PM2 globally
sudo npm install -g pm2

Démarrer le bot Python :

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

Commandes utiles :

Comparaison des méthodes¶