TeamSpeak Ports: Welche Ports dein TS3-Server braucht, Firewall-Regeln und SRV-Eintrag statt Portangabe

UDP 9987, TCP 30033, 10011 und 10022: Was jeder TeamSpeak-Port macht, welche du öffnen musst, wie die Firewall aussieht und wie Nutzer ohne Portangabe verbinden.

Ein TeamSpeak-3-Server nutzt standardmäßig drei TeamSpeak Ports: UDP 9987 für die Sprache, TCP 30033 für den Dateitransfer und TCP 10011 (Raw) beziehungsweise TCP 10022 (SSH) für die ServerQuery. Damit deine Leute reden können, muss nur UDP 9987 von außen erreichbar sein, für Avatare, Icons und Uploads zusätzlich TCP 30033. Die Query-Ports brauchst du nur für Bots und Verwaltung und solltest sie auf bekannte IP-Adressen beschränken.

Klingt simpel, und meistens ist es das auch. Die typischen Probleme entstehen an den Rändern: UDP und TCP verwechselt, der Dateitransfer vergessen, die Query offen ins Internet gestellt oder ein zweiter virtueller Server auf einem Port, den niemand freigegeben hat. Dieser Beitrag geht die Ports einzeln durch und zeigt, wie du sie absicherst und hinter einer eigenen Adresse versteckst.

Welche Ports nutzt ein TeamSpeak-3-Server?

Hier die Standardbelegung, so wie sie nach einer frischen Installation ohne angepasste Konfiguration aussieht:

  • UDP 9987 - Sprachverbindung des ersten virtuellen Servers. Über diesen Port läuft alles, was du im Client direkt merkst: Verbinden, Sprechen, Kanalwechsel, Chat.
  • TCP 30033 - Dateitransfer. Darüber laufen Avatare, Server- und Kanal-Icons sowie Dateien, die jemand in einen Kanal hochlädt oder herunterlädt.
  • TCP 10011 - ServerQuery im Raw-Modus, also eine unverschlüsselte Textschnittstelle für Bots, Webinterfaces und Skripte.
  • TCP 10022 - ServerQuery über SSH, die verschlüsselte Variante derselben Schnittstelle.
  • TCP 10080 und 10443 - WebQuery per HTTP beziehungsweise HTTPS, in neueren Serverversionen verfügbar, wenn du sie aktivierst.

Welche Query-Protokolle tatsächlich lauschen, hängt von deiner Serverversion und der Einstellung query_protocols ab. Was wirklich offen ist, siehst du am zuverlässigsten direkt auf dem Server:

sudo ss -tulpn | grep ts3server

In der Ausgabe stehen Protokoll (udp oder tcp), Adresse und Port. Steht dort zum Beispiel 0.0.0.0:10011, lauscht die Raw-Query auf allen Schnittstellen.

Welche TeamSpeak Ports müssen wirklich erreichbar sein?

Am einfachsten denkst du in drei Stufen:

  1. Pflicht: UDP 9987 (oder der Voice-Port jedes weiteren virtuellen Servers). Ohne diesen Port verbindet sich niemand.
  2. Dringend empfohlen: TCP 30033. Fehlt er, klappt das Verbinden trotzdem, aber Avatare bleiben leer, Icons laden nicht und Uploads hängen bei 0 Prozent. Genau das wird oft für einen Serverfehler gehalten.
  3. Nur für dich: TCP 10011, 10022 und gegebenenfalls 10080/10443. Diese Ports braucht kein normaler Nutzer.

Für Nutzer zählen nur der Voice-Port per UDP und der Dateitransfer per TCP, alles andere gehört hinter eine Firewall-Regel mit fester Quell-IP.

Warum so streng bei der Query? Wer sich dort mit Admin-Zugangsdaten anmeldet, kann den kompletten Server steuern. Offene Query-Ports werden im Internet automatisiert abgesucht. TeamSpeak bringt zwar einen eigenen Flood-Schutz und eine Allowlist-Datei für Query-IPs mit (je nach Version query_ip_whitelist.txt oder query_ip_allowlist.txt), aber eine Firewall-Regel davor ist die sauberere erste Verteidigungslinie. Läuft dein Bot auf demselben Server, reicht es sogar, die Query nur an 127.0.0.1 zu binden.

Ports ändern und mehrere virtuelle Server betreiben

Ein TeamSpeak-Prozess kann mehrere virtuelle Server enthalten. Jeder davon bekommt einen eigenen UDP-Voice-Port, typischerweise fortlaufend: 9987, 9988, 9989 und so weiter. Dateitransfer und Query teilen sich dagegen alle virtuellen Server über denselben Port.

Die Standardports legst du in der ts3server.ini fest oder übergibst sie beim Start als Parameter. Ein Beispiel, das die Query nur lokal anbietet:

default_voice_port=9987
voice_ip=0.0.0.0
filetransfer_port=30033
filetransfer_ip=0.0.0.0
query_port=10011
query_ssh_port=10022
query_ip=127.0.0.1

Dieselben Werte funktionieren auch direkt am Startskript:

./ts3server_startscript.sh start default_voice_port=9987 query_ip=127.0.0.1

Wichtig: default_voice_port gilt nur für den virtuellen Server, der beim allerersten Start angelegt wird. Weitere Server und Portänderungen erledigst du später über die Query oder die Servereinstellungen. Ein anderer Port bringt übrigens kaum Sicherheit, er sortiert höchstens ein paar simple Scanner aus. Sinnvoll ist er vor allem, wenn du mehrere Instanzen sauber trennen willst.

Wie du den Server überhaupt installierst und als Dienst einrichtest, steht ausführlich in der Anleitung TeamSpeak Server erstellen auf eigenem vServer oder als Voice-Server. Hier geht es nur um die Netzwerkseite.

Firewall-Regeln für TeamSpeak setzen

Auf einem Linux-Server mit ufw sieht eine vernünftige Grundkonfiguration so aus. Die Quell-IP 203.0.113.10 ersetzt du durch deine eigene feste IP oder die deines Bot-Servers:

sudo ufw allow 22/tcp
sudo ufw allow 9987/udp
sudo ufw allow 30033/tcp
sudo ufw allow from 203.0.113.10 to any port 10022 proto tcp
sudo ufw default deny incoming
sudo ufw enable

Drei Dinge, auf die du dabei achten solltest:

  • SSH zuerst. Die Regel für deinen SSH-Port muss stehen, bevor du eingehend auf Verbieten stellst. Sonst sperrst du dich selbst aus.
  • Protokoll exakt angeben. 9987 ist UDP, 30033 ist TCP. Eine TCP-Freigabe auf 9987 bringt dem Voice-Server nichts.
  • Jeder virtuelle Server braucht seine Regel. Legst du einen zweiten Server auf 9988 an, musst du auch 9988/udp freigeben.

Ausgehend lässt du den Verkehr am besten offen. Der TeamSpeak-Server baut von sich aus Verbindungen zu Diensten des Herstellers auf, etwa für die Lizenzprüfung und die öffentliche Serverliste. Wer ausgehend restriktiv filtert, riskiert, dass der Server nicht sauber startet oder in der Liste fehlt.

Mehr zur Grundhärtung eines frischen Servers, von SSH-Schlüsseln bis Backups, findest du in vServer absichern: die ersten Schritte nach der Bereitstellung.

Port im TeamSpeak-Client angeben

Läuft dein Server auf dem Standardport 9987, reicht im Client die IP-Adresse oder der Hostname. Bei jedem anderen Port hängst du ihn mit Doppelpunkt an:

203.0.113.20:9988
ts.example.de:9988
[2001:db8::20]:9988

Bei IPv6 gehört die Adresse in eckige Klammern, sonst kann der Client die Doppelpunkte der Adresse nicht vom Port unterscheiden. Den Dateitransfer-Port gibst du nie im Client an, den teilt der Server dem Client nach dem Verbinden selbst mit. Und die Query-Ports haben im Client nichts zu suchen.

Eigene Adresse statt IP und Port: der SRV-Eintrag

Schöner als 203.0.113.20:9988 ist eine Adresse wie ts.example.de, bei der niemand einen Port kennen muss. Genau dafür fragt der TeamSpeak-Client vor dem Verbinden einen SRV-Eintrag mit dem Namen _ts3._udp ab. Dieser Eintrag sagt: Für diesen Namen bitte zu Host X auf Port Y.

In der DNS-Zone sieht das so aus:

ts.example.de.             3600 IN A    203.0.113.20
_ts3._udp.ts.example.de.   3600 IN SRV  0 5 9988 ts.example.de.

Die Zahlen im SRV-Eintrag stehen für Priorität (0), Gewichtung (5), Port (9988) und Ziel. Das Ziel muss ein Hostname mit eigenem A- oder AAAA-Eintrag sein, keine nackte IP und kein CNAME. Deine Nutzer tippen danach nur noch ts.example.de ein.

Prüfen kannst du den Eintrag von jedem Rechner aus:

dig +short SRV _ts3._udp.ts.example.de

Kommt 0 5 9988 ts.example.de. zurück, ist alles richtig. Kommt nichts, ist der Eintrag noch nicht verteilt oder falsch benannt. Häufigster Fehler ist ein doppelter Domainteil, weil viele DNS-Oberflächen die Zone automatisch anhängen und aus _ts3._udp.ts.example.de dann _ts3._udp.ts.example.de.example.de wird. Das Prinzip ist übrigens dasselbe wie bei Minecraft, die Feinheiten dort beschreibt der Beitrag Minecraft Server mit eigener Domain verbinden.

Typische Fehlerbilder und ihre Ursache

Verbindung klappt, aber Avatare und Uploads nicht

Fast immer ist TCP 30033 nicht freigegeben, entweder in der Firewall des Servers oder in einer vorgeschalteten Firewall. Freigeben, Client neu verbinden, fertig.

Verbindung bricht mit Timeout ab

Prüfe mit ss -tulpn, ob der Server auf dem erwarteten UDP-Port lauscht, und ob die Firewall-Regel wirklich UDP erlaubt. Ein klassischer Test mit Telnet oder einem TCP-Portscanner sagt bei UDP nichts aus.

Die Adresse ohne Port funktioniert nicht, mit Port schon

Dann fehlt der SRV-Eintrag, er zeigt auf den falschen Port oder die DNS-Änderung ist noch nicht überall angekommen. Je nach TTL kann das von einigen Minuten bis zu Stunden dauern.

Im Serverlog tauchen fremde Query-Logins auf

Die Query ist aus dem Internet erreichbar. Regel auf deine IP beschränken oder die Query an 127.0.0.1 binden und das Query-Passwort ändern.

TeamSpeak-Ports bei Hostleaf

Betreibst du TeamSpeak auf einem eigenen vServer oder Root Server bei Hostleaf, kannst du die Regeln statt mit ufw auch in der Panel-Firewall setzen: Regel hinzufügen, Richtung Eingehend, Aktion Erlauben, Protokoll udp, Ziel-Port 9987, und dasselbe mit tcp für 30033. Für die Query trägst du deine Quell-IP ins entsprechende Feld ein. Wie Standardverhalten, Vorlagen und eigene Regeln dort zusammenspielen, beschreibt die Hilfe zu Traffic, Firewall und rDNS deines Servers.

Wenn du dich um Ports gar nicht kümmern willst, kannst du alternativ einen TeamSpeak 3 Server mieten. Dort legt die Funktion Subdomain einrichten automatisch einen A-Eintrag und den SRV-Eintrag _ts3._udp mit dem tatsächlichen Port an, für eine eigene Domain steht der SRV-Eintrag zum Kopieren bereit. Details dazu stehen in der Anleitung TeamSpeak-Server verwalten. Der Netzwerk-DDoS-Schutz ist bei allen Diensten standardmäßig aktiv.

FAQ

Welcher Port ist der Standardport von TeamSpeak 3?

Der Standard-Voice-Port ist UDP 9987. Dazu kommen TCP 30033 für den Dateitransfer und TCP 10011 beziehungsweise 10022 für die ServerQuery. Für Nutzer entscheidend ist nur der Voice-Port, und der wird im Client angegeben, wenn er vom Standard abweicht.

Muss ich TCP 30033 wirklich öffnen?

Zum reinen Sprechen nicht. Ohne TCP 30033 funktionieren aber Avatare, Icons und Datei-Uploads nicht, was Nutzer schnell als kaputten Server wahrnehmen. In der Praxis gehört der Port deshalb zu jeder Freigabe dazu.

Kann ich TeamSpeak auf einem anderen Port betreiben?

Ja. Den Voice-Port setzt du über default_voice_port beim ersten Start oder später in den Servereinstellungen, Dateitransfer und Query über filetransfer_port und query_port. Denk daran, die Firewall-Regel anzupassen und, falls vorhanden, den Port im SRV-Eintrag zu ändern.

Wie verbinden sich Nutzer ohne Portangabe?

Über einen SRV-Eintrag mit dem Namen _ts3._udp unter deiner Wunschadresse, der auf einen Hostnamen und den echten Voice-Port zeigt. Der Client fragt diesen Eintrag automatisch ab, Nutzer geben dann nur noch den Hostnamen ein.

Weitere Beiträge