Développement et gestion à distance

Ce guide couvre quatre sujets : l’ouverture de votre VelaTerm aux autres appareils de votre réseau, la connexion à d’autres machines par SSH ou par lien d’appairage, le partage de conversations avec vos propres appareils via un compte VelaTerm, et le transfert de fichiers vers et depuis des machines distantes.

1. Points d’entrée

Les fonctionnalités à distance se trouvent sur le côté droit de la barre de titre :

• L’icône en forme de globe correspond à « Accès distant (navigateur) ». Elle permet à un téléphone, une tablette ou un autre ordinateur de votre réseau d’utiliser ce VelaTerm dans un navigateur web. Lorsque le serveur est en cours d’exécution, l’icône est mise en évidence dans la couleur d’accentuation et son info-bulle ajoute « En cours · port N ».
• L’icône en forme de flèche correspond à « Se connecter à un serveur distant ». Elle fait de cette machine un client d’une autre machine, par SSH, par lien d’appairage ou via votre compte VelaTerm.
• L’icône en forme de silhouette correspond à l’entrée « Compte », marquée « Expérimental ». Elle connecte cet ordinateur à un compte VelaTerm et vous permet de partager des conversations via Internet avec vos autres appareils connectés.

Le bouton « Partager » situé à côté ouvre « Partager VelaTerm », qui sert à recommander VelaTerm à d’autres personnes ; il ne partage aucune session.

2. Ouvrir cette machine aux autres appareils (accès distant)

2.1 Démarrer le serveur

Cliquez sur le bouton en forme de globe. Choisissez un « Port » (8799 par défaut ; le dernier port utilisé est mémorisé), une adresse « IP » pour le lien d’appairage (« Automatique (première adresse LAN) » ou une interface précise ; les interfaces VPN portent la mention « VPN ») et un mot de passe d’accès (« Définir le mot de passe d’accès »), puis cliquez sur « Démarrer le serveur ».

Le mot de passe d’accès est exigé pour chaque appareil qui se connecte. Lorsque le serveur est en cours d’exécution, le panneau indique : « L’accès distant redémarre automatiquement à la réouverture de l’application. « Arrêter le serveur » le désactive. » Si le démarrage automatique échoue lors d’un lancement ultérieur, le panneau affiche « Échec du démarrage automatique : » suivi de la raison.

La case « Refléter la disposition sur tous les appareils » est cochée par défaut. Lorsqu’elle est cochée, les onglets, les volets et la session active restent identiques sur tous les appareils connectés, tandis que le focus clavier reste propre à chacun. Décochez-la si chaque appareil doit organiser ses propres onglets.

2.2 Connecter un appareil

Une fois le serveur démarré, le panneau affiche l’état, l’« Empreinte du certificat (SHA-256) », un lien d’appairage et un code QR :

Pour connecter un appareil, scannez le code QR avec son appareil photo, ou envoyez-lui le lien d’appairage (par exemple par AirDrop ou dans un message à vous-même), puis ouvrez le lien dans un navigateur et saisissez le mot de passe d’accès. Le lien d’appairage et le mot de passe sont tous deux nécessaires ; l’ouverture de l’adresse seule, sans lien d’appairage, affiche « Ce serveur nécessite un lien d’association. » Les échanges entre le navigateur et cette machine sont chiffrés de bout en bout.

Deux points sont importants pour la sécurité :

• Le lien d’appairage contient des identifiants d’accès. Ne le partagez qu’avec vos propres appareils. Si vous pensez qu’il a été divulgué, cliquez sur « Régénérer le lien (déconnecte tout) » : l’ancien lien cesse immédiatement de fonctionner, et tous les appareils connectés sont déconnectés jusqu’à ce qu’ils ouvrent le nouveau lien.
• Lors de la première visite, le navigateur signale que le certificat n’est pas approuvé, ce qui est normal pour un certificat auto-signé. Comparez l’empreinte affichée par le navigateur avec celle du panneau. Si elles correspondent, vous êtes bien connecté à votre propre machine.

Si la machine dispose de plusieurs interfaces réseau (filaire, Wi-Fi, VPN), le panneau affiche l’adresse privilégiée et répertorie les autres sous « N autres liens ». Choisissez l’adresse située sur le même réseau que l’appareil à connecter.

Les liens d’appairage restent valides après un redémarrage de VelaTerm. Seul « Régénérer le lien (déconnecte tout) » les remplace.

2.3 Possibilités du client navigateur

La page de connexion et l’interface principale sur un appareil connecté :

Un client navigateur travaille avec les mêmes sessions en direct que l’application de bureau : la même arborescence de projets, la même sortie de terminal et de conversation, et chaque côté peut saisir du texte. Lorsque « Refléter la disposition sur tous les appareils » est activé, la barre de titre de l’hôte affiche « Miroir par N » ; cliquez dessus pour afficher les « Clients connectés » avec leur nom, leur adresse et leur heure de connexion. Les noms des clients sont communiqués par les clients eux-mêmes : considérez-les comme de simples libellés, et non comme une preuve d’identité.

Lorsque le même terminal est ouvert sur plusieurs appareils, sa taille suit celle de l’un d’entre eux. Les autres appareils affichent une copie mise à l’échelle, avec un badge « ⤢ Miroir … · cliquer pour adapter à cette fenêtre » dans l’angle supérieur droit du terminal ; cliquez dessus pour dimensionner le terminal selon la fenêtre actuelle.

Les clients navigateur ne disposent ni des onglets de navigateur ni de l’option de collage natif des images. Ils peuvent envoyer et télécharger des fichiers depuis l’onglet Fichiers (§5).

2.4 Appareils appairés

Cliquez sur « Appareils appairés » dans le panneau du serveur en cours d’exécution pour afficher tous les appareils qui se sont connectés, avec leur « Dernière connexion » :

Pour bloquer un appareil, cliquez sur « Bloquer », puis sur « Confirmer le blocage ». L’appareil est immédiatement déconnecté et ne peut plus se reconnecter tant qu’il n’a pas ouvert un nouveau lien d’appairage ; les autres appareils ne sont pas affectés. Pour déconnecter tous les appareils à la fois, utilisez « Régénérer le lien (déconnecte tout) ».

2.5 Arrêter le serveur

Cliquez sur « Arrêter le serveur » en bas du panneau. Les clients navigateur sont déconnectés, et les sessions en cours d’exécution se poursuivent, car elles appartiennent à l’application de bureau. L’arrêt désactive aussi le démarrage automatique ; lors du prochain démarrage du serveur, saisissez de nouveau le mot de passe d’accès.

3. Se connecter à d’autres machines

Cliquez sur le bouton de connexion de la barre de titre. Le panneau comporte trois onglets : « SSH », « URL » et « Distant ».

3.1 SSH : la machine distante n’a besoin que de SSH

Utilisez ce mode pour une machine distante sur laquelle aucun composant VelaTerm n’est installé. La machine distante peut fonctionner sous Linux (x86_64 ou ARM64), macOS (Apple Silicon ou Intel) ou Windows (x86_64) ; les machines Windows peuvent utiliser le serveur OpenSSH de Microsoft ou un serveur SSH Cygwin ou MSYS2. La connexion effectue automatiquement toute la mise en place : VelaTerm détecte le système distant, y copie le serveur VelaTerm correspondant, démarre ce serveur de façon qu’il continue de s’exécuter de manière autonome, redirige un port local vers celui-ci et ouvre une fenêtre distante qui se connecte automatiquement.

Saisissez user@host[:port] et cliquez sur « Se connecter ». Points à connaître :

Vérification de la clé d’hôte. La première connexion à un hôte affiche son « Empreinte de la clé d’hôte SSH » avec la mention « Première connexion à cet hôte — vérifiez l’empreinte avant de continuer. » Vérifiez-la et cliquez sur « Empreinte correcte, connecter » ; la clé est enregistrée dans known_hosts et la question ne vous est plus posée. Si la clé d’un hôte connu change, un avertissement rouge apparaît : « ⚠ La clé de cet hôte a changé — il peut s’agir d’une réinstallation du serveur ou d’une attaque de l’homme du milieu. Ne continuez que si vous êtes sûr. » Déterminez-en la cause avant de confirmer.

Authentification. Votre configuration SSH existante (ssh-agent, ~/.ssh/config et clés) est utilisée telle quelle. Une invite « Mot de passe SSH » n’apparaît qu’en cas d’échec de l’authentification par clé. « Se souvenir du mot de passe » enregistre le mot de passe dans le trousseau du système, jamais dans la base de données, et le réutilise lors de la connexion suivante.

Refléter l’application de bureau distante. Cette option est désactivée par défaut et mémorisée pour chaque hôte. Activez-la lorsque la machine distante exécute aussi l’application de bureau VelaTerm et que vous souhaitez voir exactement ce qu’elle affiche : les mêmes onglets, les mêmes volets et la même session active, les modifications effectuées d’un côté apparaissant des deux côtés. Si l’application de bureau n’est pas en cours d’exécution sur la machine distante, VelaTerm ouvre directement sa base de données, ou une base de données distincte s’il n’en existe aucune. Sans cette option, le serveur distant utilise son propre répertoire de données (~/.velaterm/data, ou %USERPROFILE%\.velaterm\data sous Windows), distinct de toute application de bureau installée sur cette machine.

Si vous maintenez la touche Option (Alt sous Windows et Linux) enfoncée en cliquant sur le bouton de connexion, une option supplémentaire s’affiche lorsque la mise en miroir est désactivée : « Utiliser la base de données de l’app de bureau distante ». Elle permet au serveur distant d’ouvrir la base de données de l’application de bureau distante sans se rattacher à l’application en cours d’exécution. Il est recommandé d’utiliser la même version de VelaTerm des deux côtés.

Hôtes récents. Les hôtes auxquels vous vous êtes connecté sont répertoriés sous « Hôtes récents » (« Tout afficher (N) » affiche la liste complète). Un clic sur une entrée ne fait que remplir le formulaire ; vérifiez-le, puis cliquez sur « Se connecter ». Une icône de clé signale un mot de passe enregistré, et × (« Oublier cet hôte ») supprime l’hôte et son mot de passe enregistré.

Progression. La première connexion copie le serveur (plusieurs dizaines de Mo), et le bouton affiche « Préparation du serveur… », « Transfert du serveur… » et « Démarrage du serveur… » avec un pourcentage. Les connexions suivantes réutilisent le serveur déjà présent sur la machine distante et sont beaucoup plus rapides.

3.2 URL : l’accès distant est activé sur l’autre machine

Utilisez ce mode lorsque l’accès distant est activé sur le VelaTerm d’une autre machine (§2) et que vous disposez de son lien d’appairage. Par rapport à l’ouverture du lien dans un navigateur web, vous bénéficiez d’une fenêtre dédiée, d’une connexion automatique avec un mot de passe enregistré dans le trousseau du système et d’une vérification des empreintes prise en charge par l’application.

Collez le lien d’appairage, saisissez le « Mot de passe de connexion » défini sur l’autre machine, puis cliquez sur « Se connecter ». La première connexion affiche l’empreinte du certificat TLS de l’autre machine ; comparez-la avec l’« Empreinte du certificat (SHA-256) » affichée dans le panneau de cette machine. Les connexions suivantes avec une empreinte inchangée s’établissent directement, et une empreinte modifiée déclenche un avertissement rouge. Les liens d’appairage récents sont répertoriés sous le formulaire, comme les hôtes SSH.

3.3 Distant : vos appareils connectés au même compte

L’onglet « Distant » répertorie les appareils connectés à votre compte VelaTerm (§4). Chaque appareil indique « En ligne » ou « Hors ligne » ainsi que ce qu’il partage, par exemple « Tout l’espace de travail », un projet ou une conversation, ou « Aucun contenu n’est partagé sur cet appareil. » Lorsqu’un appareil est en ligne et partage du contenu, « Voir le contenu partagé → » ouvre ce contenu dans une nouvelle fenêtre. Si vous n’êtes pas connecté à votre compte, l’onglet affiche un lien « Se connecter à VelaTerm ».

4. Partage via votre compte VelaTerm (expérimental)

Le partage par compte vous permet de poursuivre depuis vos autres appareils, via Internet, des conversations IA qui s’exécutent sur un ordinateur, sans ouvrir de ports ni vous trouver sur le même réseau. Le contenu partagé transite par velaterm.com, chiffré de bout en bout. Cette fonctionnalité est expérimentale.

4.1 Connexion

Cliquez sur le bouton du compte dans la barre de titre. La boîte de dialogue « Compte » affiche « Se connecter à VelaTerm » ; cliquez dessus pour poursuivre dans votre navigateur web. Pendant l’attente, VelaTerm affiche « Terminez la connexion dans votre navigateur, puis revenez à VelaTerm. » Vous pouvez développer « Détails de la demande de connexion » pour comparer la demande avec ce qu’affiche le site web.

Une fois la connexion établie, la boîte de dialogue affiche votre nom et « ID du compte : », un bouton « Compte » qui ouvre la page de votre compte sur velaterm.com, ainsi que « Se déconnecter ». La déconnexion du compte déconnecte cet ordinateur et arrête tout ce qu’il partage.

4.2 Partager du contenu

Sous « Partager du contenu », choisissez un « Périmètre du partage » : « Tout l’espace de travail », « Projet » ou « Conversation ». Pour un projet ou une conversation, sélectionnez l’élément dans la liste, puis cliquez sur « Partager du contenu ». Chaque élément partagé apparaît sous « Partage actif » avec son état (« Partage actif » ou « Contenu partagé indisponible ») et un bouton « Arrêter le partage ». Vous pouvez partager plusieurs éléments à la fois. Les partages sont conservés après un redémarrage et ne sont disponibles que tant que cet ordinateur exécute VelaTerm et est en ligne.

Seules les conversations IA sont partagées. Les terminaux classiques et les pages de navigateur ne sont jamais partagés, et un appareil qui consulte du contenu partagé ne peut ouvrir ni terminaux, ni fichiers, ni paramètres, ni nouveaux onglets.

4.3 Ouvrir du contenu partagé depuis un autre appareil

Sur un autre appareil connecté au même compte, ouvrez l’onglet « Distant » du bouton de connexion (§3.3) et cliquez sur « Voir le contenu partagé → ». Vous pouvez lire les conversations partagées. Vous pouvez aussi envoyer des messages, interrompre l’agent et répondre à ses demandes d’autorisation, mais uniquement pour les sessions que l’ordinateur qui partage affiche dans la vue conversation ; pour les autres sessions, la fenêtre indique que l’hôte doit d’abord faire passer la session dans la vue conversation.

Gardez à l’esprit qu’un agent IA agit avec les autorisations de l’utilisateur de l’ordinateur qui partage : il peut y exécuter des commandes et y modifier des fichiers. Toute personne en mesure de poursuivre une conversation partagée peut diriger l’agent ; ne partagez donc qu’avec des appareils que vous contrôlez, et utilisez « Arrêter le partage » lorsque vous n’avez plus besoin de cet accès.

5. Transfert de fichiers

Dans les clients navigateur ainsi que dans les fenêtres distantes URL et SSH, l’onglet Fichiers du panneau de droite permet de transférer des fichiers entre votre appareil et la machine qui exécute les sessions. L’application de bureau locale n’en a pas besoin et n’affiche pas ces actions.

• Envoi : cliquez avec le bouton droit sur un dossier, ou sur un fichier qu’il contient, puis choisissez « Envoyer des fichiers… » ; cliquez sur le bouton d’envoi de l’en-tête de l’onglet Fichiers (« Envoyer des fichiers dans ce dossier ») ; ou faites glisser des fichiers sur l’arborescence des fichiers. Les dossiers ne peuvent pas être envoyés.
• Téléchargement : cliquez avec le bouton droit sur un fichier et choisissez « Télécharger ». Dans un navigateur web, le fichier passe par le gestionnaire de téléchargements du navigateur. Dans une fenêtre distante URL ou SSH, une boîte de dialogue d’enregistrement vous demande où stocker le fichier (par défaut, le dossier Téléchargements).

Les envois, ainsi que les téléchargements dans les fenêtres distantes, apparaissent dans la liste « Transferts » avec leur taille, leur vitesse et le temps restant. Cliquez sur le bouton d’annulation pour interrompre un élément, et sur « Effacer » pour retirer les éléments terminés. Si la connexion est interrompue pendant un envoi, l’élément affiche « Reconnexion… » et VelaTerm continue de réessayer pendant environ une minute. Un envoi interrompu ne laisse jamais de fichier partiel à destination, et un nouvel envoi du même fichier reprend là où il s’était arrêté.

6. Utiliser VelaTerm sur un téléphone

Ouvrez un lien d’appairage (§2.2) dans le navigateur du téléphone, par exemple en scannant le code QR du panneau Accès distant. Sur un téléphone, VelaTerm passe à une disposition conçue pour les petits écrans tactiles. La disposition est choisie au chargement de la page : elle est utilisée sur les appareils tactiles dont le plus petit côté de l’écran mesure moins de 768 pixels. Ajoutez ?view=mobile ou ?view=desktop à l’adresse pour choisir vous-même la disposition (une tablette peut utiliser ?view=mobile), ou choisissez « Passer à la version bureau » dans le menu « Autres actions » (•••) ; ce choix est mémorisé.

La disposition mobile comporte deux niveaux :

• Liste des sessions : l’arborescence des projets, avec un champ de recherche (« Rechercher sessions / groupes… ») et des filtres d’état (« En cours », « À traiter », « Consulté »). Les sessions sont créées dans l’application de bureau ou dans le navigateur d’un ordinateur, et apparaissent ici automatiquement.
• Page de session : touchez une session pour l’ouvrir, et utilisez « ‹ Retour » pour revenir à la liste. Les sessions dans la vue conversation affichent la conversation complète. Les sessions Claude Code, Codex, OpenCode, Pi et OMP qui s’exécutent dans la vue terminal affichent leur conversation avec une zone de message dont le texte est saisi dans le terminal. Les autres sessions affichent le terminal avec une barre de touches : Esc, Tab, Ctrl (qui ouvre une ligne de combinaisons Ctrl telles que ^C, ^D, ^R et ^W), les touches fléchées, ^C, un bouton de clavier et un bouton d’appareil photo pour envoyer une image. Balayez l’écran pour faire défiler le contenu, touchez-le pour afficher le clavier, et appuyez longuement pour sélectionner un mot et le « Copier ».

La disposition mobile n’affiche ni onglets de navigateur, ni onglets de document, ni volets ; elle ne propose pas de raccourcis clavier et conserve sa propre vue au lieu de suivre « Refléter la disposition sur tous les appareils ». Les sessions Kiro présentent leur historique dans une vue en lecture seule.

VelaTerm pour iOS est disponible sur l’App Store, et VelaTerm pour Android sur Google Play.

7. Déconnexion, fermeture et éléments conservés

7.1 Trois niveaux d’état

Pour savoir si « tout est encore là après une déconnexion », il faut distinguer trois niveaux :

Seul le troisième niveau demande de l’attention : tant que le processus serveur distant s’exécute, vos sessions en cours continuent de s’exécuter.

7.2 Fermer une fenêtre distante

SSH : le serveur distant a été démarré par cette connexion ; la fermeture de la fenêtre ouvre donc la boîte de dialogue « Déconnexion du serveur distant », qui propose trois choix. « Arrêter le serveur » arrête le serveur sur la machine distante et met fin à ses sessions en cours. « Laisser en marche » déconnecte uniquement cette fenêtre ; la connexion suivante à cette machine réutilise le serveur avec toutes ses sessions intactes. « Annuler » laisse la fenêtre ouverte. Choisissez « Laisser en marche » si les agents doivent continuer à travailler en votre absence.

SSH rattaché à l’application de bureau distante : lorsque « Refléter l’application de bureau distante » a rattaché la fenêtre à une application de bureau en cours d’exécution, la fermeture de la fenêtre se contente de la déconnecter ; l’application de bureau continue de s’exécuter.

URL : vous étiez l’invité d’un VelaTerm déjà en cours d’exécution. La fermeture de la fenêtre signifie seulement que vous partez ; l’autre côté continue de s’exécuter, et vous retrouvez tout à votre retour.

7.3 Coupures de connexion

Lorsque le réseau est coupé, une barre rouge apparaît en haut de la fenêtre distante avec le message « Connexion perdue, reconnexion… », et VelaTerm réessaie automatiquement. Les sessions en cours d’exécution ne sont pas affectées ; en mode SSH, le serveur distant s’exécute indépendamment de la connexion SSH.

Dans les fenêtres SSH, VelaTerm reconstruit aussi de lui-même le tunnel SSH (« Liaison SSH perdue, reconstruction du tunnel… »). S’il abandonne, la barre indique « Liaison SSH interrompue — appuyez sur « Reconnecter maintenant » pour réessayer » ; cliquez alors sur « Reconnecter maintenant ». Si le serveur distant lui-même s’est arrêté, une reconnexion depuis la fenêtre ne suffit pas : revenez à la fenêtre principale et connectez-vous de nouveau. La connexion vérifie si le serveur distant est toujours en cours d’exécution, le réutilise dans ce cas (avec toutes les sessions) et n’en démarre un nouveau que dans le cas contraire.

Une machine distante qui se met en veille, ferme la session utilisateur ou redémarre met fin au serveur en mode SSH et à ses sessions en cours. L’arborescence des projets est stockée sur le disque et n’est pas affectée.

7.4 Aide-mémoire

8. Sécurité en bref

• Les mots de passe (mots de passe SSH et mots de passe de connexion à distance) ne sont stockés que dans le trousseau du système, jamais dans la base de données, et uniquement lorsque vous choisissez « Se souvenir du mot de passe ». Le mot de passe de l’accès distant n’est stocké que sous forme de hachage, afin que le serveur puisse redémarrer automatiquement.
• L’accès par navigateur sur le réseau local utilise TLS avec un certificat auto-signé. Les liens d’appairage contiennent des identifiants de chiffrement de bout en bout, et le serveur refuse les connexions sans lien d’appairage.
• Les clés d’hôte SSH et les certificats TLS distants sont approuvés à la première utilisation : les cibles connues et inchangées se connectent directement, les nouvelles cibles demandent une confirmation unique, et les empreintes modifiées déclenchent un avertissement rouge. Déterminez-en la cause avant de confirmer.
• Chaque appareil peut être bloqué à tout moment (§2.4), et le lien d’appairage peut être régénéré à volonté.
• Le partage par compte est limité aux conversations IA, mais les agents de ces conversations agissent avec vos autorisations sur l’ordinateur qui partage (§4.3).

Si la barre de titre affiche un badge « ⚠ vX ≠ vY », l’interface et le service VelaTerm auquel elle est connectée signalent des versions différentes, et certaines fonctionnalités peuvent ne pas fonctionner ensemble. Mettez VelaTerm à jour afin que les deux utilisent la même version.

9. Questions fréquentes

La fenêtre est connectée, mais la barre latérale reste vide ou la barre rouge ne disparaît jamais. Le serveur distant s’est probablement arrêté. Revenez à la fenêtre principale et connectez-vous de nouveau (§7.3).

Le serveur ne démarre pas sur le port 8799. Un autre programme utilise ce port. Choisissez un autre port dans le panneau et démarrez de nouveau le serveur.

Le navigateur indique que le certificat n’est pas approuvé. C’est normal pour un certificat auto-signé. Vérifiez l’empreinte et continuez (§2.2).

Un agent sur une machine distante doit continuer à travailler pendant mon absence. En mode SSH, choisissez « Laisser en marche » lorsque vous fermez la fenêtre. La session se poursuit sur la machine distante, et vous pouvez vous reconnecter plus tard pour reprendre là où elle en est.

Un terminal s’affiche en très petit sur mon téléphone. Il s’agit d’une copie mise à l’échelle qui suit la taille d’un autre appareil. Touchez « adapter à cette fenêtre » dans le badge situé en haut à droite du terminal pour l’adapter à votre téléphone.

« Voir le contenu partagé » n’apparaît pas pour mon ordinateur. Ce bouton n’apparaît que lorsque l’ordinateur est en ligne, connecté au même compte et qu’il partage du contenu. Ouvrez VelaTerm sur cet ordinateur et vérifiez « Partage actif » dans sa boîte de dialogue « Compte ».