Pular para o conteúdo
Octoboard Documentação

Navegador via Tailscale

Abra o Octoboard em um navegador em outro computador pela sua própria rede Tailscale, sem SSH nem área de trabalho remota. O host é o computador que executa o Octoboard: um Mac, um PC com Windows ou um servidor Linux que executa o octoboardd. O login SSH (Login remoto no macOS) pode continuar desativado.

Não tem certeza de que esta é a melhor forma para você? Veja Escolha como se conectar.

Navegador no seu computador → retransmissor no seu computador (127.0.0.1) ⟷ Tailscale ⟷ retransmissor no host (127.0.0.1) → Octoboard

Novo por aqui?
  • Tailscale: um serviço que liga os seus dispositivos em uma rede privada pela internet, onde quer que estejam. Você faz login nele com a sua própria conta.
  • Tailnet: a sua rede Tailscale: os dispositivos conectados à sua conta do Tailscale.
  • 127.0.0.1 (loopback): um endereço que sempre significa “este mesmo computador”.
  • Porta: um número que escolhe um programa em um computador, como o número de uma porta de entrada. 127.0.0.1:3369 é a porta 3369 neste computador.
  • socat: um programa pequeno e gratuito que passa uma conexão de um lugar para outro. Aqui ele é o retransmissor.
  • Tailscale Serve: um comando do Tailscale que compartilha uma porta somente com a sua tailnet. O parente dele, o Tailscale Funnel, a compartilharia com a internet inteira; nunca o use aqui.
  • Terminal: a janela em que você digita comandos: Terminal no macOS, PowerShell no Windows.

Por segurança, o Octoboard só aceita um navegador que o abra em 127.0.0.1, um endereço que sempre significa “este mesmo computador” (também chamado de loopback). Por isso, você não pode simplesmente digitar no navegador o endereço do host no Tailscale. Em vez disso, você executa um pequeno programa retransmissor em cada computador: no seu, ele faz o host parecer local em 127.0.0.1; no host, ele entrega a conexão ao Octoboard. O Tailscale transporta o tráfego entre os dois.

  • Tailscale nos dois computadores, conectado à mesma tailnet. Use uma tailnet que tenha apenas os seus próprios dispositivos: todo dispositivo que ela deixa alcançar o host pode alcançar a porta que você compartilha.

  • socat em cada computador que seja um Mac ou execute Linux. Um computador com Windows não precisa dele.

    Instale antes o Homebrew se você não o tiver (o macOS não inclui nenhuma ferramenta que faça esse trabalho) e depois execute isto no Terminal:

    Terminal window
    brew install socat
  • Duas ou três janelas deixadas abertas enquanto você trabalha: o retransmissor e o Tailscale Serve no host (exceto o retransmissor no Windows) e o retransmissor no seu computador (exceto no Windows).

  1. Obtenha o endereço do navegador, que contém a chave que faz o login do navegador.

    No Octoboard, abra Ajustes › Acesso remoto, ative Permitir acesso remoto e selecione Permitir para confirmar. Duas guias aparecem abaixo do interruptor. Na guia Navegador, selecione Copiar endereço em Etapa 2: endereço do navegador.

    Leve o endereço ao outro computador de um jeito que só você possa ler, como uma nota para si mesmo: ele funciona como uma senha.

    Ignore Etapa 1: encaminhamento SSH. As configurações do app mencionam o SSH em vários lugares; você pode ignorar isso aqui, pois este guia usa apenas o endereço do navegador.

    Mantenha o Octoboard em execução: se você o fechar, o acesso remoto para.

  2. Inicie o retransmissor no host, que liga uma porta do 127.0.0.1 do host ao Octoboard. Essa porta é a porta do host nos passos abaixo.

    Execute isto no Terminal e deixe a janela aberta. Ele escuta somente em 127.0.0.1:3370.

    Terminal window
    socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"

    A porta do host é 3370.

  3. Compartilhe a porta do host com a sua tailnet usando o Tailscale Serve e deixe a janela aberta. Nunca use o Tailscale Funnel, que a colocaria na internet pública.

    Terminal window
    tailscale serve --tcp=3370 tcp://127.0.0.1:3370

    Com o app do Tailscale da App Store, execute o comando como /Applications/Tailscale.app/Contents/MacOS/Tailscale no lugar de tailscale. Com o app independente, instale antes o comando nas configurações dele, em CLI integration.

    Para conferir, execute tailscale serve status em outra janela: ele deve listar a porta do host.

  1. Encontre o host no app do Tailscale neste computador e anote o nome dele (como my-mac) ou o endereço (um número como 100.x.y.z).

  2. Inicie o retransmissor neste computador, que faz o host aparecer em 127.0.0.1:3369 aqui. Se a porta 3369 já estiver ocupada neste computador, escolha outra porta e altere-a também no endereço do navegador.

    No comando abaixo, substitua <host> pelo nome ou endereço do host e <host port> pela porta do host.

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:<host>:<host port>

    Por exemplo, para um host Mac chamado my-mac:

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:my-mac:3370

    Execute-o no Terminal e deixe a janela aberta.

  3. Abra o endereço do navegador que você copiou no host. Ele começa com http://127.0.0.1:3369/.

Você saberá que funcionou quando o Octoboard abrir na aba do navegador sem pedir que você faça login.

  • A página não carrega: uma das janelas foi fechada ou o comando dela parou. Verifique se os retransmissores e o Tailscale Serve ainda estão em execução e se tailscale serve status no host lista a porta do host.
  • O socat diz “Address already in use”: essa porta está ocupada nesse computador. Escolha outra porta; no seu computador, altere-a também no endereço do navegador.
  • A página é recusada ou fica em branco: verifique se você abriu o endereço em 127.0.0.1, e não pelo nome do host no Tailscale nem pelo endereço 100.x.y.z.
  • O retransmissor no host imprime “Connection refused” ou “No such file or directory” quando você abre a página: Permitir acesso remoto está desativado ou o Octoboard não está em execução no host (no Linux, o octoboardd não está em execução).
  • No computador de onde você navegou: pare o socat com Ctrl+C ou, no Windows, exclua o encaminhamento no PowerShell executado como administrador:

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • No host: pare o comando do Tailscale Serve e o socat com Ctrl+C. Confira com tailscale serve status que nada mais está compartilhado; se a porta ainda estiver listada, remova-a com tailscale serve --tcp=3370 off (no Windows, tailscale serve --tcp=3369 off).

  • Em um host Mac ou Windows, desative Permitir acesso remoto quando não precisar mais dele. Isso fecha a entrada do navegador e desconecta todas as páginas abertas com a chave.

  • Se o endereço puder ter vazado, dê a ele uma nova chave com Renovar chave na guia Navegador ou, no Linux, com octoboardd address --rotate. As páginas abertas com o endereço antigo são desconectadas.

  • O endereço é a senha: a chave dele dá controle total do Octoboard no host, inclusive para executar qualquer comando. Ela vale até você renová-la. Ela fica no histórico e nos favoritos do navegador e é sincronizada com os seus outros dispositivos se a sincronização do navegador estiver ativada.
  • Quem pode alcançá-lo: qualquer pessoa que alcance a porta do host e tenha a chave. Os retransmissores escutam somente em 127.0.0.1, então outros dispositivos na rede do host ou na sua rede local não conseguem alcançá-los; o Tailscale Serve torna a porta do host acessível somente pela sua tailnet, dentro do que as regras de acesso dela permitem.
  • Somente em computadores em que ninguém mais faz login: outra conta de usuário no host ou no seu computador pode se conectar a essas portas 127.0.0.1 e, enquanto um retransmissor não está em execução, pode tomar a porta dele e receber a chave quando o seu navegador se reconectar. Conectar por SSH não tem essa fraqueza em um host Mac ou Linux, nem no seu próprio computador quando você usa o app para desktop. No navegador, o seu computador ainda a tem, porque lá o encaminhamento SSH também escuta em uma porta 127.0.0.1.
  • Nunca o Funnel: o Tailscale Funnel publicaria a porta para a internet inteira.