Pular para o conteúdo
Octoboard Documentação

Conectar por SSH

Use o Octoboard em um servidor Linux ou em outro computador a partir deste computador, no app para desktop ou em um navegador, por SSH: uma conexão criptografada direto com essa máquina, sem retransmissor nem serviço na nuvem.

Não tem certeza de que esta é a melhor forma para você? Escolha como se conectar compara o SSH com as formas que usam só o navegador e não precisam de SSH.

App para desktop neste computador · Navegador por um encaminhamento SSH ⟷ SSH ⟷ Servidor Linux ou outro computador

Novo por aqui?
  • Host: a máquina em que o Octoboard é executado e que você quer acessar, um servidor Linux ou outro Mac ou PC com Windows.
  • Servidor: aqui, uma máquina Linux em que você faz login pela rede, em geral alugada, sem tela própria.
  • SSH: uma forma padrão e criptografada de fazer login em outra máquina e digitar comandos nela. Está incluído no macOS, no Windows e no Linux.
  • Terminal: a janela em que você digita comandos: Terminal no macOS, PowerShell no Windows.
  • Encaminhamento SSH: um comando SSH que faz algo do host aparecer no seu próprio computador, para que o navegador possa abri-lo ali.
  • Impressão digital (chave do host): um código curto que identifica o SSH de uma máquina. Conferir essa impressão uma vez garante que você chegou à máquina certa.
  • Arquivo de chave: um arquivo que faz o login no lugar de uma senha. Alguns provedores de servidor fornecem um.
  • Uma forma de fazer login no host por SSH. Em um servidor Linux, o provedor informa o endereço e o seu nome de usuário. Para verificar se funciona, abra o Terminal (macOS) ou o PowerShell (Windows) e execute o comando abaixo com o seu nome de usuário e o endereço do servidor. Na primeira vez, responda yes quando ele perguntar se deve confiar no servidor.

    Terminal window
    ssh <you>@<server>

    Se o host for um Mac ou um PC com Windows, você ativa o login SSH nas configurações do sistema dele; Usar outro computador como host mostra como.

  • Em um servidor Linux, o Octoboard instalado e iniciado nele. Instalação › Servidor Linux mostra como. O programa de servidor do Octoboard, o octoboardd, é o que o app chama de daemon.

  • O app Octoboard neste computador, para macOS ou Windows, a menos que você use apenas um navegador.

  1. Faça login no servidor por SSH como o usuário que executa o Octoboard, execute este comando e copie a linha que começa com octoboard+ssh://: os dados de conexão, que dizem ao app onde e como se conectar.

    Terminal window
    octoboardd connection

    Se este computador alcança o servidor por outro endereço ou outra porta SSH, adicione --host ou --ssh-port ao comando para imprimir os dados de conexão corretos.

    O QR code que ele também imprime contém a mesma linha. Nenhum app o lê ainda.

  2. No app Octoboard neste computador, abra Dispositivos remotos na barra à esquerda ou, no macOS, escolha Remoto › Dispositivos Remotos na barra de menus. No Windows, você também pode escolher Dispositivos remotos no menu de sistema da janela ou na lista de atalhos do ícone da barra de tarefas.

  3. Selecione Adicionar daemon remoto e, em seguida, Colar em Dados de conexão para preencher os campos.

  4. Em Autenticação, escolha Senha se você faz login com a senha da sua conta. Escolha Arquivo de chave se o provedor do servidor lhe deu um arquivo de chave (muitas vezes com nome como id_ed25519 ou terminado em .pem) e informe onde ele está neste computador.

  5. Selecione Salvar e depois Conectar. Digite a senha se ele pedir.

    Se você colou os dados de conexão, a identidade do servidor (a impressão digital) veio com eles e o app a confere para você. Se você digitou o endereço manualmente, o app mostra uma impressão digital na primeira vez. Para ter certeza de que chegou à máquina certa, compare-a com a que este comando imprime no servidor e conecte somente se forem iguais:

    Terminal window
    ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

Você saberá que funcionou quando uma janela separada do Octoboard abrir, mostrando os projetos e as sessões do servidor.

Você também pode acessar um Mac ou um PC com Windows que execute o app Octoboard.

  1. No computador que você quer acessar, abra Ajustes › Acesso remoto no Octoboard.
  2. Selecione Abrir Ajustes do Sistema (macOS) ou Abrir Configurações (Windows) ali e ative Login remoto (macOS) ou OpenSSH Server (Windows), seguindo o caminho indicado na linha, para que este computador aceite logins SSH. Isso exige um administrador. De volta ao Octoboard, a linha passa a mostrar Ativado.
  3. Ative Permitir acesso remoto, selecione Permitir para confirmar e mantenha o Octoboard em execução: se você o fechar, o acesso remoto para.
  4. Na guia App Octoboard, selecione Copiar dados de conexão e envie-os ao outro computador, por exemplo por e-mail ou chat.
  5. No computador de onde você vai trabalhar, adicione o host como nos passos 2 a 5 de Conectar a um servidor Linux, colando os dados que você enviou. Faça login com o seu nome de usuário e a sua senha no host.

Você saberá que funcionou quando uma janela separada abrir com os projetos e as sessões do host.

  1. Obtenha o comando de encaminhamento SSH:

    • Em um host Mac ou Windows, faça primeiro os passos 1 a 3 de Usar outro computador como host. Depois, na guia Navegador, veja Etapa 1: encaminhamento SSH. Clique no endereço no comando para escolher como o seu outro computador alcança este (ou escolha Inserir o endereço manualmente e substitua <server> depois) e selecione Copiar comando de encaminhamento. Selecione também Copiar endereço em Etapa 2: endereço do navegador.

    • Em um servidor Linux, execute isto no servidor. Ele imprime o endereço do navegador e depois o comando SSH a executar.

      Terminal window
      octoboardd address

      Substitua <server> no comando pelo endereço do servidor.

  2. No computador de onde você vai navegar, execute o comando SSH no Terminal (macOS) ou no PowerShell (Windows). A janela pode pedir a sua senha e depois não mostra mais nada; isso é normal. Deixe-a aberta enquanto trabalha: fechá-la desconecta o navegador.

  3. Abra no navegador o endereço do navegador, que começa com http://127.0.0.1:.

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

Só quem consegue alcançar o Octoboard pelo encaminhamento SSH pode usar este endereço. Mantenha-o privado: a chave dá controle total, fica no histórico e nos favoritos do navegador e é sincronizada com os seus outros dispositivos se a sincronização do navegador estiver ativada.

  • “Não foi possível alcançar o servidor”, ou o comando SSH diz “Connection refused” ou expira: o login SSH está desativado no host, ou o endereço ou a porta SSH está errado. Verifique se Login remoto ou OpenSSH Server está ativado e se você consegue fazer login com o comando ssh acima.
  • “Não foi possível entrar”, ou “Permission denied”: o nome de usuário, a senha ou o arquivo de chave está errado.
  • “A chave de host não confere”: a máquina que responde não é aquela a que você se conectou antes. Isso acontece depois que um servidor é reinstalado, mas também pode indicar que há algo errado. Não continue até saber o motivo.
  • A página do navegador não carrega: a janela do SSH foi fechada ou o comando dela parou. Execute-o de novo e recarregue a página.
  • Sem portas públicas extras: o Octoboard só aceita conexões do próprio host, então, para se conectar de outro computador, você primeiro precisa fazer login no host por SSH. É por isso que você precisa do SSH ou de um dos retransmissores.
  • Confira a que máquina você chega: o app memoriza a chave do host, a identidade SSH da máquina, na primeira conexão bem-sucedida e bloqueia a conexão com um alerta se essa identidade mudar depois.
  • Nenhuma senha armazenada: depois que você faz login pela primeira vez com uma senha ou com o seu próprio arquivo de chave, o app cria uma chave SSH separada para este computador usar nos próximos logins.
  • Retire o acesso de um computador: remova a entrada desse computador da lista de chaves SSH permitidas do host (~/.ssh/authorized_keys no Linux e no macOS). Essa chave não consegue mais fazer login; uma conexão já aberta continua até terminar.
  • Uma janela por destino SSH: conexões com outro nome de usuário, host ou porta SSH abrem cada uma a sua própria janela, de modo que projetos, sessões e notificações nunca se misturam.
  • Veja o status de cada conexão: abra o ícone do app na barra de menus no macOS ou o ícone na área de notificação no Windows para ver uma guia para cada conexão.
  • Abra sites remotos aqui: quando um agente inicia um site no host, clique no link localhost que ele fornece e o app abre esse site neste computador por SSH.
  • Abra arquivos remotos aqui: veja um arquivo na janela remota ou baixe uma cópia para abri-la no app padrão deste computador para esse arquivo.
  • Reconecte automaticamente: se a rede cair, a janela continua tentando se reconectar até conseguir ou até você fechá-la.