{"title":"SSH-åtkomst via proxy","slug":"ssh-proxy-access","category":"llm-cookbook","summary":"Hur en LLM-agent kör kommandon på fjärrmaskiner säkert via ett SSH-proxy-API i stället för råa SSH-nycklar.","audience":["llm"],"tags":["cookbook","ssh","proxy","infrastructure","remote-execution"],"difficulty":"intermediate","updated":"2026-09-26","word_count":326,"read_minutes":2,"llm_context":"Håll ALDRIG råa SSH-privatnycklar som LLM. Använd ett SSH-proxy-HTTP-API:\n1) POST /connect?target= → session_id (beständig, överlever timmar).\n2) POST //exec {command, timeout} → exec_id.\n3) GET //exec/ → utdata när klar.\n4) Använd SFTP-endpoints för filuppladdning/nedladdning i stället för cat/heredoc.\nTargets är förregistrerade namn (t.ex. \"vps1\"), inte IP:er — proxyn är den\nenda platsen där credentials lever.\n","lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# SSH-åtkomst via proxy\n\nAgenter behöver köra kommandon på fjärrmaskiner — deploya en container, läsa en logg, fixa en config. Att ge råa SSH-privatnycklar till en LLM är en dålig idé: nycklar hamnar i kontextfönster, loggar och transkriptioner. En SSH-proxy löser detta: den äger credentials, agenten talar bara HTTP.\n\n## Modellen\n\n```\nLLM ──HTTPS──► SSH-proxy ──SSH──► målmaskiner\n (äger nycklarna,\n auditlogg,\n rategränser)\n```\n\nProxyn exponerar beständiga sessioner med ett enkelt REST-yta:\n\n| Endpoint | Syfte |\n|---|---|\n| `POST /connect?target=vps1` | öppna en session → `session_id` |\n| `POST //exec` `{command, timeout}` | köra ett kommando (async) → `exec_id` |\n| `GET //exec/` | hämta utdata |\n| SFTP-endpoints | filuppladdning/nedladdning, `ls`, `mkdir`, `rm` |\n\nAutentisering är en Bearer-token — samma mönster som alla andra API:er du använder.\n\n## Exekveringsmönstret\n\n```bash\n# 1. anslut en gång, återanvänd sessionen för hela tasken\nSID=$(curl -s -H \"Authorization: Bearer $KEY\" \\\n \"https://ssh-proxy.example/connect?target=vps1\" | jq -r .session_id)\n\n# 2. kör ett kommando\nEID=$(curl -s -H \"Authorization: Bearer $KEY\" -H \"Content-Type: application/json\" \\\n -X POST \"https://ssh-proxy.example/$SID/exec\" \\\n -d '{\"command\": \"docker ps --format \\\"{{.Names}}\\\"\", \"timeout\": 120}' | jq -r .exec_id)\n\n# 3. hämta resultatet\ncurl -s -H \"Authorization: Bearer $KEY\" \"https://ssh-proxy.example/$SID/exec/$EID\"\n```\n\n## Uppföranderegler\n\n1. **Återanvänd sessioner.** Att ansluta per kommando slösar resurser och utlöser rategränser. Spara `session_id` (t.ex. `/tmp/vps1_sid`) och heartbeat:a den före återanvändning.\n2. **Namnge targets, upptäck dem inte.** Targets är förregistrerade (`vps1`, `pi`, …). Proxyn är den enda sanningskällan — hardkoda aldrig IP-adresser i agentkod.\n3. **Föredra SFTP framför shell cat/heredoc för filer.** Att escap:a binär data via `exec` korrumperar payloads. Använd de dedikerade uppladdnings-/nedladdningendpointsen.\n4. **Citera dina kommandon.** JSON-kroppen parsas två gånger (HTTP + shell). Wrappa fjärrkommandon i enkla citattecken och håll dem enradiga.\n5. **Anta auditing.** Varje exec hamnar i proxyns auditlogg — bete dig som om människan läser allt (hon kan).\n\n## När exec INTE ska användas\n\n- Läsa strukturerad tillstånd som har ett API (Docker, databaser, Synapse Mind API) — föredra alltid API framför CLI-output-parsning.\n- Långvariga interaktiva processer. `exec` är fire-and-forget med timeout; använd `nohup` + en statusfil på targeten.\n- Allt destruktivt utan uttrycklig instruktion. Proxyn ger dig makten — människan ger dig tillåtelsen.\n\n## Felåterställning\n\n| Symptom | Åtgärd |\n|---|---|\n| 401 vid connect | token utgången — läs den igen från memory/settings, aldrig från en transkription |\n| session 404 | sessionen utgick (24h-gräns) — anslut igen |\n| exec-timeout | höj `timeout` eller dela kommandot; kontrollera lasten på targeten |\n| korrumperat filinnehåll | du använde `exec` i stället för SFTP — byt till SFTP-endpointsen |\n","content_html":"

SSH-åtkomst via proxy

\n

Agenter behöver köra kommandon på fjärrmaskiner — deploya en container, läsa en logg, fixa en config. Att ge råa SSH-privatnycklar till en LLM är en dålig idé: nycklar hamnar i kontextfönster, loggar och transkriptioner. En SSH-proxy löser detta: den äger credentials, agenten talar bara HTTP.

\n

Modellen

\n
LLM ──HTTPS──► SSH-proxy ──SSH──► målmaskiner\n                (äger nycklarna,\n                 auditlogg,\n                 rategränser)

Proxyn exponerar beständiga sessioner med ett enkelt REST-yta:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
EndpointSyfte
POST /connect?target=vps1öppna en session → session_id
POST /<sid>/exec {command, timeout}köra ett kommando (async) → exec_id
GET /<sid>/exec/<exec_id>hämta utdata
SFTP-endpointsfiluppladdning/nedladdning, ls, mkdir, rm
\n

Autentisering är en Bearer-token — samma mönster som alla andra API:er du använder.

\n

Exekveringsmönstret

\n
# 1. anslut en gång, återanvänd sessionen för hela tasken\nSID=$(curl -s -H "Authorization: Bearer $KEY" \\\n  "https://ssh-proxy.example/connect?target=vps1" | jq -r .session_id)\n\n# 2. kör ett kommando\nEID=$(curl -s -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \\\n  -X POST "https://ssh-proxy.example/$SID/exec" \\\n  -d '{"command": "docker ps --format \\"{{.Names}}\\"", "timeout": 120}' | jq -r .exec_id)\n\n# 3. hämta resultatet\ncurl -s -H "Authorization: Bearer $KEY" "https://ssh-proxy.example/$SID/exec/$EID"

Uppföranderegler

\n
    \n
  1. Återanvänd sessioner. Att ansluta per kommando slösar resurser och utlöser rategränser. Spara session_id (t.ex. /tmp/vps1_sid) och heartbeat:a den före återanvändning.
    2. \n
  2. Namnge targets, upptäck dem inte. Targets är förregistrerade (vps1, pi, …). Proxyn är den enda sanningskällan — hardkoda aldrig IP-adresser i agentkod.
    3. \n
  3. Föredra SFTP framför shell cat/heredoc för filer. Att escap:a binär data via exec korrumperar payloads. Använd de dedikerade uppladdnings-/nedladdningendpointsen.
    4. \n
  4. Citera dina kommandon. JSON-kroppen parsas två gånger (HTTP + shell). Wrappa fjärrkommandon i enkla citattecken och håll dem enradiga.
    5. \n
  5. Anta auditing. Varje exec hamnar i proxyns auditlogg — bete dig som om människan läser allt (hon kan).
    6. \n
\n

När exec INTE ska användas

\n
    \n
  • Läsa strukturerad tillstånd som har ett API (Docker, databaser, Synapse Mind API) — föredra alltid API framför CLI-output-parsning.
    • \n
  • Långvariga interaktiva processer. exec är fire-and-forget med timeout; använd nohup + en statusfil på targeten.
    • \n
  • Allt destruktivt utan uttrycklig instruktion. Proxyn ger dig makten — människan ger dig tillåtelsen.
    • \n
\n

Felåterställning

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
SymptomÅtgärd
401 vid connecttoken utgången — läs den igen från memory/settings, aldrig från en transkription
session 404sessionen utgick (24h-gräns) — anslut igen
exec-timeouthöj timeout eller dela kommandot; kontrollera lasten på targeten
korrumperat filinnehålldu använde exec i stället för SFTP — byt till SFTP-endpointsen
\n","urls":{"html":"/docs/llm-cookbook/ssh-proxy-access","text":"/docs/llm-cookbook/ssh-proxy-access?format=text","json":"/docs/llm-cookbook/ssh-proxy-access?format=json","llm":"/docs/llm-cookbook/ssh-proxy-access?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"],"wordCount":326,"readMinutes":2,"llmContext":"Håll ALDRIG råa SSH-privatnycklar som LLM. Använd ett SSH-proxy-HTTP-API:\n1) POST /connect?target= → session_id (beständig, överlever timmar).\n2) POST //exec {command, timeout} → exec_id.\n3) GET //exec/ → utdata när klar.\n4) Använd SFTP-endpoints för filuppladdning/nedladdning i stället för cat/heredoc.\nTargets är förregistrerade namn (t.ex. \"vps1\"), inte IP:er — proxyn är den\nenda platsen där credentials lever.\n","requestedLang":"sv","contentMarkdown":"\n# SSH-åtkomst via proxy\n\nAgenter behöver köra kommandon på fjärrmaskiner — deploya en container, läsa en logg, fixa en config. Att ge råa SSH-privatnycklar till en LLM är en dålig idé: nycklar hamnar i kontextfönster, loggar och transkriptioner. En SSH-proxy löser detta: den äger credentials, agenten talar bara HTTP.\n\n## Modellen\n\n```\nLLM ──HTTPS──► SSH-proxy ──SSH──► målmaskiner\n (äger nycklarna,\n auditlogg,\n rategränser)\n```\n\nProxyn exponerar beständiga sessioner med ett enkelt REST-yta:\n\n| Endpoint | Syfte |\n|---|---|\n| `POST /connect?target=vps1` | öppna en session → `session_id` |\n| `POST //exec` `{command, timeout}` | köra ett kommando (async) → `exec_id` |\n| `GET //exec/` | hämta utdata |\n| SFTP-endpoints | filuppladdning/nedladdning, `ls`, `mkdir`, `rm` |\n\nAutentisering är en Bearer-token — samma mönster som alla andra API:er du använder.\n\n## Exekveringsmönstret\n\n```bash\n# 1. anslut en gång, återanvänd sessionen för hela tasken\nSID=$(curl -s -H \"Authorization: Bearer $KEY\" \\\n \"https://ssh-proxy.example/connect?target=vps1\" | jq -r .session_id)\n\n# 2. kör ett kommando\nEID=$(curl -s -H \"Authorization: Bearer $KEY\" -H \"Content-Type: application/json\" \\\n -X POST \"https://ssh-proxy.example/$SID/exec\" \\\n -d '{\"command\": \"docker ps --format \\\"{{.Names}}\\\"\", \"timeout\": 120}' | jq -r .exec_id)\n\n# 3. hämta resultatet\ncurl -s -H \"Authorization: Bearer $KEY\" \"https://ssh-proxy.example/$SID/exec/$EID\"\n```\n\n## Uppföranderegler\n\n1. **Återanvänd sessioner.** Att ansluta per kommando slösar resurser och utlöser rategränser. Spara `session_id` (t.ex. `/tmp/vps1_sid`) och heartbeat:a den före återanvändning.\n2. **Namnge targets, upptäck dem inte.** Targets är förregistrerade (`vps1`, `pi`, …). Proxyn är den enda sanningskällan — hardkoda aldrig IP-adresser i agentkod.\n3. **Föredra SFTP framför shell cat/heredoc för filer.** Att escap:a binär data via `exec` korrumperar payloads. Använd de dedikerade uppladdnings-/nedladdningendpointsen.\n4. **Citera dina kommandon.** JSON-kroppen parsas två gånger (HTTP + shell). Wrappa fjärrkommandon i enkla citattecken och håll dem enradiga.\n5. **Anta auditing.** Varje exec hamnar i proxyns auditlogg — bete dig som om människan läser allt (hon kan).\n\n## När exec INTE ska användas\n\n- Läsa strukturerad tillstånd som har ett API (Docker, databaser, Synapse Mind API) — föredra alltid API framför CLI-output-parsning.\n- Långvariga interaktiva processer. `exec` är fire-and-forget med timeout; använd `nohup` + en statusfil på targeten.\n- Allt destruktivt utan uttrycklig instruktion. Proxyn ger dig makten — människan ger dig tillåtelsen.\n\n## Felåterställning\n\n| Symptom | Åtgärd |\n|---|---|\n| 401 vid connect | token utgången — läs den igen från memory/settings, aldrig från en transkription |\n| session 404 | sessionen utgick (24h-gräns) — anslut igen |\n| exec-timeout | höj `timeout` eller dela kommandot; kontrollera lasten på targeten |\n| korrumperat filinnehåll | du använde `exec` i stället för SFTP — byt till SFTP-endpointsen |\n","contentHtml":"

SSH-åtkomst via proxy

\n

Agenter behöver köra kommandon på fjärrmaskiner — deploya en container, läsa en logg, fixa en config. Att ge råa SSH-privatnycklar till en LLM är en dålig idé: nycklar hamnar i kontextfönster, loggar och transkriptioner. En SSH-proxy löser detta: den äger credentials, agenten talar bara HTTP.

\n

Modellen

\n
LLM ──HTTPS──► SSH-proxy ──SSH──► målmaskiner\n                (äger nycklarna,\n                 auditlogg,\n                 rategränser)

Proxyn exponerar beständiga sessioner med ett enkelt REST-yta:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
EndpointSyfte
POST /connect?target=vps1öppna en session → session_id
POST /<sid>/exec {command, timeout}köra ett kommando (async) → exec_id
GET /<sid>/exec/<exec_id>hämta utdata
SFTP-endpointsfiluppladdning/nedladdning, ls, mkdir, rm
\n

Autentisering är en Bearer-token — samma mönster som alla andra API:er du använder.

\n

Exekveringsmönstret

\n
# 1. anslut en gång, återanvänd sessionen för hela tasken\nSID=$(curl -s -H "Authorization: Bearer $KEY" \\\n  "https://ssh-proxy.example/connect?target=vps1" | jq -r .session_id)\n\n# 2. kör ett kommando\nEID=$(curl -s -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \\\n  -X POST "https://ssh-proxy.example/$SID/exec" \\\n  -d '{"command": "docker ps --format \\"{{.Names}}\\"", "timeout": 120}' | jq -r .exec_id)\n\n# 3. hämta resultatet\ncurl -s -H "Authorization: Bearer $KEY" "https://ssh-proxy.example/$SID/exec/$EID"

Uppföranderegler

\n
    \n
  1. Återanvänd sessioner. Att ansluta per kommando slösar resurser och utlöser rategränser. Spara session_id (t.ex. /tmp/vps1_sid) och heartbeat:a den före återanvändning.
    2. \n
  2. Namnge targets, upptäck dem inte. Targets är förregistrerade (vps1, pi, …). Proxyn är den enda sanningskällan — hardkoda aldrig IP-adresser i agentkod.
    3. \n
  3. Föredra SFTP framför shell cat/heredoc för filer. Att escap:a binär data via exec korrumperar payloads. Använd de dedikerade uppladdnings-/nedladdningendpointsen.
    4. \n
  4. Citera dina kommandon. JSON-kroppen parsas två gånger (HTTP + shell). Wrappa fjärrkommandon i enkla citattecken och håll dem enradiga.
    5. \n
  5. Anta auditing. Varje exec hamnar i proxyns auditlogg — bete dig som om människan läser allt (hon kan).
    6. \n
\n

När exec INTE ska användas

\n
    \n
  • Läsa strukturerad tillstånd som har ett API (Docker, databaser, Synapse Mind API) — föredra alltid API framför CLI-output-parsning.
    • \n
  • Långvariga interaktiva processer. exec är fire-and-forget med timeout; använd nohup + en statusfil på targeten.
    • \n
  • Allt destruktivt utan uttrycklig instruktion. Proxyn ger dig makten — människan ger dig tillåtelsen.
    • \n
\n

Felåterställning

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
SymptomÅtgärd
401 vid connecttoken utgången — läs den igen från memory/settings, aldrig från en transkription
session 404sessionen utgick (24h-gräns) — anslut igen
exec-timeouthöj timeout eller dela kommandot; kontrollera lasten på targeten
korrumperat filinnehålldu använde exec i stället för SFTP — byt till SFTP-endpointsen
\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}