Salta ai contenuti
Octoboard Documentazione

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.

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.

  • 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 socat
  • 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).

  1. 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.

  2. Avvia il relay sull’host, che collega una porta di 127.0.0.1 dell’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.

  3. 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:3370

    Con l’app Tailscale dell’App Store, esegui il comando come /Applications/Tailscale.app/Contents/MacOS/Tailscale al posto di tailscale. Con l’app standalone, installa prima il comando dalle sue impostazioni, in CLI integration.

    Per verificare, esegui tailscale serve status in un’altra finestra: dovrebbe elencare la porta dell’host.

  1. Trova l’host nell’app Tailscale su questo computer e annota il suo nome (come my-mac) o il suo indirizzo (un numero come 100.x.y.z).

  2. Avvia il relay su questo computer, che fa comparire l’host a 127.0.0.1:3369 qui. 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:3370

    Eseguilo in Terminale e lascia aperta la finestra.

  3. 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.

  • 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 status sull’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 indirizzo 100.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).
  • 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 status che non sia più condiviso nulla; se la porta è ancora elencata, rimuovila con tailscale 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.

  • 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.1 e, 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 porta 127.0.0.1.
  • Mai Funnel: Tailscale Funnel pubblicherebbe la porta su tutto internet.