Un lien neoserver://, un clic, et NeoServer se réveille automatiquement, se connecte au serveur et ouvre le terminal exactement là où vous le souhaitez — que ce soit sur une machine spécifique, dans une session tmux ou dans un répertoire précis.

Vous pouvez le sauvegarder dans les favoris de Safari, dans Notes, comme icône sur le bureau, dans un raccourci Siri, ou l'envoyer via AirDrop à un collègue.

I. Comment écrire un lien de terminal

Tous les liens de terminal ressemblent à ceci :

neoserver://terminal?host=<serveur>&port=<port>&user=<utilisateur>&tmuxName=<session tmux>&zellijName=<session zellij>&workdir=<repertoire>

⚠️ tmuxName / zellijName / workdir ne peut contenir qu'un seul de ces paramètres. Si plusieurs sont renseignés, seul tmuxName est pris en compte, ensuite zellijName, et enfin workdir.

Copiez ceci, et modifiez-le selon vos besoins :

# Le plus simple : fournir uniquement le host
neoserver://terminal?host=1.2.3.4

# Spécifier le port et l'utilisateur
neoserver://terminal?host=1.2.3.4&port=2222&user=deploy

# Se connecter et entrer directement dans la session tmux main
neoserver://terminal?host=1.2.3.4&user=root&tmuxName=main

# Se connecter et entrer directement dans la session zellij dev
neoserver://terminal?host=1.2.3.4&user=root&zellijName=dev

# Se connecter et faire un cd automatique dans le répertoire des logs
neoserver://terminal?host=1.2.3.4&user=root&workdir=/var/log/nginx

II. Après la connexion, où s'arrête le terminal

C'est la partie la plus utile des liens de terminal — selon les paramètres renseignés, le terminal s'ouvrira à des endroits différents après la connexion :

Pourquoi distinguer ces trois options ?

• Sessions tmux / zellij : En cas de coupure réseau, fermeture de l'App ou changement de téléphone, la session reste active et les processus ne sont pas perdus. Partagez la session tmux d'un serveur avec un collègue, et vous pourrez tous les deux entrer dans le même écran pour dépanner ensemble.
• Répertoire : Plutôt que de devoir taper cd /opt/app/logs à chaque connexion, laissez le lien vous y placer directement.

III. Copier le lien depuis l'App (sans l'écrire à la main)

Écrire un lien à la main est source d'erreurs. NeoServer permet de le copier en un clic à trois endroits différents. Il vous suffit ensuite de le coller où vous le souhaitez.

1. Copier le lien de « ce serveur »

Onglet Serveurs · Liste des serveurs → Glissez vers la gauche sur un serveur → Copy Scheme Link

Le lien copié sera :

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

2. Copier depuis le mode rapide du terminal

Onglet Terminal · Liste des serveurs (mode quick) → Appui long sur un serveur → Copy Scheme Link

3. Copier le lien de « cette session » ⭐ Le plus utile

Onglet Terminal · Liste des sessions → Appui long sur une session → Copy Scheme Link

Ce lien intègre « la connexion au serveur X dans la session Y » :

• Si la session est tmux → inclut automatiquement &tmuxName=...
• Si la session est zellij → inclut automatiquement &zellijName=...
• Session normale → uniquement host/port/user

Une fois copié avec succès, la notification Link Copied s'affiche, et le lien se trouve dans votre presse-papiers.

💡 Faites un appui long pour copier une session tmux en cours d'exécution et envoyez-la à un collègue. S'il l'ouvre via NeoServer, il s'y attachera directement — vous vous retrouverez tous les deux dans le même écran de terminal.

IV. Comment ouvrir ce lien

neoserver:// est un protocole de lien iOS, partout où vous pouvez cliquer sur un lien, NeoServer peut être réveillé :

• Safari : Collez-le dans la barre d'adresse et appuyez sur Entrée, ou enregistrez-le dans vos favoris pour y cliquer.
• Notes / Rappels : Enregistrez une note, cliquez dessus pour y accéder directement.
• Raccourcis : Mettez le lien dans l'action « Ouvrir l'URL » → peut être lié à Siri, à une icône sur le bureau, ou à une automatisation.
• AirDrop : Envoyez un lien entre deux iPhone, et l'autre personne peut cliquer dessus pour se connecter.
• Mail : Envoyez le lien sous forme de texte, le destinataire le copie dans Safari pour l'ouvrir.

📱 Lors du tout premier clic sur neoserver:// sur l'appareil, iOS affichera la fenêtre « Ouvrir dans NeoServer ? », confirmez et elle ne réapparaîtra plus.

V. Trois scénarios pratiques

🏠 Scénario 1 : Mettre la « connexion au tmux de production » en icône sur le bureau

Vous devez vous connecter tous les jours à la session tmux main de la machine de production. Au lieu d'ouvrir l'App → chercher le serveur → se connecter → s'attacher, autant en faire une icône :

1. Copiez le lien de ce serveur dans l'App, puis ajoutez manuellement &tmuxName=main ;
2. Ouvrez Raccourcis sur iOS → Nouveau → ajoutez l'action « URL », et collez ce lien ;
3. Ajoutez l'action « Ouvrir l'URL » ;
4. Cliquez sur Partager → Ajouter à l'écran d'accueil, nommez-le « Connexion Prod », et choisissez une icône.

Désormais, en cliquant sur cette icône depuis le bureau, NeoServer se connectera automatiquement et entrera dans la session main, sans aucune manipulation.

🎙️ Scénario 2 : Se connecter à la voix

Associez le raccourci ci-dessus à Siri, avec la phrase « Dis Siri, connexion prod ». Une fois prononcée, le téléphone se connecte automatiquement.

🤝 Scénario 3 : Envoyer une session à un collègue

1. Terminal · Liste des sessions → Appui long sur la session → Copy Scheme Link ;
2. Envoyez-le à un collègue (via AirDrop / WeChat, peu importe) ;
3. Il clique dessus pour l'ouvrir dans NeoServer → il s'attache automatiquement à la même session tmux.

(Condition préalable : la bibliothèque de serveurs de NeoServer sur son iPhone doit également être capable de se connecter au même host.)

VI. Questions fréquentes sur les liens de terminal

Q : J'ai cliqué sur le lien, mais je suis connecté au mauvais serveur ? R : NeoServer recherche le serveur par host (+ port si renseigné + user si renseigné). Si vous avez deux serveurs avec le même host dans votre bibliothèque, il se connectera à la première correspondance. Renseigner le port ou l'user permet de les différencier avec précision.

Q : Que se passe-t-il si je clique sur le lien alors que le serveur n'est pas dans la bibliothèque ? R : Vous serez redirigé vers la page « Nouveau serveur », avec host/port/user déjà pré-remplis. Ajoutez le mot de passe ou la clé privée → Enregistrez → Connexion automatique, la session / le répertoire inclus dans le lien d'origine s'appliqueront également.

Q : Le lien peut-il contenir directement le mot de passe pour éviter de le saisir à chaque fois ? R : Non. Il s'agit d'une restriction de sécurité — le lien ne contient jamais le mot de passe. Même si vous ajoutez manuellement password=xxx, il sera ignoré. Le mot de passe passe uniquement par le trousseau (Keychain) de l'App.

Q : Les répertoires avec des espaces ou des caractères chinois peuvent-ils être utilisés dans workdir ? R : Oui. Écrivez-les directement, par exemple workdir=/home/me/my logs. L'App gérera automatiquement les caractères spéciaux. La méthode la plus sûre consiste à utiliser la fonction copier de l'App plutôt qu'à l'écrire à la main.

Q : Je clique mais rien ne se passe ? R : ① Vérifiez qu'il commence bien par neoserver:// ; ② Lors de la première utilisation, la confirmation « Ouvrir dans NeoServer » s'affiche ; ③ Vérifiez que host n'est pas vide ; ④ Ce n'est pas grave si l'App n'est pas au premier plan, elle se réveillera automatiquement.

Q : Ça peut être ouvert sur Android / Windows ? R : Non. neoserver:// n'est reconnu que par les iPhone / iPad sur lesquels NeoServer est installé.

VII. Annexe : Ouvrir le centre de notifications

En plus du terminal, il y a un autre lien pour ouvrir le centre de notifications :

neoserver://notifications

Le widget de notification sur le bureau utilise exactement celui-ci.