Il modo attuale e pulito per usare Twingate con CasaOS consiste nell'eseguire un Twingate Connector come container Docker sull'host CasaOS o su un'altra macchina nella stessa LAN. Il Connector stabilisce connessioni in uscita verso Twingate, quindi non è necessario configurare il port forwarding per la dashboard di CasaOS.
Il tutorial del forum del 2023 è precedente all'attuale modello Docker Compose di Twingate. Usa i token correnti del Connector e le variabili Compose ufficiali, invece di copiare alla cieca un vecchio pacchetto con installazione in un clic.
Crea una rete remota e un Connector
Nella Console di amministrazione di Twingate, crea una rete remota e un Connector. Twingate genera un token di accesso e un token di aggiornamento univoci per quel Connector.
Usa il modello Docker Compose attuale
L'attuale guida Docker Compose di Twingate documenta queste variabili obbligatorie:
services:
twingate-connector:
image: twingate/connector:latest
restart: always
environment:
- TWINGATE_NETWORK=YOUR_TENANT
- TWINGATE_ACCESS_TOKEN=YOUR_ACCESS_TOKEN
- TWINGATE_REFRESH_TOKEN=YOUR_REFRESH_TOKEN
Tieni i token lontani dagli screenshot pubblici
I token di accesso e di aggiornamento autenticano in modo univoco il Connector. Conservali nella configurazione dell'app CasaOS o in un file di ambiente che non venga salvato in Git né pubblicato.
Aggiungi CasaOS come risorsa Twingate
Nella Console di amministrazione di Twingate, definisci l'indirizzo IP LAN o il nome host di CasaOS e la porta web come risorsa. Concedi l'accesso solo agli utenti o ai gruppi che ne hanno bisogno.
Networking bridge o host
Twingate indica la modalità bridge come impostazione predefinita, mentre la modalità host può essere utile per il networking peer-to-peer locale. Inizia con l'impostazione predefinita ufficiale, a meno che tu non abbia un motivo specifico per condividere lo stack di rete dell'host.
Non è necessario configurare il port forwarding sul router
Il Connector si trova dietro il firewall e stabilisce la connettività in uscita. Non aprire la porta di amministrazione di CasaOS su Internet solo perché vuoi accedere da remoto.
Installa il client Twingate sul dispositivo remoto
Il Connector viene eseguito all'interno della rete domestica, mentre il client Twingate viene eseguito sul laptop o sul telefono che usi da remoto. Entrambi si registrano sulla rete Twingate prima che il traffico raggiunga la risorsa privata.
Verifica l'accesso prima di aggiungere altre risorse
Prova prima la dashboard di CasaOS, quindi aggiungi singolarmente le altre app NAS. In questo modo la politica di accesso resta esplicita, senza esporre inutilmente un'intera sottorete.
La guida all'accesso remoto privato offre un contesto più ampio sui server domestici.
Controlla lo stato del Connector prima di testare CasaOS
docker ps | grep twingate
docker logs --tail 100 twingate-connectorIl Connector dovrebbe registrarsi correttamente e rimanere in esecuzione. Se si riavvia ripetutamente, verifica il nome del tenant e i token prima di eseguire il debug della risorsa CasaOS.
Usa la definizione di risorsa più restrittiva
Se ti serve solo la dashboard di CasaOS, definisci l'IP esatto di CasaOS e la porta web invece di esporre l'intera sottorete LAN. Aggiungi altre app come risorse separate quando ne hai effettivamente bisogno.
Pianifica gli aggiornamenti del Connector
Twingate pubblica gli aggiornamenti dei container indipendentemente da CasaOS. Recupera periodicamente l'immagine corrente del Connector e riavviala durante una finestra di manutenzione, quindi verifica che l'accesso remoto funzioni ancora.
Domande frequenti
Devo aprire le porte di CasaOS sul router?
No. I Twingate Connector sono progettati per essere eseguiti dietro il firewall e stabilire la connettività in uscita.
Da dove provengono i token Twingate?
La Console di amministrazione li genera quando distribuisci un Connector.
Devo usare il networking host?
Solo quando è necessario per la tua topologia o per il comportamento peer-to-peer; bridge è l'impostazione predefinita.
Un Connector può esporre più risorse oltre a CasaOS?
Sì, ma definisci attentamente risorse e autorizzazioni, invece di concedere per impostazione predefinita un accesso esteso alla sottorete.
