Tutoriais de VPS
Túneis SSH na VPS: encaminhamento local, remoto e SOCKS
Acesse bancos e painéis privados, compartilhe prévias e configure SOCKS para aplicações específicas. Organize systemd, bastions e contas restritas, com limites claros de criptografia e exposição.

Um banco que escuta apenas em 127.0.0.1, um painel Grafana privado e uma prévia no notebook têm a mesma necessidade: permitir acesso autorizado a um serviço TCP sem publicá-lo desnecessariamente. O ssh do OpenSSH já oferece encaminhamento de portas. Comece com chaves SSH verificadas e confirme que a política do servidor permite o encaminhamento necessário.
| Opção | Onde escuta | Quem conecta ao destino |
|---|---|---|
-L | Cliente SSH | Servidor SSH |
-R | Servidor SSH | Cliente SSH |
-D | Proxy SOCKS local | O servidor alcança o destino solicitado |
L significa Local, R Remote e D Dynamic. É possível combinar vários encaminhamentos em uma conexão. O local da escuta e a máquina que resolve/conecta ao destino são coisas diferentes.
A notação original é:
ssh -L [本地地址:]本地端口:目标主机:目标端口 用户@跳板服务器
目标主机 significa host de destino. Troque todos os marcadores descritivos pelos valores reais; o destino é resolvido da perspectiva do servidor SSH.
ssh -N -L 3306:127.0.0.1:3306 [email protected]
O cliente escuta na porta local 3306 e o servidor conecta ao seu próprio 127.0.0.1 na porta 3306. Use uma conta não root autorizada para isso. -N não executa comando remoto: a conexão fica só para encaminhamento. Em configurações operacionais, indique explicitamente loopback para listeners administrativos locais.
Mantenha o banco privado conforme a segurança de exposição de bancos, frequentemente em 127.0.0.1.
# 本机 3307 转发到服务器的 3306(用 3307 避免和本机已有 MySQL 冲突)
ssh -N -L 3307:127.0.0.1:3306 [email protected]
No Navicat, DBeaver ou TablePlus, configure:
- Host:
127.0.0.1. - Porta local:
3307, evitando um MySQL local existente. - Credenciais: a conta do banco, não a conta SSH.
ssh -N -L 5433:127.0.0.1:5432 [email protected]
A porta local 5433 aponta ao PostgreSQL remoto 5432.
ssh -N -L 6380:127.0.0.1:6379 [email protected]
# 另开一个终端
redis-cli -h 127.0.0.1 -p 6380
A porta local 6380 aponta ao Redis remoto 6379. Autenticação e ACLs continuam necessárias; um túnel não autoriza operações no banco.
Distinga 127.0.0.1 de localhost. Alguns clientes MySQL tratam localhost como socket Unix. Para o túnel, escolha TCP e 127.0.0.1, evitando uma conexão localhost que acabe no socket local.
Para Grafana, Portainer, Adminer, Metabase ou pgAdmin privados, por exemplo em 127.0.0.1:3000:
ssh -N -L 3000:127.0.0.1:3000 [email protected]
Abra http://localhost:3000 no navegador local. Isso reduz exposição pública, mas mantenha autenticação, permissões e atualizações do painel. Outros processos no cliente podem alcançar a porta encaminhada; SSH não substitui a segurança da aplicação. Use ~/.ssh/config abaixo para uma configuração repetível.
ssh -N -L 8888:127.0.0.1:8888 [email protected]
O mesmo padrão atende Jupyter, Streamlit, Gradio e TensorBoard com listeners e autenticação corretos. Mantenha tokens/senhas e confira a escuta real em vez de presumir padrões.
-N é conveniente em um terminal dedicado. Sem -N, também abre uma sessão remota:
ssh -L 3307:127.0.0.1:3306 [email protected]
# 进去之后隧道一直有效,直到你退出这个会话
-f pede execução em segundo plano após autenticar:
ssh -f -N -L 3307:127.0.0.1:3306 [email protected]
Para conexões duradouras, -f sozinho oferece pouca visibilidade e não recupera automaticamente o processo. Use SSH em primeiro plano sob supervisão e defina como encerrá-lo.
ssh -N -R 8080:127.0.0.1:3000 [email protected]
O servidor escuta na porta 8080; o cliente conecta ao seu próprio loopback 3000. Com a política comum, curl 127.0.0.1:8080 no servidor pode funcionar enquanto o acesso externo a 203.0.113.10:8080 falha.
Examine a configuração efetiva de sshd_config:
#GatewayPorts no ← 官方默认值
GatewayPorts no normalmente mantém encaminhamentos remotos no loopback. Publicar em outras interfaces exige uma decisão explícita. O original mostra clientspecified:
sudo sed -i 's/^#\?GatewayPorts.*/GatewayPorts clientspecified/' /etc/ssh/sshd_config
sudo sshd -t && sudo systemctl reload ssh
O sed só altera uma linha correspondente do arquivo principal. Include, prioridade do primeiro valor e Match podem controlar o resultado. Faça backup, valide com sshd -t e sshd -T para conta/endereço reais e recarregue o serviço ssh/sshd correto.
ssh -N -R 0.0.0.0:8080:127.0.0.1:3000 [email protected]
Escutar em 0.0.0.0 pode expor o serviço do notebook a qualquer pessoa autorizada a alcançar essa porta. Revise credenciais, conteúdo e firewalls. Prefira manter GatewayPorts no: publique no loopback remoto com -R e use uma conexão autorizada -L para acesso. Um colega pode abrir seu próprio -L restrito.
-R permite que uma máquina privada inicie SSH para fora e o servidor acesse o serviço selecionado. Para acesso gerenciado e duradouro a vários serviços, avalie FRP, Cloudflare Tunnel ou Pangolin com suas políticas de identidade e exposição.
ssh -N -D 1080 [email protected]
A porta local 1080 vira proxy SOCKS; configure uma aplicação compatível com socks5://127.0.0.1:1080. Só o tráfego das aplicações configuradas passa por ele, não a rede inteira do computador.
-L define um destino; -L exige uma associação por destino, enquanto -D aceita destinos solicitados pelo cliente SOCKS, sujeitos às restrições do servidor.
Muitos clientes usando socks5:// fazem DNS localmente. Um cliente compatível pode usar socks5h://:
socks5h://127.0.0.1:1080
No Firefox, confira about:config, network.proxy.socks_remote_dns com valor true e as configurações reais do proxy. DNS depende da aplicação; teste o comportamento.
O tráfego de -D é criptografado no trecho SSH. HTTP comum continua em texto claro do servidor ao destino; HTTPS preserva a proteção de ponta a ponta. O trecho local e a segurança dos endpoints também importam. SOCKS fornece roteamento, não criptografia universal até qualquer destino.
Acrescente uma entrada em ~/.ssh/config:
Host db-tunnel
HostName 203.0.113.10
User root
IdentityFile ~/.ssh/id_ed25519
LocalForward 3307 127.0.0.1:3306
LocalForward 5433 127.0.0.1:5432
ServerAliveInterval 30
ServerAliveCountMax 3
ExitOnForwardFailure yes
SessionType none
Depois ssh db-tunnel estabelece os dois túneis. Substitua host, conta e chave, e torne as escutas locais explícitas.
- Várias linhas
LocalForwardcriam vários encaminhamentos locais. RemoteForwardcorresponde a-R.SessionType noneequivale a-Nem cliente compatível.ServerAliveInterval 30envia sondagens criptografadas; o contador define quando encerrar por falta de resposta.ExitOnForwardFailure yesencerra se não consegue estabelecer a escuta solicitada.
ExitOnForwardFailure não comprova resposta do serviço final, pois essa conexão ocorre depois. Teste a aplicação também. Coloque Host específicos antes dos padrões gerais e confira suporte de opções em clientes antigos.
Mudanças de rede, timeouts e reinicializações podem interromper o túnel. Um supervisor reinicia SSH em primeiro plano. autossh continua sendo uma alternativa a avaliar; a data de commit de julho de 2024 citada no original não prova abandono nem constitui avaliação atual de manutenção.
Exemplo de unidade em /etc/systemd/system/db-tunnel.service:
[Unit]
Description=SSH Tunnel for remote database access
After=network-online.target
Wants=network-online.target
[Service]
User=tunnel
ExecStart=/usr/bin/ssh -NT \
-o ExitOnForwardFailure=yes \
-o ServerAliveInterval=30 \
-o ServerAliveCountMax=3 \
-o StrictHostKeyChecking=accept-new \
-i /home/tunnel/.ssh/id_ed25519 \
-L 127.0.0.1:3307:127.0.0.1:3306 \
[email protected]
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
Antes de usá-la, crie a conta local tunnel e seu diretório; autorize uma chave independente e restrita na conta remota. Confira proprietário, arquivos legíveis e autenticação sem interação. Verifique a chave do servidor por um canal confiável e prepare known_hosts; prefira StrictHostKeyChecking=yes em vez de tratar accept-new como verificação prévia. Acrescente BatchMode=yes para falhas de credencial encerrarem, sem esperar entrada. Chaves pessoais com frase secreta e chaves de serviço exigem tratamentos diferentes.
sudo systemctl daemon-reload
sudo systemctl enable --now db-tunnel
127.0.0.1 em -L 127.0.0.1:3307:... evita publicar acidentalmente na LAN com 0.0.0.0. As dependências de network-online.target melhoram a ordem de partida, mas não garantem alcance do servidor remoto. Mantenha reconexões e confira journalctl -u db-tunnel. Teste parada, reinicialização do computador e conexão real ao banco.
ssh -J [email protected]:22 [email protected]
-J existe desde OpenSSH 7.3. Verifique a identidade dos dois servidores e configure ambas as contas:
Host internal-server
HostName 10.0.0.5
User deploy
ProxyJump [email protected]
IdentityFile ~/.ssh/id_ed25519
O encaminhamento também passa pelo salto:
ssh -J [email protected] -N -L 3307:127.0.0.1:3306 [email protected]
O destino 127.0.0.1 pertence ao servidor final 10.0.0.5. O bastion transporta a conexão SSH; não é o endpoint do banco neste exemplo.
Encaminhamento usa conectividade e permissões do servidor. Pode alcançar outro host interno se o servidor o alcançar e a política permitir; não fica limitado às portas do próprio host. As credenciais da aplicação continuam controlando operações.
Não ative GatewayPorts yes, ou clientspecified com 0.0.0.0, sem uma decisão de publicação. Examine AllowTcpForwarding: o padrão upstream yes pode ser alterado pela imagem. Em hosts compartilhados, restrinja usuários/grupos em sshd_config:
AllowTcpForwarding no
Match Group tunnelusers
AllowTcpForwarding yes
Esse exemplo de grupo é um início, não uma conta completamente restrita. Quem tem shell arbitrário pode implementar outros encaminhamentos; uma opção SSH não oferece isolamento sozinho.
Use conta dedicada para túneis sem interação. Um shell nologin pode funcionar com -N, mas políticas PAM/conta variam: teste no sistema instalado. O exemplo em authorized_keys usa command= e permitopen=:
command="/bin/false",no-pty,no-agent-forwarding,permitopen="127.0.0.1:3306" ssh-ed25519 AAAA... tunnel-key
permitopen limita destinos de encaminhamentos locais/dinâmicos, não listeners de encaminhamento remoto. Para acesso exclusivo a esse banco, restrinja também a conta no servidor:
Match User tunnel
AllowTcpForwarding local
PermitOpen 127.0.0.1:3306
PermitListen none
AllowStreamLocalForwarding no
X11Forwarding no
AllowAgentForwarding no
PermitTTY no
ForceCommand /bin/false
Valide suporte da versão e opções efetivas antes de recarregar, preserve recuperação administrativa e teste o bloqueio de outros destinos, túneis reversos e shells. Substitua a pública abreviada por uma completa e verificada. O comando forçado não roda em uma sessão -N sem comando; remover -N do serviço exige revisar essa política.
Um túnel TCP/SOCKS não cria uma interface de rede geral, embora alcance destinos internos TCP autorizados. Para redes e vários hosts, considere WireGuard ou Tailscale/Headscale.
bind: Address already in use: troque a porta local ou encontre o listener:
# Linux / macOS
sudo ss -lntp 'sport = :3307'
# Windows
netstat -ano | findstr :3307
ss é do Linux; no macOS use lsof -nP -iTCP:3307 -sTCP:LISTEN. O exemplo Windows identifica o PID. Veja conflitos de porta.
channel 2: open failed: connect failed: Connection refused: confira o destino na máquina que faz essa conexão:
# 在服务器上执行
sudo ss -lntp 'sport = :3306'
Em encaminhamento local, confira listener, endereço e publicação/rede Docker do servidor SSH. Em -R, a conexão de destino ocorre no cliente. Connection refused costuma significar falta de listener, mas pode resultar de rejeição explícita da rede.
channel 3: open failed: administratively prohibited: examine sshd_config / AllowTcpForwarding efetivos e as restrições de authorized_keys, inclusive permitopen e no-port-forwarding.
SSH conecta, a aplicação não: confira nesta ordem:
- Ative
ExitOnForwardFailure yespara detectar falhas na criação do listener. - Confira a escuta de destino com
ssno lado correto. - Aponte ao
127.0.0.1;localhostpode selecionar socket ou outro endereço. - Use a porta local realmente encaminhada e depois revise credenciais e protocolo.
Desconexões: ServerAliveInterval 30 pode ajudar em ociosidade; veja logs e quedas SSH. Permission denied (publickey) é falha de autenticação anterior ao túnel; consulte Permission denied.
O tráfego é criptografado? O trecho SSH é. Conexões posteriores precisam de TLS quando apropriado; não generalize um MySQL no mesmo host para bancos em redes não confiáveis.
Outros podem compartilhar? Escutar em 0.0.0.0 pode emprestar seu acesso. Prefira identidades individuais e loopback, com auditoria própria da aplicação.
Quanto custa em desempenho? Depende de cifra, CPU, latência e armazenamento. O exemplo de 10–20% do original não é uma promessa medida. Meça sua carga.
Encaminha UDP? Os encaminhamentos comuns -L/-R/-D usam TCP, não um túnel UDP geral. Use uma solução de rede apropriada para UDP.
Volta após reiniciar? Um serviço correto com enable pode partir novamente. Um ssh -L manual não se recria; rede e autenticação precisam funcionar.
E no Windows? Instale/verifique OpenSSH Client em uma versão compatível. As opções são semelhantes, com caminhos e aspas próprios. MobaXterm ou Termius podem gerenciar túneis, conforme suas condições de armazenamento e acesso.
Qual ferramenta escolher?
- Poucas portas temporárias autorizadas: SSH quando a política existente permitir.
- Acesso persistente a serviços: avalie FRP ou Cloudflare Tunnel.
- Conectividade de rede: avalie WireGuard ou Tailscale.
Cada opção precisa de política de identidade e exposição; SSH também pode exigir configurações de servidor, mesmo sem instalar outro daemon.