Soporte de Tunnelyard

Tunnelyard funciona dentro del sandbox del App Store, así que solo puede leer las carpetas que tú eliges. Usa Permitir acceso a ~/.ssh… en la guía de bienvenida, o Dar acceso… en la sección Autenticación de cualquier túnel. En el panel que se abre:

1. El panel se abre en tu carpeta .ssh. Haz clic en Dar acceso.
2. Si muestra otra carpeta: presiona ⌘⇧H para ir a tu carpeta de inicio, ⌘⇧. si no ves las carpetas ocultas, elige .ssh y haz clic en Dar acceso.

El acceso es de solo lectura y se recuerda entre aperturas. Tunnelyard usa entonces los alias, HostName, User, Port, IdentityFile y ProxyJump de tu ~/.ssh/config, y tus archivos de clave. Nunca escribe ahí. Puedes quitarlo cuando quieras con Revocar en la sección Autenticación.

En la sección Autenticación del túnel, haz clic en Importar clave… y elige el archivo de la clave privada (el que no termina en .pub, por ejemplo id_ed25519). Se admiten claves Ed25519, ECDSA y RSA en formato OpenSSH, con o sin frase de contraseña. La clave se copia a tu llavero de macOS, así el túnel funciona aunque no haya acceso a ~/.ssh. Quitar clave del llavero borra esa copia.

• Claves PEM antiguas (BEGIN RSA PRIVATE KEY): convierte una copia al formato OpenSSH con ssh-keygen -p -f <clave>.
• Claves de PuTTY: expórtalas desde PuTTYgen como clave OpenSSH.
• Las claves ECDSA con frase de contraseña aún no se admiten: usa una clave Ed25519 o importa una copia sin cifrar (queda guardada en tu llavero).

Por ahora Tunnelyard solo puede firmar con RSA usando firmas ssh-rsa (SHA-1). Los servidores OpenSSH 8.8 y posteriores las rechazan por defecto, así que una clave RSA puede fallar con “rechazó la clave RSA”. Las claves Ed25519 o ECDSA funcionan con todos los servidores actuales. Recomendamos Ed25519:

ssh-keygen -t ed25519 -C "tu@mac"

Luego agrega la nueva línea .pub a ~/.ssh/authorized_keys en el servidor (por ejemplo con ssh-copy-id -i ~/.ssh/id_ed25519.pub usuario@servidor en Terminal) y elige o importa la nueva clave en Tunnelyard.

Tunnelyard recuerda la clave de host de cada servidor la primera vez que confías en ella. Si después el servidor ofrece otra clave, no se conecta, porque puede significar que alguien está interceptando la conexión. También es normal después de reinstalar o reconstruir el servidor, o de rotar sus claves.

1. Pregúntale al administrador del servidor o revísalo en el propio servidor: ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub.
2. Si la huella coincide con la que muestra Tunnelyard, elige Reemplazar clave de confianza…. También puedes quitar una clave de confianza en la sección Clave de host del túnel con Olvidar.
3. Si no coincide, no te conectes.

Tunnelyard mantiene su propia lista de claves de confianza; no lee ni modifica ~/.ssh/known_hosts.

Otra app (u otro túnel) ya escucha en ese puerto de tu Mac; suele ser una base de datos local o una segunda copia del mismo túnel. Tunnelyard lo revisa antes de conectar y sugiere el siguiente puerto libre: haz clic en Usar … para cambiarlo, o cambia el puerto local en Reenvío de puertos. Para ver qué app lo ocupa, ejecuta en Terminal: lsof -nP -iTCP:5432 -sTCP:LISTEN (cambia 5432 por tu puerto).

• Sin ssh-agent. Tunnelyard no puede usar claves cargadas en ssh-agent, en el agente de 1Password ni en otro agente. Importa la clave o da acceso a ~/.ssh para que lea el archivo.
• Sin llaves de hardware. No se admiten YubiKey/FIDO (sk-ssh-ed25519, sk-ecdsa), tarjetas inteligentes ni PKCS#11.
• Sin comandos externos. Se ignoran ProxyCommand y los bloques Match de ~/.ssh/config. ProxyJump sí funciona, igual que HostName, User, Port, IdentityFile, Include y las líneas de reenvío.
• Cliente SSH propio. Tunnelyard no ejecuta /usr/bin/ssh, así que no comparte ~/.ssh/known_hosts y algunas opciones exclusivas de OpenSSH no están disponibles.
• No toca la configuración del sistema. Para un túnel SOCKS, Tunnelyard muestra los comandos para enviar todo el tráfico del Mac por él; tú los ejecutas en Terminal.

Sí. Si se corta la red o el servidor deja de responder, se reconecta automáticamente y mantiene listos los puertos locales. La sección Salud de la conexión del túnel muestra el tiempo conectado, el tráfico y el último problema (atenuado cuando el túnel ya volvió a conectarse). Opciones como Conectar automáticamente al abrir y Tolerar cortes breves de red están en los ajustes del túnel; Abrir al iniciar sesión está en Preferencias.

Solo en tu Mac: los túneles en el contenedor de la app, las claves y contraseñas guardadas en tu llavero. Tunnelyard no recopila datos. Revisa la política de privacidad.