Aller au contenu

Hôtes et groupes

Ce que fait chaque champ, interrupteur et paramètre : 99 éléments sur cette page. C’est le texte derrière le ⓘ à côté de chaque libellé dans les applications : sur ordinateur, survolez-le ou cliquez dessus (ou appuyez sur F1 dans le champ) ; sur le téléphone, touchez-le.

La ligne sous chaque nom donne l’identifiant que le code utilise et indique quand une seule des applications a l’élément.

Où: Hôtes › Nouvel hôte, ou Modifier sur un hôte.

host.label

Le nom de cet hôte dans votre liste. Il n’est que pour vous : il n’est jamais envoyé au serveur et ne sert pas à la connexion.

  • Exemple: web-01 (production)
  • Attention: Obligatoire, 256 caractères maximum.

host.address

L’emplacement du serveur : un nom d’hôte, ou une adresse IPv4 ou IPv6. Seule l’adresse va ici ; le port et le nom d’utilisateur ont leurs propres champs, donc user@host et host:22 sont refusés.

  • Exemple: web.example.com, 10.0.0.12 ou 2001:db8::1

host.group

Le dossier dans lequel se trouve cet hôte. Un hôte reprend chaque paramètre qu’il ne définit pas lui-même de son groupe, puis des groupes au-dessus, puis des Paramètres.

  • Par défaut: Aucun groupe.
  • Attention: Déplacer un hôte vers un autre groupe change toutes les valeurs qu’il hérite : port, nom d’utilisateur, clé, hôtes de rebond, etc.

host.tags

Mots libres pour trouver et filtrer les hôtes, comme « prod » ou « base de données ». Un hôte peut porter jusqu’à 64 étiquettes, et un nom d’étiquette fait de 1 à 64 caractères.

  • Exemple: prod, eu-west, postgres
  • Attention: Sur mobile, le × à côté d’une étiquette dans ce formulaire supprime cette étiquette de tous les hôtes, après confirmation.

host.os

Le système qu’exécute cet hôte, affiché sous forme d’icône et de nom sur l’hôte. Laissé sur « Détecter automatiquement », Sternway le lit à la connexion : à partir du message d’accueil du serveur SSH et d’une lecture seule de l’hôte (son fichier os-release, uname et le nom de son shell de connexion, qui décide aussi de ce que peuvent contenir les valeurs intégrées d’un extrait), sur un canal dédié, jamais saisie dans votre terminal. Choisissez un système dans la liste pour un hôte qu’il ne sait pas lire ou lit mal, comme un routeur qui indique seulement être sous Linux ; votre choix est conservé et aucune détection ne le remplace.

  • Par défaut: Détection automatique.
  • Exemple: Un pare-feu qui répond comme un simple FreeBSD : choisissez pfSense.
  • Attention: Cela ne change que l’affichage, pas la façon dont Sternway se connecte.

host.notes

Tout ce que vous voulez retenir sur cet hôte. Les notes sont stockées avec l’hôte et ne servent pas à la connexion. Jusqu’à 10 000 caractères.

  • Attention: Les notes se synchronisent comme le reste de l’hôte : n’y conservez pas de mot de passe.

Où: L’éditeur d’hôte ou de groupe, sous l’adresse.

host.port

Le port réseau sur lequel écoute le serveur SSH, de 1 à 65535. Ne le modifiez que si le serveur a été configuré sur un autre port. Mosh et SFTP l’utilisent aussi ; Telnet a son propre port.

  • Par défaut: 22.
  • Exemple: 2222

host.credentials · Téléphone uniquement

Comment cet hôte ouvre une session. « Utiliser une identité enregistrée » prend le nom d’utilisateur, le mot de passe et la clé d’une identité de votre trousseau ; « Définir directement » vous permet de les saisir pour cet hôte seul.

  • Par défaut: Définir directement.
  • Attention: Changer d’option efface ce que contenait l’autre : choisir une identité supprime le nom d’utilisateur, le mot de passe et la clé saisis ici, et choisir « Définir directement » dissocie l’identité.

host.username

Le compte avec lequel vous ouvrez une session sur le serveur. Laissez vide et l’application vous le demandera à la connexion.

  • Par défaut: Aucun : il vous est demandé à la connexion.
  • Exemple: root, ubuntu ou deploy
  • Attention: Une identité enregistrée choisie pour cet hôte remplace le nom d’utilisateur saisi ici.

host.password

Le mot de passe de ce compte, essayé une fois à la connexion pour ne pas vous le demander. Laissez vide pour qu’il vous soit demandé à chaque fois, ou pour ouvrir une session avec une clé.

  • Par défaut: Aucun.
  • Attention: Il est stocké dans le coffre avec l’hôte et se synchronise avec lui, sauf si Paramètres › Sécurité › « Synchroniser les clés et identités » est désactivé, auquel cas il reste sur cet appareil. Sur ordinateur, vider le champ signifie « aucun mot de passe » et bloque aussi celui que fournirait le groupe ; utilisez Effacer la surcharge pour hériter à nouveau.

host.identity

Un identifiant enregistré dans votre trousseau : un nom d’utilisateur avec un mot de passe, une clé ou les deux, conservé une fois et partagé par plusieurs hôtes. Modifiez l’identité et tous les hôtes qui l’utilisent suivent.

  • Par défaut: Aucune.
  • Attention: Une identité prime en bloc : un nom d’utilisateur, un mot de passe ou une clé saisi sur le même hôte ou groupe est ignoré tant qu’une identité est choisie.

host.key

La clé privée avec laquelle cet hôte ouvre une session au lieu d’un mot de passe. Le serveur doit déjà faire confiance à sa partie publique (Trousseau › Installer sur l’hôte s’en charge). Sternway ne propose que cette seule clé. Sur ordinateur, Paramètres › Connexions et SSH peut ajouter les clés de l’agent SSH de l’ordinateur.

  • Par défaut: Aucune.
  • Attention: Une clé protégée par une phrase secrète demande celle-ci lorsqu’elle est utilisée.

host.personalCredentials · Ordinateur uniquement

Pour un hôte d’un coffre d’équipe partagé : ouvrir une session avec vos propres nom d’utilisateur, mot de passe et clé, conservés dans votre coffre personnel, au lieu de ce que l’équipe a enregistré sur l’hôte. Chaque coéquipier utilise alors son propre compte.

  • Par défaut: Désactivé.
  • Attention: Si aucun identifiant personnel n’est enregistré pour cet hôte, il vous est demandé à la connexion.

Où: L’éditeur d’hôte ou de groupe › Avancé (ordinateur) ; les sections du bas du formulaire (téléphone).

host.startupSnippet · Ordinateur uniquement

Un extrait enregistré saisi dans la session, suivi d’Enter, dès qu’elle semble prête (voir Commande de démarrage), et saisi à nouveau à chaque reconnexion de la session. Il remplace la commande de démarrage si les deux sont définis ; si l’extrait a été supprimé depuis, la commande de démarrage est utilisée.

  • Par défaut: Aucun.
  • Attention: Il est saisi à la position du curseur, comme si vous l’aviez tapé : il apparaît donc dans le terminal et dans l’historique du shell. Comme il s’exécute à nouveau après une reconnexion, utilisez un extrait qui peut être répété sans risque.

host.startupCommand

Une commande saisie dans la session, suivie d’Enter, dès qu’elle semble prête : à la première invite si l’intégration du shell en signale une, sinon après une demi-seconde sans sortie. Elle est saisie une fois par connexion, donc à nouveau à chaque reconnexion de la session, automatique ou via le bouton Reconnecter, car une reconnexion démarre un nouveau shell. Utilisez-la pour arriver dans un dossier ou vous rattacher à tmux. Jusqu’à 4096 caractères.

  • Par défaut: Aucune.
  • Exemple: cd /srv/app && tmux attach || tmux
  • Attention: Elle est saisie, pas exécutée séparément : lors d’une ouverture de session lente, et en Telnet à l’invite de connexion, elle peut atterrir dans ce qui est à l’écran, et elle apparaît dans le terminal et l’historique du shell. Comme elle s’exécute à nouveau après une reconnexion, utilisez une commande qui peut être répétée sans risque. N’y mettez jamais de mot de passe.

host.proxy

Atteindre le serveur via un serveur proxy plutôt que directement, comme l’exigent certains réseaux d’entreprise. Les proxys SOCKS5, SOCKS4 et HTTP sont pris en charge (un proxy HTTP doit ouvrir un simple tunnel avec sa méthode CONNECT, il doit donc l’autoriser pour le port du serveur). Avec des hôtes de rebond, le proxy ne transporte la connexion que jusqu’au premier.

  • Par défaut: Aucun (connexion directe).
  • Attention: Mosh ne peut pas être utilisé sur un hôte doté d’un proxy.

host.proxyHost

L’adresse du serveur proxy : un nom d’hôte ou une adresse IP.

  • Exemple: proxy.corp.example.com

host.proxyPort

Le port sur lequel écoute le proxy, de 1 à 65535.

  • Par défaut: 1080 est renseigné quel que soit le type de proxy ; c’est le port SOCKS habituel, modifiez-le donc pour un proxy HTTP (souvent 3128 ou 8080).
  • Exemple: 1080 pour SOCKS, 3128 ou 8080 pour HTTP

host.proxyUsername

Le nom d’utilisateur que demande le proxy lui-même, s’il en demande un. SOCKS4 n’a pas de véritable authentification : on lui envoie seulement un nom, appelé « user ID », que la plupart des proxys SOCKS4 ignorent. Ce n’est pas votre compte sur le serveur.

  • Par défaut: Aucun.

host.proxyPassword

Le mot de passe que demande le proxy lui-même. SOCKS4 n’a pas de mot de passe, le champ est donc masqué pour lui.

  • Par défaut: Aucun.
  • Attention: Un proxy HTTP le reçoit avec un simple encodage de base, lisible par quiconque se trouve sur le chemin vers le proxy. Il est stocké et synchronisé comme le mot de passe de l’hôte.

host.jumpHosts

Serveurs à traverser en chemin, dans l’ordre, quand la cible n’est pas joignable directement (ssh appelle cela ProxyJump ; un tel serveur est souvent appelé bastion). L’application ouvre une session sur le premier avec les identifiants enregistrés de cet hôte, passe par un tunnel jusqu’au suivant, et ainsi de suite jusqu’à cet hôte. Jusqu’à 8, chacun étant un hôte enregistré du même coffre. Le proxy propre à un hôte de rebond est ignoré : seul le proxy de cet hôte est utilisé, pour atteindre le premier hôte de rebond. Les hôtes de rebond du premier hôte de rebond sont également traversés.

  • Par défaut: Connexion directe, ou la chaîne du groupe.
  • Exemple: bastion → cet hôte
  • Attention: Chaque hôte de rebond peut voir où vous vous connectez ensuite. Mosh ne peut pas passer par des hôtes de rebond, et Telnet les ignore.

host.env

Valeurs nommées transmises au shell distant à son démarrage, comme LANG ou une variable lue par vos scripts. Un nom se compose de lettres, de chiffres et de tirets bas, sans commencer par un chiffre ; une valeur fait jusqu’à 4096 caractères. Elles ne sont envoyées que pour les sessions SSH. Le niveau le plus proche qui en définit l’emporte en bloc : la liste d’un hôte remplace celle de son groupe, sans fusion.

  • Par défaut: Aucune.
  • Exemple: LANG = en_US.UTF-8
  • Attention: La plupart des serveurs n’acceptent que les noms listés après AcceptEnv dans la configuration de leur serveur SSH (sshd_config ; souvent juste LANG et LC_*) et ignorent silencieusement le reste. Les valeurs sont stockées et synchronisées comme des paramètres ordinaires : n’y mettez pas de secrets.

host.connectTimeout · Ordinateur uniquement

Nombre de secondes à attendre la réponse du serveur, puis la négociation d’authentification, avant d’abandonner. Augmentez-le pour une liaison lente ou lointaine. De 1 à 300.

  • Par défaut: 15 secondes (Paramètres › Connexions et SSH).

host.autoReconnect

Quand une session tombe de façon inattendue, se reconnecter sans demander : 5 tentatives rapides, en attendant 1, 2, 4, 8 et 16 secondes, puis une tentative par minute tant que son onglet est ouvert, et aussitôt que le réseau change ou que l’appareil se réveille (Arrêter les tentatives y met fin). Les redirections de ports en cours par cet hôte réessaient aussi : jusqu’à 10 tentatives en 5 minutes environ, et aussitôt que le réseau change. S’arrête aussitôt si la clé d’hôte du serveur a été refusée ou si vous avez annulé l’ouverture de session ; une redirection qui doit de nouveau être approuvée attend votre approbation.

  • Par défaut: Activé (Paramètres › Connexions et SSH).
  • Attention: Une reconnexion rouvre la session avec un mot de passe saisi plus tôt depuis le lancement de l’application (sur le téléphone : jusqu’à ce que l’application se verrouille, que vous vous déconnectiez, ou qu’elle reste en arrière-plan au-delà du délai de verrouillage automatique). Une phrase secrète de clé n’est réutilisée que si vous avez coché Mémoriser lorsqu’elle a été demandée.

host.keepaliveInterval · Ordinateur uniquement

Un keep-alive est un minuscule message « tu es là ? » envoyé quand la connexion est silencieuse, pour que les routeurs et pare-feu ne la coupent pas et qu’une liaison morte soit détectée. Ceci est le nombre de secondes entre deux messages ; 0 les désactive. De 0 à 3600.

  • Par défaut: 30 secondes (Paramètres › Arrière-plan et maintien).

host.keepaliveCountMax · Ordinateur uniquement

Nombre de messages keep-alive consécutifs pouvant rester sans réponse avant que la connexion soit déclarée perdue et fermée. Avec les valeurs par défaut, cela fait environ une minute et demie. De 1 à 100.

  • Par défaut: 3 (Paramètres › Arrière-plan et maintien).

host.agentForwarding

Permet au serveur sur lequel vous êtes d’utiliser vos clés pour ouvrir une session sur un autre serveur (par exemple git pull depuis GitHub sur le serveur), sans que les clés privées quittent cet appareil. « Clé d’authentification » ne propose que la clé qui vous a authentifié ; « Toutes les clés » propose les clés de cet hôte et de ses hôtes de rebond. Le serveur peut demander des signatures, jamais lire les clés. Ce transfert n’est demandé que dans les sessions de terminal, pas pour SFTP ni les redirections de port. « Clé d’authentification » ne propose rien si vous avez ouvert la session avec un mot de passe ou une clé de l’agent SSH de cet ordinateur. « Toutes les clés » exclut les clés de sécurité (matérielles) et les clés chiffrées dont la phrase secrète n’est ni enregistrée ni mémorisée ; il ne la demande pas.

  • Par défaut: Désactivé (Paramètres › Connexions et SSH).
  • Attention: Tant que vous êtes connecté, toute personne ayant des droits d’administrateur sur ce serveur peut ouvrir une session ailleurs en votre nom avec les clés transférées. Ne l’activez que pour des serveurs de confiance.

host.legacyAlgorithms · Ordinateur uniquement

Proposer aussi d’anciennes méthodes de chiffrement (échange de clés et signatures SHA-1, chiffrements CBC, clés d’hôte ssh-rsa) abandonnées par SSH moderne. Ne l’activez que lorsqu’un ancien routeur, commutateur ou serveur refuse de se connecter sans elles.

  • Par défaut: Désactivé (Paramètres › Connexions et SSH › Avancé).
  • Attention: Ces méthodes sont faibles. Laissez cette option désactivée pour tout ce qui est joignable depuis Internet.

host.pqc · Ordinateur uniquement

Privilégier une méthode plus récente d’accord sur les clés de chiffrement de la session (la méthode appelée mlkem768x25519), qui résiste aussi à un futur ordinateur quantique, lorsque le serveur la prend en charge ; les méthodes habituelles restent proposées ensuite. Ne la désactivez que si un serveur se comporte mal avec elle.

  • Par défaut: Activé (Paramètres › Connexions et SSH › Avancé).

host.sftpStartPath · Ordinateur uniquement

Le dossier dans lequel s’ouvre l’explorateur de fichiers pour cet hôte la première fois. Ensuite, l’application mémorise le dernier dossier où vous étiez.

  • Par défaut: Votre dossier personnel sur le serveur.
  • Exemple: /var/www

host.theme

Les couleurs des terminaux de cet hôte, pour qu’un serveur de production se distingue d’un serveur de test. Un thème choisi dans une session reste prioritaire pour cette session.

  • Par défaut: Le thème de terminal de l’application (Paramètres › Apparence).

host.fontFamily · Ordinateur uniquement

La police des terminaux de cet hôte : une police installée sur cet ordinateur, ou une police fournie (JetBrains Mono, Fira Code, Cascadia Code, Source Code Pro, Hack).

  • Par défaut: La police de Paramètres › Terminal (JetBrains Mono).

host.fontSize · Ordinateur uniquement

La taille du texte du terminal pour cet hôte, en pixels, de 6 à 72.

  • Par défaut: La taille de Paramètres › Terminal (14).

host.lineHeight · Ordinateur uniquement

L’espace occupé par chaque ligne du terminal, en multiple de la taille de police, de 0,8 à 2. Plus grand est plus aéré ; 1 est serré.

  • Par défaut: La valeur de Paramètres › Terminal (1,2).

host.charset · Ordinateur uniquement

L’encodage de caractères utilisé par le serveur. Presque tous les systèmes modernes utilisent UTF-8 ; n’en choisissez un autre que si les lettres accentuées ou les caractères de dessin de cadres s’affichent mal sur un ancien système. L’application convertit dans les deux sens ; rien n’est modifié sur le serveur.

  • Par défaut: UTF-8.
  • Exemple: ISO-8859-1, windows-1252, Shift_JIS

host.termType · Ordinateur uniquement

Ce que l’application déclare être au serveur, via la variable TERM. Les programmes s’en servent pour savoir quelles couleurs et touches fonctionnent. Ne la modifiez que si un programme plein écran (vi, top) se comporte mal sur un ancien système.

  • Par défaut: xterm-256color (Paramètres › Terminal › Avancé).
  • Exemple: vt100 pour du matériel très ancien

host.backspace · Ordinateur uniquement

Le caractère qu’envoie la touche Retour arrière. Presque tous les systèmes attendent DEL ; passez à Ctrl-H si Retour arrière affiche ^? ou n’efface pas. Ctrl+Backspace envoie l’autre.

  • Par défaut: DEL.

host.telnetPort · Ordinateur uniquement

Le port utilisé quand vous ouvrez cet hôte avec Telnet au lieu de SSH, de 1 à 65535. Telnet n’a pas d’authentification à laquelle l’application peut répondre pour vous : le serveur demande un nom d’utilisateur et un mot de passe dans le terminal, et vous les y saisissez. L’application n’enregistre ni l’un ni l’autre.

  • Par défaut: 23.
  • Attention: Telnet n’est pas chiffré : tout ce qui est saisi, mots de passe compris, peut être lu sur le réseau.

host.moshEnabled · Ordinateur uniquement

Mosh est une autre façon de maintenir un terminal actif sur une connexion médiocre ou itinérante : il survit aux changements de réseau et à la mise en veille, et affiche la saisie instantanément. L’application ouvre d’abord une session via SSH, puis bascule. Le serveur doit avoir mosh-server installé et ses ports UDP ouverts, et cet ordinateur doit avoir le programme mosh-client installé (macOS et Linux ; Mosh ne fonctionne pas dans l’application Windows). L’application mobile ne peut pas exécuter Mosh : un hôte avec cette option s’y connecte en SSH simple.

  • Par défaut: Désactivé.
  • Attention: Un hôte avec des hôtes de rebond ou un proxy ne parvient pas à se connecter quand Mosh est activé, de même qu’un hôte sur un ordinateur sans mosh-client : il n’y a pas de repli sur SSH sur ordinateur. Les sessions Mosh ne sont pas enregistrées dans le journal de session et n’ont pas de saisie semi-automatique.
  • En savoir plus: Lire la suite (en anglais)

host.moshServerCommand · Ordinateur uniquement

Le programme lancé sur le serveur pour Mosh. Ne le définissez que si mosh-server n’est pas dans le PATH du serveur. Indiquez seulement le nom du programme ou son chemin complet, sans arguments.

host.moshPortRange · Ordinateur uniquement

Le port UDP, ou la plage de ports, que le serveur peut utiliser pour Mosh, au format BAS:HAUT avec deux-points. Alignez-le sur ce que laisse passer le pare-feu du serveur.

  • Par défaut: Laissé à mosh-server (60000 à 61000 sur la plupart des systèmes).
  • Exemple: 60000:61000
  • En savoir plus: Lire la suite (en anglais)

host.shellIntegration · Ordinateur uniquement

Permet à l’application de voir où chaque commande commence et se termine dans une session bash ou zsh, ce qui fait fonctionner « une commande est-elle en cours ? » et la restauration d’un espace de travail. Pour cela, elle saisit un petit script dans le shell au démarrage de la session.

  • Par défaut: Désactivé.
  • Attention: Cela modifie les hooks d’invite de cette session shell et renvoie à l’application chaque ligne de commande que vous exécutez.

host.autocomplete · Ordinateur uniquement

Indique si des suggestions s’affichent pendant la saisie sur cet hôte, sur ordinateur et sur le téléphone. Un hôte peut seulement les désactiver ; si les suggestions sont désactivées dans Paramètres › Terminal, ceci ne peut pas les activer. Cela ne masque pas la proposition, sur ordinateur, du mot de passe enregistré à une demande de mot de passe.

  • Par défaut: Activé, selon Paramètres › Terminal.

host.autocompleteHostLookup · Ordinateur uniquement

Indique si la saisie semi-automatique peut interroger cet hôte sur ce qu’il contient : commandes installées, options des pages de manuel, et valeurs comme les branches, services et noms de fichiers. Les requêtes sont des commandes fixes en lecture seule exécutées en arrière-plan via la connexion de la session, jamais saisies dans le terminal. Désactivez-la pour un hôte où rien ne doit s’exécuter sans demande ; les suggestions y proviennent alors de votre historique, de vos extraits et des descriptions de commandes intégrées. L’application mobile suit aussi cette option.

  • Par défaut: Activé, selon Paramètres › Terminal.
  • Attention: Les requêtes s’exécutent sous l’utilisateur avec lequel vous ouvrez la session et apparaissent sur l’hôte comme n’importe quelle autre commande.

host.tabColor

Une couleur d’identification pour cet hôte : chaque onglet de session et SFTP vers lui porte la couleur, tout comme ses lignes dans Sessions et dans Hôtes, pour distinguer d’un coup d’œil un hôte (ou une catégorie, comme la production) d’un autre. Définie sur un groupe, tous ses hôtes prennent la couleur sauf s’ils définissent la leur ; « Aucune » sur un hôte lui retire la couleur du groupe. Un onglet ouvert peut recevoir une autre couleur depuis son menu sans modifier l’hôte. La couleur se synchronise avec l’hôte ; c’est un repère, pas un secret.

  • Par défaut: Aucune, ou la couleur du groupe.
  • Exemple: Rouge sur le groupe Production, vert sur Préproduction.

host.smartHighlight

Indique si Sternway colore ce qu’il reconnaît dans la sortie brute de cet hôte (adresses, chemins, tailles, niveaux de journal, listes de fichiers). Désactivez-la pour un appareil dont il interprète mal la sortie, ou activez-la pour un hôte quand elle est désactivée dans les Paramètres. Les types colorés se règlent dans Paramètres › Terminal. Les couleurs propres aux programmes ne sont jamais modifiées et la copie n’est pas affectée.

  • Par défaut: Selon Paramètres › Terminal.

host.notify

Ce que chaque session vers cet hôte vous notifie sans qu’on le lui demande à chaque fois. Les mêmes choix figurent dans le menu d’une session (« M’avertir… »), où ils valent pour cette session uniquement. Une commande compte dès qu’elle s’est exécutée pendant la durée définie dans Paramètres › Notifications ; « sortie après un silence » signifie 30 secondes sans sortie ; « quand elle devient silencieuse » signifie aucune sortie pendant les minutes définies dans Paramètres › Notifications, une fois par période de silence ; « une ligne correspond » utilise vos règles de Paramètres › Notifications ; « un agent de code attend une saisie » reconnaît les questions que posent les agents de code en ligne de commande avant d’agir ; « le programme envoie une notification » est une notification que le programme distant demande lui-même (OSC 9, 777 ou 99). Défini sur un groupe, tous ses hôtes notifient de la même façon sauf s’ils définissent le leur.

  • Par défaut: Rien : une session ne notifie que ce que vous lui demandez.
  • Attention: Une notification peut afficher une ligne de la sortie de l’hôte. Un téléphone ne notifie que tant que l’application tourne ou est maintenue active en arrière-plan.

host.sessionLogging · Ordinateur uniquement

Indique si ce qu’affichent les sessions de cet hôte est enregistré dans Journaux. L’enregistrement n’a lieu que si la journalisation est aussi activée pour le coffre de l’hôte (Paramètres › Journaux). Désactivez-la pour un hôte dont vous ne voulez jamais conserver la sortie. L’application mobile enregistre de la même façon et suit cette option. Un journal reste sur l’appareil qui l’a enregistré, sauf si « Synchroniser les journaux de session » y est activé.

  • Par défaut: Activé, quand le coffre enregistre les journaux.
  • Attention: Un journal contient tout ce qui s’est affiché dans le terminal, y compris tout secret affiché par une commande.

host.recordSessions · Ordinateur uniquement

Enregistre chaque session vers cet hôte dès son début, avec sa chronologie, pour la rejouer plus tard dans Enregistrements : ce que le terminal a affiché et chaque changement de sa taille, sous forme de fichier asciicast. Un enregistrement reste sur cet appareil, chiffré avec le reste des données de l’application, et n’est jamais synchronisé ni envoyé. Un badge rouge « Enregistrement » s’affiche sur la session pendant l’enregistrement. Défini sur un groupe, tous ses hôtes enregistrent sauf indication contraire de l’hôte. Une session peut aussi être enregistrée individuellement depuis son menu.

  • Par défaut: Désactivé.
  • Attention: Un enregistrement contient tout ce qui s’est affiché dans le terminal, y compris tout secret affiché par une commande.
  • En savoir plus: Lire la suite (en anglais)

host.recordInput · Ordinateur uniquement

Avec « Enregistrer les sessions » activé, conserve aussi votre saisie dans l’enregistrement. Ce que vous tapez après une invite reconnue par l’application (une ligne se terminant par « password: », « passphrase: », « PIN: » et similaires, également dans les principales langues européennes, en russe, japonais, chinois et coréen, même si le programme affiche * à chaque touche) n’est jamais conservé, jusqu’à Enter, Ctrl-C ou Ctrl-D.

  • Par défaut: Désactivé : seul ce que le terminal a affiché est enregistré.
  • Attention: Le texte saisi peut contenir des secrets que l’application ne peut pas reconnaître comme tels : un mot de passe collé dans une ligne de commande, un jeton, une invite formulée autrement (« Verification code: », une langue que la documentation ne liste pas) ou une invite qui n’est pas en fin de dernière ligne. Ceux-ci seraient enregistrés.
  • En savoir plus: Lire la suite (en anglais)

host.metricsStrip · Ordinateur uniquement

Affiche une fine bande au-dessus des terminaux de cet hôte avec son utilisation du CPU, la mémoire utilisée et le taux de remplissage de son système de fichiers racine. Toutes les 5 secondes, tant que le terminal est à l’écran, Sternway exécute une courte commande en lecture seule (/proc et df sous Linux ; sysctl, vm_stat et ps sous macOS et FreeBSD) sur un canal séparé de la connexion : rien n’est saisi dans votre shell et rien n’apparaît dans son historique. Elle se met en pause quand l’onglet est masqué, et reste masquée sur un système qu’il ne sait pas lire.

  • Par défaut: Désactivé.
  • Attention: Un serveur qui n’autorise qu’un canal par connexion ne peut pas l’exécuter à côté de votre shell : la bande reste alors vide.

host.tmuxAttach · Téléphone uniquement

Une session SSH vers cet hôte s’exécute dans tmux sur le serveur : à la connexion, elle se rattache à la session tmux nommée ci-dessous, et la crée si elle n’existe pas. Ce qui y tourne continue quand le téléphone se met en veille, perd le réseau ou ferme l’application, et une reconnexion, automatique ou via le bouton Reconnecter, s’y rattache à nouveau : l’écran revient tel que vous l’avez laissé. Cela fonctionne à travers les hôtes de rebond. Avant le rattachement, Sternway vérifie sur un canal dédié si tmux est installé ; si ce n’est pas le cas, vous êtes prévenu et la session continue en shell simple.

  • Par défaut: Désactivé.
  • Exemple: Une longue compilation ou un agent de code lancé depuis le téléphone et consulté plus tard.
  • Attention: La commande de rattachement est saisie dans le shell : elle s’affiche donc à l’écran et, sauf si votre shell ignore les lignes commençant par une espace, dans son historique. La commande de démarrage n’est saisie dans la session tmux qu’à sa création, pas à chaque rattachement. Quitter tmux (détacher, ou quitter sa dernière fenêtre) vous laisse dans le shell simple. Non utilisé pour Telnet ni Mosh.

host.tmuxSession · Téléphone uniquement

La session tmux à laquelle se rattacher. Si vide, elle est dérivée du libellé de l’hôte (« web-01 (prod) » devient web-01-prod). Lettres, chiffres, - et _, 64 caractères maximum. Deux hôtes du même serveur avec le même nom partagent une seule session tmux.

  • Par défaut: Dérivé du libellé de l’hôte.
  • Exemple: build

host.wakeMac

L’adresse matérielle de la carte réseau qui réveille cette machine. Une fois définie, l’hôte a une action Réveiller : cet appareil envoie le « paquet magique » qui fait démarrer une machine en veille ou éteinte, si son micrologiciel a le Wake-on-LAN activé. Le paquet part de cet ordinateur ou de ce téléphone, sur le réseau où il se trouve : aucun serveur n’intervient, il atteint donc une machine du même réseau local (ou une dont le routeur le relaie).

  • Par défaut: Aucune : pas d’action Réveiller.
  • Exemple: 52:54:00:ab:cd:ef (ou 52-54-00-ab-cd-ef ou 5254.00ab.cdef)
  • Attention: Relevez-la sur la machine elle-même (ip link sous Linux, ipconfig /all sous Windows) pendant qu’elle est allumée. Une machine débranchée, ou dont la carte est désactivée, ne peut pas recevoir le paquet.

host.wakeAddress

Où le paquet magique est envoyé. La valeur par défaut atteint toutes les machines du segment de réseau de cet appareil. Utilisez l’adresse de diffusion de l’autre réseau (par exemple 192.168.20.255) quand la machine est sur un autre sous-réseau dont le routeur la relaie, ou l’adresse de la machine elle-même quand un routeur la garde joignable pendant sa veille.

  • Par défaut: 255.255.255.255 (ce réseau).
  • Exemple: 192.168.1.255

host.wakePort

Le port UDP auquel le paquet magique est envoyé. Les cartes réseau l’écoutent quel que soit le port ; certains routeurs ne relaient que le port 7 ou 9. De 1 à 65535.

  • Par défaut: 9.

host.wakeBeforeConnect

Chaque connexion à cet hôte (terminal, fichiers, redirections de ports) envoie d’abord le paquet magique, attend que le port SSH de l’hôte réponde, au plus le délai ci-dessous, puis ouvre la session. Vérifier le port ne fait qu’ouvrir et fermer une connexion vers lui ; aucune session n’est ouverte. Un hôte déjà réveillé répond tout de suite, cela ne coûte donc rien dans ce cas.

  • Par défaut: Désactivé.
  • Attention: Pour un hôte joint par un hôte de rebond ou un proxy, le port ne peut pas être vérifié d’ici : l’app attend tout le délai avant de se connecter.

host.wakeWaitSec

Combien de temps « Réveiller avant de se connecter » attend que l’hôte commence à répondre avant de tenter quand même l’ouverture de session. Une machine qui démarre à froid a besoin de plus de temps qu’une machine qui sort de veille. De 5 à 600.

  • Par défaut: 60 secondes.

host.knockSequence

Les ports à « frapper », dans l’ordre, avant chaque connexion à cet hôte, pour un serveur dont le pare-feu (knockd et autres) garde le port SSH fermé tant qu’il ne les a pas vus. Séparez les ports par des espaces ; ajoutez :udp à un port frappé en UDP (TCP par défaut). Une frappe TCP ouvre une connexion et la ferme aussitôt ; une frappe UDP est un paquet vide. Jusqu’à 16 ports. Quand cet hôte est joint par un hôte de rebond, c’est l’hôte de rebond qui envoie les frappes.

  • Par défaut: Aucune : l’hôte est contacté directement.
  • Exemple: 7000 8000:udp 9000
  • Attention: Derrière un hôte de rebond, les frappes ne peuvent être qu’en TCP, et les frappes UDP ne passent pas par un proxy. Une séquence de frappes n’est pas un mot de passe : toute personne qui observe le réseau entre vous et le serveur peut la voir.

host.knockDelayMs

Combien de temps attendre après chaque frappe, et après la dernière avant de se connecter, pour que le pare-feu suive. De 0 à 10000 millisecondes.

  • Par défaut: 200 ms.

Où: Hôtes › Nouveau groupe, ou Modifier sur un groupe.

group.name

Le nom du dossier dans votre liste d’hôtes. Obligatoire, 256 caractères maximum.

  • Exemple: Production

group.parent

Placer ce groupe dans un autre. Ses hôtes héritent alors aussi des paramètres des groupes au-dessus. Un groupe ne peut pas être placé dans lui-même ni dans l’un de ses sous-groupes.

  • Par défaut: Aucun (niveau supérieur).

Synchroniser les hôtes depuis un fournisseur cloud

Section intitulée « Synchroniser les hôtes depuis un fournisseur cloud »

group.cloudEnable · Ordinateur uniquement

Maintient ce groupe rempli avec vos serveurs cloud en cours d’exécution : un hôte est ajouté pour chaque instance, son adresse est mise à jour quand elle change, et son hôte est supprimé quand l’instance disparaît. L’application ne fait que lire la liste des instances ; elle ne modifie rien chez le fournisseur.

  • Par défaut: Désactivé.
  • Attention: L’hôte d’une instance arrêtée ou résiliée est supprimé à l’actualisation suivante, avec toutes les modifications que vous y avez apportées.

group.cloudProvider · Ordinateur uniquement

Le service cloud où lire les instances. Seul AWS EC2 fonctionne aujourd’hui ; les autres sont indiqués comme bientôt disponibles.

  • Par défaut: AWS EC2.

group.cloudRegion · Ordinateur uniquement

La région unique du fournisseur dont les instances sont listées. Pour plusieurs régions, créez un groupe pour chacune.

  • Exemple: us-east-1 ou eu-west-2

group.cloudFilter · Ordinateur uniquement

Seules les instances dont la balise Name correspond sont ajoutées. Le texte est transmis à AWS comme filtre sur la balise Name : le nom entier doit correspondre et la casse compte, * remplace n’importe quelle suite de caractères et ? exactement un. Ainsi, « web » ne trouve qu’une instance nommée exactement web, et « web-* » trouve web-1 et web-eu-2. Avec un filtre défini, les instances sans balise Name sont exclues. Laissez vide pour toutes les instances en cours d’exécution ou de démarrage de la région.

  • Par défaut: Vide (toutes les instances).
  • Exemple: web-*

group.cloudRefresh · Ordinateur uniquement

Fréquence de relecture de la liste des instances tant que l’application est ouverte, de 1 à 1440 minutes.

  • Par défaut: 60.

group.cloudAccessKeyId · Ordinateur uniquement

La partie publique d’une clé d’accès AWS autorisée à lister les instances EC2. Laissez les deux champs de clé vides pour conserver celles déjà enregistrées.

  • Exemple: AKIA…
  • Attention: Conservée sur cet appareil uniquement : elle n’est jamais synchronisée ni partagée avec votre équipe, chaque appareil qui doit synchroniser a donc besoin de la sienne.

group.cloudSecretAccessKey · Ordinateur uniquement

La partie secrète de cette clé d’accès AWS, utilisée pour signer la requête de liste des instances.

  • Attention: Conservée sur cet appareil uniquement et plus jamais affichée. Utilisez une clé qui ne peut que lire EC2, pas la clé principale de votre compte.

group.cloudSessionToken · Ordinateur uniquement

Uniquement pour les identifiants AWS temporaires (issus de SSO ou d’un rôle assumé), qui se composent de trois parties. Laissez vide pour une clé d’accès ordinaire.

  • Par défaut: Aucun.

Hôtes : connexion rapide, déplacement et étiquettes

Section intitulée « Hôtes : connexion rapide, déplacement et étiquettes »

Où: L’écran Hôtes.

quickConnect.target

Se connecter une fois, sans enregistrer d’hôte. Saisissez l’adresse, éventuellement précédée d’un nom d’utilisateur et de @ et suivie de deux-points et d’un port, ou collez un lien ssh://, sftp:// ou telnet:// ou une commande « ssh ». D’une commande sont repris l’utilisateur (-l), le port (-p) et les hôtes de rebond (-J) ; toute autre option, une commande à exécuter sur l’hôte et un mot de passe dans un lien ne le sont pas, et vous êtes informé desquels. Rien de ce que vous collez n’est exécuté. Les valeurs par défaut de l’application (Paramètres) s’appliquent : pas de groupe, de clé ni de proxy.

  • Par défaut: Port 22 ; le nom d’utilisateur vous est demandé s’il est omis.
  • Exemple: root@203.0.113.10:2222, ou : ssh -p 2222 -J jump@bastion deploy@web-01

hostSave.label · Ordinateur uniquement

Le nom que prend la connexion rapide dans votre liste d’hôtes lorsque vous l’enregistrez. L’adresse, le port et le nom d’utilisateur sont repris de la connexion ; un mot de passe saisi n’est enregistré avec elle que si vous l’avez aussi demandé à la demande de mot de passe. Vous pouvez ensuite modifier l’hôte comme n’importe quel autre.

hostMove.group · Ordinateur uniquement

Le groupe dans lequel déplacer les hôtes sélectionnés. Ils héritent alors des paramètres de ce groupe. Des hôtes de coffres différents ne peuvent aller qu’au niveau supérieur de leur propre coffre.

  • Par défaut: Aucun groupe (niveau supérieur).

hostBulk.tags

Les étiquettes à ajouter à tous les hôtes sélectionnés ou à leur retirer. Cliquez une fois sur une étiquette pour l’ajouter à tous (ou, s’ils l’ont tous, pour la retirer), encore pour inverser, une troisième fois pour la laisser telle quelle. La puce indique quels hôtes l’ont maintenant.

  • Par défaut: Toutes les étiquettes telles quelles.

hostBulk.identity

L’identité enregistrée avec laquelle tous les hôtes sélectionnés ouvrent une session. « Hériter » retire l’identité de chaque hôte pour qu’il hérite de celle de son groupe ; « Aucune » signifie pas d’identité. Le nom d’utilisateur, le mot de passe et la clé propres à un hôte sont conservés : tant qu’une identité est choisie ils ne servent pas, et ils resservent quand l’identité est retirée.

  • Par défaut: Laisser tel quel.

hostBulk.port

Le port SSH de tous les hôtes sélectionnés : un nombre de 1 à 65535, ou « Hériter » pour retirer le port propre à chaque hôte afin qu’il hérite de celui de son groupe (22 par défaut).

  • Par défaut: Laisser tel quel.
  • Attention: Une redirection de ports approuvée sur cet appareil redemande une approbation quand le port de son hôte change, et les appareils d’un coéquipier montrent la modification avant de se connecter à un hôte partagé.

hostBulk.group

Le groupe dans lequel vont tous les hôtes sélectionnés, ou le niveau supérieur de leur coffre. Ils héritent alors des réglages de ce groupe.

  • Par défaut: Laisser tel quel.

hostTransfer.vault · Ordinateur uniquement

Le coffre dans lequel déplacer ou copier la sélection. Un coffre est une collection chiffrée séparément : votre coffre personnel, ou un coffre partagé avec une équipe.

  • Attention: Toute personne ayant accès au coffre cible pourra alors voir et utiliser ce que vous y placez.

hostTransfer.group · Ordinateur uniquement

Le groupe du coffre cible où arrivent les éléments.

  • Par défaut: (aucun groupe).

hostTransfer.linkMode · Ordinateur uniquement

Ce qu’il advient de l’identité et de la clé avec lesquelles un hôte copié ouvre une session. « Copier les liens » les copie aussi dans le coffre cible. « Conserver les identifiants personnels » (de votre coffre personnel vers un coffre d’équipe) les exclut de la copie et les garde comme vos identifiants personnels pour cet hôte.

  • Par défaut: Copier les liens.
  • Attention: Avec « Copier les liens », toute personne pouvant ouvrir le coffre cible obtient la clé et le mot de passe copiés.

tag.name

Renommer l’étiquette partout où elle est utilisée. De 1 à 64 caractères ; deux étiquettes d’un même coffre ne peuvent pas porter le même nom, quelle que soit la casse.

hostFilter.match

Avec plusieurs étiquettes choisies : « Au moins une » affiche les hôtes qui en ont au moins une, « Toutes » uniquement ceux qui les ont toutes.

  • Par défaut: Au moins une.

Où: Hôtes › Nouveau › Importer depuis Tailscale….

tailscale.source · Ordinateur uniquement

« Tailscale de cet ordinateur » interroge l’application Tailscale qui tourne ici (tailscale status --json), sans clé : elle liste les appareils que cet ordinateur peut voir. « API Tailscale » sert pour un ordinateur sans l’application Tailscale : elle interroge api.tailscale.com avec une clé d’API.

  • Par défaut: Tailscale de cet ordinateur.

tailscale.controlUrl · Ordinateur uniquement

Vide pour lire les appareils depuis Tailscale. Pour un tailnet géré par Headscale, l’URL du serveur Headscale (le server_url de sa configuration) : l’import lit alors sa liste de nœuds (/api/v1/node) avec une clé d’API Headscale, et aucun nom de tailnet n’est nécessaire. Gardé sur cet appareil pour le prochain import. « Cet ordinateur » n’a besoin de rien de tout cela : le client Tailscale répond depuis le serveur auquel il est connecté, Headscale compris.

  • Exemple: https://headscale.example.com
  • Attention: Uniquement https:// (le simple http:// seulement vers cet ordinateur, localhost), sans nom d’utilisateur ni mot de passe : la clé d’API part vers ce serveur. Headscale n’indique ni le système d’un nœud, ni son nom MagicDNS, ni s’il utilise Tailscale SSH : ces appareils sont donc ajoutés par leur adresse Tailscale.

tailscale.tailnet · Ordinateur uniquement

Le nom de votre tailnet tel que la console d’administration Tailscale l’affiche sous Settings › General (souvent votre domaine e-mail, ou un nom comme example.github). Un simple tiret (« - ») désigne le tailnet de la clé.

  • Exemple: example.com

tailscale.apiKey · Ordinateur uniquement

Un jeton d’accès API de la console d’administration Tailscale (Settings › Keys), commençant par tskey-api- ; avec un serveur de contrôle indiqué, une clé d’API Headscale (headscale apikeys create). Il est envoyé une seule fois, à api.tailscale.com ou à ce serveur, pour lire la liste des appareils, et n’est enregistré nulle part.

  • Attention: Quiconque possède la clé peut gérer votre tailnet jusqu’à son expiration : donnez-lui une courte durée de validité et révoquez-la après l’importation.

tailscale.address · Ordinateur uniquement

L’adresse attribuée à chaque nouvel hôte : son nom MagicDNS (homelab.tail1234.ts.net), qui reste valable quand l’appareil obtient une nouvelle IP Tailscale, ou son adresse IPv4 Tailscale (100.x.y.z), qui fonctionne sans MagicDNS.

  • Par défaut: Nom MagicDNS.

tailscale.ssh · Ordinateur uniquement

Pour les appareils qui exécutent Tailscale SSH : les hôtes reçoivent l’étiquette « Tailscale SSH » et aucun mot de passe ni clé. Tailscale vérifie votre identité sur le tailnet, et vous ouvrez la session avec votre nom d’utilisateur sur cet ordinateur.

  • Par défaut: Activé quand tous les appareils choisis exécutent Tailscale SSH.

Où: Hôtes › sélectionner des hôtes › Envoyer un fichier….

push.file · Ordinateur uniquement

Le fichier de cet ordinateur à copier vers chaque hôte choisi. Il y garde son nom.

push.remoteDir · Ordinateur uniquement

L’emplacement du fichier sur chaque hôte. ~ est le dossier personnel de l’utilisateur avec lequel vous ouvrez la session, et un chemin qui ne commence pas par / part de là. Le dossier doit exister.

  • Par défaut: ~ (le dossier personnel).
  • Exemple: ~/bin, /etc/myapp

push.conflict · Ordinateur uniquement

« Remplacer » écrase un fichier de ce nom dans le dossier ; « Ignorer » le laisse tel quel et marque cet hôte comme Ignoré.

  • Par défaut: Remplacer.
  • Attention: « Remplacer » écrase le fichier sur chaque hôte qui l’a, sans demander.

push.hosts · Ordinateur uniquement

Les hôtes qui reçoivent le fichier : ceux cochés, ou (Par règle de tags) les hôtes ayant les tags choisis au début de l’envoi. Quatre hôtes sont copiés à la fois ; chacun se connecte comme pour SFTP et demande ce qu’il y demanderait.

fleet.tagRule · Ordinateur uniquement

Les hôtes ayant l’un des tags cochés, ou tous. La règle est lue au début de l’action (et de nouveau à chaque relance) : un hôte tagué depuis en fait partie, un hôte dont le tag a été retiré non ; la ligne en dessous dit quels hôtes elle prend maintenant.

  • Par défaut: L’un des tags.

Où: Hôtes › Plus › Récupérer un fichier….

pull.remotePath · Ordinateur uniquement

Le fichier à récupérer sur chaque hôte choisi. ~ est le dossier personnel de l’utilisateur avec lequel vous ouvrez la session, et un chemin qui ne commence pas par / part de là. La copie de chaque hôte va dans le zip, dans un dossier au nom de l’hôte.

  • Exemple: /etc/os-release, ~/.bashrc

pull.cap · Ordinateur uniquement

Un hôte dont le fichier est plus gros est laissé de côté et marqué comme trop gros, pour qu’un énorme journal ne remplisse pas le disque. Trois hôtes sont traités à la fois.

  • Par défaut: 50 Mo.

pull.hosts · Ordinateur uniquement

Les hôtes sur lesquels récupérer le fichier : ceux cochés, ou (Par règle de tags) les hôtes ayant les tags choisis au début. Chacun se connecte comme pour SFTP. Le zip est écrit une fois tous les hôtes terminés ; récupérer à nouveau sur ceux en échec le réécrit.

Où: Hôtes › Plus › Inventaire.

inventory.export · Ordinateur uniquement

Enregistre l’inventaire dans un fichier CSV : hôte, adresse, système d’exploitation, version, architecture et date de la dernière connexion de cet appareil (UTC). Les données viennent de la vérification du système faite à chaque connexion ; un hôte auquel aucun appareil avec ce coffre ne s’est jamais connecté a des colonnes vides. Le fichier n’est pas chiffré : les hôtes d’une équipe dont la règle bloque les exports sans chiffrement (ou dont la règle ne peut pas être lue pour le moment) en sont exclus, et la fenêtre indique combien.

Où: Hôtes › un hôte › Sessions tmux….

tmux.search · Ordinateur uniquement

Trouve un mot dans ce que montre chaque volet de chaque session tmux de l’hôte : les 200 dernières lignes de chacun, jusqu’à 64 volets, sans tenir compte de la casse. Le texte est lu par un canal à part (rien n’est tapé dans un terminal) et cherché sur cet ordinateur ; un résultat dit dans quelle session, fenêtre et quel volet il se trouve, avec Attacher.

tmux.name · Ordinateur uniquement

Le nom de la session ou de la fenêtre tmux, ou le titre du volet, jusqu’à 128 caractères. Les espaces, les guillemets et tout autre caractère restent tels que tapés (un # aussi : tmux l’affiche et ne le lit pas comme un format) ; un saut de ligne, une tabulation ou un autre caractère de contrôle est refusé, de même que : et . dans un nom de session, dont tmux se sert pour désigner une fenêtre et un volet. « Démarrer » crée la session sur l’hôte et la laisse tourner ; « Démarrer et rejoindre » l’ouvre aussi dans un nouvel onglet, ce qui tape le nom dans un terminal : lettres, chiffres, - et _ seulement pour celui-là.

© 2026 IRONPINE LABS LLC
ALL RIGHTS RESERVED.