Guía

Llegar a tu máquina desde cualquier lugar

El equipo donde corren tus agentes suele estar detrás de NAT: un router doméstico, una red de oficina o un portátil sobre una mesa. Así es como llegas a él desde el teléfono sin exponer SSH a la internet pública.

Hay dos formas de resolver esto. Una es reenviar un puerto en el router. La otra es meter ambas máquinas en una red en malla privada, para que tu teléfono tenga una dirección estable de ese equipo y no haya nada escuchando en internet. Esta guía trata la segunda opción, porque la primera es como la gente pierde servidores.

1 Mete el servidor en una malla

Tailscale, NetBird, headscale o WireGuard a mano: por debajo todos son una malla WireGuard. Un comando en el servidor y ya tiene una dirección estable a la que solo llegan tus propios dispositivos.

Tailscale asigna direcciones en 100.64.0.0/10 y un nombre como m1-pro.tu-tailnet.ts.net.

2 Mete el teléfono en la misma malla

Instala la app de iOS del proveedor e inicia sesión. Instala un perfil VPN. Moshpit no interviene en absoluto en este paso.

iOS ejecuta un solo túnel VPN a la vez, así que por lo general una VPN corporativa y tu malla no pueden estar activas simultáneamente.

3 Añade la conexión en Moshpit

Host = el nombre o la dirección de la malla. Puerto = 22 salvo que lo hayas cambiado. Nombre de usuario y luego Clave SSH en AUTENTICACIÓN.

Moshpit se conecta exactamente a la dirección que escribiste. Esa es toda la integración.

Moshpit no incluye VPN de ningún tipo ni integración con Tailscale. No marca, no enruta ni descubre dispositivos. Abre una conexión TCP al texto del campo Host y, con mosh, envía UDP a ese mismo destino. Si tu teléfono alcanza esa dirección, Moshpit también.

Existe un campo useTailscale en el modelo de conexión guardada. Nada en la app lo lee y no aparece en el formulario. Es un resto antiguo, y preferimos decirlo aquí antes que hacerte buscar un interruptor que no existe.

Primero, lo que no debes hacer

No reenvíes el puerto 22 con contraseña.

Un puerto SSH recién expuesto aparece en los escáneres en cuestión de minutos. La autenticación por contraseña convierte eso en un juego de adivinanzas con intentos ilimitados, operado por bots que no hacen otra cosa. Una malla elimina el objetivo en lugar de blindarlo.

Si de verdad no tienes alternativa

Algunas redes impiden usar una malla. Si no te queda más remedio que exponer SSH, el mínimo es autenticación solo por clave — y ten claro que es un mínimo, no una recomendación:

# /etc/ssh/sshd_config.d/moshpit.conf
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
AuthenticationMethods publickey
# comprueba la sintaxis y recarga: sudo sshd -t && sudo systemctl reload ssh

Tres cosas sobre Moshpit que debes saber antes de diseñar alrededor de esto:

  • Dos métodos de autenticación, sin un tercero. Contraseña y clave pública. No hay keyboard-interactive, así que un sshd configurado para pedir un código TOTP no podrá autenticarse desde Moshpit.
  • Sin ProxyJump, sin bastión y sin reenvío de agente. «Entrar primero por SSH a un equipo puente» no es algo que soporte esta ruta. Los campos jumpHost y forwardAgent existen en el modelo y nada los lee aquí.
  • Las claves privadas cifradas con frase de contraseña no funcionan. La clave se carga sin clave de descifrado, por lo que un PEM cifrado falla al autenticar. En su lugar, genera una clave dentro de Moshpit (Ajustes → Claves SSH → +) y copia su mitad pública al servidor: esas pueden guardarse en el Secure Enclave y protegerse con Face ID.

Por qué importa UDP

UDP aparece dos veces, por motivos distintos.

Una vez por debajo, porque WireGuard es un protocolo UDP. Otra vez por encima, porque mosh también lo es. Fallan de formas diferentes, así que conviene tenerlos separados en la cabeza.

La malla, por debajo

wireguard · udp

  • Tailscale intenta crear una ruta UDP directa entre ambas máquinas: su puerto de escucha predeterminado es el 41641, saliente desde los dos extremos
  • Cuando no logra atravesar el NAT, retransmite (relay) el tráfico. Retransmitido sigue funcionando, a costa de más latencia
  • tailscale status en cualquiera de los dos extremos te dice qué consiguió: direct o un relay
  • Nada de esto necesita un puerto entrante en tu router

mosh, por encima

dentro del túnel

  • Mosh es UDP de extremo a extremo, y sobre una malla es UDP dentro del túnel: tu router nunca lo ve
  • mosh-server enlaza un puerto por sesión dentro del rango configurado, por omisión 60000–61000
  • Moshpit envía datagramas a la misma dirección de host que escribiste en el formulario, al puerto que indicó el servidor
  • Mosh no puede arrancar sin un inicio de sesión SSH funcional antes: TCP tiene que funcionar antes de que UDP importe
El arranque, paso exacto

SSH lo arranca y luego se aparta

Moshpit ejecuta un único comando sobre la sesión SSH autenticada, lee la línea que imprime y cierra SSH. A partir de ahí todo es UDP.

Por eso bloquear SSH después de conectar no mata una sesión de mosh, mientras que bloquear UDP sí. También explica por qué una malla que lleva bien TCP pero retransmite mal UDP hace que mosh se sienta peor que un SSH normal.

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 = una clave AES-128 de 16 bytes>

Qué tiene que estar abierto y dónde

QuéPuertoDirecciónPor qué
SSHTCP 22 (o tu puerto) Entrante en el servidor Mosh no tiene modo independiente: SSH arranca mosh-server y devuelve la clave
Sesión moshUDP 60000–61000 Entrante en el servidor, saliente desde el teléfono Un puerto por sesión, elegido por mosh-server dentro del rango
Ruta directa de la mallaUDP 41641 Saliente desde ambos extremos Valor por omisión de Tailscale. Si está bloqueado usa relay, no se rompe
Tu routerNada — Sin puertos reenviados. Esa es justo la gracia de hacerlo así

En una malla, «entrante en el servidor» significa en la interfaz de la malla. El firewall del host sigue aplicándose ahí: ufw, firewalld y los grupos de seguridad de la nube están entre el túnel y mosh-server. Abrir el rango en tailscale0 no es lo mismo que abrirlo al mundo, y suele ser el paso que la gente se salta.

Cambia el rango en Ajustes → MOSH · ITINERANCIA → Rango de puertos UDP (Desde / Hasta, validado entre 1 y 65535 con Desde ≤ Hasta). El formulario de conexión muestra el mismo rango en solo lectura. Un puerto inicial fuera de ese rango omite -p por completo y mosh-server usa su valor predeterminado; un final no utilizable fija la sesión al único puerto inicial.

La trampa

Elige una dirección y úsala en todas partes.

Este es el fallo que más parece un bug y no lo es. Le cuesta una tarde entera a mucha gente, así que se gana su propia sección.

Moshpit lanza mosh-server new -s. Esa opción equivale a --bind-server=ssh, el valor predeterminado desde mosh 1.4: el servidor enlaza únicamente la dirección por la que llegó la conexión SSH. Es una decisión deliberada para que los datagramas sigan la misma ruta por la que entraste.

La consecuencia:

  • Una sesión iniciada en casa conectando a 192.168.1.30 tiene su mosh-server enlazado a 192.168.1.30. Desde la malla, ese servidor es inalcanzable.
  • Una sesión iniciada por la malla enlaza la dirección de la malla y no responde desde la LAN.
  • Ninguno de los dos casos es un fallo de Moshpit. Es exactamente lo que significa --bind-server=ssh.

Por tanto: guarda la conexión con el nombre de la malla y úsalo también en casa. El tráfico hacia tu propia LAN por una malla toma una ruta local directa de todas formas. Una dirección, una conexión guardada y cero sorpresas al salir del edificio.

Los procesos mosh-server huérfanos se acumulan

Cada conexión arranca un mosh-server nuevo. Cuando el enlace muere, el anterior no termina: se queda ocupando su puerto UDP. Tras semanas de reconexiones se acumulan. Moshpit no los limpia, y eso es una carencia real, no una decisión de diseño.

pgrep -fl mosh-server                 # qué sigue en ejecución
lsof -nP -iUDP | grep mosh-server     # y a qué dirección está enlazado cada uno
pkill -f mosh-server                  # la solución drástica; cierra también sesiones vivas

Las direcciones enlazadas del segundo comando sirven además de diagnóstico: te dicen desde qué red se creó cada sesión, lo que suele bastar para explicar por qué una dejó de responder.

iOS

El permiso de Red local y cómo se ve cuando está denegado

iOS protege el acceso a direcciones de la red local detrás de un aviso único. Si lo descartaste hace meses en otra pantalla de la app, este es el síntoma que verás.

Aviso

Aparece una sola vez

En la primera conexión a una dirección LAN. El motivo que muestra Moshpit es: «Moshpit se conecta por SSH y mosh (UDP) a los servidores de tu red local. Sin este permiso, las conexiones a hosts como 192.168.x.x fallan.»

Denegado

SSH conecta, mosh se queda en negro

iOS descarta silenciosamente los paquetes UDP hacia direcciones LAN sin avisar a nadie. TCP no se ve afectado, así que SSH funciona perfecto y solo mosh queda en negro con un cursor vivo.

Solución

Ajustes → Moshpit → Red local

El aviso no vuelve a salir solo. Actívalo ahí y vuelve a conectar la sesión.

Alcance, dicho sin rodeos: esto afecta a direcciones LAN — 192.168.x.x, 10.x.x.x y similares. El tráfico hacia una dirección de malla sale en cambio por la interfaz del túnel VPN. Concede el permiso de todos modos si existe la mínima posibilidad de conectarte a esa máquina por su IP de LAN, porque el fallo que produce es indistinguible de un problema de firewall y te hará perder la tarde buscando donde no es.

Verificar

Seis comprobaciones, en este orden

Cada una descarta la capa inferior. No te saltes pasos: la respuesta casi siempre está en el 1 o el 2.

1 · ¿Está activo el par y es directo?

tailscale status          # la línea del par termina en "direct" o en el nombre de un relay
tailscale ip -4           # la dirección que debes poner en el campo Host

Un par por relay sigue funcionando. Es más lento, y en un mal día marca la diferencia entre un terminal usable y uno inutilizable.

2 · ¿Funciona SSH normal desde un portátil en la misma malla?

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

Si esto falla, para aquí. Nada por encima puede funcionar: mosh no tiene modo independiente y Moshpit es ante todo un cliente SSH.

3 · ¿De verdad va y vuelve UDP?

Esta es la prueba que nadie hace y la que encuentra el problema. Elige un puerto dentro de tu rango, escucha en el servidor y envía desde un equipo en la misma red que el teléfono:

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

# desde un portátil en el mismo Wi-Fi que el teléfono
echo PING | nc -u -w3 m1-pro.tu-tailnet.ts.net 60005

Cada lado debe ver la palabra del otro. Si el servidor ve PING pero el cliente nunca recibe REPLY, el camino de vuelta está muerto, que es exactamente la pantalla negra de mosh. Eso es una respuesta de red, no de la app.

4 · ¿Está abierto el rango en la interfaz por la que llega el tráfico?

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

Comprueba después por separado el grupo de seguridad de la nube si tienes uno. Y confirma que sea el mismo rango que tiene configurado Moshpit: el predeterminado es 60000–61000, pero se puede editar.

5 · Pregunta a la app qué está viendo

Mantén pulsada la píldora de transporte en la barra superior del terminal durante una sesión de mosh para abrir DIAGNÓSTICO DE MOSH: datagrams, applied, parse fails, gaps. La línea que más importa es la que no lleva número:

DIAGNÓSTICO DE MOSH
   Aún no llegan datagramas.

Eso significa que literalmente no ha vuelto nada: el contador sube antes de cualquier descifrado o análisis. Camino de vuelta muerto. Deja de depurar Moshpit y vuelve al paso 3.

6 · Usa la salida de emergencia

Si una red se está comiendo tu tráfico UDP y necesitas un terminal ya, toca Cambiar a SSH en el aviso, o toca la píldora MOSH en la barra superior y confirma «¿Cambiar a SSH?». SSH va por TCP a través de la misma ruta que descartó los datagramas. El aviso se puede cerrar y nunca bloquea el terminal: tus pulsaciones llegaban al servidor todo el tiempo, solo faltaba el dibujado de vuelta.

⚠  Mosh no recibe datos. Puede que tu red esté
   bloqueando UDP (VPN, proxy o firewall).

   Cambiar a SSH                                    ×

Un dato real, no una promesa

Todavía no hay métricas agregadas de usuarios. Hay un host de desarrollo contra el que probamos, y sus mediciones son más útiles que un adjetivo.

Un Mac por Tailscale, ruta directa a través de una salida móvil china: RTT de 433–640 ms, alrededor de 13 % de pérdida de paquetes. El saludo SSH tarda entre 5,8 y 9 segundos en ese enlace. Mosh funciona ahí. La primera pantalla de una sesión mosh sola aparece en unos 10 segundos; mosh más tmux necesita dos saludos SSH y tarda entre 20 y 25 segundos antes de rellenar la barra de ruta nativa.

Es un solo enlace, medido una vez, en hardware propio. No es un benchmark y tu conexión será distinta. Está aquí porque «sobrevive a la pérdida de paquetes» es el tipo de afirmación que conviene acompañar con números.

Dos cosas que nos enseñó ese enlace y que conviene esperar: un portátil que entra en reposo desaparece por completo de la malla (directo → relay → sin conexión), y un servidor tmux con una configuración pesada de plugins puede bloquearse en el primer arranque. Ninguno es un fallo de red, y ambos parecen exactamente uno.

Límites que conviene conocer antes de confiar en esto

Lo que sigue sin funcionar incluso cuando ya llegas al equipo.

La app se suspende en segundo plano iOS suspende Moshpit, su temporizador keepalive de 12 segundos y sus sondeos. El estado en vivo de los agentes deja de actualizarse hasta que vuelves a la app, momento en que se pone al día; las alertas de agentes siguen llegando porque el host las envía por su cuenta, cifradas de extremo a extremo. Si pasas más de 20 segundos fuera, Moshpit fuerza una reconexión limpia al volver en vez de confiar en una comprobación que puede dar falso positivo en un socket a medio abrir.

Sobre mosh, tmux y herdr usan su propia TUI Mosh transmite diferencias de pantalla renderizada, no un flujo de bytes por líneas, así que tmux -CC y el protocolo de tramas de herdr no pueden viajar por él. Ambos vuelven a su interfaz a pantalla completa dentro de la shell de mosh. Las hojas nativas se alimentan de una segunda conexión SSH ligera en paralelo: así que si tu malla pasa UDP pero bloquea SSH, tienes tmux sin las listas nativas.

La conexión directa de herdr es exclusiva por panel Moshpit se conecta con --takeover. Dos clientes de Moshpit apuntando al mismo panel de herdr pelearán por él, reclamándolo cada dos segundos aproximadamente. Es inherente al modo exclusivo de herdr, no algo que el cliente pueda disimular. Una TUI de herdr en escritorio no ocupa ese hueco exclusivo, así que esa combinación debería ser segura, aunque no la hemos verificado.

herdr 0.7.3 no reporta el comando del panel La versión estable de Homebrew no incluye el comando de cada panel en su instantánea, así que la barra de ruta recurre a panel N. Es cosmético, pero es la única entrada a la hoja Seleccionar panel, así que conviene reconocerlo.

Las claves de host de confianza no se pueden listar ni olvidar La primera conexión muestra la huella y el comando ssh-keygen para comprobarla. Después no hay ninguna pantalla que liste en qué hosts confías ni opción para «olvidar este host», y eliminar una conexión deja su huella guardada. Un cambio legítimo de clave se gestiona aceptando el cambio en el aviso — que a propósito tiene estilo destructivo, con Desconectar como opción predeterminada.

Preguntas

Sobre llegar a la máquina, en concreto.

¿Tengo que usar Tailscale?

No. Moshpit se conecta a una dirección; cómo haces accesible esa dirección depende por completo de ti. NetBird, headscale, WireGuard puro, ZeroTier, una VPN corporativa o un servidor con IP pública real funcionan igual desde el lado de la app. Mencionamos Tailscale porque es el camino más corto desde cero hasta tenerlo andando.

¿Puede Moshpit conectarse mediante un host de salto?

No en esta ruta de malla ni con mosh. Aquí no hay ProxyJump, soporte de bastión ni reenvío de agente. Los campos jumpHost y forwardAgent existían en el modelo guardado sin leerse aquí. Una malla evita tener que usar uno, que es parte de por qué esta guía la recomienda.

¿Por qué funciona en 5G pero no en el Wi-Fi de la oficina?

Casi siempre es una red que deja salir UDP pero descarta las respuestas entrantes: un perfil VPN de túnel dividido, un proxy o un firewall corporativo. SSH sigue funcionando porque usa TCP por la misma ruta. Ejecuta la prueba nc -u de arriba desde esa red; si la respuesta nunca llega ahí y sí por datos móviles, ya tienes el diagnóstico.

¿Puedo usar la VPN de mi empresa y una malla al mismo tiempo?

Por lo general no en iOS, que solo mantiene un túnel VPN activo a la vez. Si la VPN de la empresa debe estar conectada, la malla no lo estará y dependerás de la ruta que ofrezca la red corporativa. Es una limitación de iOS, no algo que una app pueda sortear.

¿Moshpit ve mi malla o mis otras máquinas?

No. No tiene descubrimiento de red ni cuenta. Solo conoce las conexiones que tú escribiste, y el tráfico del terminal va únicamente hacia ellas. La única pieza operada por Moshpit es el servidor relay de notificaciones push, que transporta alertas cifradas que no puede leer y nunca toca tu malla ni tus sesiones. El permiso de Red local existe únicamente para que iOS no descarte UDP hacia direcciones LAN, no para escanear nada.

Mi sesión de mosh murió al llegar a casa. ¿Por qué?

Casi seguro por la dirección. mosh-server enlaza solo la dirección por la que llegó tu inicio de sesión SSH, así que una sesión creada por la malla no responde desde la LAN ni al revés. Guarda la conexión con el nombre de la malla y úsalo en todas partes, también en casa. Consulta Elige una dirección más arriba.

Continúa con Ejecutar Claude Code desde tu iPhone · Volver a las guías