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 que os passos extras
Seção intitulada “Por que os passos extras”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.
Antes de começar
Seção intitulada “Antes de começar”-
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 socatNão há nada a instalar: um host Windows já serve o navegador em uma porta de
127.0.0.1, e um computador Windows de onde você navega usa um comando integrado.Terminal window sudo apt install socatUse o gerenciador de pacotes da sua distribuição (
dnf,pacmane assim por diante) se não for oapt. -
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).
No host
Seção intitulada “No host”-
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.
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. Anote também o número em Porta 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.
Execute isto como o usuário com que o octoboardd é executado e copie o endereço que ele imprime, começando com
http://127.0.0.1:3369/. Ignore o comando SSH que ele imprime depois.Terminal window octoboardd address -
Inicie o retransmissor no host, que liga uma porta do
127.0.0.1do 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.Não há nada a executar: o próprio Octoboard escuta na porta do navegador, somente em
127.0.0.1. A porta do host é a Porta do navegador (3369, a menos que você a tenha alterado).Execute isto como o mesmo usuário, em um terminal ou em uma sessão do
tmuxque continue aberta. Ele escuta somente em127.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. -
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:3370Com o app do Tailscale da App Store, execute o comando como
/Applications/Tailscale.app/Contents/MacOS/Tailscaleno lugar detailscale. Com o app independente, instale antes o comando nas configurações dele, em CLI integration.No PowerShell ou no Prompt de Comando:
Terminal window tailscale serve --tcp=3369 tcp://127.0.0.1:3369Use a sua porta se você alterou a Porta do navegador.
Terminal window tailscale serve --tcp=3370 tcp://127.0.0.1:3370Se o Tailscale disser que você não tem permissão, deixe o seu usuário gerenciá-lo uma vez com
sudo tailscale set --operator="$USER"ou execute o comando comsudo.Para conferir, execute
tailscale serve statusem outra janela: ele deve listar a porta do host.
No computador de onde você vai navegar
Seção intitulada “No computador de onde você vai navegar”-
Encontre o host no app do Tailscale neste computador e anote o nome dele (como
my-mac) ou o endereço (um número como100.x.y.z). -
Inicie o retransmissor neste computador, que faz o host aparecer em
127.0.0.1:3369aqui. 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:3370Execute-o no Terminal e deixe a janela aberta.
Abra o PowerShell como administrador. No comando abaixo, substitua
<host IP>pelo endereço100.x.y.zdo host (este comando precisa do número; um nome não funciona) e<host port>pela porta do host.Terminal window netsh interface portproxy add v4tov4 listenaddress=127.0.0.1 listenport=3369 connectaddress=<host IP> connectport=<host port>Esse encaminhamento permanece, inclusive depois de reinicializações, até você excluí-lo (veja abaixo), então não há janela para manter aberta. Ele precisa do serviço IP Helper, que é executado por padrão.
-
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.
Se não funcionar
Seção intitulada “Se não funcionar”- 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 statusno 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ço100.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).
Desativar
Seção intitulada “Desativar”-
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 statusque nada mais está compartilhado; se a porta ainda estiver listada, remova-a comtailscale 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.
Segurança
Seção intitulada “Segurança”- 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.1e, 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 porta127.0.0.1. - Nunca o Funnel: o Tailscale Funnel publicaria a porta para a internet inteira.