Intermedio 20 min

Query Server & API TeamSpeak 3

Abilitare la query SSH/HTTP, password di query sicure, stati dei bot e integrazioni web con TS3.

#Query#API#Bot

Pronto per iniziare il tuo servizio? Controlla le offerte e ordina online.

Query Server & API TeamSpeak 3

Il ServerQuery TeamSpeak 3 è un'interfaccia di testo TCP (porta 10011) per automatizzare l'amministrazione, lo stato dei bot, i pannelli web e le integrazioni Discord. Questa guida copre l'attivazione, la sicurezza, i comandi essenziali e le migliori pratiche sul server ospitato.

Cos'è ServerQuery?

Protocollo di riga di comando: connessione TCP, login, comandi di esecuzione (clientlist, channelcreate, sendtextmessage...). Utilizzato da TS3StatusBot, Auron, pannelli PHP, ecc.

Prerequisito

TS3 online, start
Porta 10011 accessibile (IP limitato consigliato)

Abilitare e proteggere la query

Identificatori di query predefiniti visibili alla prima configurazione, cambiali immediatamente
Client TS3 → Strumenti → Opzioni → Applicazione → Query, o file query_ip_whitelist.txt
Aggiungi solo IP dei tuoi bot/pannelli alla whitelist
Creare un account di query dedicato da bot con autorizzazioni minime
Disattivare la domanda di login Guest se esposto pubblicamente

Una query aperta su Internet senza whitelist è un possibile gateway, forza bruta e controllo server.

Prima connessione di query (esempio)

telnet IP 10011
login client_login_name=admin client_login_password=VOTRE_MDP
use port=9987
clientlist

Sostituire da TS3 Query library in Python/Node per la produzione di bot.

Ordini utili

clientlist, giocatori collegati
channelcreate channel_name=Salon password=xxx
sendtextmessage targetmode=3 msg=Annonce serveur
banadd ip=xxx.xxx.xxx.xxx time=3600
serversnapshotcreate, backup automatizzato

Bots & integrazioni

Web Status, visualizza il numero connesso sul sito
Scord bridge, sincronizzare la presenza o la creazione del canale
Anti-AFK / moderation, kick auto secondo le regole

Query HTTP (plugin)

TS3 nativo è il testo TCP. Alcuni host o wrapper espongono HTTP, controllano il documento del tuo bot. In caso contrario, eseguire il bot su VPS con l'accesso a Query whitelist.

Risoluzione dei problemi

error id=520 login non valido, identificatori di query errati
Connecting rifiutato 10011, firewall, TS3 fermato, IP sbagliato
Flood ban query, troppe domande, chiamate bot spaziali

Cfr. anche: permissions, security.