Salta ai contenuti
Octoboard Documentazione

Browser tramite UU Remote

Apri Octoboard in un browser su un altro computer attraverso il port mapping di UU Remote, l’app di controllo remoto di NetEase, senza SSH né desktop remoto. L’host è il computer su cui gira Octoboard; l’accesso SSH (Login remoto su macOS) può restare disattivato e non serve nessuna sessione di desktop remoto. L’interfaccia di UU Remote è in cinese, quindi questa guida riporta le sue etichette cinesi accanto a quelle italiane.

Questa guida apre Octoboard in un browser sul tuo computer. È più nitido e reattivo del desktop remoto, ma richiede più passaggi. Se non ti dispiacciono un po’ di ritardo e di sfocatura, usa semplicemente il desktop remoto di UU Remote per lavorare direttamente sull’host.

Non sai se è la strada giusta per te? Vedi Scegli come connetterti.

Browser sul tuo computer → 127.0.0.1 sul tuo computer ⟷ UU Remote ⟷ 127.0.0.1 sull’host → Octoboard

Sei alle prime armi?
  • 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.
  • Port mapping (端口映射): una funzione di UU Remote che fa comparire una porta dell’host come una porta sul tuo computer.
  • socat: un piccolo programma gratuito che passa una connessione da un posto a un altro. Un host Mac ne ha bisogno come relay.
  • Terminale: la finestra in cui digiti i comandi: Terminale su macOS, PowerShell su Windows.

Il port mapping di UU Remote fa comparire Octoboard dell’host sul tuo computer a 127.0.0.1, che è l’unico indirizzo a cui Octoboard accetta un browser.

  • Entrambi i computer sono un Mac o un PC Windows. UU Remote non ha il port mapping per Linux; raggiungi invece un server Linux tramite Tailscale o SSH.
  • Entrambi hanno UU Remote installato e hanno effettuato l’accesso allo stesso account, alla versione 4.21.0 o successiva su Windows e 4.32.0 o successiva su macOS. Il port mapping funziona solo per TCP, che è tutto ciò che serve a Octoboard. Al momento della stesura, UU Remote elenca il port mapping tra le funzioni gratuite; in caso di dubbi, controlla i suoi piani attuali.
  • L’host compare in I miei dispositivi (我的设备) in UU Remote sul computer da cui navigherai.
  • Un host Mac richiede anche Homebrew, per installare socat qui sotto.
  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. Crea una porta su 127.0.0.1 dell’host che porti a Octoboard. Questa porta è la porta dell’host nei passaggi seguenti.

    Un Mac serve il browser in un modo che UU Remote non può mappare, quindi serve socat come relay. Installalo in Terminale:

    Terminal window
    brew install socat

    Poi esegui questo 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.

  1. In UU Remote, apri l’host da I miei dispositivi (我的设备), scegli Altro (更多) sulla sua scheda e poi Port mapping (端口映射), e aggiungi una mappatura:

    CampoValore
    Nome (名称)Octoboard
    Porta locale (本地端口)3369
    Indirizzo di destinazione (目标地址)127.0.0.1
    Porta di destinazione (目标端口)la porta dell’host

    Salvala e attivala, poi aspetta che risulti connessa. Se 3369 è occupata su questo computer, scegli un’altra porta locale e cambiala anche nell’indirizzo del browser.

  2. Controlla che solo questo computer possa usare la mappatura. Apri Terminale (macOS) o PowerShell (Windows) su questo computer ed esegui:

    Terminal window
    lsof -nP -iTCP:3369 -sTCP:LISTEN

    Dovresti vedere una riga che contiene 127.0.0.1:3369 e LISTEN.

    Se al suo posto vedi *:3369 o 0.0.0.0:3369, elimina la mappatura: altri dispositivi della tua rete potrebbero raggiungere Octoboard.

  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 mappatura risulta connessa, ma la pagina non si carica: su un host Mac, la finestra di socat è stata chiusa o il suo comando si è fermato; oppure Consenti accesso remoto è disattivato, oppure Octoboard non è in esecuzione sull’host.
  • La mappatura non si salva o non si connette: la porta locale potrebbe essere occupata su questo computer. Scegline un’altra e cambiala anche nell’indirizzo del browser.
  • La pagina è rifiutata o vuota: controlla di aver aperto l’indirizzo a 127.0.0.1.
  • Sul computer da cui hai navigato: disattiva la mappatura nel pannello del port mapping di UU Remote, oppure eliminala. Anche chiudere il pannello o disconnettersi la ferma.
  • Su un host Mac: ferma socat con Ctrl+C.
  • Sull’host, 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. 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. Sull’host ascolta solo su 127.0.0.1; può raggiungerlo anche chiunque possa usare il tuo account UU Remote per mappare porte verso l’host, quindi proteggi bene quell’account.
  • 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 la mappatura o socat 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.