SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor

วิธีติดตั้ง DeepSeek Harness บน VPS ให้ปลอดภัย

เรียนรู้วิธีติดตั้ง DeepSeek Harness บน Linux VPS พร้อมการล็อกเวอร์ชัน npm การจัดการสิทธิ์ปลั๊กอิน และการเข้าถึง Web UI พอร์ต 3080 อย่างปลอดภัยผ่าน SSH Tunnel

DeepSeek Harness คืออะไร

DeepSeek Harness (dsh) คือรันไทม์ของเอเจนต์ที่พัฒนาด้วย Node.js ซึ่งคุณสามารถรันบน VPS (virtual private server) ได้ วิธีการใช้งานที่ปลอดภัยคือการผูกไว้กับ 127.0.0.1 และเข้าถึงผ่าน SSH (secure shell) tunnel โดยตัวโปรแกรมจะให้บริการเว็บ UI (user interface) บนพอร์ต 3080 แทนการทำงานผ่านเทอร์มินัล ในรุ่น 0.1.0-rc.6 ที่คู่มือนี้กำหนดให้ใช้ เว็บเซิร์ฟเวอร์จะไม่มีการถามรหัสผ่าน ดังนั้นหากเปิดพอร์ต 3080 สู่สาธารณะ ใครก็ตามที่พบพอร์ตนี้จะสามารถเข้าถึงเอเจนต์ที่อ่านไฟล์และรันคำสั่งในฐานะผู้ใช้ Linux ของคุณได้ สำหรับรุ่นใหม่กว่า ตั้งแต่ 0.2.0-rc.2 จนถึง 0.2.2-rc.2 ของวันที่ 11 พฤศจิกายน 2026 ซึ่งเป็นรุ่นล่าสุดที่ GitHub แสดงรายการไว้ ณ วันที่ 12 พฤศจิกายน 2026 จะมีการแสดง URL เริ่มต้นที่มีโทเค็นใหม่สำหรับกระบวนการนั้นและเปลี่ยนเป็น session cookie แต่โดยค่าเริ่มต้นโปรแกรมยังคงฟังเฉพาะบน loopback และปฏิเสธที่จะผูกกับทุกอินเทอร์เฟซ

DeepSeek เผยแพร่ซอฟต์แวร์นี้ภายใต้สัญญาอนุญาต MIT ในรูปแบบ npm package ชื่อ @deepseek-ai/dsh โครงการนี้ระบุว่าเป็นรุ่นทดสอบสำหรับนักพัฒนา (developer preview) และแจ้งว่าอาจมีการเปลี่ยนแปลงที่ส่งผลต่อความเข้ากันได้ (compatibility-breaking changes) รุ่นที่กำหนดไว้ด้านล่างคือรุ่นเดือนสิงหาคม 2026 ณ วันที่ 12 พฤศจิกายน 2026 แท็ก latest ของ npm ระบุว่าเป็น 0.2.2-rc.1 ส่วน GitHub แสดงรายการรุ่นพรีรีลีสใหม่กว่าคือ 0.2.2-rc.2 ซึ่งติดแท็ก dsh-v0.2.2-rc.2 และเผยแพร่เมื่อวันที่ 11 พฤศจิกายน 2026 โปรดตรวจสอบที่เก็บข้อมูล (repository) ก่อนคัดลอกสิ่งใดลงในเครื่องเซิร์ฟเวอร์ที่สำคัญ

แนวคิดหลักที่ใช้ในการออกแบบคือ ทุกอย่างคือปลั๊กอิน ไม่ว่าจะเป็นตัวปรับแต่งโมเดล (model adapter), ตัวจัดการเครื่องมือ (tool registry), บันทึกเซสชัน (session log), แซนด์บ็อกซ์ (sandbox), ตัวจัดตารางเวลา (scheduler) และตัวลูปของเอเจนต์เอง ทั้งหมดล้วนเป็นปลั๊กอินที่โหลดเข้าสู่บริบทที่ใช้ร่วมกัน และสามารถเปลี่ยนแทนที่ได้ทั้งหมด ไม่มีแกนกลางที่มีสิทธิ์พิเศษที่ปลั๊กอินทำได้เพียงแค่ตกแต่ง นี่คือสิ่งที่ทำให้ Harness น่าทดลองใช้ และยังเป็นจุดที่ความเสี่ยงที่แท้จริงแฝงอยู่ การตัดสินว่าการแลกเปลี่ยนนี้คุ้มค่าหรือไม่ขึ้นอยู่กับว่าคุณกำลังเปรียบเทียบกับอะไร และ การเปรียบเทียบกับ Claude Code และ Omnigent จะแสดงให้เห็นถึงการออกแบบที่เน้นปลั๊กอินนี้เมื่อเทียบกับทางเลือกอื่นในด้านการเชื่อมต่อโมเดล สัญญาอนุญาต และทรัพยากร VPS ที่แต่ละตัวต้องการ

Harness ไม่ใช่โมเดล

Harness ทำหน้าที่รันลูปของ agent ส่วนการประมวลผลเชิงเหตุผลจะเกิดขึ้นในโมเดลที่อื่น ดังนั้นระบบจะไม่ทำงานจนกว่าคุณจะระบุ API (application programming interface) key หรือที่อยู่ของ model endpoint ที่คุณโฮสต์เอง ทุกอย่างในโพสต์นี้เป็นการตั้งค่า Harness ไม่ใช่พฤติกรรมของโมเดล และ เส้นแบ่งระหว่างสองสิ่งนี้ เป็นเรื่องที่ควรทำความเข้าใจให้ชัดเจนก่อนที่คุณจะเสียเวลาทั้งบ่ายไปกับการดีบั๊กเพื่อหาว่าปัญหามาจากฝั่งไหน

คุณสามารถตั้งค่าส่วนนี้ได้ใน UI ภายใต้เมนู Settings แล้วเลือก Models โดย DeepSeek จะมี card ของตัวเอง และใน release ปัจจุบัน ปุ่ม "Add model provider" ด้านล่างจะเปิดโหมดการทำงานสองแบบ "Third-party model provider" ครอบคลุมผู้ให้บริการที่มีอยู่ในแคตตาล็อกของ Harness เช่น OpenAI และ Anthropic ซึ่งคุณเพียงแค่วาง key ลงไป ส่วนแคตตาล็อกจะระบุ endpoint และรายการโมเดลให้เอง ตัวเลือกที่น่าสนใจคือ "Custom model API" ซึ่งต้องใช้ provider ID (ตัวพิมพ์เล็ก), ชื่อที่แสดงผล, base URL, API protocol, ข้อมูลรับรอง (credential) และโมเดลอย่างน้อยหนึ่งรายการ ตัวเลือก protocol มีทั้ง OpenAI Chat Completions, OpenAI Responses, Anthropic Messages และ Gemini API ดังนั้นคุณสามารถตั้งค่า gateway หรือเซิร์ฟเวอร์ภายในที่รองรับโปรโตคอลเหล่านี้ได้ สำหรับ endpoint ที่มีรูปแบบคำขอแตกต่างกัน จำเป็นต้องมีการตั้งค่าความเข้ากันได้ (compatibility settings) นอกจากนี้ custom provider ยังสามารถคิวรีไปยัง endpoint GET /models ที่รองรับมาตรฐาน OpenAI เพื่อดึงรายการโมเดลมาให้คุณโดยอัตโนมัติ

นี่คือวิธีการชี้ Harness ไปยังโมเดลที่อยู่บน VPS เดียวกัน โดย Ollama จะเปิด API ที่รองรับมาตรฐาน OpenAI ไว้ที่ http://127.0.0.1:11434/v1/ และช่อง API key สามารถใส่สตริงใดก็ได้ โดยทั่วไปจะใช้ ollama เนื่องจากไคลเอนต์สไตล์ OpenAI ต้องการค่าในช่องนี้ แต่ Ollama จะเพิกเฉยต่อค่าดังกล่าว เอกสารของ Ollama ยังอธิบายถึง ollama launch dsh ซึ่งจะติดตั้ง @deepseek-ai/dsh หากยังไม่มีและเริ่มการทำงานกับโมเดลของ Ollama ดังนั้นควรตรวจสอบเวอร์ชันที่ติดตั้งก่อนที่คุณจะพึ่งพาการปักหมุด (pin) ด้านล่าง คำถามที่ยากกว่าคือโมเดลที่มีขนาดเล็กพอจะรันบน VPS ของคุณนั้นมีประสิทธิภาพเพียงพอที่จะขับเคลื่อน agent หรือไม่ และ ความแตกต่างระหว่าง Ollama กับ vLLM ในฐานะ local model server จะเป็นตัวกำหนดว่าคำตอบนั้นต้องใช้ RAM ของคุณมากน้อยเพียงใด

Key ที่พิมพ์ลงใน UI จะเป็นแบบเขียนได้อย่างเดียว (write-only) โดย Harness จะจัดเก็บไว้ใน $DSH_HOME/.credentials.yaml และการตั้งค่าจะเก็บไว้เพียงการอ้างอิง credential ซึ่ง release ปัจจุบันจะเขียนลงในไฟล์ patch ของโปรไฟล์ที่ใช้งานอยู่ คือ $DSH_HOME/profiles/<profile>/cordis.patch.yml (โปรไฟล์คือ web สำหรับ dsh web) โดย $DSH_HOME จะมีค่าเริ่มต้นเป็น ~/.dsh ให้ปฏิบัติต่อไฟล์ credential เหมือนไฟล์รหัสผ่าน เพราะมันคือไฟล์รหัสผ่านจริง ๆ ใครก็ตามที่อ่านไฟล์นี้ได้สามารถใช้ยอดเงิน API ของคุณได้ หากคุณต้องการแก้ไขไฟล์เหล่านี้โดยตรงแทนการคลิกผ่าน Settings คำแนะนำเกี่ยวกับไฟล์คอนฟิก, key และ model endpoint ของ dsh จะแสดงให้เห็นว่าแต่ละ key ทำหน้าที่อะไรและมีข้อมูลใดบ้างที่ถูกส่งออกจากเครื่องของคุณในแต่ละโหมด

สิ่งที่ต้องเตรียมก่อนการติดตั้ง

  • VPS ที่รัน Ubuntu 24.04 หรือ Linux เวอร์ชันปัจจุบันอื่นๆ พร้อมสิทธิ์การเข้าถึงผ่าน SSH
  • Node.js 24.9 หรือใหม่กว่า เนื่องจาก branch หลักของโปรเจกต์และ 0.2.2-alpha.2 ในขณะนี้ประกาศใช้ >=24.9.0 และการทดสอบ CI ของโปรเจกต์ใช้ Node 24 โดยมีการตรวจสอบความเข้ากันได้ที่ Node 24.9 และ Node 26 โดยไม่มี job สำหรับ Node 22 แล้ว แม้ว่า release ที่ติด tag ผ่าน 0.2.1-rc.4 จะยังระบุว่า Node 22.19 เป็นเวอร์ชันที่ยอมรับได้ แต่เวอร์ชันดังกล่าวไม่ใช่เกณฑ์ขั้นต่ำที่โปรเจกต์ใช้ในการ build อีกต่อไป
  • บัญชีผู้ใช้ทั่วไป ไม่ใช่ root เนื่องจาก agent จะรันคำสั่ง shell ในฐานะผู้ที่เริ่มกระบวนการนั้นๆ
  • pnpm ใน PATH หากคุณวางแผนที่จะติดตั้งปลั๊กอิน เนื่องจากคำสั่งปลั๊กอินจะเรียกใช้งานผ่าน shell
  • ปิดพอร์ต 3080 บน firewall ของคุณและบน network firewall แยกต่างหากของผู้ให้บริการ

แพ็กเกจ nodejs ของ Ubuntu 24.04 เองนั้นเก่ากว่าที่ระบบต้องการ ดังนั้นบน release ดังกล่าวให้ติดตั้ง Node จาก NodeSource หรือ nvm แทนการใช้ apt install nodejs ส่วน repository อย่างเป็นทางการของ Ubuntu 26.10 มี Node 24.19.0 ซึ่งสูงกว่าเกณฑ์ขั้นต่ำที่ Node 24.9 กำหนด หาก VPS เป็นเครื่องใหม่ การ ทำ hardening ให้ SSH ก่อนเริ่มงานอื่น ถือว่าคุ้มค่ากับเวลา 10 นาทีที่เสียไป เพราะอุโมงค์ที่คุณกำลังจะใช้งานนั้นจะปลอดภัยเท่ากับตัว SSH server ที่อยู่เบื้องหลังเท่านั้น

การติดตั้ง DeepSeek Harness บน VPS โดยล็อกเวอร์ชันไว้

node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 web

npx จะดาวน์โหลดแพ็กเกจและรันไบนารี dsh ของมัน web เป็นนามแฝงของ --profile web ซึ่งจะบูตแอปพลิเคชันเบราว์เซอร์ขึ้นมา และกระบวนการจะแสดงที่อยู่ที่มันกำลังฟังอยู่ ค่าเริ่มต้นคือ http://127.0.0.1:3080 ตัวเลขเหล่านั้นเป็นการตัดสินใจเรื่องการผูกพอร์ต (binding) ไม่ใช่แค่ค่าเริ่มต้นทั่วไป และ เหตุผลที่ dsh แสดงที่อยู่ loopback จะอธิบายว่า harness จะตอบสนองหรือไม่ตอบสนองต่ออะไรบ้างก่อนที่คุณจะพยายามเข้าถึงจากแล็ปท็อปของคุณ

การล็อกเวอร์ชัน (Pinning) นั้นสำคัญ npx @deepseek-ai/dsh web จะแก้ไขค่าที่แท็ก latest ชี้ไปในขณะที่คุณรันคำสั่ง เว้นแต่ว่าโปรเจกต์ที่คุณรันอยู่นั้นมีสำเนาติดตั้งไว้แล้ว ซึ่งในกรณีนั้น npx จะใช้สำเนานั้นแทนโดยอัตโนมัติ ไม่ว่ากรณีใด คุณไม่ใช่ผู้เลือกเวอร์ชัน และโปรเจกต์นี้ได้ปล่อย release candidate ออกมาหลายตัวแล้วและระบุว่าจะมีการเปลี่ยนแปลงที่ส่งผลกระทบ (breaking changes) เกิดขึ้น 0.1.0-rc.6 คือเวอร์ชันเดือนสิงหาคม 2026 ที่ล็อกไว้ที่นี่ ณ วันที่ 12 พฤศจิกายน 2026 latest ชี้ไปที่ 0.2.2-rc.1 ซึ่งเป็นรุ่นที่แสดง URL เริ่มต้นแบบมีโทเค็น ส่วน GitHub แสดงรุ่น prerelease ใหม่กว่าคือ 0.2.2-rc.2 ดังนั้นการย้ายไปเวอร์ชันอื่นจึงเป็นการอัปเกรดที่คุณควรตั้งใจทำหลังจากอ่านรายละเอียดใน repository แล้ว การล็อกเวอร์ชันหมายความว่าเครื่องที่คุณตั้งค่าในวันนี้จะมีพฤติกรรมเหมือนเดิมในเดือนหน้า ดังนั้นการอัปเกรดจึงเป็นการตัดสินใจที่คุณเลือกเอง ไม่ใช่เหตุบังเอิญที่เพิ่งมาพบภายหลัง เมื่อคำสั่งที่ล็อกเวอร์ชันไว้ยังคงเริ่ม build ที่ผิดหรือปฏิเสธการติดตั้ง ข้อผิดพลาดทั่วไปในการติดตั้งและเวอร์ชันของ dsh จะครอบคลุมถึงการล้าง npx cache และการตรวจสอบว่า npm ของคุณเชื่อมโยงกับ Node เวอร์ชันใด

สำหรับการใช้งานรายวัน ให้ติดตั้งเพียงครั้งเดียวแทนการแก้ไขเวอร์ชันใหม่ทุกครั้งที่เริ่มโปรแกรม

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --help

บรรทัดที่สองนั้นคุ้มค่าที่จะรัน เพราะตัว launcher และเว็บแอปมีชุด flag แยกกัน dsh --help จะแสดงตัวเลือกของ launcher เอง dsh --profile web --help จะแสดง flag ที่เว็บแอปพลิเคชันยอมรับ ซึ่งเป็นที่ที่ --port, --host และ --trusted-host ที่ใช้ซ้ำได้อาศัยอยู่

ตอนนี้ให้ยืนยันว่ามันกำลังฟังอยู่ที่ใด

ss -tlnp | grep 3080

คอลัมน์ local address ควรแสดงเป็น 127.0.0.1:3080 หากแสดงเป็น 0.0.0.0:3080 แสดงว่า UI กำลังฟังอยู่บนทุกอินเทอร์เฟซ ดังนั้นจะมีเพียงไฟร์วอลล์ของคุณเท่านั้นที่กั้นระหว่างมันกับอินเทอร์เน็ต และคุณควรหยุดกระบวนการนั้นทันทีก่อนที่จะทำสิ่งอื่นใดต่อ

เหตุผลที่คุณไม่ควรเปิดพอร์ต 3080 สู่สาธารณะ

เว็บเซิร์ฟเวอร์ใน 0.1.0-rc.6 ไม่มีเลเยอร์การยืนยันตัวตน การตั้งค่าของมันมีเพียงการกำหนด host และ port ที่จะรับฟัง ซึ่งเป็นพื้นที่ทั้งหมดที่เปิดเผยออกมา การควบคุมการเข้าถึงสำหรับการใช้งานที่ไม่ใช่ loopback นั้นเป็นการตั้งค่า trusted-host แยกต่างหาก ซึ่งไม่ใช่หน้าจอสำหรับล็อกอิน

ซอฟต์แวร์รุ่นใหม่ได้เพิ่มฟีเจอร์นี้เข้ามา ตั้งแต่ 0.2.0-rc.2 เป็นต้นไป เมื่อเริ่มทำงานระบบจะแสดง URL ที่มีโทเค็นใหม่สำหรับโพรเซสนั้น เบราว์เซอร์ที่เปิด URL ดังกล่าวจะได้รับ session cookie ที่มีการลงนามและถูกเปลี่ยนเส้นทางไปยังที่อยู่เดิมโดยไม่มีโทเค็นติดไปด้วย การตรวจสอบ Host/Origin ที่อยู่หน้า /api จะยอมรับเฉพาะการเชื่อมต่อจาก loopback, bind address ของตัว listener เอง และหน่วยงานที่คุณระบุไว้ใน --trusted-host เท่านั้น แม้จะเป็นข้อมูลรับรองที่ใช้งานได้จริง แต่เอกสารของโครงการได้เตือนไว้ว่า URL ที่แสดงออกมานั้นเป็นข้อมูลรับรองที่ควรแชร์เฉพาะกับผู้ใช้ที่ตั้งใจไว้เท่านั้น และการใช้ HTTP ปกติจะส่งข้อมูลดังกล่าวโดยไม่มีการเข้ารหัส ตั้งแต่ 0.2.1-alpha.2 เป็นต้นมา เว็บแอปสามารถผูกกับที่อยู่ภายในที่ระบุได้หนึ่งแห่งและให้บริการ HTTPS ด้วยตนเองผ่าน --tls-cert และ --tls-key ซึ่งช่วยแก้ปัญหาเรื่องข้อความธรรมดา (plaintext) แต่ไม่ได้แก้ปัญหาเรื่องการเปิดเผยพอร์ต มันเพียงแต่ทำให้พอร์ตที่เปิดอยู่นั้นถูกนำไปใช้ในทางที่ผิดได้ยากขึ้นเท่านั้น แต่มันก็ยังไม่ใช่สิ่งที่ควรเปิดสู่สาธารณะ

ลองพิจารณาสิ่งที่อยู่หลังพอร์ตนั้น ตัว agent มีหน้าที่แก้ไขไฟล์ใน workspace และรันคำสั่ง shell ในขณะที่ข้อมูลรับรองของผู้ให้บริการของคุณก็ถูกเก็บไว้ในดิสก์ข้างๆ กัน ดังนั้นในรุ่นที่ถูกตรึงเวอร์ชันไว้ การเปิดพอร์ต 3080 ทิ้งไว้ก็เท่ากับเป็นการเปิด remote shell ที่มีอินเทอร์เฟซแชท โดยรันในฐานะผู้ใช้ที่เริ่มโปรแกรมนั้นและมี API key ของคุณแนบอยู่ด้วย ผู้บุกรุกไม่จำเป็นต้องใช้ช่องโหว่ใดๆ พวกเขาเพียงแค่ต้องการเลขพอร์ตเท่านั้น สำหรับรุ่นที่มี launch token พวกเขาจำเป็นต้องมีโทเค็นด้วย ซึ่งใครก็ตามที่สามารถอ่าน terminal, log ของบริการ หรือดักจับ traffic ที่ไม่ได้เข้ารหัสของคุณได้ ก็จะได้รับโทเค็นนั้นไปอยู่ดี

CLI (command line interface) เห็นด้วยกับแนวทางนี้ ตั้งแต่ 0.1.0-rc.6 เป็นต้นมา มันไม่รองรับ --host 0.0.0.0 โดยเจตนาและจะแสดงข้อผิดพลาดในการใช้งานแทนที่จะเริ่มทำงาน และใน 0.2.2-alpha.2 รุ่นใหม่กว่าก็ยังคงปฏิเสธการตั้งค่านี้เมื่อเริ่มทำงาน การปฏิเสธดังกล่าวถือเป็นฟีเจอร์ ดังนั้นอย่าพยายามหาแพตช์เพื่อนำฟีเจอร์นี้ออก

มีอีกสองวิธีที่เหมาะสมหากการใช้ tunnel ไม่ตอบโจทย์คุณ วิธีแรกคือการนำเครื่องไปไว้ใน private overlay network เพื่อให้มันมีที่อยู่ที่เฉพาะอุปกรณ์ของคุณเท่านั้นที่สามารถเข้าถึงได้ ซึ่งทำได้โดยใช้ เซิร์ฟเวอร์ควบคุม Headscale ที่โฮสต์เอง หรือวิธีที่สองคือการใช้ reverse proxy วางไว้ด้านหน้าเพื่อยืนยันตัวตนคำขอก่อนที่จะส่งต่อไปยังพอร์ต 3080 เช่น การใช้ เซิร์ฟเวอร์ Authentik single sign-on เพื่อทำ forward auth การใช้ reverse proxy โดยไม่มีการยืนยันตัวตนวางไว้ด้านหน้าไม่ใช่มาตรการรักษาความปลอดภัย แต่มันเป็นเพียงการทำให้ URL ยาวขึ้นเท่านั้น

การเข้าถึง Web UI ผ่าน SSH tunnel

ให้รันคำสั่งนี้บนแล็ปท็อปของคุณ ไม่ใช่บนเซิร์ฟเวอร์

ssh -N -L 3080:127.0.0.1:3080 you@your-server

-L จะเปิดพอร์ต 3080 บนแล็ปท็อปของคุณ และส่งต่อทุกการเชื่อมต่อที่เข้ามาผ่านเซสชัน SSH ที่เข้ารหัสไว้ ส่วน 127.0.0.1:3080 จะถูกประมวลผลที่ฝั่งเซิร์ฟเวอร์ ดังนั้นการเชื่อมต่อจะมาถึง harness จาก loopback เสมือนว่าคุณกำลังใช้งานอยู่ที่เครื่องนั้นโดยตรง -N เป็นการระบุว่าไม่ต้องเริ่ม remote shell เนื่องจากคุณต้องการเพียงแค่การส่งต่อพอร์ตเท่านั้น

จากนั้นเปิด http://127.0.0.1:3080 ในเบราว์เซอร์บนเครื่องของคุณ สำหรับรุ่นที่มี launch token ให้เปิด URL เริ่มต้นฉบับเต็มที่เซิร์ฟเวอร์แสดงผลออกมาแทน ซึ่งรวมถึง token ด้วย เมื่อ harness ถูกเริ่มผ่าน SSH มันจะยังคงแสดงบรรทัดเริ่มต้นการทำงาน แต่จะไม่พยายามเปิดเบราว์เซอร์ให้คุณ หากพอร์ต 3080 ถูกใช้งานอยู่บนแล็ปท็อปของคุณ ให้เปลี่ยนตัวเลขฝั่งซ้ายเป็น ssh -N -L 3180:127.0.0.1:3080 you@your-server แล้วเข้าใช้งานที่ http://127.0.0.1:3180 โดยเปลี่ยนพอร์ตใน URL ที่มี token ให้ตรงกัน ตัวเลขฝั่งซ้ายคือพอร์ตในเครื่อง ส่วนตัวเลขฝั่งขวาคือพอร์ตบนเซิร์ฟเวอร์ ดังนั้นให้เปลี่ยนเฉพาะฝั่งซ้ายเท่านั้น

บันทึกคำสั่งนี้ไว้ใน ~/.ssh/config เพื่อให้ไม่ต้องพิมพ์ใหม่

Host dsh
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/id_ed25519
  LocalForward 3080 127.0.0.1:3080

หลังจากนั้น ssh -N dsh จะเริ่มการทำงานของ tunnel หากเบราว์เซอร์แจ้งว่าการเชื่อมต่อถูกปฏิเสธ มักหมายความว่า tunnel ทำงานอยู่แต่ไม่มีบริการใดรอรับการเชื่อมต่อที่ฝั่งปลายทาง เนื่องจาก SSH จะส่งต่อพอร์ตไม่ว่า harness จะทำงานอยู่หรือไม่ก็ตาม ให้ตรวจสอบเซิร์ฟเวอร์ด้วยคำสั่ง ss ที่ระบุไว้ข้างต้น

การรักษาให้ harness ทำงานต่อไปหลังจากที่คุณออกจากระบบ

คำสั่ง npx จะยุติการทำงานพร้อมกับ shell ของคุณ แต่ systemd user service จะยังคงทำงานอยู่ และจะเรียก harness กลับมาทำงานใหม่หลังจากเกิดการขัดข้องหรือการรีบูต หน่วยบริการ (unit) ในที่นี้ถูกออกแบบมาให้เรียบง่ายที่สุด หากคุณต้องการให้ harness ทำงานภายใต้บัญชีผู้ใช้ที่จำกัดสิทธิ์ โดยมีการระบุเวอร์ชันไว้ภายใน unit และมี log ที่สามารถสืบค้นได้จริง การตั้งค่า systemd แบบ headless สำหรับ dsh ได้อธิบายเรื่องนี้ไว้อย่างละเอียด

loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dsh

enable-linger มีความสำคัญเนื่องจากโดยปกติแล้ว user service จะหยุดทำงานเมื่อ session สุดท้ายของคุณสิ้นสุดลง ดังนั้นหากไม่มีการตั้งค่านี้ harness จะยุติการทำงานทันทีที่คุณปิด tunnel ให้ใช้ absolute path ที่แสดงโดย command -v dsh แล้วนำไปใส่ใน unit เนื่องจาก systemd จะไม่ค้นหา PATH ที่ login shell ของคุณสร้างขึ้น

[Unit]
Description=DeepSeek Harness web UI
After=network-online.target

[Service]
Type=simple
WorkingDirectory=%h/projects/site
ExecStart=/usr/local/bin/dsh web
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

WorkingDirectory ไม่ใช่แค่เรื่องของความสวยงาม กระบวนการ dsh จะใช้ไดเรกทอรีที่เรียกใช้งานเป็นตำแหน่งเริ่มต้นของระบบไฟล์ ดังนั้นหาก service เริ่มต้นในตำแหน่งที่ผิด จะทำให้ agent ชี้ไปยังโฟลเดอร์ที่ไม่ถูกต้อง อย่างไรก็ตาม ไดเรกทอรีดังกล่าวเป็นเพียงค่าเริ่มต้นเท่านั้น Web UI ที่เพิ่งเริ่มใช้งานจะยังไม่มี workspace ที่ถูกเลือกจนกว่าคุณจะเพิ่มเข้าไปในส่วน Choose workspace และคู่มือของโปรเจกต์จะแนะนำให้คุณเพิ่มไดเรกทอรีที่คุณใช้เริ่ม dsh เข้าไป คู่มือนี้ไม่มีการระบุเวอร์ชัน และมีการใช้ข้อความเดียวกันนี้ใน 0.1.0-rc.7 ดังนั้นคุณควรคาดหวังว่าจะพบข้อความนี้ในรุ่นที่ถูกระบุเวอร์ชัน (pinned release) ด้วย ให้ตั้งค่าไดเรกทอรีของ unit ให้ตรงกับโปรเจกต์ จากนั้นจึงเลือก workspace นั้นใน UI

systemctl --user daemon-reload
systemctl --user enable --now dsh
systemctl --user status dsh

หน่วยบริการที่ไม่ยอมเริ่มทำงานมักเกิดจากเส้นทาง ExecStart ที่ไม่ถูกต้อง หรือเวอร์ชันของ Node ที่ binary ปฏิเสธการทำงาน ซึ่ง journalctl --user -u dsh -n 50 จะระบุชื่อปัญหาเหล่านั้นไว้ ในรุ่นที่มี launch token ตัว journal จะเป็นที่ที่ URL สำหรับการเริ่มต้นระบบที่มาพร้อม token ปรากฏอยู่ และการรีสตาร์ททุกครั้งจะสร้าง URL ใหม่ขึ้นมา รูปแบบเดียวกันนี้ครอบคลุมถึง การรักษาให้ coding agent ใดๆ ทำงานอยู่บน VPS และรูปแบบความล้มเหลวก็เหมือนกันทุกประการ

สิ่งที่ปลั๊กอินสามารถทำได้

ปลั๊กอินคือโมดูลที่ทำหน้าที่เพิ่มบริการ, เหตุการณ์ที่มีการระบุประเภท (typed events) และผลกระทบที่ย้อนกลับได้ (reversible effects) ให้กับบริบทที่ใช้ร่วมกัน จุดเชื่อมต่อส่วนขยาย (extension points) คือส่วนที่ควรศึกษาอย่างละเอียด:

  • ลงทะเบียนผู้ให้บริการโมเดล (model provider) บน ctx.llm
  • เพิ่มเครื่องมือสำหรับโมเดล (model-facing tools) บน ctx.tools
  • จัดเตรียม shell backend เบื้องหลัง ctx.shell
  • จัดเตรียมการเข้าถึงระบบไฟล์หรือนโยบายเบื้องหลัง ctx.fs
  • ลงทะเบียนคำสั่งสำหรับผู้ใช้บน ctx.commands
  • ดำเนินงานเบื้องหลังผ่าน ctx.jobs
  • ครอบกระบวนการที่ถูกสร้างขึ้น (spawned processes) ด้วย backend ctx.sandbox
  • ดักจับคำขอและการเรียกใช้เครื่องมือผ่านเหตุการณ์ agent/* และ tools/*
  • ขยายสถานะเซสชันที่คงทน (durable session state)
  • ควบคุม UI ผ่าน ctx.agents

จงอ่านรายการข้างต้นในมุมมองของผู้โจมตี ปลั๊กอินสามารถจัดเตรียมเลเยอร์ระบบไฟล์และเลเยอร์ shell ได้ อีกทั้งยังสามารถแทรกตัวอยู่ตรงกลางของการเรียกใช้เครื่องมือทุกครั้งที่โมเดลทำ ไม่มีหน้าต่างขออนุญาตใดๆ กั้นระหว่างปลั๊กอินกับจุดเชื่อมต่อเหล่านี้ เนื่องจากปลั๊กอินเป็นเพียงโค้ด Node ปกติที่ถูกโหลดเข้าสู่กระบวนการเดียวกับส่วนอื่นๆ การติดตั้งปลั๊กอินจึงเท่ากับการรันโค้ดของคนแปลกหน้าด้วยสิทธิ์ของเอเจนต์ของคุณ และสิทธิ์ของเอเจนต์ของคุณก็คือสิทธิ์ของผู้ใช้ Unix ของคุณนั่นเอง

นี่คือการตัดสินใจเรื่องความเชื่อใจแบบเดียวกับที่คุณทำเมื่อเชื่อมต่อ MCP server เข้ากับเอเจนต์บน VPS โดยที่ MCP คือ model context protocol และนี่คือเหตุผลว่าทำไม การรัน coding agent อย่างปลอดภัยบน VPS จึงต้องเริ่มจากการพิจารณาบัญชีผู้ใช้ที่รันโปรแกรมนั้น แทนที่จะเริ่มจากตัวโมเดล และเหตุผลที่ การโจมตีห่วงโซ่อุปทานของ npm ส่งผลกระทบรุนแรงต่อเซิร์ฟเวอร์: ขั้นตอนการติดตั้งคือจุดที่เกิดการบุกรุก และไม่มีการแจ้งเตือนใดๆ ให้คุณทราบ

แหล่งที่มาของปลั๊กอิน

ปลั๊กอินจะอยู่ในโปรไฟล์ โดยโปรไฟล์คือชุดการตั้งค่าที่มีชื่อเรียกและถูกจัดเก็บไว้ภายใต้ $DSH_HOME ซึ่งค่าเริ่มต้นคือ ~/.dsh และไดเรกทอรีของแต่ละโปรไฟล์จะเก็บปลั๊กอินภายนอก (out-of-tree) ที่ติดตั้งไว้ CLI จะจัดการปลั๊กอินเหล่านี้โดยส่งต่ออาร์กิวเมนต์ของคุณไปยัง pnpm โดยตรง โดยใช้ไดเรกทอรีของโปรไฟล์เป็นไดเรกทอรีทำงาน

dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-ui

เนื่องจากอาร์กิวเมนต์ถูกส่งไปยัง pnpm โดยไม่มีการเปลี่ยนแปลง add, remove, update และ why จึงทำงานในลักษณะเดียวกับในโปรเจกต์ pnpm ทั่วไป และปลั๊กอินสามารถเป็นได้ทั้งแพ็กเกจ npm หรือ GitHub reference ทั้งนี้ pnpm จะต้องมีอยู่ใน PATH ก่อน สำหรับ Node 24 นั้น corepack enable pnpm จะติดตั้งให้โดยอัตโนมัติ แต่เนื่องจาก Node 25 ได้ยกเลิกการแจกจ่าย Corepack ดังนั้นบน Node 25 และเวอร์ชันที่ใหม่กว่า ให้ติดตั้งด้วย npm install -g pnpm แทน

การค้นหาปลั๊กอินทำผ่าน GitHub topic โดยผู้พัฒนาปลั๊กอินจะเพิ่ม topic ชื่อ dsh-plugin ลงใน repository ของตน และคุณสามารถค้นหาสิ่งที่มีอยู่ได้จากการเรียกดู topic นั้น ซึ่ง topic คือป้ายกำกับที่ผู้พัฒนาติดไว้กับ repository ของตนเอง โดยไม่มีการตรวจสอบหรือลงนามรับรองใดๆ และหน้าแสดงผลของ topic จะจัดอันดับตามจำนวนดาว ซึ่งเป็นการวัดความนิยมไม่ใช่ความปลอดภัย

เวอร์ชันปัจจุบันยังมาพร้อมกับฟีเจอร์ทดลองคือ Custom plugin indexes bundle คุณสามารถเปิดใช้งานได้ภายใต้เมนู Plugins และแท็บ Discover จะช่วยให้คุณเพิ่ม index ซึ่งเป็นไฟล์ JSON ที่ดึงมาจาก URL ที่คุณระบุ ตัว harness เองไม่มี index ของตนเอง โดยจะตรวจสอบเพียงรูปแบบของไฟล์เท่านั้น ไม่ได้ตรวจสอบชื่อ ผู้พัฒนา หรือแหล่งที่มาที่ตลาดนั้นๆ อ้างถึง และบุคคลใดก็ตามที่อยู่บนเส้นทางเครือข่ายสามารถแก้ไข index ที่ส่งผ่าน http: แบบไม่เข้ารหัสได้ ดังนั้น "ตลาด" จึงเป็นเพียงแคตตาล็อกที่ผู้อื่นเขียนขึ้น ไม่ใช่การตรวจสอบความปลอดภัย

แนวทางปฏิบัติ 4 ประการที่จะช่วยให้จัดการเรื่องนี้ได้คือ อ่านซอร์สโค้ดก่อนติดตั้ง เนื่องจากปลั๊กอินส่วนใหญ่มีขนาดเล็กพอที่จะอ่านจบภายใน 10 นาที, ระบุเวอร์ชันหรือ commit ที่แน่นอนแทนการติดตาม branch, รัน harness ภายใต้ผู้ใช้ที่ไม่มีสิทธิ์เข้าถึงข้อมูลอื่นบน VPS ที่คุณพร้อมจะติดตั้งใหม่ได้ตลอดเวลา และกำหนด API key เฉพาะสำหรับ agent โดยมีวงเงินจำกัด แยกจาก key ที่ใช้ในบริการ production หากคุณต้องการอ่านโค้ดปลั๊กอินและต้องการทราบว่าไฟล์ใดมีความเสี่ยง คำแนะนำในการตรวจสอบปลั๊กอิน dsh จะอธิบายรายละเอียดเกี่ยวกับ manifest, entry point และจุดขยาย (extension points) ที่ปลั๊กอินลงทะเบียนไว้

หากคุณต้องการเปรียบเทียบการออกแบบก่อนตัดสินใจเลือก Omnigent multi-agent harness จะเป็นอีกทางเลือกที่แก้ปัญหาเดียวกันด้วยโครงสร้างที่ต่างออกไป ซึ่งข้อดีข้อเสียจะชัดเจนขึ้นเมื่อเริ่มใช้งานปลั๊กอิน หากคุณตัดสินใจใช้งาน harness สองหรือสามตัวบนเครื่องเดียวกันแทนที่จะเลือกเพียงตัวเดียว การวาง harness ทุกตัวไว้หลัง API ที่ self-host เอง จะช่วยให้คุณไม่ต้องเปิด tunnel แยกตามพอร์ต แลกกับการต้องเพิ่มบริการอีกหนึ่งตัวที่ต้องผูกไว้กับ loopback และกำหนดรหัสผ่านจริงตั้งแต่วันแรกที่ใช้งาน

สิ่งที่มักจะพังก่อน

Node เก่าเกินไป สาขาหลักของโปรเจกต์และ 0.2.2-alpha.2 ต้องการ Node 24.9 หรือใหม่กว่า โดย CI ของโปรเจกต์จะทดสอบบน Node 24 พร้อมตรวจสอบความเข้ากันได้บน Node 24.9 และ Node 26 แต่ไม่มีการทดสอบบน Node 22 รุ่นที่ติดแท็กไว้ก่อนหน้าผ่าน 0.2.1-rc.4 เคยระบุว่า Node 22.19 สามารถใช้งานได้ แต่ปัจจุบันโปรเจกต์ไม่รองรับการ build บนเวอร์ชันดังกล่าวอีกต่อไป รันไทม์ที่เก่ากว่าจะล้มเหลวขณะเริ่มทำงานเนื่องจากโค้ดใช้ไวยากรณ์และ API ที่ไม่มีในเวอร์ชันนั้น ให้รัน node --version ก่อนดำเนินการอื่นใด

พอร์ต 3080 ถูกใช้งานอยู่ อาจเกิดจาก harness ตัวที่สอง, กระบวนการที่ค้างอยู่ หรือแอปพลิเคชันอื่นที่ใช้พอร์ต 3080 เช่นกัน ให้ค้นหาด้วย ss -tlnp | grep 3080 จากนั้นหยุดกระบวนการดังกล่าวหรือเริ่ม harness ที่พอร์ตอื่นด้วย dsh web --port 3180 โดย --port เป็นส่วนของเว็บแอปพลิเคชัน จึงต้องระบุไว้หลัง web

เบราว์เซอร์ไม่สามารถเชื่อมต่อผ่าน tunnel ได้ ตรวจสอบให้แน่ใจว่าคุณเข้าถึง 127.0.0.1 ไม่ใช่ที่อยู่สาธารณะของเซิร์ฟเวอร์ เนื่องจากพอร์ตที่ forward จะมีอยู่เฉพาะบนแล็ปท็อปของคุณเท่านั้น จากนั้นตรวจสอบว่า harness กำลังฟังพอร์ตบนเซิร์ฟเวอร์อยู่จริง เพราะ SSH จะทำการ forward พอร์ตให้ไม่ว่าจะมีบริการใดตอบสนองที่ปลายทางหรือไม่ก็ตาม

dsh plugin ล้มเหลวทันที คำสั่งนี้เป็น wrapper ของ pnpm ดังนั้นหากไม่มีไบนารี pnpm จะทำให้การทำงานหยุดลงก่อนที่ปลั๊กอินจะเริ่มทำงาน บน Node 25 และใหม่กว่า นี่เป็นสถานะเริ่มต้นเนื่องจาก Corepack ไม่ได้ถูกติดตั้งมาพร้อมกับ Node อีกต่อไป

เอเจนต์มองไม่เห็นโปรเจกต์ของคุณ Web UI ที่เพิ่งเริ่มใช้งานจะยังไม่มี workspace ที่เลือกไว้จนกว่าคุณจะเพิ่มเข้าไป และ session composer จะยังไม่พร้อมใช้งานจนกว่าคุณจะดำเนินการดังกล่าว กระบวนการจะใช้ไดเรกทอรีที่เริ่มทำงานเป็นตำแหน่งไฟล์เริ่มต้นเท่านั้น ดังนั้น unit ที่มี WorkingDirectory เป็นโฮมไดเรกทอรีของคุณจะชี้เอเจนต์ไปที่โฮมไดเรกทอรีของคุณ ให้เลือก workspace ใน UI หรือแก้ไข unit แล้วโหลดใหม่

FAQ

การเปิดใช้งาน DeepSeek Harness web UI บนพอร์ต 3080 ปลอดภัยหรือไม่?

ไม่ปลอดภัย ใน 0.1.0-rc.6 ที่ปักหมุดไว้ เว็บเซิร์ฟเวอร์ไม่มีระบบล็อกอินในตัว และเอเจนต์ที่ทำงานอยู่เบื้องหลังสามารถแก้ไขไฟล์และรันคำสั่ง shell ในฐานะผู้ใช้ที่เริ่มกระบวนการนั้น โดยมี API key ของผู้ให้บริการเก็บไว้ในดิสก์เดียวกัน ตั้งแต่ 0.2.0-rc.2 เป็นต้นไป รวมถึง 0.2.2-rc.1 และการปล่อยอัปเดต latest ของ npm เมื่อวันที่ 12 พฤศจิกายน 2026 ตลอดจนรุ่นทดสอบ 0.2.2-rc.2 ที่ใหม่กว่า URL ที่แสดงตอนเริ่มต้นจะมี launch token ซึ่งเบราว์เซอร์จะนำไปแลกเป็น session cookie แต่ URL ดังกล่าวถือเป็นข้อมูลรับรอง (credential) ซึ่งหากส่งผ่าน HTTP ปกติจะไม่มีการเข้ารหัส ดังนั้นคำแนะนำจึงยังคงเดิม ให้คงการฟังพอร์ตไว้ที่ 127.0.0.1 และเข้าถึงผ่าน SSH tunnel เท่านั้น หรือจะใช้ private overlay network หรือ reverse proxy ที่ตรวจสอบสิทธิ์ทุกคำขอก่อนส่งไปยังพอร์ตดังกล่าวก็ได้ สำหรับเวอร์ชัน 0.1.0-rc.6 ตัว CLI จะปฏิเสธ --host 0.0.0.0 และหยุดทำงานพร้อมแสดงข้อผิดพลาดการใช้งาน ส่วน 0.2.2-alpha.2 ก็ยังคงปฏิเสธเช่นกัน ซึ่งสะท้อนให้เห็นว่าผู้พัฒนาคิดอย่างไรกับแนวคิดนี้

ฉันจำเป็นต้องมี DeepSeek API key หรือสามารถใช้โมเดลในเครื่องได้หรือไม่?

ใช้ได้ทั้งสองแบบ เนื่องจาก harness เป็นเพียง runtime ไม่ใช่ตัวโมเดล ภายใต้เมนู Settings แล้วเลือก Models คุณสามารถวาง key ลงในบัตร DeepSeek หรือผู้ให้บริการในแคตตาล็อก หรือเลือก "Add model provider" จากนั้นเลือก "Custom model API" แล้วระบุ base URL ที่รองรับ OpenAI Chat Completions, OpenAI Responses, Anthropic Messages หรือ Gemini API สำหรับ Ollama server ที่รันในเครื่องจะตอบสนองที่ http://127.0.0.1:11434/v1/ และยอมรับข้อความใดก็ได้ในช่อง API key โดย key จะถูกเก็บไว้ที่ $DSH_HOME/.credentials.yaml ซึ่งค่าเริ่มต้นคือ ~/.dsh/.credentials.yaml

การติดตั้งปลั๊กอินของ DeepSeek Harness จะให้สิทธิ์อะไรแก่ปลั๊กอินบ้าง?

ปลั๊กอินจะได้รับสิทธิ์เท่ากับบัญชีผู้ใช้ที่รัน harness นั้น ปลั๊กอินคือโค้ด Node ที่โหลดเข้าสู่กระบวนการเดียวกัน โดยจุดเชื่อมต่อ (extension points) รวมถึง shell backend, เลเยอร์ระบบไฟล์, tool registry และเหตุการณ์ที่ครอบคลุมการเรียกใช้เครื่องมือทุกอย่าง ไม่มีกลไกใดที่แยกปลั๊กอินออกจากส่วนเหล่านี้ได้ เว้นแต่ปลั๊กอินนั้นจะจัดเตรียม sandbox มาเอง โปรดอ่านซอร์สโค้ดก่อนติดตั้ง และรัน harness ด้วยบัญชีผู้ใช้ที่ไม่มีข้อมูลสำคัญใดๆ อยู่

ฉันควรติดตั้งเวอร์ชันใด และมันจะยังคงทำงานได้ต่อไปหรือไม่?

ควรติดตั้งเวอร์ชันที่ระบุไว้อย่างชัดเจน เช่น npx @deepseek-ai/dsh@0.1.0-rc.6 web ซึ่งเป็นเวอร์ชันเดือนสิงหาคม 2026 ที่ปักหมุดไว้ที่นี่ ณ วันที่ 12 พฤศจิกายน 2026 แท็ก latest ของ npm จะชี้ไปที่ 0.2.2-rc.1 ส่วน GitHub จะแสดงรุ่นทดสอบใหม่กว่าคือ 0.2.2-rc.2 ซึ่งปล่อยเมื่อวันที่ 11 พฤศจิกายน และ CLI ปัจจุบันต้องการ Node 24.9 หรือใหม่กว่า โครงการนี้ระบุว่าเป็นรุ่น developer preview และคาดว่าจะมีการเปลี่ยนแปลงที่ส่งผลต่อความเข้ากันได้ (breaking changes) ดังนั้นคำสั่งที่ไม่ได้ระบุเวอร์ชันอาจทำงานแตกต่างกันไปในแต่ละวัน โปรดตรวจสอบ repository ก่อนทำการอัปเกรด และเตรียมใจว่า config keys และอินเทอร์เฟซของปลั๊กอินอาจมีการเปลี่ยนแปลงตราบใดที่เวอร์ชันยังคงขึ้นต้นด้วย 0

บทความนี้มีประโยชน์หรือไม่