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.
Do que você precisa
Seção intitulada “Do que você precisa”-
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
yesquando 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.
Conectar a um servidor Linux
Seção intitulada “Conectar a um servidor Linux”-
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 connectionSe este computador alcança o servidor por outro endereço ou outra porta SSH, adicione
--hostou--ssh-portao 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.
-
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.
-
Selecione Adicionar daemon remoto e, em seguida, Colar em Dados de conexão para preencher os campos.
-
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_ed25519ou terminado em.pem) e informe onde ele está neste computador. -
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.
Usar outro computador como host
Seção intitulada “Usar outro computador como host”Você também pode acessar um Mac ou um PC com Windows que execute o app Octoboard.
- No computador que você quer acessar, abra Ajustes › Acesso remoto no Octoboard.
- 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.
- Ative Permitir acesso remoto, selecione Permitir para confirmar e mantenha o Octoboard em execução: se você o fechar, o acesso remoto para.
- Na guia App Octoboard, selecione Copiar dados de conexão e envie-os ao outro computador, por exemplo por e-mail ou chat.
- 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.
Por um navegador
Seção intitulada “Por um navegador”-
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 addressSubstitua
<server>no comando pelo endereço do servidor.
-
-
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.
-
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.
Se não funcionar
Seção intitulada “Se não funcionar”- “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
sshacima. - “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.
Segurança
Seção intitulada “Segurança”- 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_keysno Linux e no macOS). Essa chave não consegue mais fazer login; uma conexão já aberta continua até terminar.
Em uma janela remota
Seção intitulada “Em uma janela remota”- 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
localhostque 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.