Configurazione del connettore

PrerequisitiCopia il link alla sezione

• Un server Linux amd64 o arm64 con accesso root.
• systemd 247 o successivo, curl e sha256sum.
• Un servizio HTTP o HTTPS locale.
• Accesso HTTPS in uscita all’host della dashboard e alla porta UDP o TCP 443 di waf-ingress.loclix.network.

Il connettore installato viene eseguito senza privilegi root e non richiede porte pubbliche in ingresso.

Creazione del connettoreCopia il link alla sezione

1. Apri Tunnels nell’account.
2. Seleziona Add tunnel.
3. Inserisci un nome per il server.
4. Seleziona Create tunnel.

Si apre Install connector. Puoi riaprirlo accanto alla mappa delle connessioni.

InstallazioneCopia il link alla sezione

1. Copia Install command.
2. Eseguilo sul server Linux.
3. Seleziona Continue to activation.

Usa il comando fornito dalla dashboard. Il programma di installazione scarica il binario adatto e installa il servizio systemd. L’installazione da sola non attiva il connettore.

Buffer UDPCopia il link alla sezione

Dalla versione 0.19.0, il programma di installazione imposta i limiti dei buffer UDP di ricezione e invio dell’host ad almeno 7.500.000 byte, conservando eventuali valori superiori. Salva net.core.rmem_max e net.core.wmem_max in /etc/sysctl.d/90-loclix-connector.conf per mantenerli dopo i riavvii.

Se l’installazione segnala di non poter modificare queste impostazioni, configurale sull’host che esegue il container. Buffer più piccoli possono limitare la velocità di QUIC, ma non impediscono la connessione. Altri file sysctl applicati più tardi all’avvio possono sovrascrivere questi valori.

Su un server esistente, esegui una volta il comando di installazione attuale per applicare le impostazioni dei buffer e installare il comando di riavvio. I token, le istanze e le preferenze di aggiornamento vengono conservati. Gli aggiornamenti automatici del connettore non modificano queste impostazioni dell’host.

Riavvio del connettoreCopia il link alla sezione

Per riavviare il connettore installato:

sudo loclix-connector restart

Se sono installati più connettori, il comando chiede di selezionarne uno. In uno script, specifica l’istanza oppure riavviale tutte:

sudo loclix-connector restart --instance ACCOUNT-ID.TUNNEL-ID
sudo loclix-connector restart --all

L’elenco usa i nomi dei servizi della configurazione locale iniziale, che possono differire dalle modifiche successive nella dashboard. Il riavvio interrompe le richieste e le connessioni WebSocket attive.

AttivazioneCopia il link alla sezione

1. Inserisci un Service name, ad esempio web.
2. Inserisci il relativo Local address, ad esempio http://127.0.0.1:8080.
3. Seleziona Add service per aggiungere altre applicazioni.
4. Seleziona Generate activation command.
5. Copia Activation command ed eseguilo sullo stesso server.

Il comando contiene un codice monouso valido per dieci minuti. Non condividerlo. Generare un nuovo codice invalida quello precedente non ancora utilizzato.

L’attivazione salva configurazione e credenziale, poi avvia il connettore. Attivare un connettore esistente sostituisce il suo token e disconnette le repliche che usano quello precedente. Consulta credenziali e repliche prima di farlo su un servizio in uso.

Ogni connettore supporta fino a 64 servizi con nomi univoci. Ad esempio, un comando generato può contenere:

--service 'web=http://127.0.0.1:8080' --service 'api=http://127.0.0.1:3000'

Queste sono opzioni, non un comando autonomo. Usa il comando completo fornito dalla procedura.

Dalla versione 0.19.0, i connettori comunicano gli indirizzi dei servizi alla dashboard. Usa Edit tunnel per modificarli dopo l’attivazione; consulta Servizi locali.

Se riapri l’attivazione, inserisci di nuovo gli indirizzi per generare un comando sostitutivo. L’attivazione aggiunge o sostituisce le associazioni fornite. Rimuovere una riga dal modulo non elimina un servizio già salvato sul server.

Stato della connessioneCopia il link alla sezione

Controlla la scheda del tunnel in Connection map. Si aggiorna circa ogni cinque secondi: una nuova connessione può richiedere qualche istante per comparire.

Il connettore può collegarsi prima della pubblicazione di un sito. I visitatori possono usare un nuovo hostname solo dopo il completamento della configurazione DNS e del certificato.

Per controllare il servizio sul server, sostituisci gli ID seguenti con quelli della tua configurazione:

sudo systemctl status loclix-connector@ACCOUNT-ID.TUNNEL-ID.service
sudo journalctl -u loclix-connector@ACCOUNT-ID.TUNNEL-ID.service

PubblicazioneCopia il link alla sezione

Segui Route pubblicate per collegare un nuovo hostname o un percorso di un sito esistente al servizio. Aggiungere una route non richiede un nuovo comando di attivazione.

Traffico localeCopia il link alla sezione

La connessione tra il connettore e Loclix è cifrata. Per il tratto finale verso l’applicazione, usa un indirizzo locale HTTP o HTTPS. HTTPS richiede un certificato attendibile per l’hostname dell’indirizzo.

Il connettore conserva l’header Host pubblico, il percorso e la stringa di query. Configura l’applicazione perché accetti l’hostname pubblicato.

ErroriCopia il link alla sezione

Se il codice di attivazione è scaduto o è già stato usato, genera un nuovo comando. Se l’attivazione riesce ma il server non può salvare i file, risolvi l’errore relativo ai file e genera un nuovo comando.

Consulta Problemi dei tunnel per gli errori di connessione e dei servizi.

Configurazione manualeCopia il link alla sezione

Puoi avviare il connettore anche con --config e --token-file. La configurazione contiene control, account_id, tunnel_id e una mappa services. Ogni indirizzo deve essere un’origine HTTP o HTTPS senza percorso, query, frammento o credenziali incorporate. Le destinazioni gestite dalla dashboard prevalgono su questa mappa locale, anche dopo un riavvio.

Conserva i file di configurazione e token con permessi 0600. I servizi installati li salvano in /etc/loclix-connector/ACCOUNT-ID.TUNNEL-ID/.

Usa l’API Tunnel per la gestione manuale delle credenziali. Gli aggiornamenti automatici sono abilitati per impostazione predefinita; consulta Aggiornamenti del connettore per modificare questa preferenza.