{"title":"การเข้าถึง SSH ผ่านพร็อกซี","slug":"ssh-proxy-access","category":"llm-cookbook","summary":"เอเจนต์ LLM รันคำสั่งบนเครื่องระยะไกลอย่างปลอดภัยผ่าน API พร็อกซี SSH แทนคีย์ SSH ดิบอย่างไร","audience":["llm"],"tags":["cookbook","ssh","proxy","infrastructure","remote-execution"],"difficulty":"intermediate","updated":"2026-09-26","word_count":192,"read_minutes":1,"llm_context":"อย่าเก็บคีย์ส่วนตัว SSH ดิบในฐานะ LLM โดยเด็ดขาด ใช้ SSH-proxy HTTP API:\n1) POST /connect?target= → session_id (ถาวร อยู่ได้หลายชั่วโมง)\n2) POST //exec {command, timeout} → exec_id\n3) GET //exec/ → เอาต์พุตเมื่อเสร็จ\n4) ใช้เอนด์พอยต์ SFTP สำหรับอัป/ดาวน์โหลดไฟล์แทน cat/heredoc\nเป้าหมายเป็นชื่อที่ลงทะเบียนล่วงหน้า (เช่น \"vps1\") ไม่ใช่ IP — พร็อกซีคือ\nที่เดียวที่ข้อมูลประจำตัวอาศัยอยู่\n","lang":"th","translated":true,"requested_lang":"th","content_markdown":"\n# การเข้าถึง SSH ผ่านพร็อกซี\n\nเอเจนต์ต้องรันคำสั่งบนเครื่องระยะไกล — ดีพลอยคอนเทนเนอร์ อ่านล็อก แก้คอนฟิก การส่งคีย์ส่วนตัว SSH ดิบให้ LLM เป็นความคิดที่ไม่ดี: คีย์ลงเอยในหน้าต่างบริบท ล็อก และบันทึกถอดความ พร็อกซี SSH แก้ปัญหานี้: มันเป็นผู้ถือข้อมูลประจำตัว เอเจนต์พูดแค่ HTTP\n\n## โมเดล\n\n```\nLLM ──HTTPS──► พร็อกซี SSH ──SSH──► เครื่องเป้าหมาย\n (ถือคีย์,\n บันทึกการตรวจสอบ,\n ขีดจำกัดอัตรา)\n```\n\nพร็อกซีเปิดเผยเซสชันถาวรด้วยพื้นผิว REST ที่เรียบง่าย:\n\n| เอนด์พอยต์ | วัตถุประสงค์ |\n|---|---|\n| `POST /connect?target=vps1` | เปิดเซสชัน → `session_id` |\n| `POST //exec` `{command, timeout}` | รันคำสั่ง (async) → `exec_id` |\n| `GET //exec/` | สำรวจเอาต์พุต |\n| เอนด์พอยต์ SFTP | อัป/ดาวน์โหลดไฟล์, `ls`, `mkdir`, `rm` |\n\nการยืนยันตัวตนเป็น Bearer token — รูปแบบเดียวกับทุก API อื่นที่คุณใช้\n\n## รูปแบบการดำเนินการ\n\n```bash\n# 1. เชื่อมต่อครั้งเดียว ใช้เซสชันซ้ำตลอดงาน\nSID=$(curl -s -H \"Authorization: Bearer $KEY\" \\\n \"https://ssh-proxy.example/connect?target=vps1\" | jq -r .session_id)\n\n# 2. รันคำสั่ง\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. สำรวจผลลัพธ์\ncurl -s -H \"Authorization: Bearer $KEY\" \"https://ssh-proxy.example/$SID/exec/$EID\"\n```\n\n## กฎการปฏิบัติ\n\n1. **ใช้เซสชันซ้ำ** การเชื่อมต่อต่อคำสั่งเปลืองทรัพยากรและกระตุ้นขีดจำกัดอัตรา เก็บ `session_id` (เช่น `/tmp/vps1_sid`) และส่ง heartbeat ก่อนใช้ซ้ำ\n2. **ตั้งชื่อเป้าหมาย อย่าไปค้นมัน** เป้าหมายลงทะเบียนล่วงหน้า (`vps1`, `pi`, …) พร็อกซีคือแหล่งความจริงเดียว — ห้ามฮาร์ดโค้ดที่อยู่ IP ในโค้ดเอเจนต์\n3. **เลือก SFTP มากกว่า cat/heredoc ของเชลล์สำหรับไฟล์** การหนีบีบข้อมูลไบนารีผ่าน `exec`ทำให้เพย์โหลดเสียหาย ใช้เอนด์พอยต์อัป/ดาวน์โหลดเฉพาะทาง\n4. **อ้างคำสั่งของคุณ** ตัว JSON ถูกแยกวิเคราะห์สองครั้ง (HTTP + เชลล์) ห่อคำสั่งระยะไกลด้วยเครื่องหมายคำพูดเดี่ยวและคงเป็นบรรทัดเดียว\n5. **สมมติว่ามีการตรวจสอบ** ทุก exec ลงในบันทึกการตรวจสอบของพร็อกซี — ปฏิบัติตัวเหมือนมนุษย์อ่านทุกอย่าง (เขาทำได้)\n\n## เมื่อไรไม่ควรใช้ exec\n\n- อ่านสถานะที่มีโครงสร้างซึ่งมี API (Docker, ฐานข้อมูล, Mind API ของ Synapse) — เลือก API มากกว่าการแยกวิเคราะห์เอาต์พุต CLI เสมอ\n- กระบวนการเชิงโต้ตอบที่ใช้เวลานาน `exec`เป็น fire-and-forget ที่มีหมดเวลา; ใช้ `nohup` + ไฟล์สถานะบนเป้าหมายแทน\n- สิ่งทำลายล้างอะไรก็ตามโดยไม่มีคำสั่งชัดเจน พร็อกซีให้พลังแก่คุณ — มนุษย์ให้การอนุญาตแก่คุณ\n\n## การกู้คืนจากข้อผิดพลาด\n\n| อาการ | วิธีแก้ |\n|---|---|\n| 401 ตอน connect | โทเคนหมดอายุ — อ่านใหม่จาก memory/settings ไม่เคยจากบันทึกถอดความ |\n| เซสชัน 404 | เซสชันหมดอายุ (จำกัด 24 ชม.) — เชื่อมต่อใหม่ |\n| exec หมดเวลา | เพิ่ม `timeout` หรือแยกคำสั่ง; ตรวจโหลดของเป้าหมาย |\n| เนื้อหาไฟล์เสียหาย | คุณใช้ `exec` แทน SFTP — เปลี่ยนไปใช้เอนด์พอยต์ SFTP |\n","content_html":"

การเข้าถึง SSH ผ่านพร็อกซี

\n

เอเจนต์ต้องรันคำสั่งบนเครื่องระยะไกล — ดีพลอยคอนเทนเนอร์ อ่านล็อก แก้คอนฟิก การส่งคีย์ส่วนตัว SSH ดิบให้ LLM เป็นความคิดที่ไม่ดี: คีย์ลงเอยในหน้าต่างบริบท ล็อก และบันทึกถอดความ พร็อกซี SSH แก้ปัญหานี้: มันเป็นผู้ถือข้อมูลประจำตัว เอเจนต์พูดแค่ HTTP

\n

โมเดล

\n
LLM ──HTTPS──► พร็อกซี SSH ──SSH──► เครื่องเป้าหมาย\n                (ถือคีย์,\n                 บันทึกการตรวจสอบ,\n                 ขีดจำกัดอัตรา)

พร็อกซีเปิดเผยเซสชันถาวรด้วยพื้นผิว REST ที่เรียบง่าย:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
เอนด์พอยต์วัตถุประสงค์
POST /connect?target=vps1เปิดเซสชัน → session_id
POST /<sid>/exec {command, timeout}รันคำสั่ง (async) → exec_id
GET /<sid>/exec/<exec_id>สำรวจเอาต์พุต
เอนด์พอยต์ SFTPอัป/ดาวน์โหลดไฟล์, ls, mkdir, rm
\n

การยืนยันตัวตนเป็น Bearer token — รูปแบบเดียวกับทุก API อื่นที่คุณใช้

\n

รูปแบบการดำเนินการ

\n
# 1. เชื่อมต่อครั้งเดียว ใช้เซสชันซ้ำตลอดงาน\nSID=$(curl -s -H "Authorization: Bearer $KEY" \\\n  "https://ssh-proxy.example/connect?target=vps1" | jq -r .session_id)\n\n# 2. รันคำสั่ง\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. สำรวจผลลัพธ์\ncurl -s -H "Authorization: Bearer $KEY" "https://ssh-proxy.example/$SID/exec/$EID"

กฎการปฏิบัติ

\n
    \n
  1. ใช้เซสชันซ้ำ การเชื่อมต่อต่อคำสั่งเปลืองทรัพยากรและกระตุ้นขีดจำกัดอัตรา เก็บ session_id (เช่น /tmp/vps1_sid) และส่ง heartbeat ก่อนใช้ซ้ำ
    2. \n
  2. ตั้งชื่อเป้าหมาย อย่าไปค้นมัน เป้าหมายลงทะเบียนล่วงหน้า (vps1, pi, …) พร็อกซีคือแหล่งความจริงเดียว — ห้ามฮาร์ดโค้ดที่อยู่ IP ในโค้ดเอเจนต์
    3. \n
  3. เลือก SFTP มากกว่า cat/heredoc ของเชลล์สำหรับไฟล์ การหนีบีบข้อมูลไบนารีผ่าน execทำให้เพย์โหลดเสียหาย ใช้เอนด์พอยต์อัป/ดาวน์โหลดเฉพาะทาง
    4. \n
  4. อ้างคำสั่งของคุณ ตัว JSON ถูกแยกวิเคราะห์สองครั้ง (HTTP + เชลล์) ห่อคำสั่งระยะไกลด้วยเครื่องหมายคำพูดเดี่ยวและคงเป็นบรรทัดเดียว
    5. \n
  5. สมมติว่ามีการตรวจสอบ ทุก exec ลงในบันทึกการตรวจสอบของพร็อกซี — ปฏิบัติตัวเหมือนมนุษย์อ่านทุกอย่าง (เขาทำได้)
    6. \n
\n

เมื่อไรไม่ควรใช้ exec

\n
    \n
  • อ่านสถานะที่มีโครงสร้างซึ่งมี API (Docker, ฐานข้อมูล, Mind API ของ Synapse) — เลือก API มากกว่าการแยกวิเคราะห์เอาต์พุต CLI เสมอ
    • \n
  • กระบวนการเชิงโต้ตอบที่ใช้เวลานาน execเป็น fire-and-forget ที่มีหมดเวลา; ใช้ nohup + ไฟล์สถานะบนเป้าหมายแทน
    • \n
  • สิ่งทำลายล้างอะไรก็ตามโดยไม่มีคำสั่งชัดเจน พร็อกซีให้พลังแก่คุณ — มนุษย์ให้การอนุญาตแก่คุณ
    • \n
\n

การกู้คืนจากข้อผิดพลาด

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
อาการวิธีแก้
401 ตอน connectโทเคนหมดอายุ — อ่านใหม่จาก memory/settings ไม่เคยจากบันทึกถอดความ
เซสชัน 404เซสชันหมดอายุ (จำกัด 24 ชม.) — เชื่อมต่อใหม่
exec หมดเวลาเพิ่ม timeout หรือแยกคำสั่ง; ตรวจโหลดของเป้าหมาย
เนื้อหาไฟล์เสียหายคุณใช้ exec แทน SFTP — เปลี่ยนไปใช้เอนด์พอยต์ SFTP
\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":192,"readMinutes":1,"llmContext":"อย่าเก็บคีย์ส่วนตัว SSH ดิบในฐานะ LLM โดยเด็ดขาด ใช้ SSH-proxy HTTP API:\n1) POST /connect?target= → session_id (ถาวร อยู่ได้หลายชั่วโมง)\n2) POST //exec {command, timeout} → exec_id\n3) GET //exec/ → เอาต์พุตเมื่อเสร็จ\n4) ใช้เอนด์พอยต์ SFTP สำหรับอัป/ดาวน์โหลดไฟล์แทน cat/heredoc\nเป้าหมายเป็นชื่อที่ลงทะเบียนล่วงหน้า (เช่น \"vps1\") ไม่ใช่ IP — พร็อกซีคือ\nที่เดียวที่ข้อมูลประจำตัวอาศัยอยู่\n","requestedLang":"th","contentMarkdown":"\n# การเข้าถึง SSH ผ่านพร็อกซี\n\nเอเจนต์ต้องรันคำสั่งบนเครื่องระยะไกล — ดีพลอยคอนเทนเนอร์ อ่านล็อก แก้คอนฟิก การส่งคีย์ส่วนตัว SSH ดิบให้ LLM เป็นความคิดที่ไม่ดี: คีย์ลงเอยในหน้าต่างบริบท ล็อก และบันทึกถอดความ พร็อกซี SSH แก้ปัญหานี้: มันเป็นผู้ถือข้อมูลประจำตัว เอเจนต์พูดแค่ HTTP\n\n## โมเดล\n\n```\nLLM ──HTTPS──► พร็อกซี SSH ──SSH──► เครื่องเป้าหมาย\n (ถือคีย์,\n บันทึกการตรวจสอบ,\n ขีดจำกัดอัตรา)\n```\n\nพร็อกซีเปิดเผยเซสชันถาวรด้วยพื้นผิว REST ที่เรียบง่าย:\n\n| เอนด์พอยต์ | วัตถุประสงค์ |\n|---|---|\n| `POST /connect?target=vps1` | เปิดเซสชัน → `session_id` |\n| `POST //exec` `{command, timeout}` | รันคำสั่ง (async) → `exec_id` |\n| `GET //exec/` | สำรวจเอาต์พุต |\n| เอนด์พอยต์ SFTP | อัป/ดาวน์โหลดไฟล์, `ls`, `mkdir`, `rm` |\n\nการยืนยันตัวตนเป็น Bearer token — รูปแบบเดียวกับทุก API อื่นที่คุณใช้\n\n## รูปแบบการดำเนินการ\n\n```bash\n# 1. เชื่อมต่อครั้งเดียว ใช้เซสชันซ้ำตลอดงาน\nSID=$(curl -s -H \"Authorization: Bearer $KEY\" \\\n \"https://ssh-proxy.example/connect?target=vps1\" | jq -r .session_id)\n\n# 2. รันคำสั่ง\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. สำรวจผลลัพธ์\ncurl -s -H \"Authorization: Bearer $KEY\" \"https://ssh-proxy.example/$SID/exec/$EID\"\n```\n\n## กฎการปฏิบัติ\n\n1. **ใช้เซสชันซ้ำ** การเชื่อมต่อต่อคำสั่งเปลืองทรัพยากรและกระตุ้นขีดจำกัดอัตรา เก็บ `session_id` (เช่น `/tmp/vps1_sid`) และส่ง heartbeat ก่อนใช้ซ้ำ\n2. **ตั้งชื่อเป้าหมาย อย่าไปค้นมัน** เป้าหมายลงทะเบียนล่วงหน้า (`vps1`, `pi`, …) พร็อกซีคือแหล่งความจริงเดียว — ห้ามฮาร์ดโค้ดที่อยู่ IP ในโค้ดเอเจนต์\n3. **เลือก SFTP มากกว่า cat/heredoc ของเชลล์สำหรับไฟล์** การหนีบีบข้อมูลไบนารีผ่าน `exec`ทำให้เพย์โหลดเสียหาย ใช้เอนด์พอยต์อัป/ดาวน์โหลดเฉพาะทาง\n4. **อ้างคำสั่งของคุณ** ตัว JSON ถูกแยกวิเคราะห์สองครั้ง (HTTP + เชลล์) ห่อคำสั่งระยะไกลด้วยเครื่องหมายคำพูดเดี่ยวและคงเป็นบรรทัดเดียว\n5. **สมมติว่ามีการตรวจสอบ** ทุก exec ลงในบันทึกการตรวจสอบของพร็อกซี — ปฏิบัติตัวเหมือนมนุษย์อ่านทุกอย่าง (เขาทำได้)\n\n## เมื่อไรไม่ควรใช้ exec\n\n- อ่านสถานะที่มีโครงสร้างซึ่งมี API (Docker, ฐานข้อมูล, Mind API ของ Synapse) — เลือก API มากกว่าการแยกวิเคราะห์เอาต์พุต CLI เสมอ\n- กระบวนการเชิงโต้ตอบที่ใช้เวลานาน `exec`เป็น fire-and-forget ที่มีหมดเวลา; ใช้ `nohup` + ไฟล์สถานะบนเป้าหมายแทน\n- สิ่งทำลายล้างอะไรก็ตามโดยไม่มีคำสั่งชัดเจน พร็อกซีให้พลังแก่คุณ — มนุษย์ให้การอนุญาตแก่คุณ\n\n## การกู้คืนจากข้อผิดพลาด\n\n| อาการ | วิธีแก้ |\n|---|---|\n| 401 ตอน connect | โทเคนหมดอายุ — อ่านใหม่จาก memory/settings ไม่เคยจากบันทึกถอดความ |\n| เซสชัน 404 | เซสชันหมดอายุ (จำกัด 24 ชม.) — เชื่อมต่อใหม่ |\n| exec หมดเวลา | เพิ่ม `timeout` หรือแยกคำสั่ง; ตรวจโหลดของเป้าหมาย |\n| เนื้อหาไฟล์เสียหาย | คุณใช้ `exec` แทน SFTP — เปลี่ยนไปใช้เอนด์พอยต์ SFTP |\n","contentHtml":"

การเข้าถึง SSH ผ่านพร็อกซี

\n

เอเจนต์ต้องรันคำสั่งบนเครื่องระยะไกล — ดีพลอยคอนเทนเนอร์ อ่านล็อก แก้คอนฟิก การส่งคีย์ส่วนตัว SSH ดิบให้ LLM เป็นความคิดที่ไม่ดี: คีย์ลงเอยในหน้าต่างบริบท ล็อก และบันทึกถอดความ พร็อกซี SSH แก้ปัญหานี้: มันเป็นผู้ถือข้อมูลประจำตัว เอเจนต์พูดแค่ HTTP

\n

โมเดล

\n
LLM ──HTTPS──► พร็อกซี SSH ──SSH──► เครื่องเป้าหมาย\n                (ถือคีย์,\n                 บันทึกการตรวจสอบ,\n                 ขีดจำกัดอัตรา)

พร็อกซีเปิดเผยเซสชันถาวรด้วยพื้นผิว REST ที่เรียบง่าย:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
เอนด์พอยต์วัตถุประสงค์
POST /connect?target=vps1เปิดเซสชัน → session_id
POST /<sid>/exec {command, timeout}รันคำสั่ง (async) → exec_id
GET /<sid>/exec/<exec_id>สำรวจเอาต์พุต
เอนด์พอยต์ SFTPอัป/ดาวน์โหลดไฟล์, ls, mkdir, rm
\n

การยืนยันตัวตนเป็น Bearer token — รูปแบบเดียวกับทุก API อื่นที่คุณใช้

\n

รูปแบบการดำเนินการ

\n
# 1. เชื่อมต่อครั้งเดียว ใช้เซสชันซ้ำตลอดงาน\nSID=$(curl -s -H "Authorization: Bearer $KEY" \\\n  "https://ssh-proxy.example/connect?target=vps1" | jq -r .session_id)\n\n# 2. รันคำสั่ง\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. สำรวจผลลัพธ์\ncurl -s -H "Authorization: Bearer $KEY" "https://ssh-proxy.example/$SID/exec/$EID"

กฎการปฏิบัติ

\n
    \n
  1. ใช้เซสชันซ้ำ การเชื่อมต่อต่อคำสั่งเปลืองทรัพยากรและกระตุ้นขีดจำกัดอัตรา เก็บ session_id (เช่น /tmp/vps1_sid) และส่ง heartbeat ก่อนใช้ซ้ำ
    2. \n
  2. ตั้งชื่อเป้าหมาย อย่าไปค้นมัน เป้าหมายลงทะเบียนล่วงหน้า (vps1, pi, …) พร็อกซีคือแหล่งความจริงเดียว — ห้ามฮาร์ดโค้ดที่อยู่ IP ในโค้ดเอเจนต์
    3. \n
  3. เลือก SFTP มากกว่า cat/heredoc ของเชลล์สำหรับไฟล์ การหนีบีบข้อมูลไบนารีผ่าน execทำให้เพย์โหลดเสียหาย ใช้เอนด์พอยต์อัป/ดาวน์โหลดเฉพาะทาง
    4. \n
  4. อ้างคำสั่งของคุณ ตัว JSON ถูกแยกวิเคราะห์สองครั้ง (HTTP + เชลล์) ห่อคำสั่งระยะไกลด้วยเครื่องหมายคำพูดเดี่ยวและคงเป็นบรรทัดเดียว
    5. \n
  5. สมมติว่ามีการตรวจสอบ ทุก exec ลงในบันทึกการตรวจสอบของพร็อกซี — ปฏิบัติตัวเหมือนมนุษย์อ่านทุกอย่าง (เขาทำได้)
    6. \n
\n

เมื่อไรไม่ควรใช้ exec

\n
    \n
  • อ่านสถานะที่มีโครงสร้างซึ่งมี API (Docker, ฐานข้อมูล, Mind API ของ Synapse) — เลือก API มากกว่าการแยกวิเคราะห์เอาต์พุต CLI เสมอ
    • \n
  • กระบวนการเชิงโต้ตอบที่ใช้เวลานาน execเป็น fire-and-forget ที่มีหมดเวลา; ใช้ nohup + ไฟล์สถานะบนเป้าหมายแทน
    • \n
  • สิ่งทำลายล้างอะไรก็ตามโดยไม่มีคำสั่งชัดเจน พร็อกซีให้พลังแก่คุณ — มนุษย์ให้การอนุญาตแก่คุณ
    • \n
\n

การกู้คืนจากข้อผิดพลาด

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
อาการวิธีแก้
401 ตอน connectโทเคนหมดอายุ — อ่านใหม่จาก memory/settings ไม่เคยจากบันทึกถอดความ
เซสชัน 404เซสชันหมดอายุ (จำกัด 24 ชม.) — เชื่อมต่อใหม่
exec หมดเวลาเพิ่ม timeout หรือแยกคำสั่ง; ตรวจโหลดของเป้าหมาย
เนื้อหาไฟล์เสียหายคุณใช้ exec แทน SFTP — เปลี่ยนไปใช้เอนด์พอยต์ SFTP
\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}