{"title":"Proxy üzerinden SSH erişimi","slug":"ssh-proxy-access","category":"llm-cookbook","summary":"Bir LLM ajanının uzak makinelerde ham SSH anahtarları yerine bir SSH-proxy API'si üzerinden güvenle komut çalıştırması.","audience":["llm"],"tags":["cookbook","ssh","proxy","infrastructure","remote-execution"],"difficulty":"intermediate","updated":"2026-09-26","word_count":346,"read_minutes":2,"llm_context":"LLM olarak ASLA ham SSH özel anahtarı tutma. SSH-proxy HTTP API'si kullan:\n1) POST /connect?target= → session_id (kalıcı, saatlerce yaşar).\n2) POST //exec {command, timeout} → exec_id.\n3) GET //exec/ → bittiğinde çıktı.\n4) Dosya yükleme/indirme için cat/heredoc yerine SFTP uçlarını kullan.\nHedefler önceden kayıtlı adlardır (örn. \"vps1\"), IP değil — kimlik bilgilerinin\nyaşadığı tek yer proxy'dir.\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Proxy üzerinden SSH erişimi\n\nAjanların uzak makinelerde komut çalıştırması gerekir — bir konteyner dağıtmak, bir log okumak, bir config düzeltmek. Ham SSH özel anahtarlarını bir LLM'e vermek kötü bir fikirdir: anahtarlar bağlam pencerelerine, loglara ve kayıtlara düşer. Bir SSH-proxy bunu çözer: kimlik bilgilerini o tutar, ajan yalnızca HTTP konuşur.\n\n## Model\n\n```\nLLM ──HTTPS──► SSH-proxy ──SSH──► hedef makineler\n (anahtarları tutar,\n denetim günlüğü,\n hız limitleri)\n```\n\nProxy, basit bir REST yüzeyi ile kalıcı oturumlar sunar:\n\n| Uç | Amaç |\n|---|---|\n| `POST /connect?target=vps1` | bir oturum aç → `session_id` |\n| `POST //exec` `{command, timeout}` | komut çalıştır (async) → `exec_id` |\n| `GET //exec/` | çıktıyı sorgula |\n| SFTP uçları | dosya yükleme/indirme, `ls`, `mkdir`, `rm` |\n\nKimlik doğrulama bir Bearer token'dır — kullandığın diğer her API ile aynı desen.\n\n## Yürütme deseni\n\n```bash\n# 1. bir kez bağlan, oturumu tüm görev boyunca yeniden kullan\nSID=$(curl -s -H \"Authorization: Bearer $KEY\" \\\n \"https://ssh-proxy.example/connect?target=vps1\" | jq -r .session_id)\n\n# 2. bir komut çalıştır\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. sonucu sorgula\ncurl -s -H \"Authorization: Bearer $KEY\" \"https://ssh-proxy.example/$SID/exec/$EID\"\n```\n\n## Kurallar\n\n1. **Oturumları yeniden kullan.** Her komut için bağlanmak kaynak harcar ve hız limitlerini tetikler. `session_id`'yi sakla (örn. `/tmp/vps1_sid`) ve yeniden kullanmadan önce heartbeat ile kontrol et.\n2. **Hedefleri adlandır, keşfetme.** Hedefler önceden kayıtlıdır (`vps1`, `pi`, …). Proxy tek doğruluk kaynağıdır — ajan koduna asla IP adresi gömme.\n3. **Dosyalar için shell cat/heredoc yerine SFTP'yi tercih et.** `exec` üzerinden ikili veri escape etmek yükleri bozar. Özel yükleme/indirme uçlarını kullan.\n4. **Komutlarını tırnakla.** JSON gövdesi iki kez parse edilir (HTTP + shell). Uzak komutları tek tırnak içine al ve tek satırda tut.\n5. **Denetim olduğunu varsay.** Her exec proxy'nin denetim günlüğüne düşer — insan her şeyi okuyormuş gibi davran (okuyabilir).\n\n## exec NE ZAMAN kullanılmaz\n\n- Bir API'si olan yapılandırılmış durumu okumak (Docker, veritabanları, Synapse Mind API) — CLI çıktısı ayrıştırmak yerine her zaman API'yi tercih et.\n- Uzun süren etkileşimli süreçler. `exec`, zaman aşımlı fire-and-forget'tır; bunun yerine hedefte `nohup` + bir durum dosyası kullan.\n- Açık talimat olmadan yıkıcı herhangi bir şey. Proxy sana gücü verir — insan sana izni verir.\n\n## Hata kurtarma\n\n| Belirti | Çözüm |\n|---|---|\n| connect'te 401 | token süresi doldu — memory/settings'ten yeniden oku, asla bir kayıttan değil |\n| oturum 404 | oturum süresi doldu (24h sınırı) — yeniden bağlan |\n| exec zaman aşımı | `timeout` değerini yükselt ya da komutu böl; hedefin yükünü kontrol et |\n| bozuk dosya içeriği | SFTP yerine `exec` kullandın — SFTP uçlarına geç |\n","content_html":"

Proxy üzerinden SSH erişimi

\n

Ajanların uzak makinelerde komut çalıştırması gerekir — bir konteyner dağıtmak, bir log okumak, bir config düzeltmek. Ham SSH özel anahtarlarını bir LLM'e vermek kötü bir fikirdir: anahtarlar bağlam pencerelerine, loglara ve kayıtlara düşer. Bir SSH-proxy bunu çözer: kimlik bilgilerini o tutar, ajan yalnızca HTTP konuşur.

\n

Model

\n
LLM ──HTTPS──► SSH-proxy ──SSH──► hedef makineler\n                (anahtarları tutar,\n                 denetim günlüğü,\n                 hız limitleri)

Proxy, basit bir REST yüzeyi ile kalıcı oturumlar sunar:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
UçAmaç
POST /connect?target=vps1bir oturum aç → session_id
POST /<sid>/exec {command, timeout}komut çalıştır (async) → exec_id
GET /<sid>/exec/<exec_id>çıktıyı sorgula
SFTP uçlarıdosya yükleme/indirme, ls, mkdir, rm
\n

Kimlik doğrulama bir Bearer token'dır — kullandığın diğer her API ile aynı desen.

\n

Yürütme deseni

\n
# 1. bir kez bağlan, oturumu tüm görev boyunca yeniden kullan\nSID=$(curl -s -H "Authorization: Bearer $KEY" \\\n  "https://ssh-proxy.example/connect?target=vps1" | jq -r .session_id)\n\n# 2. bir komut çalıştır\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. sonucu sorgula\ncurl -s -H "Authorization: Bearer $KEY" "https://ssh-proxy.example/$SID/exec/$EID"

Kurallar

\n
    \n
  1. Oturumları yeniden kullan. Her komut için bağlanmak kaynak harcar ve hız limitlerini tetikler. session_id'yi sakla (örn. /tmp/vps1_sid) ve yeniden kullanmadan önce heartbeat ile kontrol et.
    2. \n
  2. Hedefleri adlandır, keşfetme. Hedefler önceden kayıtlıdır (vps1, pi, …). Proxy tek doğruluk kaynağıdır — ajan koduna asla IP adresi gömme.
    3. \n
  3. Dosyalar için shell cat/heredoc yerine SFTP'yi tercih et. exec üzerinden ikili veri escape etmek yükleri bozar. Özel yükleme/indirme uçlarını kullan.
    4. \n
  4. Komutlarını tırnakla. JSON gövdesi iki kez parse edilir (HTTP + shell). Uzak komutları tek tırnak içine al ve tek satırda tut.
    5. \n
  5. Denetim olduğunu varsay. Her exec proxy'nin denetim günlüğüne düşer — insan her şeyi okuyormuş gibi davran (okuyabilir).
    6. \n
\n

exec NE ZAMAN kullanılmaz

\n
    \n
  • Bir API'si olan yapılandırılmış durumu okumak (Docker, veritabanları, Synapse Mind API) — CLI çıktısı ayrıştırmak yerine her zaman API'yi tercih et.
    • \n
  • Uzun süren etkileşimli süreçler. exec, zaman aşımlı fire-and-forget'tır; bunun yerine hedefte nohup + bir durum dosyası kullan.
    • \n
  • Açık talimat olmadan yıkıcı herhangi bir şey. Proxy sana gücü verir — insan sana izni verir.
    • \n
\n

Hata kurtarma

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
BelirtiÇözüm
connect'te 401token süresi doldu — memory/settings'ten yeniden oku, asla bir kayıttan değil
oturum 404oturum süresi doldu (24h sınırı) — yeniden bağlan
exec zaman aşımıtimeout değerini yükselt ya da komutu böl; hedefin yükünü kontrol et
bozuk dosya içeriğiSFTP yerine exec kullandın — SFTP uçlarına geç
\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":346,"readMinutes":2,"llmContext":"LLM olarak ASLA ham SSH özel anahtarı tutma. SSH-proxy HTTP API'si kullan:\n1) POST /connect?target= → session_id (kalıcı, saatlerce yaşar).\n2) POST //exec {command, timeout} → exec_id.\n3) GET //exec/ → bittiğinde çıktı.\n4) Dosya yükleme/indirme için cat/heredoc yerine SFTP uçlarını kullan.\nHedefler önceden kayıtlı adlardır (örn. \"vps1\"), IP değil — kimlik bilgilerinin\nyaşadığı tek yer proxy'dir.\n","requestedLang":"tr","contentMarkdown":"\n# Proxy üzerinden SSH erişimi\n\nAjanların uzak makinelerde komut çalıştırması gerekir — bir konteyner dağıtmak, bir log okumak, bir config düzeltmek. Ham SSH özel anahtarlarını bir LLM'e vermek kötü bir fikirdir: anahtarlar bağlam pencerelerine, loglara ve kayıtlara düşer. Bir SSH-proxy bunu çözer: kimlik bilgilerini o tutar, ajan yalnızca HTTP konuşur.\n\n## Model\n\n```\nLLM ──HTTPS──► SSH-proxy ──SSH──► hedef makineler\n (anahtarları tutar,\n denetim günlüğü,\n hız limitleri)\n```\n\nProxy, basit bir REST yüzeyi ile kalıcı oturumlar sunar:\n\n| Uç | Amaç |\n|---|---|\n| `POST /connect?target=vps1` | bir oturum aç → `session_id` |\n| `POST //exec` `{command, timeout}` | komut çalıştır (async) → `exec_id` |\n| `GET //exec/` | çıktıyı sorgula |\n| SFTP uçları | dosya yükleme/indirme, `ls`, `mkdir`, `rm` |\n\nKimlik doğrulama bir Bearer token'dır — kullandığın diğer her API ile aynı desen.\n\n## Yürütme deseni\n\n```bash\n# 1. bir kez bağlan, oturumu tüm görev boyunca yeniden kullan\nSID=$(curl -s -H \"Authorization: Bearer $KEY\" \\\n \"https://ssh-proxy.example/connect?target=vps1\" | jq -r .session_id)\n\n# 2. bir komut çalıştır\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. sonucu sorgula\ncurl -s -H \"Authorization: Bearer $KEY\" \"https://ssh-proxy.example/$SID/exec/$EID\"\n```\n\n## Kurallar\n\n1. **Oturumları yeniden kullan.** Her komut için bağlanmak kaynak harcar ve hız limitlerini tetikler. `session_id`'yi sakla (örn. `/tmp/vps1_sid`) ve yeniden kullanmadan önce heartbeat ile kontrol et.\n2. **Hedefleri adlandır, keşfetme.** Hedefler önceden kayıtlıdır (`vps1`, `pi`, …). Proxy tek doğruluk kaynağıdır — ajan koduna asla IP adresi gömme.\n3. **Dosyalar için shell cat/heredoc yerine SFTP'yi tercih et.** `exec` üzerinden ikili veri escape etmek yükleri bozar. Özel yükleme/indirme uçlarını kullan.\n4. **Komutlarını tırnakla.** JSON gövdesi iki kez parse edilir (HTTP + shell). Uzak komutları tek tırnak içine al ve tek satırda tut.\n5. **Denetim olduğunu varsay.** Her exec proxy'nin denetim günlüğüne düşer — insan her şeyi okuyormuş gibi davran (okuyabilir).\n\n## exec NE ZAMAN kullanılmaz\n\n- Bir API'si olan yapılandırılmış durumu okumak (Docker, veritabanları, Synapse Mind API) — CLI çıktısı ayrıştırmak yerine her zaman API'yi tercih et.\n- Uzun süren etkileşimli süreçler. `exec`, zaman aşımlı fire-and-forget'tır; bunun yerine hedefte `nohup` + bir durum dosyası kullan.\n- Açık talimat olmadan yıkıcı herhangi bir şey. Proxy sana gücü verir — insan sana izni verir.\n\n## Hata kurtarma\n\n| Belirti | Çözüm |\n|---|---|\n| connect'te 401 | token süresi doldu — memory/settings'ten yeniden oku, asla bir kayıttan değil |\n| oturum 404 | oturum süresi doldu (24h sınırı) — yeniden bağlan |\n| exec zaman aşımı | `timeout` değerini yükselt ya da komutu böl; hedefin yükünü kontrol et |\n| bozuk dosya içeriği | SFTP yerine `exec` kullandın — SFTP uçlarına geç |\n","contentHtml":"

Proxy üzerinden SSH erişimi

\n

Ajanların uzak makinelerde komut çalıştırması gerekir — bir konteyner dağıtmak, bir log okumak, bir config düzeltmek. Ham SSH özel anahtarlarını bir LLM'e vermek kötü bir fikirdir: anahtarlar bağlam pencerelerine, loglara ve kayıtlara düşer. Bir SSH-proxy bunu çözer: kimlik bilgilerini o tutar, ajan yalnızca HTTP konuşur.

\n

Model

\n
LLM ──HTTPS──► SSH-proxy ──SSH──► hedef makineler\n                (anahtarları tutar,\n                 denetim günlüğü,\n                 hız limitleri)

Proxy, basit bir REST yüzeyi ile kalıcı oturumlar sunar:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
UçAmaç
POST /connect?target=vps1bir oturum aç → session_id
POST /<sid>/exec {command, timeout}komut çalıştır (async) → exec_id
GET /<sid>/exec/<exec_id>çıktıyı sorgula
SFTP uçlarıdosya yükleme/indirme, ls, mkdir, rm
\n

Kimlik doğrulama bir Bearer token'dır — kullandığın diğer her API ile aynı desen.

\n

Yürütme deseni

\n
# 1. bir kez bağlan, oturumu tüm görev boyunca yeniden kullan\nSID=$(curl -s -H "Authorization: Bearer $KEY" \\\n  "https://ssh-proxy.example/connect?target=vps1" | jq -r .session_id)\n\n# 2. bir komut çalıştır\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. sonucu sorgula\ncurl -s -H "Authorization: Bearer $KEY" "https://ssh-proxy.example/$SID/exec/$EID"

Kurallar

\n
    \n
  1. Oturumları yeniden kullan. Her komut için bağlanmak kaynak harcar ve hız limitlerini tetikler. session_id'yi sakla (örn. /tmp/vps1_sid) ve yeniden kullanmadan önce heartbeat ile kontrol et.
    2. \n
  2. Hedefleri adlandır, keşfetme. Hedefler önceden kayıtlıdır (vps1, pi, …). Proxy tek doğruluk kaynağıdır — ajan koduna asla IP adresi gömme.
    3. \n
  3. Dosyalar için shell cat/heredoc yerine SFTP'yi tercih et. exec üzerinden ikili veri escape etmek yükleri bozar. Özel yükleme/indirme uçlarını kullan.
    4. \n
  4. Komutlarını tırnakla. JSON gövdesi iki kez parse edilir (HTTP + shell). Uzak komutları tek tırnak içine al ve tek satırda tut.
    5. \n
  5. Denetim olduğunu varsay. Her exec proxy'nin denetim günlüğüne düşer — insan her şeyi okuyormuş gibi davran (okuyabilir).
    6. \n
\n

exec NE ZAMAN kullanılmaz

\n
    \n
  • Bir API'si olan yapılandırılmış durumu okumak (Docker, veritabanları, Synapse Mind API) — CLI çıktısı ayrıştırmak yerine her zaman API'yi tercih et.
    • \n
  • Uzun süren etkileşimli süreçler. exec, zaman aşımlı fire-and-forget'tır; bunun yerine hedefte nohup + bir durum dosyası kullan.
    • \n
  • Açık talimat olmadan yıkıcı herhangi bir şey. Proxy sana gücü verir — insan sana izni verir.
    • \n
\n

Hata kurtarma

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
BelirtiÇözüm
connect'te 401token süresi doldu — memory/settings'ten yeniden oku, asla bir kayıttan değil
oturum 404oturum süresi doldu (24h sınırı) — yeniden bağlan
exec zaman aşımıtimeout değerini yükselt ya da komutu böl; hedefin yükünü kontrol et
bozuk dosya içeriğiSFTP yerine exec kullandın — SFTP uçlarına geç
\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}