Documentation VNTerm

Un guide rapide, de l’installation à la synchronisation des hosts entre vos machines.

Installer l’application

Téléchargez l’installateur pour votre système d’exploitation sur la page Téléchargements.

macOS (11+, Apple Silicon & Intel)

Ouvrez le fichier VNTerm_<version>_aarch64.dmg et faites glisser VNTerm dans le dossier Applications.
À la première ouverture, si macOS indique que le développeur ne peut pas être vérifié : clic droit sur l’application → Open.

Ubuntu / Debian (22.04+, x86_64)

sudo apt install ./vnterm_*_amd64.deb

Ou utilisez la version AppImage sans installation :

chmod +x VNTerm_*_amd64.AppImage && ./VNTerm_*_amd64.AppImage

Windows 10/11 (x64)

Lancez VNTerm_*_x64-setup.exe (ou VNTerm_*_x64_en-US.msi pour un déploiement via GPO/Intune). Si SmartScreen affiche un avertissement, choisissez More info → Run anyway.

Créer un compte

Le compte sert à synchroniser le vault entre vos appareils. Vous pouvez vous inscrire directement dans l’application ou sur la page d’inscription.

Le mot de passe principal (8 caractères minimum) chiffre l’intégralité du vault sur votre machine. Il n’est jamais envoyé au serveur et nous ne pouvons pas le récupérer.
Après l’inscription, l’application affiche la clé de récupération une seule fois — conservez-la (voir Clé de récupération).
Connectez-vous avec le même compte sur une autre machine pour récupérer tous vos hosts, clés et snippets. La liste des appareils et le bouton de révocation se trouvent sur la page Compte.

Ajouter un host

Dans la section Hosts, cliquez sur New host.
Saisissez l’Address (IP ou nom d’hôte), le Label, choisissez le Parent Group et les Tags si besoin.
Définissez le port SSH (22 par défaut), le Username et le Password, ou associez une clé / Identity depuis le Keychain.
Double-cliquez sur la carte d’un host pour vous connecter. À la première connexion, l’application affiche l’empreinte du serveur pour que vous la confirmiez ; elle est enregistrée dans Known Hosts et vous serez averti si elle change.

Vous avez déjà une configuration ? Choisissez New host → Import from ~/.ssh/config pour un import en masse. Les options avancées du host incluent agent forwarding, startup snippet, host chaining (jump host), proxy SOCKS5/HTTP et thème de terminal dédié.

Keychain & Identity

Générer une clé : Keychain → Generate key, choisissez ed25519 (recommandé), ECDSA ou RSA, et définissez une passphrase si vous le souhaitez.
Importer une clé : collez ou sélectionnez un fichier de clé privée existant (OpenSSH / PEM).
Ajoutez la clé publique à ~/.ssh/authorized_keys sur le serveur, puis associez la clé au host dans la section Credentials.
Identity regroupe nom d’utilisateur + mot de passe/clé en un ensemble réutilisable sur plusieurs hosts : changez le mot de passe une fois, tous les hosts qui utilisent cette Identity sont mis à jour.

Quick connect: SSH, Mosh, Telnet

Saisissez l’adresse dans le champ de recherche de la page Hosts puis appuyez sur Enter ou Connect. Syntaxe :

[ssh|mosh|telnet] [user@]host[:port]
[email protected]
mosh [email protected]
telnet 10.0.0.5:23
[2001:db8::1]:2222

Si aucun protocole n’est indiqué, l’application vous demande de choisir SSH, Mosh ou Telnet, puis vos identifiants si nécessaire.

SSH — port 22 par défaut, prend en charge mot de passe, clé et agent.
Mosh — lance le client mosh du système dans un onglet et maintient la session quand le réseau est instable ou que vous changez de Wi-Fi. Nécessite mosh sur votre machine et mosh-server sur le serveur.
Telnet — port 23 par défaut, pour les anciens équipements réseau. Telnet n’est pas chiffré : à utiliser uniquement sur un réseau de confiance.

SFTP

Ouvrez l’onglet SFTP : le panneau de gauche est votre machine, celui de droite le host enregistré. Vous pouvez parcourir les dossiers, faire upload / download via le menu contextuel, créer des dossiers, renommer, supprimer et modifier les permissions (chmod). Maintenez ⌘/Ctrl en cliquant pour sélectionner plusieurs fichiers.

Port forwarding

La section Port Forwarding enregistre les règles avec le vault ; chaque règle s’active / se désactive indépendamment.

Type	Équivalent	Utilisation
Local (L)	`ssh -L 5432:db.internal:5432 host`	Accédez à un service situé derrière le serveur via un port de votre machine, par exemple une base de données interne.
Remote (R)	`ssh -R 8080:localhost:3000 host`	Permet au serveur d’accéder à un service qui tourne sur votre machine.
Dynamic (D)	`ssh -D 1080 host`	Crée un proxy SOCKS5 local, tout le trafic passe par le serveur.

Bases de données

La section Databases se connecte à MySQL, MariaDB, PostgreSQL et SQLite. Les paramètres de connexion (mots de passe compris) sont dans votre coffre et chiffrés de bout en bout comme les hôtes. Choisissez un hôte sous Se connecter via un hôte SSH pour passer par un tunnel SSH — sans règle de redirection de port. Disponible sur ordinateur et sur téléphone.

Arborescence à gauche — dossier → connexion → base → Tables, Vues, Fonctions, Événements, Requêtes. Chaque entrée s'ouvre dans un onglet ; clic droit (ou appui long sur téléphone) pour le menu.
Données — cliquez sur une cellule pour la modifier et éloignez le pointeur pour enregistrer ; sélectionnez une ligne par son numéro, puis ⌘/Ctrl+C, ⌘/Ctrl+V ajoute une nouvelle ligne. Filtre, tri, export CSV / JSON / SQL et import CSV.
Concepteur de table — champs, index, clés étrangères, déclencheurs, contraintes et options ; aperçu du SQL avant l'enregistrement.
Lecture seule — les requêtes démarrent en lecture seule ; désactivez l'option pour écrire.

Serial

Page Hosts → Serial : choisissez le port (par exemple /dev/ttyUSB0, COM3) et le débit en bauds (300 – 921600, 9600 par défaut). La section Advanced permet de régler data bits, parité et stop bits. Sous Linux, le compte doit appartenir au groupe dialout pour ouvrir un port série.

Remote Desktop

Contrôlez des machines Windows directement dans un onglet de l'application de bureau. Rien à installer ni à configurer sous Windows — il suffit que le Bureau à distance soit activé (Settings → System → Remote Desktop) et que le port 3389 soit joignable.

New host → choisissez Remote Desktop, saisissez l'adresse, le nom d'utilisateur (avec le domaine si besoin, p. ex. CORP\admin) et le mot de passe.
Double-cliquez sur l'hôte pour ouvrir l'écran Windows. La résolution suit la taille de l'onglet.
La barre d'outils de l'onglet : Qualité (Automatique selon le débit, ou fixe), GFX (graphismes RDP 8+, activé par défaut), un bouton Ctrl + Alt + Suppr, écran partagé, fenêtre flottante et partage.

Le copier / coller de texte fonctionne dans les deux sens entre votre ordinateur et Windows.
Les raccourcis sont envoyés à Windows. Sur Mac, ⌘ + C / V / X / Z / A / F / S deviennent Ctrl, les autres combinaisons ⌘ la touche Windows ; ⌘ W ferme toujours l'onglet.
Réseau lent : le mode Automatique baisse la qualité d'image pour rester réactif, puis la remonte quand le réseau s'améliore.

Onglets & groupes d’onglets

Chaque session est un onglet ; plusieurs sessions vers le même host sont numérotées, par exemple Onik (1), Onik (2).
Glissez un onglet sur un autre pour les regrouper. Un groupe peut être dissocié ou fermé en une seule fois.
Le bouton + de la barre d’onglets ouvre la connexion rapide ou un terminal local.

Fenêtre flottante

Clic droit sur un onglet → Float on top pour placer un terminal (ou un écran de Bureau à distance) dans une petite fenêtre toujours au premier plan — pratique pour suivre des logs ou un build pendant que vous faites autre chose. Fermer la fenêtre flottante ramène la session dans son onglet.

Multiplayer

Clic droit sur un onglet → Multiplayer pour créer un lien de partage. Les destinataires l'ouvrent dans leur navigateur, sans compte. Le contenu est chiffré de bout en bout et la clé se trouve après le # du lien : le serveur ne peut pas le lire. Vous activez ou désactivez la saisie (ou le contrôle du Bureau à distance) des spectateurs et arrêtez le partage à tout moment.

Thème & apparence

Dans Settings, choisissez le thème de terminal par défaut, la taille de police et la langue de l’interface. Chaque host peut avoir son propre thème (dans le panneau d’édition du host) ; un host sans thème utilise le thème par défaut du compte. Ces paramètres sont synchronisés avec le vault.

Raccourcis clavier

Action	macOS	Linux / Windows
Ouvrir un terminal local	`⌘` `⇧` `T`	`Ctrl` `Shift` `T`
Copier dans le terminal	`⌘` `C`	`Ctrl` `Shift` `C`
Coller dans le terminal	`⌘` `V`	`Ctrl` `Shift` `V`
Connexion rapide depuis le champ de recherche	`Enter`
Fermer le panneau / la boîte de dialogue, annuler la recherche	`Esc`
Sélection multiple de fichiers dans SFTP	`⌘` + click	`Ctrl` + click

Synchronisation & chiffrement de bout en bout

VNTerm chiffre votre coffre sur votre appareil : le serveur ne stocke que des données chiffrées et ne reçoit jamais votre mot de passe principal. Tant que la connexion rapide avec Google / Apple / Telegram est activée (par défaut), le serveur garde aussi une copie chiffrée de votre clé de coffre pour ouvrir votre coffre sur un nouvel appareil — désactivez-la dans l'application : Réglages → Compte.

Mot de passe principal → PBKDF2-SHA256 (600 000 itérations) → master key. On en dérive l’auth key (envoyée au serveur pour la connexion, stockée sous forme Argon2id) et l’enc key (qui reste uniquement sur votre machine).
Chaque host, clé, snippet… est chiffré en AES-256-GCM avec une vault key aléatoire avant la synchronisation. La vault key est elle-même chiffrée par l’enc key.
Chaque requête API est en outre chiffrée par une couche supplémentaire (X25519 + AES-256-GCM, liée à l’endpoint et à l’horodatage, anti-rejeu) à l’intérieur de HTTPS.
Synchronisation par révision : une modification simultanée du même élément sur deux machines est détectée comme un conflit au lieu d’être écrasée silencieusement.

Clé de récupération

La clé de récupération est le seul moyen de conserver les données du vault si vous oubliez votre mot de passe principal.

Conservez la clé (au format XXXX-XXXX-…) en lieu sûr : gestionnaire de mots de passe ou version imprimée.
En cas d’oubli du mot de passe : allez sur Mot de passe oublié, saisissez le code à 6 chiffres reçu par e-mail, définissez un nouveau mot de passe et collez la clé de récupération — le vault est conservé.
Sans clé de récupération : l’ancien vault est supprimé, vous obtenez un vault vide et une nouvelle clé de récupération. Tous les appareils sont déconnectés après la réinitialisation du mot de passe.

Team vault

Bouton Vaults ▾ de la barre du haut → Add vault : donnez un nom et invitez des membres par e-mail.
Menu de l'hôte → Move to vault place l'hôte (avec ses clés / identités) dans un coffre d'équipe.
Dans le menu Vaults ▾, cliquez sur un coffre pour le masquer / l'afficher, ou sur only pour ne voir que lui. Cela ne s'applique qu'à l'appareil actuel.
Manage vaults (Settings → Invite People) liste les membres et les invitations en attente ; retirer quelqu'un révoque son accès immédiatement.

Les nouveaux membres ouvrent l'application une fois pour créer leur paire de clés ; un membre qui détient la clé scelle alors automatiquement la clé du coffre pour eux.

Offres & facturation

Consultez et achetez les offres sur la page Tarifs. Paiement par carte (Stripe) ou PayPal, au mois ou à l'année ; codes promo acceptés. Les offres sont prépayées et ne vous prélèvent jamais automatiquement — vous recevez un rappel avant l'échéance et renouvelez depuis la page Compte.

Les fonctionnalités se débloquent dans l'application quelques secondes après le paiement (ou à votre retour dans l'application).
Les offres Team / Business sont facturées par siège ; les membres de votre coffre d'équipe utilisent les fonctionnalités de l'offre.
Quand une offre prend fin, rien n'est perdu : votre coffre se télécharge toujours sur vos appareils, seules les fonctionnalités de l'offre se verrouillent.

Encore des questions ? Signalez un bug ou proposez une fonctionnalité.