Come testare un server TURN: risponde, accetta il login e fa da relay?

Per testare un server TURN, controlla tre cose in ordine: che risponda sulla porta indicata, che accetti le tue credenziali e che i dati passino davvero dal suo relay. Un server può superare le prime due e far fallire comunque ogni chiamata, quindi la terza è quella che conta.
Questo articolo passa in rassegna ogni controllo con il nostro test del server TURN gratuito, spiega cosa significano i suoi errori e come risolverli, e mostra come fare gli stessi controlli a mano.
Cosa deve fare un server TURN che funziona
Un server TURN porta una chiamata quando due dispositivi non riescono a raggiungersi direttamente (i server STUN e TURN spiega perché succede). Per farlo ha tre compiti distinti:
- Rispondere. Qualcosa è in ascolto a quell’indirizzo, su quella porta e quel protocollo, e le reti nel mezzo lasciano passare il traffico.
- Farti entrare. Accetta il tuo nome utente e la tua credenziale, e dà al browser un indirizzo di relay.
- Fare da relay. I dati inviati a quell’indirizzo di relay arrivano al browser, e viceversa.
Molti controlli si fermano al secondo compito, e così si perde un guasto frequente. Il server risponde sulla porta principale, mentre il relay usa un ampio intervallo di altre porte, per impostazione predefinita da 49152 a 65535 su coturn. Se sono chiuse, il server distribuisce comunque un indirizzo e sembra in salute, ma le chiamate che passano da lì falliscono.
Testalo nel browser
- Apri il test del server TURN.
- Inserisci ogni indirizzo su una riga a sé, uno per ogni modo di accesso che offri:
turn:turn.example.com:3478?transport=udp
turn:turn.example.com:3478?transport=tcp
turns:turn.example.com:443?transport=tcp- Inserisci il nome utente e la credenziale. Con credenziali a tempo, creane prima una coppia nuova.
- Avvia il test.
Ogni indirizzo viene testato da solo, quindi una riga che fallisce lo dice da sé. Il tuo browser parla direttamente con il tuo server, e niente di ciò che scrivi arriva a noi.
Per verificare solo che un server sia raggiungibile, lascia vuoti entrambi i campi. Il server rifiuta un login non valido, e solo il server può rispondere così, il che dimostra che la porta è aperta.
Cosa significano i risultati
- È arrivato un indirizzo di relay e i dati sono passati. Il server funziona da questo browser e su questa rete. Il test mostra anche il tempo di andata e ritorno attraverso il relay.
- È arrivato un indirizzo di relay ma i dati non sono passati. Probabilmente le porte del relay sono chiuse nel firewall del server, oppure un server dietro NAT non ha impostato il proprio indirizzo pubblico. Alcuni server rifiutano anche di fare da relay verso il proprio indirizzo, e questo fa fallire il passaggio mentre le chiamate vere possono funzionare. Prima di cambiare qualcosa, prova una chiamata tra due reti diverse.
- Errore 401 o 441. Il server ha risposto e ha rifiutato il login. Il nome utente o la credenziale sono sbagliati, oppure quelli a tempo sono scaduti. Se fallisce anche una coppia nuova, controlla il segreto da cui vengono create e l’orologio del server.
- Errore 486. Questo utente ha già tanti relay quanti ne consente il server, spesso perché vecchie schede o chiamate riavviate hanno lasciato i propri. Si liberano quando quelle allocazioni terminano.
- Errore 701. Il browser non è riuscito a raggiungere il server a quell’indirizzo, su quella porta e con quel protocollo. Controlla il nome, la porta e i firewall su entrambi i lati. Chrome può anche segnalare 701 per un’interfaccia di rete mentre un’altra funziona, quindi conta solo se non arriva nessun indirizzo.
- Nessuna risposta. Non è tornato nulla prima che il test si arrendesse, il che di solito significa una porta sbagliata o un firewall che scarta il traffico.
- Il browser ha interrotto subito il controllo. Non ha mai interpellato il server. Può dipendere da un’impostazione del browser, da un’estensione o da una VPN, quindi riprova senza di esse o con un altro browser.
Non tutti i browser dicono a una pagina cosa ha risposto un server. Se una riga dice Non testato, esegui il test in Chrome o Edge su un computer.
Testa ogni modo di accesso
Una rete che blocca l’UDP può comunque consentire il TCP, e una molto rigida può consentire solo ciò che sembra traffico web sulla porta 443. Per questo un server TURN di solito offre più modi di accesso, e per questo ognuno ha bisogno del suo test.
Anche superare il test dalla tua scrivania dice poco sui tuoi utenti. Esegui il test dalle reti in cui si trovano loro: un telefono su una rete mobile, un hotel, un ufficio con un firewall rigido. Il test WebRTC mostra cosa consente ciascuna di queste reti, senza coinvolgere nessun tuo server.
Testalo a mano
Questo esegue il controllo del login nella console del browser, su qualsiasi pagina servita in HTTPS:
const pc = new RTCPeerConnection({
iceServers: [{
urls: 'turn:turn.example.com:3478?transport=udp',
username: 'your-username',
credential: 'your-credential',
}],
iceTransportPolicy: 'relay',
});
pc.onicecandidate = ({ candidate }) => {
if (candidate) console.log('Relay address:', candidate.address, candidate.port);
};
pc.onicecandidateerror = ({ errorCode, errorText }) => {
console.log('Error', errorCode, errorText);
};
pc.createDataChannel('test');
await pc.setLocalDescription();iceTransportPolicy: 'relay' fa usare al browser solo il server TURN, quindi l’unico tipo di candidato che può tornare è un indirizzo di relay. Come sopra, un indirizzo dimostra il login e non il relay in sé.
Su un server con coturn installato, il suo client invia dati anche attraverso il relay:
turnutils_uclient -u your-username -w your-credential -y -n 5 turn.example.comEseguilo da una macchina fuori dalla rete del server. Da dentro può riuscire dove fallirebbero i tuoi utenti.
Se preferisci non gestirne uno
Tutto questo vale per un server TURN tuo. Le chiamate su WordPlus Cloud usano i nostri relay, che girano in regioni in tutto il mondo, con ogni dispositivo che raggiunge il più vicino. I relay non hanno mai un costo a parte, come spiega quanto costano le videochiamate, e non c’è nulla da ospitare. La documentazione sulle chiamate mostra come li usa un’app.
Per vedere se una rete li raggiunge, premi Testa i nostri relay nel test del server TURN, oppure esegui il test di connessione, che controlla anche il resto del cloud.