Whitelist und Bannliste auf dem Valheim-Server einrichten
In dieser Anleitung erklären wir Schritt für Schritt, wie Sie auf einem Valheim Dedicated Server die Whitelist (permittedlist.txt) und die Bannliste (bannedlist.txt) einrichten. Mit diesen Dateien und den Admin-Befehlen im Spiel legen Sie fest, wer den Server betreten darf, werfen unerwünschte Spieler hinaus und sperren sie dauerhaft. Falls Sie den Server noch nicht eingerichtet haben, folgen Sie zuerst der Anleitung Valheim-Server mit SteamCMD auf einem VDS einrichten; die Installationsschritte wiederholen wir hier nicht. Zur Miete eines Servers finden Sie Informationen auf der Seite Valheim-Server mieten, weitere Themen im Bereich Valheim-Anleitungen.
Drei Zugriffslisten: admin, permitted und banned
Der Valheim Dedicated Server verwaltet den Spielerzugriff über drei einfache Textdateien. In jeder Datei steht pro Zeile eine Spielerkennung (ID):
| Datei | Aufgabe | Verhalten, wenn leer |
|---|---|---|
adminlist.txt | Spieler mit Adminrechten; sie können die Befehle ban und kick verwenden. | Es gibt keine Admins. |
permittedlist.txt | Whitelist. Ist sie gefüllt, können nur die aufgeführten Spieler beitreten. | Jeder kann beitreten. |
bannedlist.txt | Bannliste. Die aufgeführten Spieler können sich nicht mit dem Server verbinden. | Es gibt keine gesperrten Spieler. |
Diese Anleitung konzentriert sich auf Whitelist und Bannliste. Wie Sie Admins festlegen und welche Konsolenbefehle es im Spiel gibt, erfahren Sie in der Anleitung Admin werden in Valheim und Konsolenbefehle.
Whitelist und Bannliste sollten nicht mit der Firewall des Betriebssystems verwechselt werden. Die Firewall kontrolliert Netzwerkports und wird innerhalb des Betriebssystems verwaltet; diese Listen bestimmen dagegen nur, wer dem Spiel beitreten darf.
Passwort, Whitelist oder öffentliche Sichtbarkeit: Was eignet sich wann?
Den Zugriff auf Ihren Valheim-Server können Sie auf drei Arten steuern, die sich gegenseitig ergänzen:
- Passwort (
-password): Jeder, der das Passwort kennt, kann beitreten. Für eine kleine Gruppe, der Sie vertrauen, ist das die praktischste Methode. - Whitelist (
permittedlist.txt): Nur Spieler, deren ID auf der Liste steht, können beitreten. Geeignet für Communitys, in denen Sie kein Passwort weitergeben möchten und genau festgelegte Personen spielen sollen. - Öffentliche Sichtbarkeit (
-public 0/-public 1):-public 0blendet den Server in der Community-Liste aus, und Spieler verbinden sich nur über die IP. Das allein verhindert den Zugriff nicht; es verbirgt den Server lediglich in der Liste.
Die strengste Konfiguration ist die Kombination aus Passwort und Whitelist: Der Spieler muss sowohl die richtige ID haben als auch das Passwort kennen. Die Bannliste (bannedlist.txt) wirkt unabhängig von diesen drei Methoden und hält bestimmte Spieler in jedem Fall fern.
Wo liegen die Listendateien?
Alle drei Dateien liegen im Speicherverzeichnis (Save) des Servers, nicht im Installationsordner. Die Standardorte lauten:
- Windows:
%USERPROFILE%\AppData\LocalLow\IronGate\Valheim\ - Linux:
~/.config/unity3d/IronGate/Valheim/
Wenn Sie im Startskript des Servers den Parameter -savedir verwenden, liegen die Dateien in dem angegebenen Verzeichnis; haben Sie zum Beispiel -savedir ./save angegeben, liegen die Listendateien unter ./save/ und die Weltdaten in ./save/worlds_local/. Wenn Sie mehrere Server betreiben, beachten Sie, dass jeder sein eigenes -savedir-Verzeichnis und damit seine eigenen Listen verwendet.
Die Dateien werden beim ersten Start des Servers automatisch angelegt und enthalten Erläuterungszeilen, die mit // beginnen. Diese Zeilen sind Kommentare und zählen nicht als ID; Sie müssen sie nicht löschen.
Voraussetzungen
- Ein installierter und mindestens einmal gestarteter Valheim Dedicated Server (damit die Dateien angelegt werden).
- Zugriff auf die Serverdateien: per RDP beim Windows-VDS, per SSH beim Linux-VDS. Ist Ihr Zugang gestört, können Sie sich über die VNC (Webkonsole) im Kundenbereich mit dem Server verbinden.
- Die SteamID64-Werte der Spieler, die Sie in die Liste aufnehmen (17-stellige Nummer).
- Die Möglichkeit, den Server neu zu starten, um Änderungen zu übernehmen.
Wie finden Sie die SteamID64?
In die Listendateien tragen Sie die SteamID64 des Spielers ein. Sie können sie auf mehreren Wegen ermitteln:
- Aus dem Serverlog: Wenn sich ein Spieler verbindet, erscheint seine ID in der Serverkonsole oder in der Logdatei. Das ist der einfachste Weg, die ID eines gerade verbundenen Spielers zu erhalten.
- Mit externen Werkzeugen: Geben Sie den Link zum Steam-Profil des Spielers auf einer Website wie https://steamid.io ein, um den Wert SteamID64 (steamID64) zu ermitteln.
- Aus dem Steam-Profil: Hat die Profiladresse die numerische Form (
/profiles/7656...), ist die 17-stellige Nummer am Ende direkt die SteamID64.
Verbindet sich zum Beispiel ein Spieler mit dem Server, erscheint im Serverlog zusammen mit den Verbindungsdaten die ID des Spielers; diese Nummer können Sie kopieren und in die betreffende Listendatei einfügen. Achten Sie beim Notieren der IDs auf Tippfehler; eine einzige falsche Ziffer führt dazu, dass Sie den falschen Spieler eintragen.
Ist Crossplay aktiviert, kann die ID von Spielern aus Netzwerken außerhalb von Steam (zum Beispiel PlayFab) in einem anderen Format erscheinen. Kopieren Sie in diesem Fall die ID genau so, wie sie im Serverlog steht, in die Datei. Zur Einrichtung von Crossplay lesen Sie die Anleitung Valheim-Crossplay-Server einrichten.
Whitelist (permittedlist.txt) anlegen
Die Whitelist dient dazu, Ihren Server vollständig privat zu machen. Sobald Sie der Datei permittedlist.txt mindestens eine ID hinzufügen, akzeptiert der Server nur noch die aufgeführten Spieler; alle anderen können sich nicht verbinden. Ist die Datei leer (enthält sie nur //-Kommentarzeilen), kann jeder beitreten.
Ein wichtiger Punkt: Wenn Sie die Whitelist aktivieren, müssen Sie die IDs aller Spieler, die beitreten sollen, einschließlich der Admins und Ihrer eigenen, in diese Datei eintragen. Ein Eintrag nur in adminlist.txt genügt bei aktiver Whitelist nicht für den Zutritt.
Schritt für Schritt: privater Server mit Whitelist
- Starten Sie den Server mindestens einmal, damit die Listendateien angelegt werden.
- Sammeln Sie die SteamID64-Werte aller Spieler, denen Sie den Zutritt erlauben (einschließlich Ihrer eigenen und der Admins).
- Öffnen Sie die Datei
permittedlist.txtim Speicherverzeichnis. - Schreiben Sie jede ID in eine eigene Zeile; die mit
//beginnenden Erläuterungszeilen müssen Sie nicht anfassen. - Speichern Sie die Datei.
- Ergänzen Sie optional im Startskript
-password, um eine zweite Schutzschicht hinzuzufügen. - Stoppen Sie den Serverprozess und starten Sie ihn neu. Jetzt können sich nur noch die aufgeführten Spieler verbinden.
Unter Windows
Wechseln Sie in das Speicherverzeichnis, öffnen Sie die Datei permittedlist.txt mit Notepad (Editor) und schreiben Sie pro Zeile eine SteamID64:
// permittedlist - eine ID pro Zeile
76561198000000001
76561198000000002
76561198000000003
Speichern Sie die Datei und starten Sie den Server neu. Jetzt können sich nur noch diese drei Spieler verbinden.
Unter Linux
Öffnen Sie dieselbe Datei mit einem Editor wie nano:
nano ~/.config/unity3d/IronGate/Valheim/permittedlist.txt
Fügen Sie die IDs mit einer ID pro Zeile hinzu, speichern Sie (Strg+O, danach Strg+X) und starten Sie den Server neu. Wenn Sie -savedir verwenden, passen Sie den Pfad zur Datei entsprechend an.
Einstellungen der Bannliste (bannedlist.txt)
Es gibt zwei Wege, unerwünschte Spieler zu sperren: die Datei manuell bearbeiten oder die Admin-Befehle im Spiel verwenden.
Datei manuell bearbeiten
Öffnen Sie die Datei bannedlist.txt, tragen Sie die SteamID64-Werte der zu sperrenden Spieler mit einer ID pro Zeile ein, speichern Sie und starten Sie den Server neu:
// bannedlist - eine ID pro Zeile
76561198000000009
76561198000000010
Sperren mit Befehlen im Spiel
Um im Spiel sofort zu sperren, müssen Sie Admin sein. Nachdem Sie Ihre SteamID64 in adminlist.txt eingetragen und den Server neu gestartet haben, öffnen Sie im Spiel mit F5 die Konsole und können die folgenden Befehle verwenden:
| Befehl | Beschreibung |
|---|---|
banned | Zeigt die Liste der gesperrten Spieler. |
ban [Name/ID] | Sperrt den Spieler dauerhaft und trägt ihn in bannedlist.txt ein. |
unban [ID] | Hebt die Sperre des Spielers auf. |
kick [Name/ID] | Wirft den Spieler vom Server (vorübergehend; der Spieler kann sich erneut verbinden). |
Beispielbefehle:
ban 76561198000000009
kick Spielername
unban 76561198000000009
banned
Der Befehl ban im Spiel wirkt sofort und dauerhaft; kick wirft dagegen nur für den Moment hinaus, der Spieler kann wieder beitreten. Verwenden Sie für eine dauerhafte Sperre ban. Alle Admin-Befehle und das Festlegen von Admins finden Sie in der Anleitung Admin werden in Valheim und Konsolenbefehle.
Sperren nach IP
Der Befehl ban im Spiel akzeptiert den Spielernamen, die IP-Adresse oder die Benutzerkennung (userID). Eine Sperre nach IP kann helfen, jemanden aufzuhalten, der häufig seine Kennung wechselt; da sich die IP bei den meisten Heimanschlüssen mit der Zeit ändern kann, ist eine Sperre per SteamID64 als dauerhafte Lösung jedoch zuverlässiger. Bei manueller Bearbeitung ist es am sichersten, die ID in die Datei bannedlist.txt zu schreiben.
Listen in Ordnung halten
Mit der Zeit können Whitelist und Bannliste lang werden. Gehen Sie die Dateien gelegentlich durch: Personen, die nicht mehr auf dem Server spielen, können Sie von der Whitelist streichen, und einen versehentlich eingetragenen oder begnadigten Spieler können Sie von der Bannliste löschen. Denken Sie daran, die Datei nach jeder Änderung zu speichern und den Server neu zu starten. Statt eine Zeile vollständig zu löschen, können Sie sie auch vorübergehend deaktivieren, indem Sie // davor setzen; so können Sie den Zugriff an- und abschalten, ohne die ID zu verlieren.
Beispiel: Passwort und Whitelist kombiniert
Die Whitelist ist unabhängig vom Serverpasswort; Sie können beide zusammen verwenden. Das Passwort legen Sie im Startskript fest, den Zugriff begrenzen Sie mit permittedlist.txt. Im folgenden Beispiel erscheint der Server nicht in der Community-Liste (-public 0) und verlangt ein Passwort:
valheim_server -nographics -batchmode -name "Mein HanHosting Server" -port 2456 -world "MeineWelt" -password "starkes5Passwort" -public 0
Ist zusätzlich permittedlist.txt gefüllt, können nur Spieler beitreten, die das Passwort kennen und auf der Whitelist stehen. Einzelheiten zu Servername, Welt und Passwort finden Sie in der Anleitung Valheim-Servereinstellungen und Passwort festlegen.
Änderungen übernehmen und der HanHosting-Kundenbereich
Damit Änderungen an den Listendateien zuverlässig übernommen werden, stoppen Sie den Valheim-Serverprozess und starten ihn neu. Die Befehle ban, kick und unban im Spiel wirken dagegen sofort. Bei Bedarf können Sie den gesamten Server über die Energiefunktionen im Kundenbereich („Server starten“ / „Herunterfahren“ / „Neu starten“) neu starten; ist Ihr RDP- oder SSH-Zugang gestört, verbinden Sie sich über die VNC (Webkonsole) im Kundenbereich mit dem Bildschirm des Servers.
Ein wichtiger Hinweis: Bei VDS-Paketen sind automatische Backups nicht enthalten; das Backup liegt in Ihrer Verantwortung. Sichern Sie zusammen mit Ihrem Weltspielstand regelmäßig auch die Dateien permittedlist.txt, bannedlist.txt und adminlist.txt. Zu Backup und Übertragung von Spielständen lesen Sie die Anleitung Valheim-Spielstand übertragen und sichern. Bei Verbindungsproblemen, die nichts mit den Listen zu tun haben, hilft die Anleitung Valheim: Ports öffnen und Verbindungsprobleme beheben.
Häufige Fehler
- Whitelist aktiv, aber Admins kommen nicht hinein: Ist
permittedlist.txtgefüllt, können nur die aufgeführten Spieler beitreten. Stellen Sie sicher, dass auch die Admins und Ihre eigene ID in der Datei stehen. - Namen in die Datei schreiben und eine Sperre erwarten:
bannedlist.txtundpermittedlist.txtarbeiten mit IDs (SteamID64). Eine Sperre nach Namen ist nur mit dem Befehlbanim Spiel möglich, solange der Spieler verbunden ist. - Falsches ID-Format: Tragen Sie die 17-stellige SteamID64 ein, nicht SteamID2 oder SteamID3.
- Änderung wirkt nicht: Möglicherweise haben Sie vergessen, den Server nach der Bearbeitung der Datei neu zu starten.
- Falsches Verzeichnis bearbeitet: Wenn Sie
-savedirverwenden, bearbeiten Sie die Dateien in diesem Verzeichnis, nicht die im Installationsordner. - Crossplay-Spieler lässt sich nicht sperren: Die ID eines Crossplay-Spielers kann ein anderes Format haben; verwenden Sie die ID genau so, wie sie im Serverlog steht.
Häufig gestellte Fragen
Kann ich Whitelist und Passwort zusammen verwenden?
Ja. permittedlist.txt begrenzt den Zugriff nach ID, das Passwort wird über -password im Startskript festgelegt. Beides funktioniert zusammen.
Ist ein Bann dauerhaft?
Ja; der Spieler kann sich nicht verbinden, bis Sie den Befehl unban verwenden oder die ID aus bannedlist.txt löschen und den Server neu starten.
Was ist der Unterschied zwischen Kick und Bann?
kick wirft den Spieler nur für den Moment hinaus, er kann sich erneut verbinden. ban sperrt dagegen dauerhaft und trägt den Spieler in bannedlist.txt ein.
Muss ich den Server für eine Änderung neu starten?
Wenn Sie die Dateien manuell bearbeiten, ist ein Neustart des Servers der sicherste Weg, damit die Änderung zuverlässig übernommen wird. Die Befehle ban, kick und unban im Spiel wirken dagegen sofort.
Wo finde ich die SteamID64?
Am einfachsten übernehmen Sie die ID, die beim Verbinden des Spielers im Serverlog erscheint. Alternativ können Sie den Link zum Steam-Profil des Spielers in ein Werkzeug wie https://steamid.io eingeben.
Was muss ich tun, um die Whitelist abzuschalten?
Löschen Sie alle ID-Zeilen in permittedlist.txt (nur die //-Kommentarzeilen bleiben stehen) und starten Sie den Server neu; danach ist der Server wieder für alle offen.
Wie viele Spieler kann ich gleichzeitig eintragen?
Bei der Zeilenzahl von Whitelist und Bannliste stoßen Sie in der Praxis auf keine Grenze; es genügt, für jeden Spieler eine Zeile hinzuzufügen. Wichtig ist, dass in jeder Zeile genau eine SteamID64 im richtigen Format steht.
Gilt ein Admin automatisch als in die Whitelist eingetragen?
Nein. Bei aktiver Whitelist müssen auch die Admins in permittedlist.txt stehen; ein Eintrag nur in adminlist.txt berechtigt nicht zum Beitritt.
Welchen VDS sollte ich wählen?
Für einen Valheim-Server sind ausreichend RAM und eine gute Single-Core-Leistung wichtig. Die verfügbaren VDS-Familien und Mietangebote finden Sie auf der Seite Valheim-Server mieten; wenn Sie nicht weiterkommen, können Sie im Kundenbereich ein Support-Ticket eröffnen.
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.