---
tags: [note opencode desktop ia vps, OpenCode]
type: "note"
nature: documentation # Options : portrait, lieu, info, concept, script, process, tuto, none
ressource: true
univers: PERSO
projects:
  - "[[03_PROJETS/VPS-IA]]"
date: "[[01_JOURNAL/2026/2026-10-26]]"
priority: 10
description: "Connexion d'OpenCode Desktop au serveur VPS par tunnel SSH -L, contournant le SSO YunoHost."
---
# Connecter OpenCode Desktop à OpenCode Server sur VPS IA

La méthode la plus simple et sécurisée est d'utiliser un tunnel SSH.
L'objectif est de créer un pont sécurisé (tunnel) qui fait croire à OpenCode Desktop que le serveur tourne en local.


## En ligne de commande

Il faut exécuter cette commande **depuis un terminal (sur le PC)** :

```sh
ssh -L 49374:127.0.0.1:49374 shizendo@datagrandest.net
```

Une fois ce terminal ouvert il faut le laisser tourner en arrière-plan.

Ensuite :
* Dans **OpenCode Desktop**, il faut configurer le serveur distant pour qu'il pointe vers `http://localhost:49374`.
* Le trafic transitera de manière sécurisée par le tunnel SSH, contournera le SSO et arrivera directement sur le serveur OpenCode du VPS.


## Via Putty

### Étape 1 : Configurer le Tunnel dans PuTTY

1. Ouvrir **PuTTY**.
2. Dans le menu de gauche, charger la session habituelle (ou entrez l'adresse IP du VPS dans *Host Name*).
3. Dans le menu de gauche, dérouler l'arborescence : **Connection** -> **SSH** -> **Tunnels**.
4. Aller dans le transfert de port (*Port Forwarding*) :
    * **Source port** : Entrer `49374`.
    * **Destination** : Entrer `127.0.0.1:49374` (le port cible sur votre VPS).
5. Cliquez sur le bouton **Add**.
    * La ligne `L49374 127.0.0.1:49374` apparaît dans la liste juste au-dessus (*Forwarded ports*).
6. Si nécessaire, dans **Connection** -> **SSH** -> **Auth** renseigner la clé privée de connexion SSH au format `ppk`.
    
### Étape 2 : Sauvegarder et Ouvrir la session

1. Revenir sur la catégorie tout en haut dans le menu de gauche : **Session**.
2. Dans *Saved Sessions*, taper un nom (par exemple `OpenCode Tunnel`) et cliquer sur **Save**.
3. Cliquer sur **Open** pour lancer la connexion SSH vers votre VPS.
4. Se connecter avec les identifiants habituels (ou la clé SSH).

*Tant que cette fenêtre noire PuTTY reste ouverte, le tunnel réseau fonctionne en arrière-plan.*

### Étape 3 : Configurer OpenCode Desktop

Le pont sécurisé est établi entre votre PC et votre VPS via PuTTY.

1. Ouvrir **OpenCode Desktop** sur le PC.
2. Renseigner l'adresse locale : `http://127.0.0.1:49374`.
3. Saisir le mot de passe d'authentification du serveur si demandé.

Le trafic emprunte le tunnel PuTTY, traverser le SSH de manière chiffrée, contourne le SSO du VPS et va dialoguer directement avec le serveur OpenCode qui tourne en local sur `127.0.0.1:49374` sur le VPS.