Accesso remoto

Raggiungi SimpliGen da un agente in esecuzione su un VPS o un'altra macchina, attraverso un tunnel sicuro.

View as Markdown Open in ChatGPT Open in Claude

Per impostazione predefinita, un agente si connette a SimpliGen sulla stessa macchina. Se esegui il tuo agente altrove, come su un VPS, puoi comunque raggiungere SimpliGen attraverso un tunnel sicuro, senza apportare modifiche all'app.

L'idea

Il servizio di controllo di SimpliGen ascolta solo su localhost, per motivi di sicurezza. Il trucco è quindi di creare un tunnel dal localhost della macchina remota al localhost della tua macchina SimpliGen. Un tunnel SSH inverso fa esattamente questo, e SSH gestisce tutta la crittografia e l'autenticazione.

Cosa ti serve

SimpliGen in esecuzione sulla tua macchina principale, con un token di associazione (creane uno in Impostazioni -> Connetti un agente -> Configurazione manuale).
La porta dell'API di controllo. Su Windows si trova in %APPDATA%\simpligen\agent-api.json, ad esempio 48199.
Accesso SSH dalla tua macchina principale alla macchina remota.

Apri il tunnel

Dalla tua macchina principale (dove SimpliGen è in esecuzione), apri un tunnel inverso verso la macchina remota. Sostituisci 48199 con la tua porta e user@your-vps con il tuo server:

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

Questo rende localhost:48199 sulla macchina remota un inoltro a localhost:48199 sulla tua macchina principale. Mantienilo in esecuzione mentre l'agente lavora.

Indica all'agente dove trovarla

Sulla macchina remota, configura il server MCP del tuo agente con il tuo token e la porta:

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

SIMPLIGEN_API_PORT dice al connettore quale porta usare, poiché la macchina remota non ha un'installazione di SimpliGen da cui rilevarla. Ogni richiesta viaggia attraverso il tunnel verso SimpliGen sulla tua macchina principale.

Mantieni entrambi in esecuzione

SimpliGen deve rimanere aperto sulla tua macchina principale, e il tunnel deve rimanere attivo. Se uno dei due si ferma, l'agente perde la connessione finché non lo riavvii.

Usare Tailscale o una rete privata

Se utilizzi una rete mesh privata come Tailscale, esegui lo stesso tunnel SSH inverso su di essa per un collegamento stabile senza aprire porte sul router di casa. La meccanica è identica: il localhost della macchina remota si inoltrerà ancora al localhost della tua macchina principale.

Una nota sulla sicurezza

Poiché il tunnel termina su localhost su entrambi gli estremi, non esponi SimpliGen a internet pubblico. SSH crittografa e autentica la connessione, e il tuo token di associazione autorizza l'agente. Puoi revocare quel token da Agenti connessi in qualsiasi momento per interrompere l'accesso.