Un enlace neoserver://, un clic, y NeoServer se despierta automáticamente, se conecta al servidor y abre la terminal en la posición que quieres — puede ser en una máquina específica, una sesión de tmux, o un directorio.

Guárdalo en los favoritos de Safari, Notas, como icono en el escritorio, en Atajos de Siri, o envíalo por AirDrop a un colega, todo funciona.

一、Cómo escribir el enlace de la terminal

Todos los enlaces de la terminal se ven así:

neoserver://terminal?host=<servidor>&port=<puerto>&user=<usuario>&tmuxName=<sesión-tmux>&zellijName=<sesión-zellij>&workdir=<directorio>

⚠️ tmuxName / zellijName / workdir solo se puede rellenar uno. Si rellenas varios, solo se reconocerá tmuxName, luego zellijName, y por último workdir.

Cópialo tal cual, simplemente cámbialo por tus datos:

# Lo más simple: solo el host
neoserver://terminal?host=1.2.3.4

# Especificar puerto y usuario
neoserver://terminal?host=1.2.3.4&port=2222&user=deploy

# Conectar y entrar directamente a la sesión main de tmux
neoserver://terminal?host=1.2.3.4&user=root&tmuxName=main

# Conectar y entrar directamente a la sesión dev de zellij
neoserver://terminal?host=1.2.3.4&user=root&zellijName=dev

# Conectar y hacer cd automáticamente al directorio de registros
neoserver://terminal?host=1.2.3.4&user=root&workdir=/var/log/nginx

二、Después de conectar, ¿dónde se abrirá la terminal?

Esta es la parte más útil del enlace de la terminal: dependiendo de los parámetros rellenados, el lugar donde se abre la terminal al conectar será diferente:

¿Por qué dividirlo en estos tres tipos?

• Sesiones tmux / zellij: Si se corta la red, se cierra la App, o te conectas desde otro teléfono, la sesión sigue ahí y no se pierden los procesos. Si compartes la sesión tmux de un servidor con un colega, ambos pueden entrar a la misma pantalla para solucionar problemas juntos.
• Directorio: En lugar de hacer cd /opt/app/logs cada vez que te conectas, es mejor que el enlace te deje directamente ahí.

三、Copiar el enlace desde la App (sin escribirlo a mano)

Escribir el enlace a mano es propenso a errores. NeoServer permite copiarlo con un clic en tres lugares; una vez copiado, simplemente pégalo donde quieras.

1. Copiar el enlace de «este servidor»

Pestaña Servidores · Lista de servidores → Desliza hacia la izquierda sobre un servidor → Copy Scheme Link

Lo que se copia es:

neoserver://terminal?host=...&port=...&user=...

2. Copiar en el modo quick de la terminal

Pestaña Terminal · Lista de servidores (modo quick) → Mantén pulsado sobre un servidor → Copy Scheme Link

3. Copiar el enlace de «esta sesión» ⭐ El más útil

Pestaña Terminal · Lista de sesiones → Mantén pulsado sobre una sesión → Copy Scheme Link

Este enlace empaquetará «conectar al servidor X en la sesión Y»:

• Si esta sesión es tmux → incluirá automáticamente &tmuxName=...
• Si esta sesión es zellij → incluirá automáticamente &zellijName=...
• Sesión normal → solo tendrá host/port/user

Al copiarse con éxito aparecerá Link Copied, y el enlace estará en el portapapeles.

💡 Mantén pulsado para copiar y enviar a un colega una sesión de tmux que se está ejecutando. Si él hace clic en NeoServer, se conectará directamente a la misma sesión —ambos entrarán en la misma pantalla de la terminal.

四、Cómo abrir este enlace

neoserver:// es un protocolo de enlaces de iOS, en cualquier lugar donde puedas hacer clic en un enlace se puede despertar NeoServer:

• Safari: Pégalo en la barra de direcciones y presiona Enter, o guárdalo en favoritos y haz clic.
• Notas / Recordatorios: Guarda una nota, haz un clic y entra directamente.
• Atajos: Pega el enlace en la acción «Abrir URL» → se puede vincular a la voz de Siri, iconos de escritorio o automatizaciones.
• AirDrop: Envía un enlace entre dos iPhone, la otra persona hace clic y se conecta.
• Correo: Envía el enlace como texto, el destinatario lo copia a Safari para abrirlo.

📱 La primera vez que haces clic en neoserver:// en el dispositivo real, iOS mostrará el mensaje «¿Abrir en NeoServer?», simplemente confirma y no volverá a aparecer.

五、Tres escenarios prácticos

🏠 Escenario 1: Hacer un icono en el escritorio para «conectar a tmux de producción»

Todos los días tienes que conectarte a la sesión main de tmux en la máquina de producción. En lugar de abrir la App → buscar el servidor → conectar → attach cada vez, es mejor crear un icono:

1. Copia el enlace de este servidor en la App, y añádele manualmente &tmuxName=main;
2. Abre «Atajos» en iOS → Nuevo → Añade la acción «URL», pega este enlace;
3. Añade la acción «Abrir URL»;
4. Haz clic en Compartir → Añadir a pantalla de inicio, nómbralo «Conectar a prod», elige un icono.

A partir de ahora, al hacer clic en este icono en el escritorio, NeoServer se conectará automáticamente y entrará en la sesión main, todo sin ningún paso adicional.

🎙️ Escenario 2: Conectar con la voz

Conecta el atajo anterior a Siri, y configura una frase como «Oye Siri, conectar a prod». Después de decirlo, el teléfono se conectará automáticamente.

🤝 Escenario 3: Enviar una sesión a un colega

1. Terminal · Lista de sesiones → Mantén pulsado en esta sesión → Copy Scheme Link;
2. Envíaselo a un colega (AirDrop / WeChat, cualquiera sirve);
3. Él hace clic en NeoServer → se conecta automáticamente (attach) a la misma sesión de tmux.

(Requisito: su iPhone también debe poder conectarse al mismo host desde la biblioteca de servidores de NeoServer.)

六、Preguntas frecuentes sobre enlaces de terminal

P: Hice clic en el enlace, ¿y me conecté al servidor equivocado? R: NeoServer busca el servidor por el host (+ port si se rellenó + user si se rellenó). Si tienes dos servidores en tu biblioteca con el mismo host, se conectará al primer coincidente. Rellenar el port o el user permite distinguirlos con precisión.

P: Si no tengo este servidor en la biblioteca, ¿qué pasa al hacer clic en el enlace? R: Saltará a la página de «Nuevo servidor», con host/port/user ya rellenados para ti. Añades la contraseña o clave privada → Guardar → Conexión automática, y la sesión / directorio incluidos en el enlace original también surtirán efecto.

P: ¿Puede el enlace incluir la contraseña directamente para ahorrar tener que rellenarla cada vez? R: No. Esta es una restricción de seguridad: el enlace nunca contiene la contraseña. Incluso si añades manualmente password=xxx, será ignorado. La contraseña solo pasa por el llavero dentro de la App.

P: ¿Se pueden poner directorios con espacios o caracteres chinos en workdir? R: Sí. Escríbelo directamente, por ejemplo workdir=/home/me/my logs. La App manejará automáticamente los caracteres especiales. La forma más segura es usar la función de copiar de la App en lugar de escribirlo a mano.

P: ¿Hice clic y no hay respuesta? R: ① Confirma que empieza por neoserver://; ② La primera vez aparecerá la confirmación de «Abrir en NeoServer»; ③ Comprueba que host no esté vacío; ④ No importa si la App no está en primer plano, se despertará automáticamente.

P: ¿Se puede abrir en Android / Windows? R: No. neoserver:// solo lo reconocen los iPhone / iPad que tienen NeoServer instalado.

七、Anexo: Abrir el centro de notificaciones

Además de la terminal, hay otro enlace para abrir el centro de notificaciones:

neoserver://notifications

Al hacer clic en el widget de notificaciones del escritorio, se ejecuta este enlace.