Resolución de problemas

Las claves RSA no son compatibles

Tessera no puede generar ni importar claves RSA: la pila SSH actual solo puede ofrecer la firma obsoleta RSA/SHA-1. Genera una clave Ed25519 en su lugar — todos los servidores OpenSSH modernos la aceptan. Las claves RSA que queden de versiones anteriores se muestran desactivadas.

Mosh no conecta

• ¿Está mosh-server instalado en el servidor?
• ¿Puede el UDP llegar al servidor? Algunos cortafuegos y la mayoría de los NAT lo bloquean; mosh necesita los puertos UDP 60000–61000 por omisión.
• A través de un host de salto: el UDP de mosh no puede atravesar bastiones. Tessera avisa («mosh es inalcanzable a través de la cadena de saltos…») y recurre a SSH.

El reenvío rechaza un puerto local

El sandbox de iOS no puede enlazar puertos por debajo de 1024 — elige un puerto local más alto. Los puertos locales tampoco pueden repetirse dentro de un mismo host. Consulta reenvío de puertos.

El reenvío está desactivado en un host con Mosh

Con el transporte mosh y el modo de inicio personalizado no hay ninguna conexión SSH que lleve los reenvíos. Cambia el modo de inicio a tmux automático o tmux con nombre — esos mantienen un canal lateral SSH que el reenvío puede aprovechar.

Una conexión se queda en «conectando» o «iniciando tmux»

Espera doce segundos: la superposición de inicio nombra la etapa en la que se ha quedado y ofrece editar el host, reintentar y atrás — se acabaron los indicadores giratorios indefinidos. Si el problema es el propio tmux (no está instalado, no arranca o los dotfiles del host ya lanzan tmux al iniciar sesión), Tessera cae a un shell simple con un aviso que nombra el motivo. Y si una sesión se conecta pero la pantalla se queda en blanco, un aviso dice «pulsa cualquier tecla para despertarla» — hazlo. Consulta cuando una conexión se atasca.

tmux no aplicó mis cambios

Las variables de entorno y los fragmentos de inicio solo se ejecutan cuando arranca la sesión de tmux. Cierra la sesión en el servidor (tmux kill-session) y vuelve a conectar.

El panel de archivos dice que la clave del host no es de confianza

El puente de archivos es una conexión SSH aparte con las mismas reglas de confianza. Abre una sesión de terminal al host, revisa la hoja de host desconocido y acepta la clave — después vuelve a abrir el panel.

El panel de archivos no sigue a mi shell

El seguimiento de directorio necesita OSC 7 desde tu shell. Usa el botón Activar el seguimiento: instalar la integración con el shell del panel y luego exec $SHELL o vuelve a conectar. Los detalles, en archivos.

Las sesiones a un host WSL se congelan a mitad de la salida

La conexión está bien, pero las ráfagas grandes de salida nunca llegan — un desajuste de MTU en el adaptador virtual de WSL2, que se traga todos los paquetes grandes. Consulta bloqueos de MTU en WSL.

Fallan las conexiones en la red local

iOS controla el acceso a la LAN con el permiso Red local. Si lo denegaste, vuelve a activarlo en la app Ajustes, dentro de Tessera. Ese mismo permiso es el que deja que la configuración cercana encuentre tu otro dispositivo.

La configuración cercana no encuentra dispositivos

Ambos dispositivos deben tener Tessera abierto en la pantalla de configuración, en primer plano, en la misma red y con el permiso Red local concedido en los dos. Un desajuste de versiones se detiene con un mensaje explícito de «Actualiza Tessera en …». Consulta configuración cercana.

Handoff no aparece en el otro dispositivo

Handoff es fontanería de Apple: la misma cuenta de Apple en ambos dispositivos, Bluetooth y wifi activados, y Handoff habilitado en la app Ajustes de iOS. Un dispositivo bloqueado deja de emitir a propósito. Recuperar el control de las sesiones de tmux compartidas necesita además tmux 3.2+ en el servidor. Consulta continuidad.

Una tarjeta de agente dice «estado no disponible»

La detección encontró el agente, pero el estado preciso necesita el hook de estado de ese host — instálalo o actualízalo desde la tarjeta. En Codex, el primer arranque integrado puede pedirte además que confíes en el hook con /hooks. Consulta centro de agentes.

No llegan las notificaciones

Comprueba el permiso de notificaciones de iOS (la hoja de ajustes de la campana enlaza directamente con él). Recuerda que la entrega en segundo plano se hace en la medida de lo posible: iOS puede suspender las sesiones largas en segundo plano. Consulta notificaciones.

Una compra no se trasladó

ajustes → hosts ilimitados → restaurar compras vuelve a comprobar tu cuenta de Apple — cubre las reinstalaciones, los dispositivos nuevos y el desbloqueo incluido con la compra original de la app de pago. Consulta gratis y hosts ilimitados.

Otra cosa

ajustes → diagnósticos → enviar al desarrollador abre un correo ya dirigido con el registro de diagnóstico adjunto — lo ves todo antes de tocar enviar. (Necesita una cuenta de correo en el dispositivo; si no la hay, usa exportar el registro y envía el archivo desde cualquier app de correo.) O abre una incidencia en GitHub Issues. El registro está depurado y solo sale de tu dispositivo cuando lo envías.