Bohdan Triapitsyn
6ec1797583
- --relay links now carry both routes: direct LAN plus relay fallback, matching the UI's Anywhere pairing; devices prefer the direct route - pairing sessions created by the CLI are marked with usesRelay, and the server reconciles relay demand on a timer, so a headless instance brings the relay up on its own after connect-url --relay - warn with LAN_UNREACHABLE when the link's direct route points at loopback and other devices cannot use it - document the --relay flow and the --lan binding caveat in Connect a Device and Remote Instances across all locales
49 lines
3.8 KiB
Plaintext
49 lines
3.8 KiB
Plaintext
---
|
||
title: Instances distantes
|
||
description: Connectez l’application desktop à OpenChamber sur une autre machine via SSH.
|
||
---
|
||
|
||
# Instances distantes
|
||
|
||
L’application desktop peut se connecter à OpenChamber exécuté sur une autre machine via SSH — serveur de travail, machine cloud, homelab — et afficher son UI sur votre écran comme si elle était locale. Configurez cela dans **Paramètres → Instances distantes**.
|
||
|
||
> Les instances distantes sont une fonctionnalité **desktop uniquement**. Sur le web ou dans VS Code, connectez-vous à un serveur distant avec les variables d’environnement de [Serveur OpenCode](/opencode-server/) à la place.
|
||
|
||
## Ajouter une instance distante
|
||
|
||
1. Ouvrez **Paramètres → Instances distantes** et ajoutez-en une.
|
||
2. Donnez la commande SSH que vous utilisez normalement pour joindre la machine, plus un surnom.
|
||
3. Choisissez comment OpenChamber s’y exécute :
|
||
- **managed** — OpenChamber s’installe et se démarre sur la machine distante
|
||
- **external** — se connecter à une instance déjà en cours d’exécution
|
||
4. Connectez-vous.
|
||
|
||
OpenChamber déroule les étapes — vérification de la connexion, configuration du remote, démarrage du serveur et transfert du port — et montre où il en est à chaque étape. Quand il atteint **ready**, l’UI distante se charge localement.
|
||
|
||
## Identifiants
|
||
|
||
Vous décidez d’enregistrer les mots de passe SSH et UI ou de les saisir à chaque fois. Si la connexion tombe, OpenChamber indique l’étape qui a échoué pour vous aider à corriger — voir [Accès distant](/troubleshooting/remote-access/).
|
||
|
||
## Liens de connexion
|
||
|
||
Si une machine distante exécute déjà OpenChamber, le moyen le plus simple de connecter l’application desktop est un lien d’association. Sur l’UI du serveur distant, ouvrez **Paramètres → Instances distantes → Se connecter à ce serveur → Ajouter un appareil**, créez un lien, puis importez-le sur votre desktop dans **Paramètres → Instances distantes → Autres serveurs OpenChamber → Importer le lien**. Voir [Connecter un appareil](/connect-devices/) pour le flux complet.
|
||
|
||
Un lien créé avec **Partout** contient à la fois une adresse directe et une route via le [Relais privé](/private-relay/) : le desktop se connecte directement quand il peut joindre le serveur (même réseau), et bascule sur le relais chiffré de bout en bout quand vous êtes en déplacement. Le statut à côté de chaque serveur enregistré indique la route utilisée.
|
||
|
||
Vous pouvez aussi créer un lien depuis un terminal sur la machine distante :
|
||
|
||
```bash
|
||
openchamber connect-url --port 3000 --server http://your-host:3000 --qr
|
||
```
|
||
|
||
`connect-url` démarre d’abord le serveur si rien ne tourne sur ce port. Ajoutez `--api-only` pour un serveur headless, `--lan` pour écouter sur le LAN au démarrage, `--ui-password` pour protéger l’accès navigateur et `--name` pour nommer la connexion enregistrée. Ajoutez `--relay` pour un lien qui fonctionne aussi hors du réseau local : l’appareil préfère la connexion directe quand elle est joignable et bascule sur le [Relais privé](/private-relay/) — l’instance active le relais toute seule.
|
||
|
||
Le lien généré contient un secret d’association à usage unique. Une fois importé, l’appareil détient son propre token client — séparé du mot de passe de l’UI navigateur — qui survit aux redémarrages du serveur jusqu’à révocation sur le serveur émetteur.
|
||
|
||
## Pages liées
|
||
|
||
- [Connecter un appareil](/connect-devices/) — liens d’association, QR codes et gestion des appareils
|
||
- [Relais privé](/private-relay/) — comment fonctionnent les connexions « Partout »
|
||
- [Serveur OpenCode](/opencode-server/) — se connecter à un serveur distant sur web ou VS Code
|
||
- [Accès distant](/troubleshooting/remote-access/) — quand une connexion ne se termine pas
|