Accès à distance

Accédez à SimpliGen depuis un agent exécuté sur un VPS ou une autre machine, via un tunnel sécurisé.

View as Markdown Open in ChatGPT Open in Claude

Par défaut, un agent se connecte à SimpliGen sur la même machine. Si vous exécutez votre agent ailleurs, par exemple sur un VPS, vous pouvez toujours accéder à SimpliGen via un tunnel sécurisé, sans apporter de modifications à l'application.

L'idée

Le service de contrôle de SimpliGen n'écoute que sur localhost, pour des raisons de sécurité. L'astuce consiste donc à créer un tunnel du localhost de la machine distante vers le localhost de votre machine SimpliGen. Un tunnel SSH inverse fait exactement cela, et SSH gère tout le chiffrement et l'authentification.

Ce dont vous avez besoin

SimpliGen exécuté sur votre machine personnelle, avec un jeton d'appairage (créez-en un dans Paramètres -> Connecter un agent -> Configuration manuelle).
Le port de l'API de contrôle. Sous Windows, il se trouve dans %APPDATA%\simpligen\agent-api.json, par exemple 48199.
Un accès SSH de votre machine personnelle vers la machine distante.

Ouvrir le tunnel

Depuis votre machine personnelle (où SimpliGen s'exécute), ouvrez un tunnel inverse vers la machine distante. Remplacez 48199 par votre port et user@your-vps par votre serveur:

ssh -N -R 48199:localhost:48199 user@your-vps

Cela fait que localhost:48199 sur la machine distante renvoie à localhost:48199 sur votre machine personnelle. Laissez-le fonctionner pendant que l'agent travaille.

Pointer l'agent vers celui-ci

Sur la machine distante, configurez le serveur MCP de votre agent avec votre jeton et le port:

{
  "mcpServers": {
    "simpligen": {
      "command": "npx",
      "args": ["-y", "@simpligen/mcp"],
      "env": {
        "SIMPLIGEN_TOKEN": "sg-agent-...",
        "SIMPLIGEN_API_PORT": "48199"
      }
    }
  }
}

SIMPLIGEN_API_PORT indique au connecteur quel port utiliser, puisque la machine distante n'a pas d'installation SimpliGen pour le détecter. Chaque demande traverse le tunnel jusqu'à SimpliGen sur votre machine personnelle.

Gardez les deux en cours d'exécution

SimpliGen doit rester ouvert sur votre machine personnelle, et le tunnel doit rester actif. Si l'un des deux s'arrête, l'agent perd sa connexion jusqu'à ce que vous le redémarriez.

Utiliser Tailscale ou un réseau privé

Si vous utilisez un réseau maillé privé comme Tailscale, exécutez le même tunnel SSH inverse sur celui-ci pour un lien stable sans ouvrir aucun port sur votre routeur personnel. La mécanique est identique: le localhost de la machine distante se transmet toujours au localhost de votre machine personnelle.

Une note sur la sécurité

Puisque le tunnel se termine sur localhost des deux côtés, vous n'exposez pas SimpliGen à l'internet public. SSH chiffre et authentifie la connexion, et votre jeton d'appairage autorise l'agent. Vous pouvez révoquer ce jeton depuis Agents connectés à tout moment pour couper l'accès.