Mettre en place une whitelist sur un serveur Minecraft

Une whitelist Minecraft, aussi appelée liste blanche, limite l’accès à un serveur aux joueurs que vous avez autorisés. C’est un réglage simple pour un serveur privé entre amis, une communauté en lancement ou une phase de test. Ce guide explique comment l’activer, ajouter et retirer des joueurs, puis vérifier que le filtrage fonctionne sans confondre whitelist, opérateur, bannissement et réglage réseau.

Avant de commencer

Vous devez pouvoir administrer les fichiers du serveur ou utiliser sa console. Faites une sauvegarde du fichier de configuration avant toute modification et notez le nom exact des joueurs à autoriser. Sur Minecraft Java Edition, le nom utilisé par la liste blanche doit correspondre à l’identifiant du compte du joueur. Une faute de frappe ou un changement de pseudonyme peut donc empêcher une connexion légitime.

La whitelist filtre les joueurs après leur tentative de connexion. Elle ne corrige pas une adresse IP incorrecte, un nom de domaine mal configuré, un port fermé ou un serveur arrêté. Avant d’inviter votre communauté, vérifiez donc que le serveur répond depuis un autre réseau et que l’adresse communiquée pointe vers la bonne machine.

La whitelist ne remplace pas la sécurité générale. Utilisez un mot de passe RCON robuste si RCON est activé, limitez les accès d’administration et gardez le serveur à jour. Pour choisir une machine adaptée à votre projet, consultez notre guide sur l’hébergement d’un serveur Minecraft.

Choisir l’environnement du serveur

Un serveur Minecraft peut être installé sur un ordinateur personnel, un VPS ou un serveur dédié. Sur un VPS Linux, l’administration se fait souvent à distance avec SSH et un compte root ou un compte sudo. Sur Ubuntu ou Debian, gardez le système et les paquets à jour avant d’exposer le serveur sur Internet. Le CPU, la RAM, le stockage SSD et la bande passante disponibles influencent la fluidité lorsque plusieurs joueurs explorent le monde ou chargent des zones.

Le pare-feu doit autoriser le port de jeu prévu, sans ouvrir inutilement les ports d’administration. Une connexion distante sécurisée, une clé SSH et des comptes séparés réduisent le risque d’erreur. La whitelist concerne les connexions Minecraft, tandis que le firewall protège les services de la machine. Pour les autres réglages de protection, consultez les premiers réglages de sécurité d’un serveur dédié.

Si vous passez par un hébergeur, demandez où sont conservés les fichiers, les logs et les backups. Un panneau de contrôle peut simplifier l’installation, la mise à jour et l’accès à la console, mais l’administrateur doit toujours savoir quelle instance est active. Vérifiez l’espace disque disponible, la date du dernier backup et la possibilité de récupérer la configuration sans dépendre d’un seul poste.

Le choix entre serveur physique, serveur VPS et serveur cloud dépend du nombre de joueurs, du budget et de la flexibilité recherchée. La virtualisation permet d’isoler plusieurs serveurs sur une même infrastructure, mais chaque instance doit garder ses propres fichiers, ports et sauvegardes. Si vous faites tourner plusieurs serveurs Minecraft, attribuez à chacun une configuration claire et testez les accès séparément.

Configurer la maintenance et l’administration

Pour gérer un serveur virtuel, documentez les configurations qui touchent au jeu, au réseau et aux sauvegardes. Notez le chemin du monde, les scripts de démarrage, le processeur et la mémoire réservée à Java. Cette fiche facilite la reprise lorsque la machine virtuelle redémarre ou lorsqu’un administrateur doit intervenir à distance.

Planifiez les mises à jour pendant une période calme, contrôlez l’espace de stockage et conservez plusieurs backups. Une sauvegarde haute disponibilité ne dispense pas d’un test de restauration. Si le serveur change de machine, comparez l’adresse IP, le DNS, les ports et les fichiers de whitelist avant de rouvrir les connexions des joueurs.

Activer la whitelist dans la configuration

Arrêtez le serveur proprement avant de modifier sa configuration. Dans le fichier server.properties, recherchez la propriété white-list. Réglez-la sur true, enregistrez le fichier, puis redémarrez le serveur. La valeur doit être écrite sans espace inutile et avec la syntaxe attendue par le fichier.

Après le redémarrage, contrôlez la console et essayez une connexion avec un compte autorisé puis avec un compte absent de la liste. Ne testez pas uniquement depuis la console d’administration : un opérateur peut disposer de droits particuliers et donner une impression trompeuse du résultat.

Si vous utilisez un panel de contrôle, la même opération peut apparaître sous la forme d’une case « Whitelist ». Le panel ne doit pas être considéré comme une preuve suffisante : vérifiez toujours la configuration réellement chargée par le serveur et le journal de démarrage.

Ajouter un joueur autorisé

La console du serveur accepte généralement la commande whitelist add NomDuJoueur. Remplacez NomDuJoueur par le nom exact du compte, sans ajouter de commentaire. Vous pouvez ensuite contrôler la liste avec whitelist list. Si votre interface propose un bouton dédié, utilisez-le seulement après avoir confirmé que la commande correspondante a bien été exécutée.

Ajoutez les joueurs un par un lorsque vous préparez une ouverture. Cette méthode réduit les erreurs et facilite le diagnostic. Envoyez au joueur les informations de connexion par un canal approprié, sans publier l’adresse IP du serveur dans un espace ouvert si votre objectif est de garder une communauté privée.

Une whitelist concerne l’accès au serveur de jeu. Elle ne donne pas automatiquement les permissions d’opérateur. Conservez les droits élevés pour les administrateurs identifiés et expliquez à chaque membre de l’équipe la différence entre autorisation de connexion et permission de commande.

Retirer un joueur et vérifier les accès

Pour retirer une autorisation, utilisez whitelist remove NomDuJoueur, puis vérifiez le résultat avec whitelist list. Le retrait de la whitelist n’est pas un bannissement. Si un joueur est déjà connecté, contrôlez son état après la modification et appliquez la mesure adaptée à votre politique d’administration.

Conservez une trace des changements importants : date, administrateur, raison et résultat du test. Une petite procédure écrite évite de réautoriser par erreur un ancien compte et aide à résoudre rapidement les demandes d’accès. Pour les sauvegardes, consultez notre guide des sauvegardes d’un serveur dédié.

Dépannage des problèmes courants

Si un joueur autorisé ne peut pas entrer, vérifiez d’abord l’orthographe exacte de son nom, la version du jeu, l’adresse utilisée et le journal du serveur. Confirmez également que la whitelist est activée sur le serveur auquel le joueur se connecte, et non sur une copie locale ou un autre environnement.

Si le serveur est visible mais que la connexion expire, contrôlez l’adresse IP, le nom de domaine, le port configuré et le pare-feu de la machine. Un serveur Minecraft installé sur un VPS ou un serveur dédié doit accepter le trafic nécessaire sur son interface réseau. Le DNS peut aussi conserver une ancienne adresse pendant un certain temps après une modification. Ces contrôles relèvent de l’accès réseau, pas de la liste blanche.

Si un joueur non autorisé parvient à se connecter, contrôlez la valeur active après redémarrage, la liste chargée et l’éventuel proxy placé devant le serveur. Un proxy ou une architecture multi-serveurs peut demander une configuration séparée sur chaque instance. Ne donnez pas les droits opérateur pour contourner un problème de whitelist : l’opérateur dispose de privilèges d’administration et ce n’est pas une solution de filtrage.

Enfin, sauvegardez régulièrement les fichiers de configuration et testez leur restauration. Notre guide sur les sauvegardes Pterodactyl détaille une méthode de contrôle des sauvegardes et de restauration. Pour comparer les ressources nécessaires, consultez aussi VPS et serveur dédié ainsi que nos solutions d’hébergement Minecraft.

Checklist avant ouverture

• la whitelist est activée dans la configuration chargée ;
• les noms des joueurs autorisés ont été vérifiés individuellement ;
• un test positif et un test négatif ont été réalisés ;
• l’adresse IP, le DNS, le port et le pare-feu ont été contrôlés ;
• les accès SSH et les comptes d’administration sont protégés séparément ;
• le CPU, la RAM, le stockage SSD et la bande passante sont adaptés ;
• la configuration et les données du serveur sont sauvegardées ;
• la procédure d’ajout et de retrait est connue des administrateurs.