AEONHOST / WISSEN

Minecraft-Domain mit SRV-Eintrag einrichten

Der untersuchte Mojang-Java-Client 26.3 kann einen Spielserver über einen SRV-Eintrag mit einem Minecraft-Java-Namen verbinden. So können Spieler zum Beispiel play.example.com eingeben, obwohl der Server auf einem anderen Port als 25565 lauscht. DNS öffnet dabei keinen Port und prüft nicht, ob der Server erreichbar ist. Im Clientcode erscheint die Dienstkennung _minecraft._tcp.. Diese Anleitung beschränkt sich auf Minecraft Java. (Mojang Client 26.3)

Aktualisiert am 07.10.2026

Der untersuchte Mojang-Java-Client 26.3 kann einen Spielserver über einen SRV-Eintrag mit einem Minecraft-Java-Namen verbinden. So können Spieler zum Beispiel play.example.com eingeben, obwohl der Server auf einem anderen Port als 25565 lauscht. DNS öffnet dabei keinen Port und prüft nicht, ob der Server erreichbar ist. Im Clientcode erscheint die Dienstkennung _minecraft._tcp.. Diese Anleitung beschränkt sich auf Minecraft Java. (Mojang Client 26.3)

Vor dem Eintrag: Zielhost und Port kennen

Du brauchst Zugriff auf die DNS-Zone deiner Domain und die tatsächlichen Verbindungsdaten deines Servers. Übernimm den Hostnamen und den Spielport aus der Serverkonfiguration oder vom zuständigen Anbieter. Der Port muss der Port sein, auf dem der Server Verbindungen annimmt. Ein Webport, ein Verwaltungsport oder ein Port aus einem Beispiel ist dafür nicht automatisch geeignet.

Lege für den Zielhost mindestens den passenden Adresstyp an. Ein A-Eintrag enthält eine IPv4-Adresse; ein AAAA-Eintrag enthält eine IPv6-Adresse. Veröffentliche eine AAAA-Adresse nur, wenn der Server über genau diesen IPv6-Weg erreichbar ist. Die Beispieladressen unten stammen aus Dokumentationsbereichen und sind nicht mit einem Spielserver verbunden. (RFC 1035, RFC 3596, IANA: Special-Use Domain Names, IANA: Example Domains)

node.example.net. 300 IN A     192.0.2.40
node.example.net. 300 IN AAAA  2001:db8::40

example.com und example.net sind für Dokumentationsbeispiele reserviert. 192.0.2.0/24 und 2001:db8::/32 sind ebenfalls Dokumentationsbereiche. Ersetze diese Werte durch deinen eigenen Hostnamen und die echten, vom Anbieter bestätigten Serveradressen; kopiere die Beispieladressen nicht in eine produktive Zone. (IANA: Example Domains, IANA: IPv4-Adressraum, IANA: IPv6-Sonderbereiche)

SRV-Eintrag für den Namen anlegen

Wenn Spieler play.example.com eingeben sollen, lautet der vollständige SRV-Abfragename _minecraft._tcp.play.example.com. Für die Hauptdomain example.com wäre es _minecraft._tcp.example.com. Der DNS-Standard setzt den Dienst vor das Protokoll und den Namen, für den der Eintrag gilt. In einem Anbieterformular kann das Feld Name relativ zur Zone sein; lies den vollständig zusammengesetzten Namen nach dem Speichern nochmals aus. (RFC 2782, Cloudflare: DNS-Recordtypen)

Für den Beispieldienst auf Port 25570 sieht der Eintrag so aus:

Name:      _minecraft._tcp.play
Typ:       SRV
Priorität: 0
Gewicht:   0
Port:      25570
Ziel:      node.example.net.

Als vollständiger Resource Record lautet derselbe Beispieldatensatz:

_minecraft._tcp.play.example.com. 300 IN SRV 0 0 25570 node.example.net.

Der Zielhost muss eigene A- oder AAAA-Adressen besitzen und darf gemäss RFC 2782 kein Alias sein. Zeigt das Ziel auf einen CNAME, verwende stattdessen den endgültigen Hostnamen mit Adresseintrag. Bei der Priorität wird die kleinere Zahl zuerst versucht. Das Gewicht beeinflusst die Reihenfolge nur zwischen Einträgen mit gleicher Priorität; ein höheres Gewicht ist eine relative Auswahlchance und keine Garantie für eine bestimmte Verteilung. Bei nur einem SRV-Eintrag bewirkt das Gewicht keine Lastverteilung. (RFC 2782)

Antwort im DNS prüfen und mit Java verbinden

Prüfe zuerst den SRV-Eintrag und danach die Adresse des Ziels. dig +noall +answer zeigt Name, TTL, Typ und Antwort kompakt an; das ist die dokumentierte BIND-Form für eine kurze Antwort. Ersetze die Beispielnamen durch deine eigene Zone. (BIND 9: dig)

dig +noall +answer _minecraft._tcp.play.example.com SRV
dig +noall +answer node.example.net A
dig +noall +answer node.example.net AAAA

Die Antwort sollte für SRV Port und Ziel enthalten und für den Zielhost die tatsächlich eingerichteten A- und gegebenenfalls AAAA-Werte zurückgeben. Ein beispielhafter Antwortaufbau ist:

_minecraft._tcp.play.example.com. 300 IN SRV 0 0 25570 node.example.net.
node.example.net. 300 IN A 192.0.2.40
node.example.net. 300 IN AAAA 2001:db8::40

Diese Werte sind nur Dokumentationsbeispiele und nicht live geprüft. Ein leeres SRV-Ergebnis kann auf einen falsch zusammengesetzten Namen oder eine andere aktive DNS-Zone hindeuten. Wenn nur der AAAA-Wert falsch ist, können IPv6-fähige Spieler einen anderen oder unerreichbaren Endpunkt erhalten.

Im untersuchten Mojang-Java-Client 26.3 wird _minecraft._tcp nur abgefragt, wenn der eingelesene Port 25565 beträgt. Ohne Portangabe setzt der Client diesen Standard; auch :25565 erfüllt die Bedingung. Ein ausdrücklich anderer Port wie :25570 überspringt die SRV-Abfrage (Mojang Java-Client 26.3). Für diesen Client trägst du daher nur play.example.com ein, wenn du den SRV-Port verwenden willst. Der Codebeleg gilt für Mojang Java 26.3 und sagt nichts über Bedrock oder andere Clientversionen aus.

Prüfe danach die Verbindung mit einem Java-Client, nachdem die DNS-Antwort den erwarteten Port zeigt. Die Abfrage bestätigt nur veröffentlichte Daten, nicht Firewall, Portzuordnung oder Serverstart. Wenn DNS korrekt aussieht, die Verbindung aber mit Connection refused oder Timeout scheitert, helfen die getrennten Schritte zu Verbindungsfehlern. Für eine DNS-Änderung kurz vor einem Umzug beachte auch den TTL- und Umstellungsplan. Zur Geräte- und Editionswahl siehe Minecraft Java oder Bedrock.

Häufige Fehler

  • Der SRV-Eintrag fehlt in der Abfrage: Prüfe _minecraft._tcp und den gewünschten Namen. Manche Formulare ergänzen die Zone automatisch; dann darfst du sie nicht nochmals vollständig anhängen.
  • SRV antwortet, aber der Zielhost löst nicht auf: Ergänze die passende A- oder AAAA-Adresse und prüfe den Zielnamen. Der Punkt am Ende kennzeichnet in einer Zonendatei den vollständigen Hostnamen; in einer Oberfläche hängt das Verhalten vom Anbieter ab.
  • Antwort enthält den falschen Port: Vergleiche den SRV-Port mit dem tatsächlichen Spielport. Eine DNS-Adresse allein ersetzt diese Zuordnung bei einem abweichenden Port nicht.
  • Die Abfrage ist richtig, der Client erreicht den Server dennoch nicht: Prüfe die tatsächliche Portfreigabe, den laufenden Server und den verwendeten Netzwerkpfad. Ein SRV-Eintrag ist kein Proxy und öffnet keine Firewall.

Quellen