Gérer des sessions persistantes sur un VPS Linux avec tmux

Vous lancez votre serveur FiveM ou Minecraft en SSH, vous fermez le terminal, et le processus s'arrête. Ce comportement est normal : quand la connexion SSH se termine, le shell envoie un signal SIGHUP à tous les processus enfants, qui s'interrompent. tmux résout ce problème en exécutant vos processus dans des sessions persistantes qui survivent à toute déconnexion. Ce tutoriel couvre l'installation, la configuration et l'administration quotidienne de tmux sur un serveur VPS Linux.

Ce guide vous explique comment installer tmux sur un VPS Linux, créer des sessions persistantes, les gérer au quotidien, et sécuriser votre hébergement de serveur de jeu avec cette méthode éprouvée pour les administrateurs système.

Pourquoi les processus s'arrêtent à la déconnexion SSH

Lorsque vous vous connectez en SSH à votre VPS Linux, le serveur SSH crée un shell de connexion. Tous les processus que vous lancez deviennent des enfants de ce shell. Au moment où la connexion se coupe (déconnexion volontaire, timeout réseau ou perte de connexion), le noyau Linux envoie le signal SIGHUP (hangup) au shell, qui le propage à ses enfants. Le résultat : votre serveur de jeu, votre script de sauvegarde ou votre mise à jour s'interrompent brutalement.

tmux interpose un serveur de sessions entre votre shell SSH et vos processus. Les processus s'exécutent à l'intérieur d'une session tmux gérée par un daemon ; votre terminal SSH n'est qu'un client qui s'y connecte. Quand vous vous déconnectez, la session reste active sur le serveur et vous pouvez vous y rattacher depuis n'importe quel terminal, depuis n'importe quelle adresse IP.

Ce comportement est fondamental pour administrer et héberger un serveur VPS Linux de façon fiable : les opérations longues (mise à jour du système, compilation, restauration d'une sauvegarde, backup d'une base de données) peuvent tourner en arrière-plan sans dépendre de la stabilité de votre connexion Internet locale.

Installer tmux sur votre VPS Linux

tmux est disponible dans les dépôts officiels de toutes les distributions courantes. Son installation ne nécessite aucune dépendance externe et n'impacte pas les performances CPU ni l'utilisation du SSD.

Ubuntu / Debian :

sudo apt update && sudo apt install -y tmux

Rocky Linux / AlmaLinux / CentOS Stream :

sudo dnf install -y tmux

Fedora :

sudo dnf install -y tmux

Vérifiez la version installée en ligne de commande :

tmux -V

Vous devriez obtenir une sortie du type tmux 3.3a. La version 3.x apporte la persistance améliorée des panneaux et les raccourcis clavier étendus. Pour redémarrer (restart) le daemon tmux, un simple tmux kill-server suivi d'une nouvelle session suffit.

Créer votre première session persistante

Pour créer une session nommée (recommandé pour l'administration d'un serveur FiveM ou d'un serveur Minecraft) :

tmux new-session -s fivem

Vous entrez immédiatement dans la session. La barre verte en bas de l'écran indique que vous êtes dans un terminal tmux. Vous pouvez maintenant lancer votre serveur de jeu, exécuter vos scripts ou lancer des sauvegardes longues sans craindre une interruption.

Pour créer une session en arrière-plan sans y entrer immédiatement :

tmux new-session -d -s minecraft

Cette commande est particulièrement utile dans les scripts de démarrage automatique ou dans les configurations systemd de votre hébergeur VPS.

Se détacher et se rattacher à une session

Une fois dans une session tmux, le raccourci clavier fondamental est Ctrl+b, qui active le préfixe de commande. Pour vous détacher de la session sans l'arrêter :

Ctrl+b  d

(Appuyez d'abord sur Ctrl+b, relâchez, puis appuyez sur d.) Votre session reste active sur le serveur ; vous pouvez fermer le terminal SSH en toute sécurité.

Pour lister les sessions actives depuis n'importe quelle connexion SSH :

tmux list-sessions

Pour vous rattacher à une session nommée :

tmux attach-session -t fivem

Ou, en version courte :

tmux a -t fivem

Si vous n'avez qu'une seule session active :

tmux attach

Gérer les fenêtres et les panneaux

À l'intérieur d'une session tmux, vous pouvez ouvrir plusieurs fenêtres (onglets) et découper chaque fenêtre en panneaux (panes). C'est particulièrement utile quand vous administrez plusieurs services sur votre serveur dédié : un panneau pour le serveur de jeu, un panneau pour Nginx en reverse proxy, un panneau pour surveiller la RAM et la charge CPU en temps réel.

Raccourcis essentiels :

• Ctrl+b c : créer une nouvelle fenêtre
• Ctrl+b n : passer à la fenêtre suivante
• Ctrl+b p : revenir à la fenêtre précédente
• Ctrl+b & : fermer la fenêtre courante (confirmation requise)
• Ctrl+b % : diviser le panneau verticalement
• Ctrl+b " : diviser le panneau horizontalement
• Ctrl+b o : passer au panneau suivant
• Ctrl+b x : fermer le panneau courant

Exemple concret : fenêtre 0 pour votre serveur FiveM, fenêtre 1 pour surveiller les logs avec journalctl -f, fenêtre 2 pour des opérations ponctuelles d'administration du serveur VPS.

Commandes essentielles pour l'administration quotidienne

Voici les commandes tmux les plus utiles pour administrer un serveur VPS Linux au quotidien en ligne de commande :

# Lister toutes les sessions actives
tmux list-sessions

# Renommer une session existante
tmux rename-session -t ancien-nom nouveau-nom

# Tuer une session spécifique
tmux kill-session -t nom-session

# Tuer toutes les sessions tmux et redémarrer (restart)
tmux kill-server

# Envoyer une commande à une session sans y entrer
tmux send-keys -t fivem "systemctl status fivem" Enter

# Afficher le contenu du scrollback (utile pour lire les logs et sauvegarder les sorties)
tmux show-buffer

Ces commandes peuvent être intégrées dans vos scripts de monitoring ou vos procédures d'administration. Par exemple, pour redémarrer un service et envoyer la commande à la session tmux sans connexion interactive, utile sur un hébergeur VPS avec accès shell limité.

Démarrer automatiquement une session au reboot

Pour relancer automatiquement votre serveur de jeu après un redémarrage (restart) du VPS, créez un service systemd. C'est la méthode recommandée pour l'hébergement en production : systemd gère les dépendances réseau, les redémarrages automatiques et la journalisation des logs.

Créez le fichier /etc/systemd/system/fivem.service :

[Unit]
Description=Serveur FiveM
After=network.target

[Service]
Type=forking
User=gameserver
WorkingDirectory=/opt/fivem
ExecStart=/usr/bin/tmux new-session -d -s fivem /opt/fivem/run.sh
ExecStop=/usr/bin/tmux kill-session -t fivem
Restart=on-failure

[Install]
WantedBy=multi-user.target

Puis activez et démarrez le service :

sudo systemctl daemon-reload
sudo systemctl enable fivem
sudo systemctl start fivem

Après un redémarrage, vérifiez que la session est bien active :

tmux list-sessions

Pour consulter les logs du service, utilisez journalctl -u fivem -f. Cela vous permet de monitorer la charge CPU, les erreurs et les redémarrages de votre serveur de jeu depuis une seule ligne de commande.

Personnaliser tmux avec un fichier de configuration

tmux lit son fichier de configuration dans ~/.tmux.conf au démarrage. Voici une configuration minimale adaptée à l'administration d'un serveur VPS Linux :

# Augmenter le scrollback buffer (utile pour lire les logs et les backups)
set -g history-limit 10000

# Numérotation des fenêtres à partir de 1
set -g base-index 1

# Activer la souris pour redimensionner les panneaux
set -g mouse on

# Barre de statut avec le nom de l'hôte et l'heure
set -g status-right "#H | %d/%m %H:%M"

# Rechargement de la configuration sans quitter tmux
bind r source-file ~/.tmux.conf \; display-message "Config rechargée"

Rechargez la configuration sans quitter tmux :

tmux source-file ~/.tmux.conf

Vous pouvez versionner ce fichier avec Git pour synchroniser vos configurations entre plusieurs serveurs VPS ou serveurs dédiés gérés par votre équipe d'administration.

Bonnes pratiques de sécurité et d'organisation

Quelques règles à respecter pour administrer vos sessions tmux de façon sécurisée sur votre hébergement VPS :

• Nommez vos sessions explicitement : préférez fivem-prod ou minecraft-vanilla à des noms génériques comme session-1. Un nommage clair facilite l'administration quotidienne et les sauvegardes.
• N'exécutez pas tmux en root : créez un utilisateur dédié (admin non-privilégié) pour vos services de jeu sur votre VPS Linux. Une session root laissée ouverte représente un risque en cas de compromission.
• Fermez les sessions inutilisées : chaque session consomme de la RAM sur votre VPS. Tuez les sessions dormantes avec tmux kill-session -t nom pour libérer des ressources.
• Sécurisez votre accès SSH : tmux est complémentaire d'une bonne sécurité SSH. Consultez notre guide sur la limitation des tentatives de connexion SSH et notre guide Fail2ban pour les VPS Linux.
• Configurez un pare-feu : combiné à tmux, un firewall (UFW ou nftables) garantit que votre serveur de jeu n'est accessible que sur les ports souhaités. Voir notre guide pour ouvrir les ports d'un serveur de jeu avec UFW.

Dépannage courant

Session introuvable après reconnexion : Vérifiez d'abord que vous êtes connecté avec le même utilisateur. tmux list-sessions affiche uniquement les sessions de l'utilisateur courant. Si vous vous attendiez à retrouver une session admin, connectez-vous avec le bon compte ou utilisez sudo tmux list-sessions pour lister les sessions root.

Le terminal affiche des caractères illisibles : Le problème vient souvent d'une variable TERM incompatible. Forcer 256 couleurs au démarrage :

tmux -2 new-session -s fivem

tmux: no server running on /tmp/tmux-... : Le daemon tmux a été tué (restart du VPS ou kill involontaire). Vos sessions ne sont pas récupérables dans ce cas. Avec systemd, configurez le restart automatique comme décrit ci-dessus pour éviter cette situation et sécuriser votre hébergement.

Pour les problèmes réseau sur votre serveur de jeu hébergé sur VPS, consultez notre guide VPS inaccessible : diagnostic réseau en 30 secondes.