Inicie um túnel com seu cliente SSH
Plano Grátis Túneis HTTP e TCP
Nesta página 11 seções
- Quando usar
- Antes de começar
- Passos
- Crie um túnel HTTP ou TCP
- Abra o comando SSH
- Escolha se ele deve reconectar
- Execute o comando
- Mantenha a janela aberta
- Pelo Assistente de configuração de túnel
- O comando explicado
- Reconexão automática
- Por quanto tempo um comando permanece válido
- Limites
- O que você vê no painel
- Solução de problemas
- Mensagens no painel
- Mensagens no terminal
- 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únel | Comando SSH |
|---|---|
| HTTP / HTTPS | Disponível |
| TCP | Disponível |
| UDP, UDP / TCP misto, TLS, Servidor de arquivos, Servidor proxy e os demais tipos | Indisponí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
sshna máquina que alcança o serviço. Verifique comssh -V. - As conexões TCP de saída para a porta
223precisam 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 #
-
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.1e a porta do seu serviço, quando você executa o comando na mesma máquina do serviço. Deixe o túnel parado. -
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.
-
Escolha se ele deve reconectar #
Deixe Reconectar automaticamente desativado para obter o comando
sshsimples. 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. -
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>. -
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
exite 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:
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>| Parte | O que faz |
|---|---|
-p 223 | Conecta à 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=yes | Faz 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=3 | Envia 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=15 | Desiste após 15 segundos se o servidor não puder ser alcançado. |
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null | Pula a pergunta sobre a chave do host e não grava o servidor no seu arquivo known_hosts. |
-o LogLevel=ERROR | Oculta 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
sshtermina, 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 #
| Mensagem | O 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 sintoma | Causa e correção |
|---|---|
O ssh termina imediatamente com um erro de autenticação, geralmente Permission denied | O 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 refused | A 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 erro | O 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. |