Ir para o conteúdo
Localtonet Localtonet Painel

Inicie um túnel com seu cliente SSH

Plano Grátis Túneis HTTP e TCP

Ajuda com esta página
Nesta página 11 seções
  1. Quando usar
  2. Antes de começar
  3. Passos
  4. Crie um túnel HTTP ou TCP
  5. Abra o comando SSH
  6. Escolha se ele deve reconectar
  7. Execute o comando
  8. Mantenha a janela aberta
  9. Pelo Assistente de configuração de túnel
  10. O comando explicado
  11. Reconexão automática
  12. Por quanto tempo um comando permanece válido
  13. Limites
  14. O que você vê no painel
  15. Solução de problemas
  16. Mensagens no painel
  17. Mensagens no terminal
  18. Páginas relacionadas

Coloque um serviço local no ar sem instalar o Localtonet. O painel fornece um comando ssh pronto; enquanto esse comando estiver em execução, seu túnel HTTP ou TCP fica ativo.

Quando usar #

Use o SSH sem instalação em uma máquina onde você não pode ou não quer instalar o cliente do Localtonet, por exemplo um servidor que você acessa só por um momento, um computador corporativo restrito ou uma demonstração rápida. O cliente ssh que acompanha o Windows, o macOS e o Linux é tudo de que você precisa.

O comando SSH substitui o cliente do Localtonet para um túnel. Todo o resto continua no painel: o endereço do túnel, as configurações, os logs e a banda.

Tipo de túnelComando SSH
HTTP / HTTPSDisponível
TCPDisponível
UDP, UDP / TCP misto, TLS, Servidor de arquivos, Servidor proxy e os demais tiposIndisponível. Esses tipos precisam do cliente do Localtonet.

Esta página não trata de acessar um servidor SSH. Para publicar seu próprio servidor SSH por meio de um túnel, veja Usando o Localtonet com SSH. Para abrir um shell em um dos seus dispositivos pelo painel, veja Terminal de dispositivo.

Antes de começar #

  • Uma conta do Localtonet e um serviço que já esteja em execução, por exemplo um aplicativo web na porta 3000.
  • Um cliente ssh na máquina que alcança o serviço. Verifique com ssh -V.
  • As conexões TCP de saída para a porta 223 precisam ser permitidas na rede dessa máquina.
  • Um AuthToken que nenhum cliente do Localtonet em execução esteja usando. Um túnel sempre pertence a um token, mas com SSH nenhum cliente se conecta com ele. Se um cliente estiver conectado com o token do túnel, o painel se recusa a emitir o comando.

Passos #

  1. Crie um túnel HTTP ou TCP #

    Abra Meus túneis › HTTP ou Meus túneis › TCP - UDP (protocolo TCP) e crie o túnel normalmente. Endereço IP local e Porta local indicam para onde o cliente SSH vai enviar o tráfego: 127.0.0.1 e a porta do seu serviço, quando você executa o comando na mesma máquina do serviço. Deixe o túnel parado.

  2. Abra o comando SSH #

    Na lista de túneis, selecione Configurações do túnel e depois Mostrar comando SSH. A caixa de diálogo Comando SSH abre com o comando deste túnel. Um aviso informa quantos segundos você tem para executá-lo; um comando não utilizado expira, e você então solicita um novo da mesma forma.

  3. Escolha se ele deve reconectar #

    Deixe Reconectar automaticamente desativado para obter o comando ssh simples. Ative para envolver o comando em um laço que o inicia de novo quando a conexão cai e, em Onde você vai executá-lo, escolha para qual shell o laço é escrito: PowerShell, Prompt de Comando ou macOS ou Linux.

  4. Execute o comando #

    Copie o texto em Comando. Abra um terminal no computador que executa seu serviço, cole o comando e pressione Enter. Nenhuma senha é solicitada. Quando a conexão estiver ativa, o terminal mostra os endpoints do túnel:

    Terminal
    +--------------------------------------------------------------+
    | Welcome to Localtonet!                                       |
    +--------------------------------------------------------------+
    | Localtonet Tunnel Endpoints                                  |
    +--------------------------------------------------------------+
    | HTTP => http://<YOUR_ADDRESS> => 127.0.0.1:3000               |
    | HTTPS => https://<YOUR_ADDRESS> => 127.0.0.1:3000             |
    +--------------------------------------------------------------+
    | Server Time: ...                                             |
    +--------------------------------------------------------------+
    
    You can view your requests and configure your tunnel settings from the Localtonet Dashboard.

    Um túnel TCP mostra uma única linha: TCP => <YOUR_ADDRESS>:<PORT> => 127.0.0.1:<LOCAL_PORT>.

  5. Mantenha a janela aberta #

    O túnel inicia sozinho quando o comando se conecta; você não precisa selecionar Iniciar. Ele fica online enquanto o comando estiver em execução. Fechar a janela encerra a conexão, e o endereço público deixa de responder. Para encerrar o comando por conta própria, digite exit e pressione Enter, ou pressione Ctrl + C.

    Encerrar o comando não para o túnel no painel. O túnel continua iniciado, com a conexão exibida como desligada, para que o mesmo comando possa se conectar de novo. Quando terminar de usar o túnel, selecione Parar para ele no painel. O painel só emite um novo comando SSH para um túnel parado.

Pelo Assistente de configuração de túnel #

O Assistente de configuração de túnel no Painel oferece o mesmo comando. Na última etapa, em que você escolhe a plataforma, selecione SSH e depois Gerar comando SSH. A opção SSH só aparece para túneis HTTP e TCP. O assistente mostra Aguardando SSH até que seu comando se conecte e Conectado via SSH depois disso. Reconexão automática adiciona o mesmo laço de reconexão, e Gerar novo comando substitui um comando que expirou.

O comando explicado #

O comando sempre tem este formato. O painel preenche os valores do seu túnel:

Bash
ssh -o ExitOnForwardFailure=yes -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ConnectTimeout=15 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -p 223 -l <COMMAND_KEY> <TUNNEL_ADDRESS> -R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>
ParteO que faz
-p 223Conecta à porta 223, onde o Localtonet aceita essas conexões SSH.
-l <COMMAND_KEY>O nome de login. É uma chave que o painel gera para este túnel, não seu AuthToken nem a senha da sua conta. Ela diz ao Localtonet qual túnel iniciar, e por isso nenhuma senha é solicitada.
<TUNNEL_ADDRESS>O endereço do seu túnel. A conexão SSH vai para o servidor que o hospeda.
-R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>O encaminhamento remoto: as conexões que chegam ao túnel no servidor são enviadas pela conexão SSH para <LOCAL_IP>:<LOCAL_PORT>. Os dois últimos valores são o Endereço IP local e a Porta local do túnel. A porta do servidor é atribuída pelo Localtonet e não deve ser alterada.
-o ExitOnForwardFailure=yesFaz o ssh encerrar se o encaminhamento não puder ser configurado, em vez de continuar conectado sem um túnel funcionando.
-o ServerAliveInterval=15 -o ServerAliveCountMax=3Envia um sinal de keep-alive a cada 15 segundos e encerra a conexão após três sem resposta, de modo que uma conexão morta é percebida em cerca de 45 segundos.
-o ConnectTimeout=15Desiste após 15 segundos se o servidor não puder ser alcançado.
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/nullPula a pergunta sobre a chave do host e não grava o servidor no seu arquivo known_hosts.
-o LogLevel=ERROROculta as mensagens informativas do ssh. Os erros continuam sendo exibidos.

Como <LOCAL_IP> é resolvido na máquina em que você executa o ssh, o serviço não precisa estar nessa máquina. Com um endereço local como 192.168.1.20, o comando encaminha para outro dispositivo da mesma rede.

Não compartilhe o comando. Quem o executar enquanto ele for válido responderá ao tráfego do seu túnel.

Reconexão automática #

Com Reconectar automaticamente ativado, o painel envolve o mesmo comando ssh em um pequeno script para o shell escolhido. Para o Prompt de Comando, o script é entregue como uma única linha powershell -NoProfile -EncodedCommand …. O script se comporta da mesma forma em todos os shells:

  • Quando o ssh termina, ele espera e o inicia de novo. A espera começa em cerca de 10 segundos e dobra a cada tentativa com falha, até cerca de 2 minutos.
  • Uma conexão que durou pelo menos 60 segundos conta como sucesso e zera o tempo de espera.
  • Após 8 tentativas seguidas que terminaram em menos de 60 segundos cada, ele para e exibe SSH reconnect stopped. If a session or bandwidth limit was reached, get a new SSH command from the panel.

A reconexão reutiliza o mesmo comando. Isso funciona após uma interrupção de rede, mas não depois que o túnel foi parado no painel ou atingiu um limite; nesse caso o script desiste e você precisa de um novo comando.

Por quanto tempo um comando permanece válido #

  • Antes do primeiro uso: o comando deve ser executado dentro do tempo que o painel mostra ao emiti-lo. Depois disso, a oferta de porta expira.
  • Durante o uso: uma sessão SSH por túnel. Uma segunda cópia do comando é recusada enquanto a primeira estiver conectada.
  • Depois que a conexão terminou: o mesmo comando pode se conectar de novo, desde que o túnel não tenha sido parado no painel e nenhum limite tenha sido atingido.
  • Depois de uma parada: quando o túnel foi parado no painel ou por um limite, o comando está encerrado. Abra Mostrar comando SSH de novo para obter um novo.

O painel só emite um comando enquanto o túnel está parado. Um novo comando pode vir com uma porta de servidor diferente; no plano Grátis, cada novo comando recebe uma nova. Em um túnel TCP, essa porta faz parte do endereço público, portanto confira o endereço na saída do terminal ou na lista de túneis depois de solicitar um novo comando. O log de atividades do túnel registra a mudança como Server port changed to "…" for SSH.

Limites #

  • Limite de sessão no plano Grátis. Um túnel iniciado por SSH segue a mesma regra de um iniciado com o cliente: no plano Grátis, os túneis TCP param após 30 minutos e podem ser iniciados de novo, e os túneis HTTP não têm limite de tempo. Os 30 minutos contam a partir da primeira vez que um comando se conecta; reconectar com o mesmo comando não os reinicia. Quando uma sessão TCP atinge o limite, o servidor encerra a conexão SSH com a mensagem Session time limit reached. Get a new SSH command from the panel. Veja Planos e saldo.
  • Banda. O tráfego conta para a sua banda como qualquer outro tráfego de túnel. Sem banda restante, nenhum comando é emitido, e o servidor encerra uma sessão em andamento com a mensagem Bandwidth limit reached. Get a new command after bandwidth is available.
  • Somente encaminhamento reverso. O endpoint SSH aceita apenas o encaminhamento do comando. Ele não dá a você um shell em um servidor do Localtonet nem nenhum outro tipo de encaminhamento.
  • Um túnel por comando. Para executar vários túneis, solicite um comando para cada um e execute cada um em seu próprio terminal.

O que você vê no painel #

Enquanto o comando está conectado, o túnel aparece como iniciado e as requisições surgem nos logs como de costume. O Log de atividades do túnel registra Tunnel started over SSH. quando um comando se conecta. Veja Logs e inspeção.

Solução de problemas #

Mensagens no painel #

MensagemO que fazer
Pare o túnel antes de solicitar um comando SSH.O túnel está em execução com o cliente do Localtonet. Pare-o e selecione Mostrar comando SSH de novo.
Pare o túnel SSH atual antes de solicitar um novo comando.O túnel ainda está iniciado por SSH, ou uma sessão SSH dele estava ativa há pouco. Encerre o comando ssh em execução, selecione Parar para o túnel e tente de novo.
Um cliente está conectado a este túnel com o AuthToken que você criou. Crie um novo AuthToken.Um cliente do Localtonet está conectado com o token do túnel. Pare esse cliente ou crie outro token em Meus tokens e use-o para este túnel.
Você não tem banda restante suficiente para iniciar o túnel.Sua banda acabou. Veja Planos e saldo.
Este recurso não está disponível para este tipo de protocolo.O túnel não é um túnel HTTP nem TCP.
Este recurso não está disponível neste servidor. Mova seu túnel para outro servidor.O servidor deste túnel não oferece comandos SSH. Crie o túnel em outro servidor.
Há uma operação de túnel em andamento. Tente novamente em instantes.Aguarde alguns segundos e tente de novo.
Não foi possível atribuir uma nova porta do servidor.Tente de novo. Se continuar falhando, crie o túnel em outro servidor.
Não foi possível salvar a porta SSH. Tente novamente.Tente de novo.

Mensagens no terminal #

Quando o servidor encerra uma sessão, ele envia uma das mensagens abaixo como motivo. A forma como o motivo é exibido depende do seu cliente ssh.

Mensagem ou sintomaCausa e correção
O ssh termina imediatamente com um erro de autenticação, geralmente Permission deniedO Localtonet não aceitou o comando. Ele não foi executado a tempo, o túnel foi parado ou atingiu um limite desde que foi emitido, outra sessão do mesmo comando já está conectada, ou o texto foi alterado ao copiar. Gere um novo comando no painel e cole-o sem alterações.
Port mismatch. Get a new SSH command from the panel.A porta do servidor após -R não é a que o Localtonet atribuiu. Use o comando exatamente como foi emitido.
Session time limit reached. Get a new SSH command from the panel.A sessão de 30 minutos de um túnel TCP no plano Grátis terminou. Solicite um novo comando para começar de novo.
Bandwidth limit reached. Get a new command after bandwidth is available.Sua banda acabou.
Session stopped. Get a new SSH command from the panel.O túnel foi parado, por exemplo pelo painel.
Um tempo limite de conexão esgotado, ou Connection refusedA máquina não consegue alcançar o servidor na porta 223. Permita conexões TCP de saída para a porta 223 no firewall ou tente a partir de outra rede.
O túnel está ativo, mas os visitantes recebem um erroO ssh está conectado, mas não alcança o seu serviço. Verifique se o serviço está em execução e se o Endereço IP local e a Porta local do túnel estão corretos. Depois de alterá-los, solicite um novo comando, porque o antigo ainda contém os valores antigos.
Suporte