Problemi dei tunnel

Avviso di configurazioneCopia il link alla sezione

Se la dashboard indica che la configurazione dei tunnel non è disponibile, contatta l’assistenza Loclix riportando il messaggio. Prima di provare un hostname pubblicato, verifica che il sito abbia completato la configurazione DNS e del certificato.

Nessuna connessione attivaCopia il link alla sezione

1. Controlla i log del servizio con journalctl -u loclix-connector@ACCOUNT-ID.TUNNEL-ID.service.
2. Controlla gli ID dell’account e del tunnel in connector.json.
3. Verifica che il file del token sia leggibile solo dal proprietario.
4. Consenti HTTPS in uscita verso l’host della dashboard.
5. Consenti la porta UDP e TCP 443 in uscita verso waf-ingress.loclix.network.

Un proxy di rete che sostituisce il certificato di ingresso impedisce al connettore di verificare Loclix. Consenti il passaggio della connessione TLS senza intercettazione.

Errori nei permessi delle credenzialiCopia il link alla sezione

I connettori meno recenti possono mostrare Tunnel token file requires mode 0600 or stricter quando leggono una credenziale systemd. La versione 0.18.5 corregge il controllo dei permessi per le liste di controllo degli accessi di systemd.

Abilita gli aggiornamenti automatici ed esegui il controllo:

sudo systemctl start loclix-connector-update@ACCOUNT-ID.TUNNEL-ID.service

Mantieni i file sorgente delle credenziali in /etc/loclix-connector/ con permessi 0600. Non modificare i permessi delle credenziali temporanee di systemd. Questo aggiornamento non richiede un nuovo codice di attivazione.

Avviso sui buffer UDPCopia il link alla sezione

Un avviso sul buffer di ricezione può limitare la velocità di QUIC senza impedire la connessione. Esegui il comando di installazione attuale per configurare i limiti di ricezione e invio dell’host. Nei container con restrizioni può essere necessario applicare le impostazioni sull’host.

Riavvia il connettore dopo aver modificato i limiti:

sudo loclix-connector restart

Modifiche alle destinazioni in attesaCopia il link alla sezione

I servizi gestiti dalla dashboard richiedono la versione 0.19.0 o successiva. Controlla l’indirizzo comunicato e la destinazione in attesa in Tunnels. Se mancano i dati, verifica che il connettore sia online e possa raggiungere l’host della dashboard.

Un indirizzo salvato diventa attivo solo dopo che il connettore lo ha applicato. Consulta Servizi locali per il comportamento delle repliche. Contatta l’assistenza se la dashboard segnala che la gestione dei servizi non è disponibile.

Connessioni HTTP/2Copia il link alla sezione

Il connettore usa QUIC quando riesce a stabilire una connessione UDP. In caso contrario, usa HTTP/2 cifrato su TCP. Una connessione HTTP/2 è una modalità di funzionamento supportata.

Controlla la porta UDP 443 in uscita se ti aspetti QUIC. Il connettore riprova QUIC alla successiva riconnessione.

Errori dei serviziCopia il link alla sezione

Le regole di sicurezza o Zero Trust possono rifiutare una richiesta prima che raggiunga il tunnel. Cerca il suo ID in Monitoraggio per esaminare la decisione.

Disconnessioni ripetuteCopia il link alla sezione

Controlla eventuali sostituzioni del token, sospensioni del connettore o riavvii di aggiornamento non riusciti. Una modifica alle credenziali riguarda tutte le repliche. Controlla anche la connessione all’host della dashboard: l’autorizzazione scade dopo 60 secondi senza rinnovo.

Se il problema persiste, invia all’assistenza l’ID della richiesta e gli errori pertinenti dei log. Escludi token, comandi di attivazione e chiavi private.

Percorsi senza corrispondenzaCopia il link alla sezione

Un prefisso /admin non corrisponde a /administrator. Consulta la corrispondenza dei percorsi e verifica che la route sia abilitata. I percorsi senza corrispondenza usano le altre route di origine del sito.