# 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](https://bambouville.com/docs/es/keys/#generar-una-clave) 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](https://bambouville.com/docs/es/connections/#hosts-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](https://bambouville.com/docs/es/port-forwarding/).

## 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](https://bambouville.com/docs/es/connections/#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](https://bambouville.com/docs/es/host-keys/#primera-conexión) 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](https://bambouville.com/docs/es/files/#seguir-a-tu-shell).

## 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](https://bambouville.com/docs/es/wsl-mtu/).

## 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](https://bambouville.com/docs/es/nearby-setup/)
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](https://bambouville.com/docs/es/nearby-setup/#antes-de-empezar).

## 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](https://bambouville.com/docs/es/continuity/).

## 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](https://bambouville.com/docs/es/agent-center/#cómo-funciona-la-detección).

## 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](https://bambouville.com/docs/es/notifications/).

## 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](https://bambouville.com/docs/es/unlimited-hosts/).

## 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](https://github.com/bambouville/tessera/issues). El registro
está depurado y solo sale de tu dispositivo cuando lo envías.
