Files
chanora/docs/offline-knowledge/external/yatqa-de.md
T
Edison Jwa dd6e80f72a docs: add offline knowledge library with project analysis and external references
- function-inventory: complete public API for 10 Rust crates + 56 Dart files
- coverage-analysis: 312 Rust tests, 221 Dart tests, doc coverage gaps
- doc-quality-analysis: duplications, broken refs, useless content audit
- link-coverage-report: all internal/external links validated
- external/teaspeak: TeaSpeak voice server architecture & protocol
- external/respeak: ReSpeak org, tsclientlib, tsproto, crypto docs
- external/yatqa-en/de: yat.qa admin tool (English + German)
- reviews/: cross-validation reports for all analyses

All documentation only, no code changes.
2026-06-13 02:00:26 +09:00

349 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# YaTQA Wissensdatenbank (Deutsch)
> Quelle: https://yat.qa/ — Abgerufen: 13.06.2026
> Version: v3.9.9b (01. Mrz 2023)
## Überblick
**YaTQA** (Yet Another TeamSpeak³ Query Admin Tool) ist eine Windows-Anwendung zur Verwaltung von **TeamSpeak-3-Servern und -Instanzen** über das ServerQuery-Interface. Es bietet eine grafische Oberfläche für alle Query-Befehle und macht das Erlernen der rohen Query-Syntax überflüssig.
- **Autor:** Janni „Яedeemer" K. (Norddeutschland)
- **Sprache:** Geschrieben in Delphi 2009 (über 50.000 Zeilen Quelltext)
- **Entwicklungsbeginn:** 10. April 2011
- **Erstveröffentlichung:** 29. Juni 2011
- **Lizenz:** Kostenlos und voll funktionsfähig (keine Adware/Spyware)
- **Plattformen:** Windows XP und neuer, Linux mittels Wine
- **Größe:** ~1,3 MiB Installer
- **Enthaltene Sprachen:** Deutsch und Englisch (Auswahl während der Installation)
- **Unterstützte Server:** TeamSpeak 3.9.0 bis 3.13.7, TeaSpeak 1.4.10-beta
- **Download:** https://dl.yat.qa/stable/
- **Website:** https://yat.qa/
### Motto
*„Dinosaurier haben kein TeamSpeak benutzt und sind vor 66 Millionen Jahren ausgestorben. Zufall? Vermutlich nicht."*
---
## Funktionen
**YaTQA unterstützt alle ServerQuery-Funktionen ohne Ausnahme.** Die folgende Liste beschränkt sich auf Funktionen, die der normale TS-Client nicht bietet.
### Allgemeine Funktionen (Kein Admin erforderlich)
- **DNS-Auflösung:** Detaillierte Visualisierung der DNS-Auflösung (simuliert 10 verschiedene Client-Versionen)
- **Blacklist-Prüfung:** TeamSpeaks Blacklist auf eine IP überprüfen
- **Blacklist2:** TeamSpeaks Blacklist2 für virtuelle Server prüfen
- **Benutzerdiagramm:** Serverstatistiken von Planet TeamSpeak als Diagramm anzeigen und als PNG speichern
- **Client-Cache:** Avatare, Icons und Chatlogs im Client-Cache finden
### Konsole (Query-Interface)
- **Autovervollständigung:** Befehlsvervollständigung einschließlich undokumentierter Befehle
- **Parameterhilfe:** Zeigt alle Parameter eines Befehls basierend auf eigener Forschung
- **Werteauswahl:** Strg+Leertaste für Werteliste
- **Ergebnisanalyse:** Gruppierte Datensätze mit Erklärungen
- **Skripting:** Befehlslisten aus Dateien laden und ausführen
- **Events:** Server-Events abonnieren und in der Konsole protokollieren
### SSH-Tunnel
- **Verschlüsselung:** Vollständig verschlüsselte Verbindung (außer Dateiübertragungen)
- **Geschwindigkeit:** Auf vielen Servern merkbar schneller (ähnlich wie `tcp_nodelay`)
- **Privatsphäre:** IP wird immer verborgen (man erscheint als 127.0.0.1)
- **Flood-Umgehung:** Umgeht alle Flood-Beschränkungen (127.0.0.1 steht üblicherweise auf der Whitelist)
### Instanz-Funktionen (Erfordert serveradmin)
- Instanzstatistiken anzeigen/bearbeiten
- Lizenzdetails und IP-Bindings anzeigen
- Alle virtuellen Server anzeigen
- Lokale Notizen zu Servern erstellen (lokal gespeichert)
- Virtuelle Server starten/stoppen/erstellen/löschen/umbenennen
- Unsichtbar werden (Server-Fehler, könnte behoben werden)
- Nachricht an alle Server senden
- Snapshots erstellen/massenweise erstellen/wiederherstellen (inkl. Dateien)
- Manipulierte Snapshots einspielen
- Server mittels Snapshots kopieren
- Rechte auf Vorlagengruppen zurücksetzen
- Channel-Datei-Backups speichern/wiederherstellen (inkrementelles Backup unterstützt)
### Funktionen für virtuelle Server
- Host-Message-Modal-Quit und hohe Sicherheitsstufe ignorieren
- Sehr detaillierte Serverstatistiken
- Mehrere Server gleichzeitig bearbeiten
- Ausklappbarer Serverbaum (optional immer im Vordergrund)
- Mehrere Nutzer gleichzeitig verschieben/kicken/bannen/beschreiben
- Mehrere Channel gleichzeitig erstellen
- Channel als Vorlage für weitere verwenden
- Mehrere Channel gleichzeitig bearbeiten
- Nachrichten an mehrere Nutzer/Channel gleichzeitig senden
- Rechte mehrerer Nutzer/Channel gleichzeitig bearbeiten
- Dateien zwischen Channeln verschieben
- Bildvorschau ohne Download (bmp, gif, jpg, png, pbm, pgm, ppm, xbm, xpm)
- Upload/Download ganzer Ordnerstrukturen
- Nutzer zu Gruppen hinzufügen durch Namenseingabe
- Funktionierende Rechteübersicht mit Echtzeitbearbeitung
- Rechte zwischen Servern/Instanzen kopieren
- Rechtewerte und -powers vergleichen
- Alle Clients/Gruppen mit einem bestimmten Recht finden
- Mehrere Gruppen gleichzeitig bearbeiten
- Verbesserte Clientdatenbank mit mehr Details und Suchfunktionen
- Gesamte Clientdatenbank mit einem Klick herunterladen
- Clientdatenbank als HTML oder CSV exportieren
- Gebannte Nutzer und IP-teilende Profile hervorheben
- Log an beliebiger Stelle lesen
- User CustomInfo verwalten (suchen, anzeigen, bearbeiten, hinzufügen)
- Log als HTML oder TXT exportieren
- Avatare und Icons herunterladen
- Avatar-Besitzer auf dem Server identifizieren
- Servervorlage verwalten
- Uploads/Downloads überwachen
### Unterstützte Bildformate
| Format | Beschreibung |
|--------|-------------|
| bmp | Windows Bitmap |
| gif | Graphics Interchange Format |
| jpg/jpeg | Joint Photographic Experts Group |
| png | Portable Network Graphics |
| pbm | Portable Bitmap (ASCII und binär) |
| pgm | Portable Graymap (ASCII und binär) |
| ppm | Portable Pixmap (ASCII und binär) |
| xbm | X BitMap |
| xpm | X PixMap |
---
## Architektur / Funktionsweise
### Verbindungsmethoden
- **Raw TCP/Telnet:** Standard-Query-Verbindung (Standardport 10011)
- **YaTQA-SSH-Tunnel:** Über Plink (PuTTY-Suite) — verschlüsselt, schneller, IP verborgen
- **TeamSpeak SSH:** Natives TS3.3+-SSH (auch unterstützt, aber weniger Vorteile)
### Datenspeicherung
- **Portable Modus:** Alle Daten im Installationsverzeichnis (`yatqa.ini` vorhanden)
- **Standardmodus:** Einige Dateien in `%APPDATA%\YaTQA`
- **Icon-Cache:** 16-Bit-RES-Format (`icons.res`)
- **Befehlsverlauf:** `commandhistory.txt`
- **Debug-Log:** `RedeemerTS3.log` (erstellt mit `-debug`-Schalter)
### DNS-Auflösung
YaTQA simuliert die Auflösungsschritte des TeamSpeak-Clients und zeigt sie visuell an. Verwendet Googles DNS-Server für Zuverlässigkeit. Unterstützt:
- A- und CNAME-Einträge
- SRV-Einträge
- TSDNS-Auflösung
- Alle 10 verschiedenen Client-Version-DNS-Verhaltensweisen
### Snapshot-System
- Snapshots enthalten alle Servereinstellungen (außer Port und Server-ID)
- Snapshots enthalten KEINE Dateien, Icons oder Avatare
- Datei-Backups enthalten Dateien und Icons (keine Avatare wegen Serverbeschränkungen)
- Pseudo-Snapshots ermöglichen Serverkopien ohne Keypair
- Unterstützt Zstd-komprimierte Snapshots (3.10.0+-Format)
### Anti-Flood-Schutz
- Konfigurierbare „Befehle bis Flood"-Einstellung (empfohlen: ~20)
- Konfigurierbare Verzögerung zwischen Befehlen (empfohlen: 340ms für fremde Server)
- SSH-Verbindungen umgehen Flood-Beschränkungen (127.0.0.1 auf Whitelist)
---
## Konfiguration
### Anwendungseinstellungen
| Einstellung | Beschreibung |
|------------|-------------|
| Verbesserte XP-Unicode-Anzeige | Verwendet Arial Unicode MS für bessere CJK-Unterstützung |
| Daten bei Tabwechsel aktualisieren | Automatisch Daten aktualisieren |
| Lokale Zeit verwenden | Lokale Zeit statt UTC |
| Verbesserte Channel-Dropdowns | Baumansicht für Unterchannel |
| In den Tray minimieren | Minimieren in den Systemtray |
| Tray-Icon immer anzeigen | Permanent anzeigen |
| Icon-Caching aktivieren | Icons in `icons.res` cachen (empfohlen) |
| Keine Icons verwenden | Icon-Anzeige deaktivieren |
| Windows Aero verwenden | Aero-Design nutzen (Vista+) |
| Aero-Glow deaktivieren | Weißen Schatten hinter Menütext entfernen |
| Beim Start nach Updates suchen | Automatisch nach Updates suchen |
| Sortiereinstellungen speichern | Sortierpräferenzen merken |
| Sprunglisten aktivieren | Windows 7+-Sprunglisten-Integration |
### Kompatibilitätseinstellungen
| Einstellung | Beschreibung |
|------------|-------------|
| Befehle bis Flood | Verzögerung zwischen Befehlen (340 empfohlen für fremde Server) |
| Nicht-Standard-Query-Port erlauben | Verbindung zu anderen Ports als 10011 |
| Löschen wichtiger Gruppen erlauben | Löschen der ersten 5 Server-/4 Channelgruppen erlauben |
| Verlassen wichtiger Gruppen erlauben | serveradmin darf Admin Server Query verlassen |
| Machine-ID ändern erlauben | Änderung der Machine-ID ermöglichen |
### SSH-Tunnel-Profile
SSH-Profile für Server konfigurieren. Bei Verbindung zu einem Server mit passendem SSH-Profil verwendet YaTQA automatisch den Tunnel.
### Kreisdiagramm-Styles
Auswahl aus 4 verschiedenen Kreisdiagramm-Styles (durch Benutzerabstimmung ausgewählt).
---
## Startparameter
| Parameter | Beschreibung |
|-----------|-------------|
| `-a` | Verbindung zum Standardserver |
| `-b [IP]` | Blacklist-Prüfung |
| `-c IP Query_Port [User Pass [Voice_Port]]` | Verbindung zum angegebenen Server |
| `-d` | DNS-Auflösung |
| `-i` | Iconsammlung |
| `-p` | Rechtedateien-Editor |
| `-s [IP]` | Benutzerstatistik |
| `-debug` | Debug-Logging aktivieren |
---
## Systemanforderungen
### Mindestanforderungen
- **Betriebssystem:** Windows XP+ (Desktop), Windows 2012+ (Server)
- **Speicher:** 3 MB für YaTQA (mehr für Konfiguration/Snapshots)
- **Auflösung:** 960×720 (allgemein), 1024×720 (Serverbaum), 1024×768 (Konsole)
### Fehlende Funktionen unter Windows XP
- Geist-Modus
- Nameserver für DNS-Auflösung ändern
- Einklappbare DNS-Ergebnisse
- Einklappbare Gruppen im Servergruppenmodus der Benutzer-DB
### Fehlende Funktionen unter Windows Vista/XP
- Sprunglisten
### Wine/Linux-Einschränkungen
- Speicherlecks (Wine unterstützt kein Entfernen von Link-Labels)
- Auch unter XP fehlende Funktionen fehlen unter Wine
- Zusätzliche Einschränkungen: Keine Array-Gruppierung, keine DNS-Gruppierung, kein Servergruppenmodus in der Benutzer-DB
- Plink muss manuell installiert werden (Version 0.61+)
---
## Schlüsselkonzepte
### ServerQuery-Interface
Das TeamSpeak-3-ServerQuery-Interface ist ein textbasiertes Protokoll zur Serververwaltung. YaTQA kapselt diese Schnittstelle in einer GUI mit:
- Befehlsautovervollständigung
- Parameterhilfe
- Werteauswahl
- Ergebnisanalyse
### Virtueller Server
Ein virtueller Server ist eine unabhängige TeamSpeak-Serverinstanz, die auf einem einzelnen physischen Serverprozess läuft. Mehrere virtuelle Server können auf einer Instanz laufen.
### Instanz
Der Serverprozess, der einen oder mehrere virtuelle Server hostet. Verwaltet über den „serveradmin"-Account.
### Snapshot
Ein vollständiges Backup der Einstellungen eines virtuellen Servers (ohne Port und ID). Enthält keine Dateien, Icons oder Avatare.
### Pseudo-Snapshot
Ein vom Benutzer manipulierter Snapshot, der zum Kopieren von Servern ohne Beibehaltung des originalen Keypairs verwendet werden kann.
### Rechtesystem
TeamSpeak verwendet ein hierarchisches Rechtesystem mit:
- Servergruppen
- Channelgruppen
- Client-Rechte
- Rechte-Powers (Werte, die steuern, was gesetzt werden kann)
### Anti-Flood
TeamSpeak-Server begrenzen die Häufigkeit von Query-Befehlen. YaTQA bietet konfigurierbare Verzögerungen und „Befehle bis Flood"-Einstellungen, um Bans zu vermeiden.
### Blacklist / Blacklist2
TeamSpeak führt Blacklists gebannter IPs (Blacklist1) und Server-UIDs (Blacklist2).
### Abzeichen
Visuelle Indikatoren im TeamSpeak, die Benutzerstatus, Addon-Creator-Status usw. anzeigen. YaTQA kann Abzeichen konfigurieren.
### DNS-Auflösung
TeamSpeak-Clients lösen Serveradressen über mehrere Methoden auf: A-Einträge, CNAME, SRV-Einträge und TSDNS. YaTQA visualisiert diesen Prozess.
---
## Bekannte Einschränkungen
- **Channel-Passwörter:** YaTQA sendet grundsätzlich keine Channel-Passwörter. Erfordert `b_channel_join_ignore_password` und `b_ft_ignore_password`-Rechte.
- **Unicode:** Nur Basic Multilingual Plane (BMP) unterstützt (TeamSpeak-Einschränkung).
- **Integrierte DNS-Auflösung:** Nur A- und CNAME-Einträge (TSDNS und SRV im integrierten Resolver nicht unterstützt).
- **Geist-Modus:** Viele Funktionen funktionieren nicht; Geist hat nur Query-Gast-Rechte.
- **Konsole:** Nur die üblichen Einschränkungen des TS3-Servers.
---
## IPv6-Unterstützung
Eckige Klammern `[]` um die Serveradresse schreiben. Unterstützt seit v1.4/2.0-pre für Query-Verbindungen. IPv4-Tunnel (z.B. `[::ffff:7f00:1]`) werden nicht unterstützt.
---
## Projekthistorie
- **10.04.2011:** Entwicklungsbeginn (ursprünglich „TS3Telnet" genannt)
- **29.06.2011:** Erste Alpha-Version veröffentlicht
- **18.04.2014:** v2.0 führte Registrierungserfordernis für einige Funktionen ein
- **22.08.2019:** YaTQA wieder uneingeschränkt Freeware
- **01.03.2023:** v3.9.9b veröffentlicht (Zeitlimit dauerhaft entfernt)
### Namensherkunft
„Yet Another TeamSpeak³ Query App" — benannt, weil es beim Entwicklungsbeginn bereits viele Query-Tools gab, aber keines auf dem Rechner des Autors funktionierte.
### Aussprache
[jatka] in IPA-Lautschrift — auch als deutsches Wort aussprechbar.
---
## Globale Tastenkürzel
| Kürzel | Aktion |
|--------|--------|
| Strg+F | Filtern (Rechte, Log) oder Suchen |
| Strg+Alt+F | In Listen suchen |
| F3 | Weiter suchen |
| Strg+A | Alles auswählen |
| Strg+C | Kopieren oder ausgewählte Daten speichern |
| Strg+Alt+A | Spalten automatisch anpassen |
| F2 | Umbenennen |
| F5 | Tab aktualisieren |
| NUM + | Ausgewählte Checkbox-Elemente aktivieren |
| NUM - | Ausgewählte Checkbox-Elemente deaktivieren |
| Strg+Leertaste | Parameterwert auswählen (Konsole) |
| Strg+E | Ausgewählten Text escapen (Konsole) |
| Strg+S | Diagramm als Bild speichern |
---
## Ressourcen
- **Website:** https://yat.qa/
- **Download:** https://dl.yat.qa/stable/
- **Funktionen:** https://yat.qa/funktionen/
- **Anleitung:** https://yat.qa/manual/ (nur Englisch)
- **Changelog:** https://yat.qa/changelog/ (nur Englisch)
- **FAQ:** https://yat.qa/haeufige-fragen/
- **Support:** https://yat.qa/unterstuetzung/
- **Ressourcen:** https://yat.qa/ressourcen/
- **Über:** https://yat.qa/ueber/
---
## Übersetzung
YaTQAs Originalsprache ist Deutsch. Die Übersetzung erfolgt mit OmegaT und XLIFF-Dateien. Den Autor vorher kontaktieren. Das Übersetzungssystem verwendet:
- `%s` — Zeichenketten-Platzhalter
- `%d` — Dezimalzahl-Platzhalter
- `&` — Tastenkürzel
- `&&` — Tatsächliches Kaufmanns-Und
- `|` — Senkrechter Strich (Hinweistext-Trennzeichen)
- `\r\n` — Neue Zeile
- `\t` — Tabulator