Pular para o conteúdo
Octoboard Documentação

Navegador via UU Remote

Abra o Octoboard em um navegador em outro computador pelo mapeamento de portas do UU Remote, o app de controle remoto da NetEase, sem SSH nem área de trabalho remota. O host é o computador que executa o Octoboard; o login SSH (Login remoto no macOS) pode continuar desativado e não é preciso nenhuma sessão de área de trabalho remota. A interface do UU Remote está em chinês, por isso este guia mostra os rótulos em chinês ao lado do português.

Este guia abre o Octoboard em um navegador no seu próprio computador. Isso é mais nítido e rápido do que a área de trabalho remota, mas exige mais passos. Se você não se importa com um pouco de atraso e borrão, basta usar a área de trabalho remota do UU Remote para trabalhar diretamente no host.

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

Navegador no seu computador → 127.0.0.1 no seu computador ⟷ UU Remote ⟷ 127.0.0.1 no host → Octoboard

Novo por aqui?
  • 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.
  • Mapeamento de portas (端口映射): um recurso do UU Remote que faz uma porta do host aparecer como uma porta no seu próprio computador.
  • socat: um programa pequeno e gratuito que passa uma conexão de um lugar para outro. Um host Mac precisa dele como retransmissor.
  • Terminal: a janela em que você digita comandos: Terminal no macOS, PowerShell no Windows.

O mapeamento de portas do UU Remote faz o Octoboard do host aparecer no seu próprio computador em 127.0.0.1, o único endereço em que o Octoboard aceita um navegador.

  • Os dois computadores são um Mac ou um PC com Windows. O UU Remote não tem mapeamento de portas para Linux; para acessar um servidor Linux, use o Tailscale ou o SSH.
  • Os dois têm o UU Remote instalado e conectado à mesma conta, na versão 4.21.0 ou posterior no Windows e 4.32.0 ou posterior no macOS. O mapeamento de portas funciona apenas para TCP, que é tudo de que o Octoboard precisa. No momento da redação, o UU Remote lista o mapeamento de portas entre os recursos gratuitos; confira os planos atuais em caso de dúvida.
  • O host aparece em Meus dispositivos (我的设备) no UU Remote do computador de onde você vai navegar.
  • Um host Mac também precisa do Homebrew, para instalar o socat abaixo.
  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. Crie uma porta no 127.0.0.1 do host que leve ao Octoboard. Essa porta é a porta do host nos passos abaixo.

    Um Mac serve o navegador de um jeito que o UU Remote não consegue mapear, por isso ele precisa do socat como retransmissor. Instale-o no Terminal:

    Terminal window
    brew install socat

    Depois execute isto 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.

  1. No UU Remote, abra o host em Meus dispositivos (我的设备), escolha Mais (更多) no cartão dele e depois Mapeamento de portas (端口映射), e adicione um mapeamento:

    CampoValor
    Nome (名称)Octoboard
    Porta local (本地端口)3369
    Endereço de destino (目标地址)127.0.0.1
    Porta de destino (目标端口)a porta do host

    Salve e ative-o e espere até ele aparecer como conectado. Se a 3369 estiver ocupada neste computador, escolha outra porta local e altere-a também no endereço do navegador.

  2. Confira se somente este computador pode usar o mapeamento. Abra o Terminal (macOS) ou o PowerShell (Windows) neste computador e execute:

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

    Você deve ver uma linha que contém 127.0.0.1:3369 e LISTEN.

    Se você vir *:3369 ou 0.0.0.0:3369 no lugar, exclua o mapeamento: outros dispositivos na sua rede poderiam alcançar o Octoboard.

  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.

  • O mapeamento aparece como conectado, mas a página não carrega: em um host Mac, a janela do socat foi fechada ou o comando dela parou; ou Permitir acesso remoto está desativado, ou o Octoboard não está em execução no host.
  • O mapeamento não salva nem conecta: a porta local pode estar ocupada neste computador. Escolha outra e 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.
  • No computador de onde você navegou: desative o mapeamento no painel de mapeamento de portas do UU Remote ou exclua-o. Fechar o painel ou se desconectar também o interrompe.
  • Em um host Mac: pare o socat com Ctrl+C.
  • No host, 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. 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. No host, ele escuta somente em 127.0.0.1; quem puder usar a sua conta do UU Remote para mapear portas para o host também consegue alcançá-lo, então mantenha essa conta segura.
  • 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 o mapeamento ou o socat não está em execução, pode tomar a porta 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.