Guia

Acessar sua máquina de qualquer lugar

A máquina em que seus agentes rodam quase sempre está atrás de NAT — um roteador residencial, uma rede de escritório, um notebook na mesa. Veja como alcançá-la pelo celular sem colocar o SSH na internet pública.

Existem dois jeitos de resolver isso. Um é redirecionar uma porta no roteador. O outro é colocar as duas máquinas em uma rede mesh privada, para que o seu celular tenha um endereço estável para aquela máquina e nada fique escutando na internet pública. Este guia usa o segundo caminho, porque o primeiro é como muita gente perde servidores.

1 Coloque o servidor na mesh

Tailscale, NetBird, headscale ou WireGuard na mão — todos são uma rede mesh WireGuard por baixo. Um comando no servidor e ele ganha um endereço estável acessível apenas pelos seus próprios aparelhos.

O Tailscale distribui endereços em 100.64.0.0/10 e um nome como m1-pro.your-tailnet.ts.net.

2 Coloque o celular na mesma mesh

Instale o app iOS do provedor e faça login. Ele instala um perfil de VPN. O Moshpit não participa em nada deste passo.

O iOS mantém apenas um túnel VPN ativo por vez, então uma VPN corporativa e a sua mesh em geral não conseguem ficar ligadas ao mesmo tempo.

3 Adicione a conexão no Moshpit

Host = o nome ou endereço da mesh. Porta = 22, a menos que você tenha mudado. Nome de usuário e depois Chave SSH em AUTENTICAÇÃO.

O Moshpit conecta exatamente no endereço que você digitou. A integração inteira é só essa.

O Moshpit não tem VPN de nenhum tipo, nem integração com o Tailscale. Ele não disca, não roteia e não descobre máquinas. Ele abre uma conexão TCP para o texto do campo Host e, no mosh, envia UDP para esse mesmo endereço. Se o seu celular alcança o endereço, o Moshpit também alcança.

Existe um campo useTailscale no modelo salvo de conexão. Nada no app lê esse campo e ele nem aparece no formulário. É um resquício, e preferimos dizer isso aqui do que deixar você procurando um botão que não existe.

Primeiro, o que não fazer

Não abra a porta 22 com senha.

Uma porta SSH exposta na internet é achada por scanners em minutos. Autenticação por senha transforma isso num jogo de adivinhação com tentativas infinitas, jogado por bots que não fazem outra coisa. Uma mesh elimina o alvo em vez de tentar blindá-lo.

Se você realmente não tiver alternativa

Algumas redes impedem usar uma mesh. Se você precisar expor o SSH, o mínimo é autenticação somente por chave — lembrando que isso é o mínimo, não uma recomendação:

# /etc/ssh/sshd_config.d/moshpit.conf
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
AuthenticationMethods publickey
# confira a sintaxe e recarregue: sudo sshd -t && sudo systemctl reload ssh

Três coisas sobre o Moshpit que você precisa saber antes de montar tudo em torno dele:

  • Dois métodos de autenticação, nenhum terceiro. Senha e chave pública. Não há keyboard-interactive, então um sshd configurado para pedir TOTP não autentica pelo Moshpit.
  • Sem ProxyJump, sem bastion, sem agent forwarding. «Conectar primeiro em um jump box» não é algo que esta configuração cobre aqui; os campos antigos jumpHost e forwardAgent existiam no modelo sem uso neste fluxo (para jump hosts atuais da 1.1.0, veja Jump hosts).
  • Chaves privadas protegidas por frase-senha não funcionam. A chave é carregada sem chave de descriptografia, então um PEM criptografado falha ao autenticar. Gere uma chave dentro do Moshpit (Ajustes → Chaves SSH → +) e coloque a parte pública no servidor — essas podem ficar no Secure Enclave protegidas por Face ID.

Por que UDP importa

O UDP aparece duas vezes, por motivos diferentes.

Uma vez por baixo, porque o WireGuard é um protocolo UDP. Outra por cima, porque o mosh também é. Eles falham de maneiras diferentes, então vale manter os dois separados na cabeça.

A mesh, por baixo

wireguard · udp

  • O Tailscale tenta abrir uma rota UDP direta entre as duas máquinas — a porta de escuta padrão é a 41641, de saída nos dois lados
  • Quando não consegue furar o NAT, ele faz relay do tráfego. Via relay ainda funciona, mas custa latência
  • tailscale status em qualquer ponta mostra qual você pegou — direct ou um relay
  • Nada aqui precisa de porta de entrada aberta no roteador

O mosh, por cima

dentro do túnel

  • O Mosh é UDP de ponta a ponta, e sobre uma mesh vira UDP dentro do túnel — seu roteador nem enxerga
  • O mosh-server ocupa uma porta por sessão na faixa configurada, por padrão 60000–61000
  • O Moshpit manda datagramas para o mesmo endereço de host digitado no formulário, na porta informada pelo servidor
  • O Mosh não consegue iniciar sem um login SSH funcionando antes — o TCP precisa passar antes de o UDP entrar em cena
A inicialização, exatamente

O SSH inicia e sai da frente

O Moshpit roda um comando pela sessão SSH autenticada, lê a linha única que ele imprime e fecha o SSH. Daí em diante é tudo UDP.

É por isso que bloquear o SSH depois da conexão não derruba uma sessão mosh, enquanto bloquear UDP derruba. E também é por isso que uma mesh que leva TCP bem, mas faz relay ruim de UDP, deixa o mosh pior do que SSH comum.

PATH="$PATH:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/local/sbin:$HOME/.local/bin" \
  mosh-server new -s -c 256 -p 60000:61000 -l LANG=en_US.UTF-8

MOSH CONNECT 60001 <22 caracteres base64 = chave AES-128 de 16 bytes>

O que precisa estar aberto, e onde

O quêPortaDireçãoPor quê
SSHTCP 22 (ou sua Porta) Entrada no servidor O Mosh não tem modo avulso — o SSH inicia o mosh-server e traz a chave de volta
Sessão moshUDP 60000–61000 Entrada no servidor, saída do celular Uma porta por sessão, escolhida pelo mosh-server dentro da faixa
Rota direta da meshUDP 41641 Saída nas duas pontas Padrão do Tailscale. Bloqueado vira relay, não quebra
Seu roteadorNada — Nenhuma porta redirecionada. Esse é exatamente o motivo de fazer assim

Em uma mesh, «entrada no servidor» significa na interface da mesh. O firewall do host ainda vale ali: ufw, firewalld e um security group na nuvem ficam entre o túnel e o mosh-server. Liberar a faixa em tailscale0 não é o mesmo que abrir para o mundo, e costuma ser o passo que todo mundo esquece.

Altere a faixa em Ajustes → MOSH · ROAMING → Faixa de portas UDP (De / Até, validado entre 1 e 65535 com De ≤ Até). O formulário da conexão exibe a mesma faixa como somente leitura. Uma porta inicial fora dessa faixa omite -p por completo e o mosh-server volta ao padrão dele; um limite final inválido fixa a sessão na porta inicial única.

A armadilha

Escolha um endereço e use-o em todo lugar.

Esta é a falha que mais parece bug e não é. Costuma custar uma noite inteira, então ganhou seção própria.

O Moshpit inicia mosh-server new -s. Essa flag equivale a --bind-server=ssh no mosh, padrão upstream desde o mosh 1.4: o servidor escuta apenas no endereço pelo qual a conexão SSH chegou. É uma escolha intencional — assim os datagramas seguem exatamente o mesmo caminho do seu login.

A consequência:

  • Uma sessão iniciada em casa conectando a 192.168.1.30 cria um mosh-server vinculado a 192.168.1.30. Pela mesh, esse servidor fica inacessível.
  • Uma sessão iniciada pela mesh vincula o endereço da mesh e fica inacessível pela LAN.
  • Nenhum dos dois é erro do Moshpit. É exatamente o que --bind-server=ssh faz.

Portanto: salve a conexão com o nome da mesh e use-a em casa também. O tráfego dentro da sua própria LAN pela mesh já segue rota local direta. Um endereço, uma conexão salva, zero surpresa quando você sai pela porta.

Processos mosh-server órfãos se acumulam

Cada conexão inicia um novo mosh-server. Quando o link morre, o antigo não encerra — fica lá segurando a porta UDP. Ao longo de semanas reconectando, eles se acumulam. O Moshpit não limpa esses processos, e isso é uma lacuna real, não uma decisão de design.

pgrep -fl mosh-server                 # o que ainda está rodando
lsof -nP -iUDP | grep mosh-server     # e a qual endereço cada um está vinculado
pkill -f mosh-server                  # a solução drástica; derruba sessões ativas também

Os endereços mostrados no segundo comando também servem de diagnóstico: eles revelam de qual rede cada sessão nasceu, o que quase sempre explica por que uma delas parou de responder.

iOS

A permissão de Rede Local e como fica quando você nega

O iOS protege o acesso a endereços da rede local atrás de um aviso único. Se você negou meses atrás em outra tela, o sintoma é este aqui.

Aviso

Aparece uma vez

Na primeira conexão a um endereço da LAN. A justificativa do Moshpit diz: «O Moshpit conecta por SSH e mosh (UDP) aos servidores da sua rede local. Sem esta permissão, conexões a hosts como 192.168.x.x falham.»

Negado

SSH conecta, mosh fica tela preta

O iOS descarta UDP para endereços da LAN sem avisar ninguém. O TCP continua intacto, então o SSH funciona perfeitamente e só o mosh fica preto atrás de um cursor aceso.

Correção

Ajustes → Moshpit → Rede Local

O aviso não volta a aparecer sozinho. Ative a opção lá e reconecte a sessão.

Escopo, sem rodeios: isso controla endereços da LAN — 192.168.x.x, 10.x.x.x e afins. Tráfego para um endereço da mesh sai pela interface do túnel VPN. Conceda mesmo assim se houver qualquer chance de você conectar a essa máquina pelo IP local, porque a falha gerada é idêntica a um problema de firewall e faz você perder a noite procurando no lugar errado.

Verificar

Seis verificações, nesta ordem

Cada uma elimina a camada de baixo. Não pule etapas — a resposta quase sempre está no passo 1 ou 2.

1 · O peer está no ar, e a rota é direta?

tailscale status          # a linha do peer termina em "direct" ou no nome de um relay
tailscale ip -4           # o endereço para colocar no campo Host

Um peer via relay ainda funciona. Fica mais lento e, num dia ruim, faz a diferença entre um terminal usável e um insuportável.

2 · SSH puro funciona de um notebook na mesma mesh?

ssh -v user@m1-pro.your-tailnet.ts.net

Se isso falhar, pare aqui. Nada acima disso pode funcionar — o mosh não tem modo avulso, e o Moshpit é primeiro um cliente SSH.

3 · O UDP realmente vai e volta?

Este é o teste que ninguém roda e o que encontra o problema. Escolha uma porta dentro da sua faixa, escute no servidor e envie de uma máquina na mesma rede que o celular:

# no servidor
echo REPLY | nc -u -l 60005 > /tmp/udp-in

# de um notebook no mesmo Wi-Fi do celular
echo PING | nc -u -w3 m1-pro.your-tailnet.ts.net 60005

Cada lado precisa ver a palavra do outro. O servidor vê PING, mas o cliente nunca recebe REPLY = caminho de volta morto, exatamente a tela preta do mosh. Essa resposta é da rede, não do app.

4 · A faixa está aberta na interface por onde o tráfego chega?

sudo ufw status verbose                       # Debian / Ubuntu
sudo firewall-cmd --list-all                  # Fedora / RHEL
sudo ufw allow in on tailscale0 to any port 60000:61000 proto udp

Depois confira o security group da nuvem separado, se houver. E confirme se é a mesma faixa configurada no Moshpit — o padrão é 60000–61000, mas é editável.

5 · Pergunte ao app o que ele está vendo

Segure a pílula de transporte na barra superior do terminal em uma sessão mosh para abrir DIAGNÓSTICO DO MOSH: datagrams, applied, parse fails, gaps. A linha que mais importa não é um número:

DIAGNÓSTICO DO MOSH
   Nenhum datagrama ainda.

Isso significa que literalmente nada voltou — o contador sobe antes de qualquer descriptografia ou análise. Caminho de retorno morto. Pare de depurar o Moshpit e volte ao passo 3.

6 · Use a saída de emergência

Se uma rede está engolindo seu UDP e você precisa de um terminal agora, toque em Trocar para SSH no aviso, ou toque na pílula MOSH na barra superior e confirme «Trocar para SSH?». O SSH passa por TCP no mesmo caminho que derrubou os datagramas. O aviso pode ser dispensado e nunca trava o terminal — suas teclas estavam chegando ao servidor o tempo todo; só a pintura da tela estava sem retorno.

⚠  O Mosh não está recebendo dados. Sua rede pode estar
   bloqueando UDP (VPN, proxy ou firewall).

   Trocar para SSH                                  ×

Um dado medido, não uma promessa

Não há números agregados aqui. Existe um host de desenvolvimento contra o qual testamos, e as medições dele valem mais do que adjetivos.

Um Mac sobre Tailscale, rota direta saindo por rede móvel na China: RTT de 433–640 ms, cerca de 13% de perda de pacotes. O handshake SSH leva 5,8–9 segundos nesse link. O Mosh funciona nele. A primeira tela de uma sessão mosh pura aparece em cerca de 10 segundos; mosh com tmux exige dois handshakes SSH e leva 20–25 segundos até a barra nativa popular.

Isso é um link só, medido uma vez, em hardware nosso. Não é benchmark, e a sua conexão vai variar. Está aqui porque «sobrevive à perda de pacotes» é o tipo de afirmação que merece vir acompanhada de um número.

Duas coisas que esse link ensinou e que você deve esperar: um notebook que entra em repouso some completamente da mesh (direto → relay → offline), e um servidor tmux cheio de plugins pesados pode travar na primeira abertura. Nenhum dos dois é problema de rede, mas os dois parecem exatamente um.

Limites que vale saber antes de depender disso

O que ainda não funciona depois que você alcança a máquina.

O app suspende em segundo plano O iOS suspende o Moshpit, o temporizador de keepalive de 12 segundos e o polling. O estado ao vivo dos agentes para de atualizar até você voltar ao app, quando então se atualiza — os alertas de agentes continuam chegando, porque o próprio host envia os pushes, criptografados de ponta a ponta. Fora por mais de 20 segundos, o Moshpit força uma reconexão nova ao voltar em vez de confiar num teste de atividade que pode dar falso positivo num socket meio aberto.

Sobre mosh, tmux e herdr rodam a própria TUI O Mosh transmite diffs de tela renderizada, não um fluxo bruto de bytes delimitado por linhas, então tmux -CC e o protocolo de quadros do herdr não passam por ele. Ambos usam a própria interface em tela cheia dentro do shell mosh. As folhas nativas são alimentadas por uma segunda conexão SSH leve em paralelo — logo, se sua mesh passa UDP mas bloqueia SSH, você fica com tmux sem as listas nativas.

O attach direto do herdr é exclusivo por painel O Moshpit conecta com --takeover. Dois clientes Moshpit apontados para o mesmo painel do herdr vão disputar o controle, retomando a cada cerca de dois segundos. Isso é inerente ao attach exclusivo do herdr, não algo que o cliente consiga disfarçar. Uma TUI do herdr no desktop não ocupa dono de attach, então essa combinação deve ser segura — mas ainda não foi verificada.

O herdr 0.7.3 não informa o comando do painel A versão estável do Homebrew nessa época não traz o comando do painel no snapshot, então a barra de navegação cai para painel N. É cosmético, mas é a única entrada para a folha «Selecionar painel», então vale reconhecer.

Chaves de host confiáveis não podem ser listadas nem esquecidas A primeira conexão mostra a impressão digital e o comando ssh-keygen para conferir. Depois disso não existe tela listando em que você confiou, nem «esquecer este host», e apagar uma conexão mantém a impressão digital dela. Uma troca legítima de chave é resolvida aceitando a mudança no diálogo de aviso — que de propósito usa estilo destrutivo, com Desconectar como padrão.

Perguntas

Sobre alcançar a máquina, especificamente.

Eu preciso usar Tailscale?

Não. O Moshpit conecta a um endereço; como esse endereço fica acessível é totalmente com você. NetBird, headscale, WireGuard puro, ZeroTier, uma VPN corporativa ou um servidor com IP público real funcionam exatamente igual do lado do app. O Tailscale aparece aqui porque é o caminho mais curto do zero até funcionar.

O Moshpit consegue conectar por um jump host?

A versão 1.1.0 adicionou suporte a jump host de um salto via SSH (Conectar via) — veja Jump hosts. Ainda não há encadeamento de múltiplos saltos nem agent forwarding, e o mosh não passa por jump host porque precisa de UDP direto. Uma rede mesh continua dispensando jump host na maioria dos casos, e é por isso que este guia a recomenda.

Por que funciona no 5G, mas não no Wi-Fi do escritório?

Quase sempre uma rede que libera UDP de saída e descarta as respostas de volta — um perfil VPN split-tunnel, um proxy ou um firewall corporativo. O SSH continua funcionando porque usa TCP pelo mesmo caminho. Rode o teste nc -u acima nessa rede; se a resposta não chegar ali mas chegar nos dados celulares, você achou o culpado.

Posso rodar a VPN da empresa e uma mesh ao mesmo tempo?

Em geral não no iOS, que mantém apenas um túnel VPN ativo por vez. Se a VPN da empresa precisa ficar ligada, a mesh fica fora e você depende da rota que a rede corporativa oferece. É uma limitação do iOS, não algo que um app consiga contornar.

O Moshpit enxerga minha mesh ou minhas outras máquinas?

Não. Ele não faz descoberta de rede nem tem conta. Só conhece as conexões que você digitou, e o tráfego do terminal só vai para elas. A única peça operada pelo Moshpit é o relay de push de notificações, que carrega alertas selados de agentes que não consegue ler — ele nunca toca na sua mesh nem nas suas sessões. A permissão de Rede Local existe apenas para o iOS não descartar UDP para endereços da LAN, não para escanear nada.

Minha sessão mosh morreu quando cheguei em casa. Por quê?

Muito provavelmente o endereço. O mosh-server escuta só no endereço em que o login SSH chegou, então uma sessão aberta pela mesh não responde pela LAN e vice-versa. Salve a conexão com o nome da mesh e use-a em todo lugar, inclusive em casa. Veja Escolha um endereço acima.

Continue com Rodar o Claude Code pelo iPhone · Voltar aos guias