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

วิธีตรวจสอบความปลอดภัย dsh plugin ก่อนติดตั้งใช้งาน

dsh plugin คือ Node package ที่รันโค้ดด้วยสิทธิ์ของ agent โดยตรง เรียนรู้วิธีตรวจสอบสิทธิ์การเข้าถึงไฟล์และระบบก่อนติดตั้ง เพื่อป้องกันความเสี่ยงจากการรันโค้ดภายนอกในสภาพแวดล้อมของคุณ

dsh plugin คืออะไรและทำอะไรได้บ้าง

dsh plugin คือ Node package ที่ DeepSeek Harness โหลดเข้าสู่กระบวนการทำงานของตัวเอง เมื่อโหลดแล้ว plugin จะรันโค้ดของผู้อื่นด้วยสิทธิ์ของ agent ของคุณ บนเครื่องที่ agent ของคุณเข้าถึงได้อยู่แล้ว ขั้นตอนการติดตั้งนั้นมีการป้องกันไว้มากกว่านั้น pnpm จะระงับสคริปต์ build ของ dependency ไว้จนกว่าคุณจะอนุมัติ และคู่มือ CLI ระบุให้ "รีสตาร์ท Profile นั้นหลังจากเพิ่ม ลบ หรืออัปเดต Bundle" ดังนั้น plugin ที่เพิ่มด้วย dsh plugin จะโหลดในการรีสตาร์ทครั้งถัดไป ส่วน plugin ที่ติดตั้งจากหน้าเว็บ Plugins สามารถใช้งานได้ทันที ไม่มีสิ่งใดขวางกั้นระหว่าง plugin ที่โหลดแล้วกับส่วนที่เหลือของ harness ดังนั้นคำถามที่ต้องถามก่อนติดตั้งคือโค้ดนั้นเข้าถึงอะไรได้บ้าง และคุณจะจำกัดขอบเขตให้เล็กที่สุดได้อย่างไร

dsh (DeepSeek Harness) คือ agent harness แบบโอเพนซอร์สของ DeepSeek AI ซึ่งสร้างบนเฟรมเวิร์ก plugin ที่ชื่อว่า Cordis คำกลางนั้นมีความสำคัญมาก เพราะ agent harness คือโปรแกรมที่ครอบตัวโมเดลซึ่งเป็นเจ้าของลูป เครื่องมือ และสิทธิ์ต่างๆ โดย plugin จะเข้าร่วมในระดับเดียวกันนั้นเลย README ของโปรเจกต์ระบุว่าทุกอย่างคือ plugin ตัว adapter ของโมเดลก็เป็น plugin อินเทอร์เฟซเว็บที่คุณพิมพ์โต้ตอบก็เป็น plugin สิ่งใดก็ตามที่คุณติดตั้งจากภายนอกโปรเจกต์จะเข้ามาอยู่ในโครงสร้างเดียวกัน และได้รับความไว้วางใจในระดับเดียวกับส่วนประกอบที่มาพร้อมกับโปรเจกต์ หากคุณยังไม่ได้ติดตั้ง ให้เริ่มจาก DeepSeek Harness บน VPS แล้วค่อยกลับมาที่นี่ก่อนที่คุณจะเพิ่มสิ่งใดเข้าไป

ในเดือนสิงหาคม 2026 AGENTS.md ของ repository ได้ระบุจุดขยาย (extension points) ที่ plugin สามารถเข้าถึงได้ ซึ่งครอบคลุมถึง:

  • LLM (large language model): ผู้ให้บริการที่คุณจ่ายเงินผ่าน API key
  • Shell: ความสามารถในการใช้ bash โดยมีผู้ให้บริการทั้งแบบ local และ pwsh
  • Filesystem: การเข้าถึงไฟล์ที่ควบคุมด้วยนโยบาย
  • Web: ผู้ให้บริการสำหรับการค้นหาและดึงข้อมูล
  • Subprocess: ผู้ให้บริการสำหรับกระบวนการทำงานแบบ process-tree
  • Workflow: เธรดการทำงาน (worker threads)
  • Subagent: การมอบหมายงานให้ agent อื่น
  • Settings and credentials: การตั้งค่าและตัวแปรสภาพแวดล้อมที่คุณบันทึกไว้

รายการดังกล่าวได้ถูกนำออกจาก AGENTS.md แล้ว ณ วันที่ 17 พฤศจิกายน 2026 docs/architecture.md ของโปรเจกต์ได้ระบุชื่อจุดขยายแทน และได้เพิ่ม sandbox backends, persistent terminals, background jobs, human commands และ webhook-triggered sessions เข้าไปในส่วนของ model, tool, shell, filesystem และ subagent

นอกจากนี้ plugin ยังลงทะเบียนเครื่องมือบน ctx.tools และเอกสารระบุไว้อย่างชัดเจนว่า schema ของเครื่องมือที่ลงทะเบียนจะถูกนำไปรวมในการประกอบ prompt ส่วนหลังนี้คือสิ่งที่คนมักมองข้าม plugin สามารถเปลี่ยนสิ่งที่ agent ของคุณตัดสินใจทำได้โดยที่โค้ดของมันเองไม่ต้องทำอะไรผิดปกติ เพราะคำอธิบายที่มันเพิ่มเข้าไปจะกลายเป็นข้อความที่โมเดลอ่าน ซึ่งเป็นปัญหาในรูปแบบเดียวกับ prompt injection ต่อ coding agent โดยมีความแตกต่างเพียงอย่างเดียวคือ ข้อความนี้จะเข้ามาเมื่อคุณติดตั้ง และจะคงอยู่จนกว่าคุณจะลบ plugin นั้นออกไป

dsh ค้นหาและโหลดปลั๊กอินอย่างไร

ไม่มีไดเรกทอรีปลั๊กอินส่วนกลาง dsh ที่กำลังทำงานอยู่คือโครงสร้างปลั๊กอินที่ประกอบขึ้นตอนบูตจากเลเยอร์ที่เรียงลำดับไว้ โดยหน่วยที่เก็บตัวเลือกของคุณคือโปรไฟล์ $DSH_HOME จะใช้ค่าเริ่มต้นเป็น ~/.dsh และแต่ละโปรไฟล์จะอยู่ใน $DSH_HOME/profiles/<name> ส่วนโปรไฟล์ web และ headless จะสร้างตัวเองขึ้นมาในการใช้งานครั้งแรกจากเทมเพลตที่มาพร้อมกับซอฟต์แวร์

ไดเรกทอรีโปรไฟล์ประกอบด้วยไฟล์สองไฟล์ที่กำหนดทุกอย่าง:

  • package.json ซึ่งมีรายการ dependency ของปลั๊กอินที่อยู่นอกโครงสร้างหลัก พร้อมด้วยไฟล์ manifest dsh.profile ที่ระบุรายการ bundles ตามลำดับ
  • cordis.patch.yml ซึ่งเป็นเลเยอร์แพตช์ของคุณเองที่ครอบทับบนบันเดิลเหล่านั้น
ls ~/.dsh
ls ~/.dsh/profiles/web

กระบวนการบูตจะใช้เลเยอร์ตามลำดับนี้ โดยเลเยอร์ที่อยู่หลังสุดจะมีผลเหนือกว่า:

  1. รูทที่ว่างเปล่า
  2. บันเดิลของโปรไฟล์ ตามลำดับที่ระบุไว้ใน manifest
  3. cordis.patch.yml ของโปรไฟล์
  4. $DSH_HOME/cordis.patch.yml
  5. --patch <path> ใดๆ ที่ส่งผ่านทางบรรทัดคำสั่ง

มีแฟล็กสองตัวที่ใช้แสดงผลลัพธ์ของการประกอบเลเยอร์เหล่านี้โดยไม่ต้องเริ่มการทำงานใดๆ:

dsh --profile web --dump-default-config
dsh --profile web --dump-config

--dump-default-config จะแสดงเฉพาะเลเยอร์ของบันเดิล ส่วน --dump-config จะเพิ่มเลเยอร์โปรไฟล์ เลเยอร์แพตช์ในโฮมไดเรกทอรี และ --patch ใดๆ เข้าไปด้วย จึงถือเป็นรายการที่ใกล้เคียงที่สุดกับสิ่งที่การบูตครั้งถัดไปของคุณจะโหลดจริง โปรดอ่านรายการนี้ก่อนที่คุณจะเชื่อใจเครื่องที่คุณได้รับสืบทอดมา

คำเตือนประการหนึ่งเกี่ยวกับไฟล์แพตช์เหล่านั้น การตั้งค่าในที่นี้ไม่ใช่ข้อมูลที่อยู่นิ่ง เนื่องจากรูปแบบไฟล์อนุญาตให้มีค่าที่ติดแท็ก !!js ภายใต้บล็อก config ของปลั๊กอินได้ ดังนั้นสคริปต์ cordis.patch.yml ที่คัดลอกมาจากโพสต์ในฟอรัมถือเป็นโค้ด โปรดปฏิบัติต่อมันเช่นเดียวกับที่คุณปฏิบัติต่อเชลล์สคริปต์จากแหล่งที่มาเดียวกัน

dsh plugin add ทำงานอย่างไร

dsh plugin --profile <name> <args> จะส่งต่ออาร์กิวเมนต์ไปยัง pnpm ภายในไดเรกทอรีของโปรไฟล์นั้น ดังนั้น pnpm จึงต้องอยู่ใน PATH โดยคำสั่งที่ใช้จะเป็นคำสั่งของ pnpm เอง:

dsh plugin --profile web add '<package-or-git-spec>'
dsh plugin --profile web remove '<package-name>'
dsh plugin --profile web why '<package-name>'
dsh plugin --profile web update

ดังนั้น รูปแบบความปลอดภัยของการติดตั้ง dsh plugin จึงเป็นรูปแบบเดียวกับการติดตั้ง dependency สไตล์ npm เพิ่มเติมด้วยขั้นตอนพิเศษที่ผลลัพธ์จะถูกโหลดเข้าสู่ agent ของคุณ แพ็กเกจจะนำ dependency tree ของตัวเองมาด้วย และทุกแพ็กเกจใน tree นั้นจะทำงานในกระบวนการเดียวกัน ทุกสิ่งที่ระบุไว้ใน วิธีที่การโจมตีห่วงโซ่อุปทานของ npm เข้าถึงเซิร์ฟเวอร์ สามารถนำมาปรับใช้ได้โดยไม่ต้องแก้ไข

pnpm เวอร์ชัน 10 ขึ้นไปจะไม่รัน build script ของ dependency โดยค่าเริ่มต้น และการอนุมัติจะทำเป็นรายแพ็กเกจผ่าน pnpm approve-builds หรือการตั้งค่า allowBuilds โดย pnpm 11 ได้เปลี่ยนการตั้งค่า onlyBuiltDependencies แบบเดิมเป็น allowBuilds ดังนั้นคู่มือหรือการตั้งค่าเก่าที่ยังใช้ onlyBuiltDependencies จะไม่เป็นการอนุมัติสิ่งใดใน pnpm เวอร์ชันปัจจุบัน โปรดตรวจสอบเวอร์ชัน pnpm ของคุณ:

pnpm --version

ปลั๊กอินที่โฮสต์บน Git คือจุดแรกที่คุณจะพบกับเรื่องนี้ เอกสารอ้างอิง CLI ระบุว่าปลั๊กอิน Git ที่ส่งมอบซอร์สโค้ดจะทำการ build ระหว่างการติดตั้งผ่านสคริปต์ prepare ดังนั้นการรัน add ครั้งแรกจะล้มเหลวพร้อมคำแนะนำ allowBuilds ของ pnpm ให้คุณคัดลอกคีย์ที่แสดงขึ้นมาไปใส่ใน pnpm-workspace.yaml ของโปรไฟล์แล้วรันคำสั่งใหม่อีกครั้ง การอนุมัติคีย์นั้นจะอนุญาตให้สคริปต์ build ของ repository ทำงานด้วยสิทธิ์ของผู้ใช้คุณ ส่วน tarball ที่ build มาแล้วและ local checkout ไม่จำเป็นต้องได้รับการอนุญาต

ค่าเริ่มต้นนี้เป็นสิ่งที่ควรมี และยังเป็นฟีเจอร์ความปลอดภัยที่ถูกมองข้ามมากที่สุดในระบบนิเวศนี้ การบล็อก build script จะหยุดไม่ให้โค้ดทำงานระหว่างการติดตั้ง แต่ไม่ได้ทำอะไรกับตัวปลั๊กอินเอง เพราะจุดประสงค์หลักของปลั๊กอินคือการที่ harness นำเข้าและเรียกใช้งานเมื่อโปรไฟล์รีสตาร์ท หรือทันทีที่การติดตั้งมีผลเมื่อคุณใช้หน้า Plugins บนเว็บ ปลั๊กอินไม่จำเป็นต้องมี hook postinstall เพราะมันได้รับเชิญให้เข้ามาทำงานอยู่แล้ว

สิ่งที่ควรอ่านก่อนติดตั้ง dsh plugin

ดาวน์โหลด tarball ที่เผยแพร่แล้วอ่านเนื้อหาภายใน การแตกไฟล์เก็บถาวรไม่ได้เป็นการเรียกใช้งานโปรแกรมใดๆ

npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.json

ฟิลด์ทั้ง 4 ใน package.json จะบอกข้อมูลส่วนใหญ่ที่คุณจำเป็นต้องทราบ ให้อ่าน scripts เพื่อดูรายการ preinstall, install และ postinstall ให้อ่าน dependencies สำหรับชื่อที่คุณไม่คุ้นเคย หรือชื่อที่สะกดคล้ายกับชื่อที่คุณรู้จัก ให้อ่าน bin สำหรับสิ่งที่แพ็กเกจต้องการเพิ่มลงใน PATH ของคุณ ให้อ่าน main หรือ exports เพื่อดูไฟล์เริ่มต้น จากนั้นเปิดไฟล์ดังกล่าวและปฏิบัติตามขั้นตอนที่ระบุไว้

จากนั้นให้อ่านโค้ดที่จะถูกโหลดขึ้นมาทำงานจริง ปลั๊กอินที่โฆษณาว่าเป็นเครื่องมือแจ้งเตือนไม่มีเหตุผลอันควรที่จะต้องอ่าน ~/.ssh, ติดต่อไปยังโฮสต์ที่คุณไม่เคยรู้จัก หรือเรียกใช้ shell หากแพ็กเกจนั้นมีเพียง JavaScript ที่ถูกรวมหรือย่อขนาด (minified) มาให้โดยไม่มีซอร์สโค้ดที่ตรงกันใน repository สาธารณะ นั่นคือคำตอบของคุณแล้ว ให้เลือกใช้ปลั๊กอินที่คุณสามารถอ่านซอร์สโค้ดได้ และควรเลือกปลั๊กอินที่มีขนาดเล็ก

คุณยังสามารถตรวจสอบข้อมูลจาก registry ได้โดยไม่ต้องติดตั้งสิ่งใด:

pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versions

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

กำหนดเวอร์ชันให้คงที่และเก็บไฟล์ lockfile ไว้

การใช้ช่วงเวอร์ชันแบบลอยตัว (floating version range) หมายความว่าโค้ดภายในกระบวนการทำงานของ agent อาจเปลี่ยนแปลงได้ทุกครั้งที่มีการติดตั้งหรืออัปเดตโดยที่คุณไม่ได้เป็นผู้ตัดสินใจ ดังนั้นคุณควรระบุเวอร์ชันให้คงที่ (pin)

dsh plugin --profile web add --save-exact '<package-name>@<version>'

ตำแหน่งของ flag อาจแตกต่างกันไปตามเวอร์ชันของ pnpm ดังนั้นให้ตรวจสอบผลลัพธ์แทนการเชื่อคำสั่งเพียงอย่างเดียว หลังจากนั้นให้เปิดไฟล์ package.json ของโปรไฟล์ขึ้นมาดู และยืนยันว่า dependency นั้นแสดงเป็นเลขเวอร์ชันตรงๆ โดยไม่มีสัญลักษณ์ ^ หรือ ~ นำหน้า ไฟล์ดังกล่าวจะเป็นตัวตัดสินว่าสิ่งที่ติดตั้งลงไปคืออะไร

จากนั้นให้เก็บไฟล์ lockfile ไว้ ซึ่งไฟล์นี้จะทำหน้าที่ล็อกโครงสร้าง dependency ทั้งหมดแบบ transitive ไม่ใช่แค่ชื่อแพ็กเกจระดับบนสุดเท่านั้น:

find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'

คัดลอกไฟล์นี้ไปยังที่ที่คุณสำรองข้อมูลไว้ พร้อมกับไฟล์ package.json ของโปรไฟล์ ไฟล์ทั้งสองนี้จะช่วยให้คุณสร้างโครงสร้างเดิมขึ้นมาใหม่บนเครื่องอื่นได้ ให้รันคำสั่ง dsh plugin --profile web update เฉพาะเมื่อคุณตัดสินใจที่จะเปลี่ยนเวอร์ชันเท่านั้น อย่าทำเป็นกิจวัตรเพื่อจัดระเบียบ และให้ตรวจสอบความแตกต่างในไฟล์ lockfile หลังจากรันคำสั่งเสมอ

สำหรับปลั๊กอินที่ติดตั้งจาก git แทนที่จะเป็น registry ให้ระบุเจาะจงที่ commit แทนการใช้ชื่อ branch การระบุเวอร์ชันในรูปแบบ github:owner/repo#<full commit sha> จะทำให้คุณได้โครงสร้างที่คงที่ แต่การใช้ชื่อ branch จะทำให้คุณได้รับโค้ดล่าสุดที่ branch นั้นถือครองอยู่ในการแก้ไข dependency ครั้งถัดไปของ pnpm ซึ่งเป็นการตัดสินใจที่คุณได้มอบอำนาจให้ผู้อื่นไปแล้ว ตัวระบบ harness เองก็ต้องการวินัยในลักษณะเดียวกัน เนื่องจาก npm latest เป็นรุ่น release candidate และการติดตั้งโดยไม่ระบุเวอร์ชันให้คงที่อาจทำให้ได้เวอร์ชันที่แตกต่างกันในแต่ละวัน ซึ่งเป็นสาเหตุหลักของ ข้อผิดพลาดในการติดตั้งและเวอร์ชันของ dsh ส่วนใหญ่

ตลาดปลั๊กอินและคุณค่าของคำว่า "ผ่านการคัดสรร"

dsh มีตลาดปลั๊กอินและติดตั้งในรูปแบบปลั๊กอิน ซึ่งสะท้อนให้เห็นถึงสถาปัตยกรรมของระบบ:

dsh plugin --profile web add dshmarket

หลังจากรีสตาร์ท ปลั๊กอินจะปรากฏเป็นแท็บในหน้า Plugins ถัดจากแท็บ Installed สำหรับ dsh เวอร์ชัน 0.2.1 ขึ้นไป ส่วนโฮสต์รุ่นเก่าให้ไปที่ Settings แล้วเลือก Plugin Market ไฟล์ README ระบุข้อจำกัดไว้อย่างชัดเจน การติดตั้งจะจำกัดเฉพาะแหล่งที่มาที่อยู่ใน registry ที่ผ่านการคัดสรรแล้วเท่านั้น และจะปฏิเสธแหล่งที่มาอื่นทั้งหมด สคริปต์การ build จะถูกบล็อกโดยค่าเริ่มต้น และการเปิดใช้งานสคริปต์ต้องได้รับการอนุมัติเป็นรายแพ็กเกจ ปลั๊กอินประเภท Terminal จะถูกทำเครื่องหมายแจ้งเตือนก่อนที่จะนำไปใช้ใน web profile ประโยคที่สำคัญที่สุดคือการระบุว่าการมีชื่ออยู่ในรายการไม่ได้หมายถึงการรับรอง เนื่องจากปลั๊กอินเป็นโค้ดจากบุคคลที่สาม README ฉบับเดียวกันระบุว่าปลั๊กอินส่วนใหญ่ที่ติดตั้งผ่านช่องทางนี้จะเริ่มทำงานได้ทันทีหลังจากรีเฟรชหน้าเว็บโดยไม่ต้องรีสตาร์ท ดังนั้นการติดตั้งแบบคลิกเดียวอาจทำให้โค้ดทำงานภายในเอเจนต์ของคุณได้ในเวลาเพียงไม่กี่วินาที

รายการที่ผ่านการคัดสรรช่วยยกระดับมาตรฐานขั้นต่ำ แต่ไม่ได้หมายความว่าจะมีการอ่านโค้ดแทนคุณ และไม่สามารถบอกได้ว่าปลั๊กอินเวอร์ชันถัดไปจะทำอะไรหลังจากบัญชีผู้ดูแลเปลี่ยนมือ ให้ปฏิบัติต่อการติดตั้งแบบคลิกเดียวเช่นเดียวกับที่คุณปฏิบัติต่อ curl | bash จากผู้เขียนคนเดียวกัน มีอีกหนึ่งบรรทัดจาก README ที่ควรย้ำเตือน: ไฟล์สำรองที่ export ออกมาอาจมีข้อมูลประจำตัว (credentials) จากการตั้งค่าโปรไฟล์ของคุณ ดังนั้นห้ามแนบไฟล์ดังกล่าวกับประเด็นปัญหา (issue) สาธารณะหรือเว็บไซต์วางข้อความ (paste site) หากคุณต้องการรายการเริ่มต้นแทนที่จะเป็นวิธีการติดตั้ง ปลั๊กอิน dsh ที่น่าติดตั้ง คือบทความที่ควรอ่านคู่กันกับบทความนี้

ปัจจุบันตัว harness มีเส้นทาง (route) ของตัวเองเช่นกัน โดยมีฟีเจอร์ทดลอง Custom plugin indexes bundle ซึ่งเปิดใช้งานได้จากหน้า Plugins ฟีเจอร์นี้จะเพิ่มแท็บ Discover ที่ดึงข้อมูลจากไฟล์ดัชนีที่คุณเพิ่มเข้าไปเอง dsh ไม่ได้จัดเตรียมแหล่งที่มาของดัชนีไว้ให้ และเอกสารระบุว่าดัชนีเป็นเนื้อหาจากบุคคลที่สาม โดย dsh จะตรวจสอบเพียงรูปแบบไฟล์เท่านั้น แต่จะไม่ตรวจสอบสิ่งที่ดัชนีกล่าวอ้างเกี่ยวกับชื่อปลั๊กอิน ผู้เขียน หรือแหล่งที่มา

เรียกใช้งาน dsh ด้วยผู้ใช้ของตนเอง ไม่ใช่ root

การตรวจสอบอย่างละเอียดช่วยลดโอกาสที่สิ่งไม่พึงประสงค์จะหลุดรอดเข้ามา ส่วนหลักการให้สิทธิ์น้อยที่สุด (least privilege) จะเป็นตัวกำหนดขอบเขตความเสียหายหากเกิดเหตุการณ์ดังกล่าวขึ้น บน VPS การตั้งค่าส่วนหลังนี้ทำได้ง่ายและมีต้นทุนต่ำ

สร้างบัญชีผู้ใช้ unix แยกต่างหากสำหรับ harness พร้อม home directory ของตนเอง และห้ามเรียกใช้งานด้วยสิทธิ์ root โดยเด็ดขาด:

sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrun

ภายใน session นั้น ให้เริ่มการทำงานของ harness เพื่อให้มันเขียนข้อมูลลงใน home directory ของบัญชีผู้ใช้นั้น:

npx @deepseek-ai/dsh web

โดยปกติแล้ว web UI จะให้บริการบน http://127.0.0.1:3080 ให้คงค่าเดิมไว้ หากคุณเคยคลิกลิงก์ที่แสดงผลบนเครื่องอื่นแล้วไม่สามารถเข้าถึงได้ ความหมายของ dsh เมื่อแสดงที่อยู่นั้น จะอธิบายสาเหตุให้ทราบ องค์ประกอบของเว็บที่มาพร้อมกับโปรแกรมจะตรวจสอบ Host และ Origin header และกำหนดให้ต้องมีการยืนยันตัวตนผ่านเบราว์เซอร์หรือ API Peer สำหรับทุก Host RPC method และ WebSocket stream นอกจากนี้ dsh web จะปฏิเสธ --host 0.0.0.0 ผู้เรียกใช้ API จะต้องยืนยันตัวตนผ่าน /connect และได้รับ API cookie ที่มีการลงนามไว้ ให้ถือว่าการล็อกอินนี้เป็นปราการด่านที่สอง ไม่ใช่เหตุผลที่จะเปิดพอร์ต 3080 สู่สาธารณะ เบื้องหลังนั้นมี agent ที่เข้าถึง shell ได้ ดังนั้นหาก session token รั่วไหลหรือมีช่องโหว่ในการล็อกอินบนพอร์ตสาธารณะ ผู้ไม่หวังดีจะได้รับสิทธิ์ remote shell ที่ไม่มีสิทธิ์ root แต่มีอินเทอร์เฟซที่ใช้งานง่าย ให้เข้าถึงผ่าน SSH tunnel จากแล็ปท็อปของคุณแทน:

ssh -L 3080:127.0.0.1:3080 you@your-vps

จากนั้นตรวจสอบให้แน่ใจว่าไม่มีบริการใดกำลังฟังการเชื่อมต่อบน public address:

ss -lnt | grep 3080

ที่อยู่ local ควรแสดงเป็น 127.0.0.1:3080 หากแสดงเป็น 0.0.0.0:3080 แสดงว่ามีบางอย่างนอกเหนือจากค่าเริ่มต้นของ dsh web เป็นผู้กำหนดค่าดังกล่าว เช่น การตั้งค่า composition แบบอื่นหรือการแก้ไข config ซึ่ง composition นั้นจะต้องรับผิดชอบการยืนยันตัวตนด้วยตนเอง เอกสารของโปรเจกต์ระบุว่าเว็บเซิร์ฟเวอร์พื้นฐานไม่มีระบบยืนยันตัวตนหรือนโยบาย Origin ของตนเอง ดังนั้นจนกว่าคุณจะทราบแน่ชัดว่าสิ่งใดทำหน้าที่ป้องกันพอร์ตนั้นอยู่ ให้สันนิษฐานว่า firewall ของคุณเป็นปราการด่านเดียวที่กั้นระหว่างคนแปลกหน้ากับ agent ของคุณ และให้ย้ายกลับไปที่ loopback เหตุผลเบื้องหลัง การเรียกใช้งาน Claude Code บน VPS อย่างปลอดภัย สามารถนำมาปรับใช้กับ dsh ได้โดยตรง ให้สิทธิ์ agent เข้าถึงได้เพียงไดเรกทอรี workspace เดียวที่ยอมรับได้หากจะเสียหาย และเก็บข้อมูลใดก็ตามที่คุณไม่สามารถสร้างใหม่ได้ไว้ภายนอกเครื่องนั้น หรือทางที่ดีกว่าคือมองว่าเครื่องนั้นเป็น VM แบบใช้แล้วทิ้งสำหรับ coding agent เพราะการสร้าง VPS ใหม่ใช้เวลาเพียงหนึ่งชั่วโมง ในขณะที่การตรวจสอบความปลอดภัยของเครื่องหนึ่งเครื่องอาจใช้เวลาถึงหนึ่งสัปดาห์

ตำแหน่งที่เก็บคีย์ของคุณ และเหตุผลที่สิทธิ์ของไฟล์มีข้อจำกัด

dsh เก็บ API keys ไว้ใน $DSH_HOME/.credentials.yaml และค่า environment ไว้ใน $DSH_HOME/.env โดยมีการตั้งค่าโมเดลอยู่ใน cordis.patch.yml ของโปรไฟล์ที่ใช้งานอยู่ เมื่อคู่มือนี้ได้รับการตรวจสอบครั้งแรกในเดือนตุลาคม 2026 ไฟล์ $DSH_HOME/settings.yaml จากรุ่นก่อนหน้าถูกนำเข้ามาหนึ่งครั้งและเปลี่ยนชื่อเป็น settings.yaml.imported คีย์ใดควรอยู่ในไฟล์ใด และข้อมูลใดที่ถูกส่งออกจากเครื่องในแต่ละโหมด เป็นหัวข้อของ การกำหนดค่า API keys, โมเดล และ endpoint ของ dsh ซึ่งควรจัดการให้เรียบร้อยก่อนที่คุณจะเพิ่มปลั๊กอิน เพราะทุกคีย์ที่คุณเชื่อมต่อเข้าไปคือสิ่งที่ปลั๊กอินสามารถอ่านได้ ให้จำกัดสิทธิ์ไฟล์สำคัญทั้งสองไฟล์ดังนี้:

chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dsh

โหมด 600 ให้สิทธิ์เจ้าของในการอ่านและเขียน และไม่ให้สิทธิ์ผู้อื่นเลย ซึ่งเป็นสิ่งที่ควรทราบทั้งในรูปแบบตัวเลขและสัญลักษณ์ (โหมด chmod แบบตัวเลขเทียบกับแบบสัญลักษณ์) จงตระหนักถึงสิ่งที่โหมดนี้ทำได้จริง สิทธิ์ของไฟล์ช่วยป้องกันไฟล์เหล่านั้นจากบัญชีผู้ใช้อื่นบนเครื่อง แต่ไม่มีผลใดๆ ต่อปลั๊กอิน เพราะปลั๊กอินทำงานในฐานะผู้ใช้ที่เป็นเจ้าของไฟล์และอยู่ภายในกระบวนการที่อ่านไฟล์เหล่านั้น นั่นคือเหตุผลที่ การเก็บความลับให้พ้นจากมือของ AI agent หมายถึงการไม่เก็บความลับเหล่านั้นไว้บนเครื่องเลย เครื่องที่รัน dsh ควรเก็บเฉพาะคีย์ของโมเดลที่จำเป็นต้องใช้เท่านั้น ส่วนข้อมูลรับรองระบบคลาวด์และคีย์สำหรับลงนามของคุณควรเก็บไว้ที่อื่น

เหตุใดปลั๊กอินที่อ่านเว็บจึงเปลี่ยนรูปแบบภัยคุกคาม

จุดเชื่อมต่อเว็บ (Web seam) ช่วยให้ปลั๊กอินสามารถค้นหาและดึงข้อมูลจากผู้ให้บริการได้ ปลั๊กอินที่ดึงหน้าเว็บเข้ามาในเซสชันของคุณกำลังดึงข้อความที่ผู้โจมตีสามารถเขียนขึ้นมาได้ เนื่องจาก prompt ของโมเดลไม่ได้แยกคำสั่งออกจากข้อมูล หน้าเว็บที่ถูกดึงมาจึงอาจมีบรรทัดที่ระบุถึงเอเจนต์ของคุณ และระบบที่ถือความสามารถในการเข้าถึง shell ก็อยู่ห่างจากการรันคำสั่งดังกล่าวเพียงขั้นตอนเดียวเท่านั้น

การควบคุมมีอยู่แล้วในระบบ dsh-base ซึ่งเป็นชุดคำสั่งแรกที่ใช้ร่วมกันของโปรไฟล์ web, headless, sdk และ acp โดยมาพร้อมกับ sandbox และนโยบายการอนุมัติ (โปรไฟล์ sdk-minimal จงใจละส่วนนี้ไว้) ให้ใช้งานส่วนนี้เสีย เซสชันที่สามารถดึงหน้าเว็บที่ไม่น่าเชื่อถือควรต้องมีการอนุมัติสำหรับทุกสิ่งที่เขียนหรือรัน เพื่อไม่ให้คำสั่งที่ดึงมากลายเป็นการกระทำด้วยตัวมันเอง การจำกัดการกระทำของเอเจนต์ด้วยการอนุมัติ ครอบคลุมถึงวิธีคิดเกี่ยวกับการกำหนดขอบเขตดังกล่าว ความสัมพันธ์นี้ทำงานในทั้งสองทิศทางเช่นกัน เนื่องจากเซิร์ฟเวอร์ของคุณเองก็เป็นหน้าเว็บที่เอเจนต์ของผู้อื่นจะเข้ามาดึงข้อมูล ซึ่งเป็นกรณีที่กล่าวถึงใน การบล็อก AI crawler บนเซิร์ฟเวอร์ของคุณ

ฉันจะตรวจสอบได้อย่างไรว่าปลั๊กอินมีการเปลี่ยนแปลงอะไรบ้าง?

ให้ทำ snapshot ก่อนติดตั้ง ทำการติดตั้ง แล้วทำ snapshot อีกครั้ง จากนั้นจึงอ่านค่าความแตกต่าง

dsh --profile web --dump-config > /tmp/dsh-before.txt
dsh plugin --profile web add '<package-name>@<version>'
dsh --profile web --dump-config > /tmp/dsh-after.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after.txt

ค่า diff จะแสดงให้เห็นว่าการติดตั้งได้เพิ่มรายการปลั๊กอินใดเข้าไปในโครงสร้างที่ประกอบขึ้นมาบ้าง เฉพาะแพ็กเกจที่ประกาศ bundle patch เท่านั้นที่จะถูกรวมเข้ากับโครงสร้างนี้ ส่วน dependency ทั่วไปจะไม่เพิ่มสิ่งใดลงไป และ dsh จะแจ้งเตือนเกี่ยวกับเรื่องนี้หนึ่งครั้ง หากคุณติดตั้งปลั๊กอินเพื่อใช้งานฟีเจอร์เล็กๆ เพียงอย่างเดียว แต่ปลั๊กอินนั้นกลับเพิ่มรายการเข้ามาหลายรายการที่คุณไม่สามารถระบุที่มาได้ นั่นเป็นเหตุผลที่คุณควรหยุดและอ่านซอร์สโค้ดก่อนที่จะบูตระบบ dsh plugin --profile web why <package-name> จะตอบคำถามอีกข้อหนึ่งคือ: dependency โดยตรงตัวใดของคุณที่เป็นตัวดึงแพ็กเกจนั้นเข้ามา

แพ็กเกจที่ติดตั้งแล้วจะถูกจัดเก็บไว้ใน node_modules ของโปรไฟล์เอง ที่ตำแหน่ง $DSH_HOME/profiles/<name>/node_modules ดังนั้นคุณจึงสามารถตรวจสอบโครงสร้างบนดิสก์ได้เช่นกัน:

ls ~/.dsh/profiles/web/node_modules

ให้เก็บโปรไฟล์สำรองไว้อีกหนึ่งโปรไฟล์ที่คุณจะไม่นำมาใช้ทดลอง เมื่อการติดตั้งทำให้ระบบเสียหาย การบูตด้วย dsh --profile <clean-name> จะช่วยให้คุณทราบได้ภายในไม่กี่วินาทีว่าปลั๊กอินเป็นสาเหตุของปัญหาหรือไม่

ฉันจะลบปลั๊กอิน dsh ได้อย่างไร

dsh plugin --profile web remove '<package-name>'
dsh --profile web --dump-config > /tmp/dsh-after-removal.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after-removal.txt

การลบ dependency ไม่ได้หมายความว่าจะลบการตั้งค่าออกเสมอไป รายการที่ถูกเขียนลงใน cordis.patch.yml ของโปรไฟล์จะยังคงอยู่ที่เดิม เนื่องจากไฟล์นั้นเป็นของคุณและระบบจะไม่เขียนทับให้โดยอัตโนมัติ ให้เปิดไฟล์ดังกล่าวแล้วลบบล็อกที่ระบุชื่อแพ็กเกจที่คุณต้องการนำออก

less ~/.dsh/profiles/web/cordis.patch.yml

จากนั้นให้จัดการในส่วนที่ไม่มีคำสั่งถอนการติดตั้งใดแก้ไขได้ หากคุณลบปลั๊กอินเพราะไม่ไว้วางใจอีกต่อไป ข้อมูลใดก็ตามที่ปลั๊กอินนั้นสามารถอ่านได้ ถือว่าถูกอ่านไปเรียบร้อยแล้ว ให้หมุนเวียน (rotate) DeepSeek API key ในคอนโซลของผู้ให้บริการ และหมุนเวียนข้อมูลอื่นใดก็ตามที่เคยอยู่ใน $DSH_HOME จากนั้นให้ตรวจสอบว่าบัญชีผู้ใช้ unix ที่ปลั๊กอินนั้นใช้รันอยู่ สามารถเข้าถึงส่วนใดของเครือข่ายคุณได้บ้าง

สรุปโดยย่อ

  • อ่าน tarball ที่เผยแพร่ก่อนทำการติดตั้ง โดยเริ่มจาก scripts และไฟล์ entry
  • ระบุเวอร์ชันที่แน่นอน หรือระบุ commit ที่แน่นอนสำหรับ git spec และเก็บ lockfile ไว้
  • ติดตั้งลงใน profile เดียว และรักษา profile ที่สะอาดไว้เพื่อให้สามารถบูตเข้าใช้งานได้เมื่อเกิดปัญหา
  • ตรวจสอบความแตกต่างของ --dump-config ก่อนและหลังการติดตั้งทุกครั้ง
  • รัน harness ในฐานะผู้ใช้ unix ของตนเอง บน loopback และเข้าถึงผ่าน SSH
  • เก็บ API key ไว้บนเครื่องเพียงชุดเดียว และหมุนเวียนคีย์ในวันที่คุณลบปลั๊กอินที่ไม่น่าเชื่อถือออก

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

FAQ

dsh มีการทำ sandbox แยกปลั๊กอินออกจากกันหรือไม่?

ไม่มี ปลั๊กอินจะถูกโหลดเข้าสู่กระบวนการ harness ผ่านทาง Cordis และสามารถเข้าถึงส่วนเชื่อมต่อความสามารถที่ระบุไว้ได้ทั้งหมด รวมถึง shell, ระบบไฟล์, เว็บ, subprocess, subagent และ credentials โดย dsh-base ซึ่งเป็น bundle แรกที่ใช้ร่วมกันของโปรไฟล์ web, headless, sdk และ acp จะเป็นตัวจัดส่ง sandbox และนโยบายการอนุมัติที่ควบคุมว่าเครื่องมือของ agent สามารถทำอะไรได้บ้าง และนโยบายดังกล่าวคือจุดที่ให้การปกป้องแก่คุณ ทั้งนี้ไม่มีการแบ่งขอบเขตสิทธิ์รายปลั๊กอิน ดังนั้นรูปแบบที่ถูกต้องคือการติดตั้งปลั๊กอินถือเป็นการขยายความไว้วางใจของคุณไปยังผู้เขียนปลั๊กอินนั้นและทุกแพ็กเกจใน dependency tree ของมัน

ฉันสามารถติดตั้งปลั๊กอิน dsh โดยไม่รันสคริปต์ติดตั้งได้หรือไม่?

pnpm 10 ขึ้นไปจะบล็อกสคริปต์การ build ของ dependency โดยค่าเริ่มต้น และเนื่องจาก dsh plugin ... add ส่งคำสั่งต่อไปยัง pnpm ดังนั้นใน pnpm เวอร์ชันปัจจุบัน การติดตั้งจะไม่รันสคริปต์ของแพ็กเกจเว้นแต่คุณจะอนุมัติแพ็กเกจนั้น คุณสามารถตรวจสอบเวอร์ชันได้ด้วย pnpm --version อย่างไรก็ตาม สิ่งนี้ไม่ได้ทำให้ปลั๊กอินที่ไม่ได้ตรวจสอบมีความปลอดภัย โค้ดของปลั๊กอินจะทำงานทันทีที่ harness โหลดมันขึ้นมา ในการรีสตาร์ทโปรไฟล์ครั้งถัดไปหลังจากติดตั้งด้วย dsh plugin หรือมักจะทำงานทันทีหลังติดตั้งจากหน้า Plugins บนเว็บ ซึ่งไม่มีข้อจำกัดในขณะติดตั้งใดๆ ที่ส่งผลต่อการทำงานนี้

ปลั๊กอิน dsh และไฟล์ตั้งค่าของมันถูกจัดเก็บไว้ที่ไหน?

$DSH_HOME มีค่าเริ่มต้นอยู่ที่ ~/.dsh โดยโปรไฟล์จะอยู่ใน $DSH_HOME/profiles/<name> ซึ่งแต่ละโปรไฟล์จะเก็บ package.json ที่มี dependency ของปลั๊กอิน รวมถึง manifest dsh.profile ของ bundle ที่เรียงลำดับไว้ และเลเยอร์ patch cordis.patch.yml แพ็กเกจที่ติดตั้งจะถูกเก็บไว้ใน node_modules ของแต่ละโปรไฟล์ที่ $DSH_HOME/profiles/<name>/node_modules ส่วนกุญแจจะอยู่ใน $DSH_HOME/.credentials.yaml, ค่า environment อยู่ใน $DSH_HOME/.env และไฟล์ $DSH_HOME/cordis.patch.yml ระดับ home จะถูกนำมาใช้ครอบคลุมทุกโปรไฟล์ ให้รัน dsh --profile web --dump-config เพื่อดูผลลัพธ์ที่รวมกันแล้วโดยไม่ต้องบูตระบบ

การติดตั้งจาก dsh plugin market ปลอดภัยหรือไม่?

Market จะจำกัดการติดตั้งเฉพาะแหล่งที่มาจาก registry ที่ผ่านการคัดกรองและบล็อกสคริปต์การ build เว้นแต่คุณจะอนุมัติเป็นรายแพ็กเกจ ซึ่งถือเป็นการปรับปรุงที่ดีกว่าการคัดลอกชื่อแพ็กเกจจากหน้าต่างแชทมาวาง อย่างไรก็ตาม README ของ market ยังคงระบุว่าการแสดงรายการไม่ได้หมายถึงการรับรอง เนื่องจากปลั๊กอินเป็นโค้ดของบุคคลที่สามจากผู้อื่น คุณควรตรวจสอบซอร์สโค้ดและระบุเวอร์ชันให้ชัดเจน (pin version) และควรเก็บ harness ไว้ในบัญชีผู้ใช้ หรือถ้าเป็นไปได้คือบนเครื่องที่คุณสามารถยอมรับความเสี่ยงหากเกิดความเสียหายได้

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