Browser tramite Tailscale
Apri Octoboard in un browser su un altro computer attraverso la tua rete Tailscale, senza SSH né desktop remoto. L’host è il computer su cui gira Octoboard: un Mac, un PC Windows o un server Linux su cui gira octoboardd. L’accesso SSH (Login remoto su macOS) può restare disattivato.
Non sai se è la strada giusta per te? Vedi Scegli come connetterti.
Browser sul tuo computer → relay sul tuo computer (127.0.0.1) ⟷ Tailscale ⟷ relay sull’host (127.0.0.1) → Octoboard
Sei alle prime armi?
- Tailscale: un servizio che collega i tuoi dispositivi in una rete privata attraverso internet, ovunque si trovino. Accedi con il tuo account.
- Tailnet: la tua rete Tailscale: i dispositivi che hanno effettuato l’accesso al tuo account Tailscale.
- 127.0.0.1 (loopback): un indirizzo che significa sempre “questo stesso computer”.
- Porta: un numero che sceglie un programma su un computer, come il numero di una porta di casa.
127.0.0.1:3369è la porta 3369 su questo computer. - socat: un piccolo programma gratuito che passa una connessione da un posto a un altro. Qui fa da relay.
- Tailscale Serve: un comando di Tailscale che condivide una porta solo con la tua tailnet. Il suo cugino, Tailscale Funnel, la condividerebbe con tutto internet; non usarlo mai qui.
- Terminale: la finestra in cui digiti i comandi: Terminale su macOS, PowerShell su Windows.
Perché questi passaggi in più
Sezione intitolata “Perché questi passaggi in più”Per sicurezza, Octoboard accetta solo un browser che lo apre a 127.0.0.1, un indirizzo che significa sempre “questo stesso computer” (detto anche loopback). Quindi non basta digitare nel browser l’indirizzo Tailscale dell’host. Invece, esegui un piccolo programma relay su ciascun computer: sul tuo fa sembrare locale l’host a 127.0.0.1; sull’host passa la connessione a Octoboard. Tailscale trasporta il traffico tra i due.
Prima di iniziare
Sezione intitolata “Prima di iniziare”-
Tailscale su entrambi i computer, con l’accesso alla stessa tailnet. Usa una tailnet che contenga solo i tuoi dispositivi: ogni dispositivo che può raggiungere l’host può raggiungere la porta che condividi.
-
socat su ogni computer che è un Mac o su cui gira Linux. Un computer Windows non ne ha bisogno.
Installa prima Homebrew se non ce l’hai (macOS non include uno strumento adatto a questo compito), poi esegui questo in Terminale:
Terminal window brew install socatNon c’è nulla da installare: un host Windows serve già il browser su una porta di
127.0.0.1, e un computer Windows da cui navighi usa invece un comando integrato.Terminal window sudo apt install socatUsa il gestore di pacchetti della tua distribuzione (
dnf,pacmane così via) se non èapt. -
Due o tre finestre lasciate aperte mentre lavori: il relay e Tailscale Serve sull’host (tranne il relay su Windows) e il relay sul tuo computer (tranne su Windows).
Sull’host
Sezione intitolata “Sull’host”-
Ottieni l’indirizzo del browser, che contiene la chiave con cui il browser accede.
In Octoboard apri Impostazioni › Accesso remoto, attiva Consenti accesso remoto e seleziona Consenti per confermare. Sotto l’interruttore compaiono due schede. Nella scheda Browser, seleziona Copia indirizzo sotto Passaggio 2: indirizzo del browser.
Fai arrivare l’indirizzo all’altro computer in un modo che solo tu puoi leggere, come una nota per te: funziona come una password.
Salta Passaggio 1: inoltro SSH. Le impostazioni dell’app citano SSH in più punti; qui puoi ignorarli, perché questa guida usa solo l’indirizzo del browser.
Tieni Octoboard in esecuzione: se lo chiudi, l’accesso remoto si interrompe.
In Octoboard apri Impostazioni › Accesso remoto, attiva Consenti accesso remoto e seleziona Consenti per confermare. Sotto l’interruttore compaiono due schede. Nella scheda Browser, seleziona Copia indirizzo sotto Passaggio 2: indirizzo del browser. Annota anche il numero sotto Porta del browser.
Fai arrivare l’indirizzo all’altro computer in un modo che solo tu puoi leggere, come una nota per te: funziona come una password.
Salta Passaggio 1: inoltro SSH. Le impostazioni dell’app citano SSH in più punti; qui puoi ignorarli, perché questa guida usa solo l’indirizzo del browser.
Tieni Octoboard in esecuzione: se lo chiudi, l’accesso remoto si interrompe.
Esegui questo come l’utente con cui gira octoboardd e copia l’indirizzo che stampa, che inizia con
http://127.0.0.1:3369/. Ignora il comando SSH che stampa dopo.Terminal window octoboardd address -
Avvia il relay sull’host, che collega una porta di
127.0.0.1dell’host a Octoboard. Questa porta è la porta dell’host nei passaggi seguenti.Esegui questo in Terminale e lascia aperta la finestra. Ascolta solo su
127.0.0.1:3370.Terminal window socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"La porta dell’host è
3370.Non c’è nulla da eseguire: Octoboard stesso ascolta sulla porta del browser, solo su
127.0.0.1. La porta dell’host è la Porta del browser (3369 se non l’hai cambiata).Esegui questo come lo stesso utente, in un terminale o in una sessione
tmuxche resta aperta. Ascolta solo su127.0.0.1:3370.Terminal window socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"La porta dell’host è
3370. -
Condividi la porta dell’host con la tua tailnet con Tailscale Serve e lascia aperta la finestra. Non usare mai Tailscale Funnel, che la metterebbe su internet pubblico.
Terminal window tailscale serve --tcp=3370 tcp://127.0.0.1:3370Con l’app Tailscale dell’App Store, esegui il comando come
/Applications/Tailscale.app/Contents/MacOS/Tailscaleal posto ditailscale. Con l’app standalone, installa prima il comando dalle sue impostazioni, in CLI integration.In PowerShell o nel Prompt dei comandi:
Terminal window tailscale serve --tcp=3369 tcp://127.0.0.1:3369Usa la tua porta se hai cambiato Porta del browser.
Terminal window tailscale serve --tcp=3370 tcp://127.0.0.1:3370Se Tailscale dice che non hai i permessi, consenti una volta al tuo utente di gestirlo con
sudo tailscale set --operator="$USER", oppure esegui il comando consudo.Per verificare, esegui
tailscale serve statusin un’altra finestra: dovrebbe elencare la porta dell’host.
Sul computer da cui navigherai
Sezione intitolata “Sul computer da cui navigherai”-
Trova l’host nell’app Tailscale su questo computer e annota il suo nome (come
my-mac) o il suo indirizzo (un numero come100.x.y.z). -
Avvia il relay su questo computer, che fa comparire l’host a
127.0.0.1:3369qui. Se la porta 3369 è già occupata su questo computer, scegline un’altra e cambiala anche nell’indirizzo del browser.Nel comando qui sotto, sostituisci
<host>con il nome o l’indirizzo dell’host e<host port>con la porta dell’host.Terminal window socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:<host>:<host port>Per esempio, per un host Mac chiamato
my-mac:Terminal window socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:my-mac:3370Eseguilo in Terminale e lascia aperta la finestra.
Apri PowerShell come amministratore. Nel comando qui sotto, sostituisci
<host IP>con l’indirizzo100.x.y.zdell’host (questo comando richiede il numero; un nome non funziona) e<host port>con la porta dell’host.Terminal window netsh interface portproxy add v4tov4 listenaddress=127.0.0.1 listenport=3369 connectaddress=<host IP> connectport=<host port>Questo inoltro resta attivo, anche dopo i riavvii, finché non lo elimini (vedi sotto), quindi non c’è nessuna finestra da tenere aperta. Richiede il servizio IP Helper, che è in esecuzione per impostazione predefinita.
-
Apri l’indirizzo del browser che hai copiato sull’host. Inizia con
http://127.0.0.1:3369/.
Saprai che ha funzionato quando Octoboard si apre nella scheda del browser senza chiederti di accedere.
Se non funziona
Sezione intitolata “Se non funziona”- La pagina non si carica: una delle finestre è stata chiusa o il suo comando si è fermato. Controlla che i relay e Tailscale Serve siano ancora in esecuzione e che
tailscale serve statussull’host elenchi la porta dell’host. - socat dice “Address already in use”: quella porta è occupata su quel computer. Scegline un’altra; sul tuo computer, cambiala anche nell’indirizzo del browser.
- La pagina è rifiutata o vuota: controlla di aver aperto l’indirizzo a
127.0.0.1, non il nome Tailscale dell’host né il suo indirizzo100.x.y.z. - Il relay sull’host stampa “Connection refused” o “No such file or directory” quando apri la pagina: Consenti accesso remoto è disattivato, oppure Octoboard non è in esecuzione sull’host (su Linux, octoboardd non è in esecuzione).
Disattivarlo
Sezione intitolata “Disattivarlo”-
Sul computer da cui hai navigato: ferma socat con Ctrl+C, oppure su Windows elimina l’inoltro in PowerShell eseguito come amministratore:
Terminal window netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369 -
Sull’host: ferma il comando Tailscale Serve e socat con Ctrl+C. Controlla con
tailscale serve statusche non sia più condiviso nulla; se la porta è ancora elencata, rimuovila contailscale serve --tcp=3370 off(su Windows,tailscale serve --tcp=3369 off). -
Su un host Mac o Windows, disattiva Consenti accesso remoto quando non ti serve più. Questo chiude l’ingresso del browser e scollega tutte le pagine aperte con la chiave.
-
Se l’indirizzo potrebbe essere trapelato, dagli una nuova chiave con Rinnova chiave nella scheda Browser, oppure su Linux con
octoboardd address --rotate. Le pagine aperte con il vecchio indirizzo vengono scollegate.
Sicurezza
Sezione intitolata “Sicurezza”- L’indirizzo è la password: la sua chiave dà il controllo completo di Octoboard sull’host, compresa l’esecuzione di qualsiasi comando. Dura finché non la rinnovi. Resta nella cronologia e nei segnalibri del browser e si sincronizza con gli altri tuoi dispositivi se la sincronizzazione del browser è attiva.
- Chi può raggiungerlo: chiunque raggiunga la porta dell’host e abbia la chiave. I relay ascoltano solo su
127.0.0.1, quindi gli altri dispositivi nella rete dell’host o nella tua rete locale non possono raggiungerli; Tailscale Serve rende la porta dell’host raggiungibile solo dalla tua tailnet, entro i limiti delle sue regole di accesso. - Solo su computer a cui non accede nessun altro: un altro account utente sull’host o sul tuo computer può connettersi a queste porte
127.0.0.1e, mentre un relay non è in esecuzione, può prenderne la porta e ricevere la chiave quando il browser si riconnette. Connettersi tramite SSH non ha questo punto debole su un host Mac o Linux, e nemmeno il tuo computer se usi l’app desktop. In un browser il tuo computer ce l’ha ancora, perché lì anche l’inoltro SSH è in ascolto su una porta127.0.0.1. - Mai Funnel: Tailscale Funnel pubblicherebbe la porta su tutto internet.