Comment configurer la whitelist (liste blanche) et les bans sur Valheim ?
Dans ce guide, nous expliquons pas à pas comment configurer la liste blanche (whitelist / permittedlist.txt) et la liste des bannis (ban / bannedlist.txt) d'un serveur dédié (dedicated) Valheim. Ces fichiers et les commandes d'administration (admin) en jeu vous permettent de limiter les personnes autorisées à rejoindre le serveur, d'expulser les joueurs indésirables et de les bloquer définitivement. Si vous n'avez pas encore installé le serveur, suivez d'abord le guide Comment installer un serveur Valheim ? SteamCMD sur un VDS Windows et Linux ; nous ne reprenons pas ici les étapes d'installation. Pour louer un serveur, consultez la page Location de serveur Valheim ; pour les autres sujets, la rubrique Guides Valheim.
Trois listes d'accès : admin, permitted et banned
Le serveur dédié Valheim gère l'accès des joueurs avec trois fichiers texte brut. Dans chaque fichier, on écrit un identifiant (ID) de joueur par ligne :
| Fichier | Rôle | Comportement lorsqu'il est vide |
|---|---|---|
adminlist.txt | Joueurs administrateurs (admin) ; ils peuvent utiliser les commandes ban et kick. | Aucun administrateur. |
permittedlist.txt | Liste blanche. Si elle est remplie, seuls les joueurs de la liste peuvent entrer. | Tout le monde peut entrer. |
bannedlist.txt | Liste des bannis. Les joueurs de la liste ne peuvent pas se connecter au serveur. | Aucun joueur banni. |
Ce guide se concentre sur la liste blanche et la liste des bannis. Pour la désignation des administrateurs et l'ensemble des commandes de la console en jeu, consultez le guide Devenir administrateur (admin) sur Valheim : guide des commandes console.
Il ne faut pas confondre la liste blanche et la liste des bannis avec le pare-feu (firewall) du système d'exploitation. Le pare-feu contrôle les ports réseau et se gère depuis le système d'exploitation ; ces listes, elles, déterminent uniquement qui peut rejoindre la partie.
Mot de passe, liste blanche et visibilité publique : quoi utiliser et quand ?
Vous pouvez contrôler l'accès à votre serveur Valheim de trois façons différentes, qui se complètent :
- Mot de passe (
-password) : toute personne qui connaît le mot de passe peut entrer. C'est la méthode la plus pratique pour un petit groupe de confiance. - Liste blanche (
permittedlist.txt) : seuls les joueurs dont l'identifiant (ID) figure dans la liste peuvent entrer. Elle convient aux communautés réservées à des personnes bien précises, où vous ne voulez pas partager de mot de passe. - Visibilité publique (
-public 0/-public 1) :-public 0masque le serveur dans la liste communautaire, et les joueurs se connectent uniquement par IP. Cela ne bloque pas l'accès à lui seul ; le serveur est seulement caché dans la liste.
La configuration la plus stricte consiste à utiliser ensemble le mot de passe et la liste blanche : le joueur doit à la fois avoir le bon identifiant et connaître le mot de passe. La liste des bannis (bannedlist.txt), elle, fonctionne indépendamment de ces trois méthodes et tient certains joueurs à l'écart en toutes circonstances.
Où se trouvent les fichiers de liste ?
Les trois fichiers se trouvent dans le dossier de sauvegarde (save) du serveur, et non dans le dossier d'installation. Les emplacements par défaut sont les suivants :
- Windows :
%USERPROFILE%\AppData\LocalLow\IronGate\Valheim\ - Linux :
~/.config/unity3d/IronGate/Valheim/
Si vous utilisez le paramètre -savedir dans le script de démarrage du serveur, les fichiers sont déplacés dans le dossier indiqué ; par exemple, avec -savedir ./save, les fichiers de liste se trouvent sous ./save/ et les sauvegardes du monde dans ./save/worlds_local/. Si vous faites tourner plusieurs serveurs, veillez à ce que chacun utilise son propre dossier -savedir, et donc ses propres listes.
Les fichiers sont créés automatiquement au premier démarrage du serveur et contiennent des lignes d'explication commençant par //. Ces lignes sont des commentaires et ne comptent pas comme des identifiants ; inutile de les supprimer.
Prérequis
- Un serveur dédié Valheim installé et démarré au moins une fois (pour que les fichiers soient créés).
- Un accès aux fichiers du serveur : RDP sur un VDS Windows, SSH sur un VDS Linux. Si votre accès ne fonctionne plus, vous pouvez vous connecter au serveur avec la console VNC (console web) de l'Espace client.
- Les valeurs SteamID64 des joueurs à ajouter à la liste (numéro à 17 chiffres).
- La possibilité de redémarrer le serveur pour appliquer les modifications.
Comment trouver le SteamID64 ?
Dans les fichiers de liste, vous écrivez la valeur SteamID64 du joueur. Vous pouvez l'obtenir de plusieurs façons :
- Depuis le journal du serveur (log) : lorsqu'un joueur se connecte, son identifiant apparaît dans la console du serveur ou dans le fichier journal. C'est le moyen le plus simple d'obtenir l'ID d'un joueur connecté à ce moment-là.
- Avec des outils externes : en saisissant le lien du profil Steam du joueur sur un site comme https://steamid.io, vous pouvez trouver sa valeur SteamID64 (steamID64).
- Depuis le profil Steam : si l'adresse du profil est au format numérique (
/profiles/7656...), le numéro à 17 chiffres à la fin est directement le SteamID64.
Par exemple, lorsqu'un joueur se connecte au serveur, son identifiant apparaît dans le journal du serveur avec les informations de connexion ; vous pouvez copier ce numéro et l'ajouter au fichier de liste concerné. Veillez à ne pas faire de faute de frappe en notant les identifiants : un seul chiffre erroné vous fait inscrire le mauvais joueur.
Si le crossplay (multiplateforme) est activé, l'identifiant des joueurs venant de réseaux autres que Steam (par exemple PlayFab) peut apparaître sous un format différent. Dans ce cas, copiez l'identifiant exactement tel qu'il apparaît dans le journal du serveur et écrivez-le dans le fichier. Pour configurer le crossplay, vous pouvez consulter le guide Configurer un serveur Valheim en crossplay (Steam et Xbox).
Créer la liste blanche (permittedlist.txt)
La liste blanche sert à rendre votre serveur entièrement privé (private). Dès que vous ajoutez au moins un identifiant au fichier permittedlist.txt, le serveur n'accepte que les joueurs de la liste ; personne d'autre ne peut se connecter. Tant que le fichier est vide (seulement des lignes de commentaire //), tout le monde peut entrer.
Point important : lorsque vous activez la liste blanche, vous devez ajouter à ce fichier l'ID de tous les joueurs que vous voulez laisser entrer, administrateurs et vous-même compris. Figurer uniquement dans adminlist.txt ne suffit pas pour entrer lorsque la liste blanche est active.
Pas à pas : un serveur privé avec liste blanche
- Démarrez le serveur au moins une fois pour que les fichiers de liste soient créés.
- Rassemblez les valeurs SteamID64 de tous les joueurs que vous autoriserez à entrer (vous-même et les administrateurs compris).
- Ouvrez le fichier
permittedlist.txtdans le dossier de sauvegarde. - Écrivez chaque identifiant sur une ligne distincte ; inutile de toucher aux lignes de commentaire commençant par
//. - Enregistrez le fichier.
- Si vous le souhaitez, ajoutez
-passwordau script de démarrage pour mettre en place une deuxième couche de protection. - Arrêtez le processus du serveur, puis redémarrez-le. Désormais, seuls les joueurs de la liste peuvent se connecter.
Sous Windows
Allez dans le dossier de sauvegarde, ouvrez le fichier permittedlist.txt avec « Notepad » (Bloc-notes) et écrivez un SteamID64 par ligne :
// permittedlist - un ID par ligne
76561198000000001
76561198000000002
76561198000000003
Enregistrez le fichier et redémarrez le serveur. Désormais, seuls ces trois joueurs peuvent se connecter.
Sous Linux
Ouvrez le même fichier avec un éditeur comme nano :
nano ~/.config/unity3d/IronGate/Valheim/permittedlist.txt
Ajoutez les identifiants à raison d'un par ligne, enregistrez (Ctrl+O, puis Ctrl+X) et redémarrez le serveur. Si vous utilisez -savedir, corrigez le chemin du fichier en conséquence.
Configurer la liste des bannis (bannedlist.txt)
Il existe deux façons de bloquer les joueurs indésirables : modifier le fichier à la main ou utiliser les commandes d'administration en jeu.
Modifier le fichier à la main
Ouvrez le fichier bannedlist.txt, écrivez les valeurs SteamID64 des joueurs à bannir, une par ligne, enregistrez et redémarrez le serveur :
// bannedlist - un ID par ligne
76561198000000009
76561198000000010
Bannir avec les commandes en jeu
Pour bannir instantanément en jeu, vous devez être administrateur. Après avoir ajouté votre SteamID64 à adminlist.txt et redémarré le serveur, ouvrez la console en jeu avec F5 et utilisez les commandes suivantes :
| Commande | Description |
|---|---|
banned | Affiche la liste des joueurs bannis. |
ban [nom/ID] | Bannit définitivement le joueur et l'ajoute à bannedlist.txt. |
unban [ID] | Lève le bannissement du joueur. |
kick [nom/ID] | Expulse le joueur du serveur (temporaire ; le joueur peut se reconnecter). |
Exemples de commandes :
ban 76561198000000009
kick NomDuJoueur
unban 76561198000000009
banned
La commande ban en jeu agit immédiatement et de façon permanente ; kick, en revanche, n'expulse le joueur que sur le moment, et il peut revenir. Pour un blocage permanent, utilisez ban. Pour l'ensemble des commandes d'administration et la désignation des administrateurs, consultez le guide Devenir administrateur (admin) sur Valheim : guide des commandes console.
Bannir par IP
La commande ban en jeu accepte le nom du joueur, son adresse IP ou son identifiant utilisateur (userID). Bannir par IP peut être utile pour bloquer quelqu'un qui change souvent d'identifiant ; mais comme l'IP de la plupart des connexions domestiques peut changer avec le temps, le bannissement par SteamID64 est plus fiable comme solution permanente. Lors d'une modification manuelle, écrire l'identifiant dans le fichier bannedlist.txt est la méthode la plus solide.
Garder les listes à jour
Avec le temps, la liste blanche et la liste des bannis peuvent s'allonger. Relisez les fichiers de temps en temps : vous pouvez retirer de la liste blanche les personnes qui ne jouent plus sur le serveur, et supprimer de la liste des bannis un joueur ajouté par erreur ou que vous avez pardonné. Après chaque modification, n'oubliez pas d'enregistrer le fichier et de redémarrer le serveur. Au lieu de supprimer complètement une ligne, vous pouvez aussi la désactiver temporairement en ajoutant // au début ; vous pouvez ainsi ouvrir et fermer l'accès sans perdre l'identifiant.
Exemple : mot de passe et liste blanche ensemble
La liste blanche est indépendante du mot de passe du serveur ; vous pouvez utiliser les deux ensemble. Vous définissez le mot de passe dans le script de démarrage et limitez l'accès avec permittedlist.txt. Dans l'exemple ci-dessous, le serveur n'apparaît pas dans la liste communautaire (-public 0) et demande un mot de passe :
valheim_server -nographics -batchmode -name "Mon serveur HanHosting" -port 2456 -world "MonMonde" -password "fort5motdepasse" -public 0
Si, en plus, permittedlist.txt est rempli, seuls les joueurs qui connaissent le mot de passe et figurent dans la liste blanche peuvent entrer. Pour le détail des réglages du nom du serveur, du monde et du mot de passe, consultez le guide Réglages d'un serveur Valheim et définition d'un mot de passe (password).
Appliquer les modifications et panneau HanHosting
Pour que les modifications des fichiers de liste soient appliquées de façon sûre, arrêtez puis redémarrez le processus du serveur Valheim. Les commandes en jeu ban, kick et unban, elles, agissent immédiatement. Si nécessaire, vous pouvez redémarrer l'ensemble du serveur avec les actions d'alimentation (« Démarrer » / « Arrêter » / « Redémarrer ») de l'Espace client ; si votre accès RDP ou SSH ne fonctionne plus, vous pouvez accéder à l'écran du serveur avec la console VNC (console web) du panneau.
Un point à surveiller : les VDS n'incluent pas de sauvegarde automatique ; les sauvegardes relèvent de votre responsabilité. Sauvegardez régulièrement, avec votre monde, les fichiers permittedlist.txt, bannedlist.txt et adminlist.txt. Pour la sauvegarde et le transfert des saves, vous pouvez consulter le guide Sauvegarder et transférer les fichiers de sauvegarde (save) de Valheim. Pour les problèmes de connexion sans rapport avec les listes, consultez le guide Ouvrir les ports d'un serveur Valheim (2456-2458 UDP) et corriger l'erreur Disconnected.
Erreurs fréquentes
- La liste blanche est active, mais les administrateurs ne peuvent pas entrer : lorsque
permittedlist.txtest rempli, seuls les joueurs de la liste peuvent entrer. Vérifiez que les administrateurs et votre propre ID figurent aussi dans le fichier. - Écrire un nom dans le fichier et s'attendre à un bannissement :
bannedlist.txtetpermittedlist.txtfonctionnent avec des identifiants (SteamID64). Le bannissement par nom ne se fait qu'avec la commandebanen jeu, pendant que le joueur est connecté. - Mauvais format d'identifiant : écrivez le SteamID64 à 17 chiffres, et non un SteamID2 ou un SteamID3.
- La modification ne prend pas effet : vous avez peut-être oublié de redémarrer le serveur après avoir modifié le fichier.
- Modifier le mauvais dossier : si vous utilisez
-savedir, modifiez les fichiers de ce dossier, et non ceux du dossier d'installation. - Impossible de bannir un joueur crossplay : l'identifiant d'un joueur crossplay peut avoir un format différent ; utilisez exactement l'identifiant qui figure dans le journal du serveur.
Questions fréquentes
Puis-je utiliser la liste blanche et le mot de passe ensemble ?
Oui. permittedlist.txt limite l'accès par identifiant, tandis que le mot de passe est défini avec -password dans le script de démarrage. Les deux fonctionnent ensemble.
Le bannissement est-il permanent ?
Oui ; le joueur ne peut pas se connecter tant que vous n'avez pas utilisé la commande unban ou supprimé son ID de bannedlist.txt puis redémarré le serveur.
Quelle est la différence entre kick et ban ?
kick expulse le joueur sur le moment, et il peut se reconnecter. ban, lui, impose un blocage permanent et inscrit le joueur dans bannedlist.txt.
Dois-je redémarrer le serveur pour qu'une modification soit prise en compte ?
Lorsque vous modifiez les fichiers à la main, redémarrer le serveur est le moyen le plus sûr de garantir l'application de la modification. Les commandes en jeu ban, kick et unban, elles, agissent immédiatement.
Où trouver le SteamID64 ?
Le plus simple est de relever l'identifiant qui apparaît dans le journal du serveur lorsque le joueur se connecte. Vous pouvez aussi saisir le lien du profil Steam du joueur dans un outil comme https://steamid.io.
Que faire si je veux désactiver la liste blanche ?
Supprimez toutes les lignes d'identifiants de permittedlist.txt (ne laissez que les lignes de commentaire //) et redémarrez le serveur ; le serveur redevient alors ouvert à tous.
Combien de joueurs puis-je ajouter ?
En pratique, vous ne rencontrerez pas de limite au nombre de lignes de la liste blanche et de la liste des bannis ; il suffit d'ajouter une ligne par joueur. L'important est que chaque ligne contienne un seul SteamID64, au bon format.
Un administrateur est-il automatiquement considéré comme inscrit dans la liste blanche ?
Non. Lorsque la liste blanche est active, les administrateurs doivent eux aussi figurer dans permittedlist.txt ; être inscrit uniquement dans adminlist.txt ne donne pas le droit d'entrer.
Quel VDS choisir ?
Pour un serveur Valheim, une quantité de RAM suffisante et de bonnes performances mono-cœur sont importantes. Pour les familles proposées et la location, consultez la page Location de serveur Valheim ; si vous êtes bloqué, vous pouvez ouvrir un ticket d'assistance depuis l'Espace client.
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.