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

วิธีเข้าใช้งาน DeepSeek Harness Web UI ที่ 127.0.0.1:3080

พบข้อความแจ้งเตือน 127.0.0.1:3080 บน VPS ใช่หรือไม่ สาเหตุเกิดจาก Web UI ผูกไว้กับ localhost เท่านั้น เรียนรู้วิธีเชื่อมต่อผ่าน SSH Tunnel อย่างปลอดภัยแทนการเปิดพอร์ต

ความหมายของ dsh web: http://127.0.0.1:3080

เมื่อคุณเริ่มใช้งานโปรไฟล์เว็บของ DeepSeek Harness บน VPS ระบบจะแสดงข้อความบรรทัดหนึ่งแล้วหยุดรอ:

dsh web: http://127.0.0.1:3080/?token=...

127.0.0.1 คือ loopback address ซึ่งเป็นที่อยู่ที่เครื่องใช้เพื่อสื่อสารกับตัวเอง Socket ที่ผูกกับ 127.0.0.1 จะยอมรับการเชื่อมต่อจากโพรเซสที่อยู่บนเครื่องเดียวกันเท่านั้น ไม่รับจากที่อื่น ดังนั้นบรรทัดดังกล่าวจึงบอกข้อมูลสองอย่างพร้อมกัน คือตำแหน่งที่ Web UI กำลังรอรับการเชื่อมต่อ และใครบ้างที่ได้รับอนุญาตให้เข้าถึง ซึ่งก็คือเฉพาะเครื่องที่ dsh กำลังทำงานอยู่เท่านั้น ส่วน ?token= ที่ต่อท้ายคือข้อมูลรับรองแบบสุ่มที่สร้างขึ้นใหม่ทุกครั้งที่โพรเซสเริ่มต้น ซึ่งจะมีรายละเอียดเพิ่มเติมในหัวข้อถัดไป

นี่คือเหตุผลว่าทำไม URL ดังกล่าวจึงใช้งานไม่ได้เมื่อคุณนำไปวางในเบราว์เซอร์บนแล็ปท็อปของคุณ เพราะ 127.0.0.1 ของแล็ปท็อปคือตัวแล็ปท็อปเอง ในขณะที่ Harness กำลังรอรับการเชื่อมต่ออยู่ที่ 127.0.0.1 ของ VPS ซึ่งเป็นคนละเครื่องและมี loopback stack แยกจากกัน ไม่ได้มีอะไรเสียหาย คุณเพียงแค่ต้องส่งผ่านการเชื่อมต่อข้ามมาเท่านั้น

README อย่างเป็นทางการระบุค่าเริ่มต้นไว้อย่างชัดเจนว่า: "คำสั่งจะเริ่ม Web UI ที่ http://127.0.0.1:3080 โดยค่าเริ่มต้น และเปิดในเบราว์เซอร์หลักสำหรับการใช้งานในเครื่อง" แต่เมื่อใช้งานผ่าน SSH จะไม่มีเบราว์เซอร์ให้เปิด URL จึงแสดงไว้เพื่อให้คุณนำไปใช้งานด้วยตนเอง ที่อยู่สำหรับ bind มาจากปลั๊กอินโฮสต์ของเว็บเซิร์ฟเวอร์คือ @deepseek-ai/dsh-host-webserver ในรุ่น 0.2.0-rc.2 ที่คู่มือนี้กำหนดไว้ คีย์ host ถูกระบุไว้ว่า "Listen host; ค่าที่รองรับมีสองค่าคือ loopback และ all-interfaces" โดยค่าเริ่มต้นจะเป็น loopback เว้นแต่คุณจะเข้าไปเปลี่ยน หากคุณยังไม่คุ้นเคยกับพอร์ต การทำงานของพอร์ตบน Linux จะอธิบายถึงรูปแบบที่อยู่รวมกับพอร์ตซึ่งเป็นพื้นฐานของเรื่องนี้ทั้งหมด

เหตุใด Web UI จึงผูกไว้กับ localhost เท่านั้น

dsh เป็น agent harness ซึ่งเป็น โปรแกรมที่ครอบตัวโมเดลไว้ โดยทำหน้าที่ควบคุมลูป การเรียกใช้เครื่องมือ และสิทธิ์ที่การเรียกเหล่านั้นทำงานภายใต้ แท็บเบราว์เซอร์เปรียบเสมือนแผงควบคุมสำหรับกระบวนการที่รันคำสั่ง shell, อ่านและเขียนไฟล์ในไดเรกทอรี workspace ที่คุณเลือก และใช้ API key ของโมเดลของคุณ ใครก็ตามที่สามารถโหลดหน้านั้นได้ย่อมสามารถทำทุกอย่างได้ในฐานะผู้ใช้ที่รัน dsh อยู่ เครือข่ายไม่ใช่ช่องทางเดียวที่จะเข้าถึงสิทธิ์เหล่านี้ได้: ปลั๊กอินที่คุณติดตั้งจะรันภายในกระบวนการเดียวกันด้วยสิทธิ์เดียวกัน ซึ่งเป็นเหตุผลว่าทำไม การตรวจสอบปลั๊กอิน dsh ก่อนติดตั้ง จึงต้องใช้ความระมัดระวังเช่นเดียวกับการตัดสินใจว่าเซิร์ฟเวอร์ควรฟังพอร์ตใด

ดังนั้นพอร์ต 3080 จึงไม่ใช่แดชบอร์ดแบบอ่านอย่างเดียว การโหลดหน้านั้นเท่ากับการเปิดช่องให้รันคำสั่งบนเซิร์ฟเวอร์ได้

เมื่อเปิด URL ที่แสดงขึ้นมา คุณจะเข้าสู่รายการเซสชันโดยตรง ไม่มีหน้าจอเข้าสู่ระบบและไม่มีบัญชีผู้ใช้ สิ่งที่ทำหน้าที่กั้นหน้าเว็บคือโทเค็นที่ต่อท้าย URL โดยหน้า root จะแลกเปลี่ยนโทเค็นนั้นเป็น signed session cookie และเปลี่ยนเส้นทางไปยังที่อยู่ที่สะอาด หลังจากนั้น ทุกการเรียก RPC และ WebSocket stream ที่ UI ทำโดยไม่มีคุกกี้ที่ถูกต้องจะได้รับ 401 Unauthorized อย่างไรก็ตาม ไม่ใช่ทุกอย่างบนพอร์ตนี้ที่จะถูกป้องกันไว้ เอกสารของปลั๊กอิน Connection ระบุว่า static assets ยังคงเป็นสาธารณะ และตัวเว็บเซิร์ฟเวอร์เองไม่มีการตรวจสอบสิทธิ์ระดับเซิร์ฟเวอร์หรือนโยบาย origin ดังนั้นปลั๊กอินแต่ละตัวที่เป็นเจ้าของเส้นทาง (route) จึงต้องบังคับใช้กฎของตนเอง ในเส้นทางที่ได้รับการป้องกันเหล่านั้น ปลั๊กอิน Connection จะตอบกลับด้วย 403 เมื่อส่วนหัว Host ไม่ใช่ loopback หรือโฮสต์ที่คุณเชื่อถือไว้อย่างชัดเจน บน loopback นี่เป็นชั้นที่สองที่สมเหตุสมผลต่อจากการควบคุมการเข้าถึงที่แท้จริง ซึ่งก็คือระบบปฏิบัติการที่อนุญาตให้เฉพาะกระบวนการภายในเครื่องเท่านั้นที่ผ่านเข้ามาได้ แต่นี่ไม่ใช่เหตุผลที่จะเปิดพอร์ตสู่สาธารณะ โทเค็นจะค้างอยู่ใน terminal scrollback ของคุณและใน log ใดๆ ที่บันทึก output ตอนเริ่มต้นระบบ คู่มือ reverse proxy ของโปรเจกต์เองระบุว่าทั้งการตรวจสอบ Host และ URL ที่แสดงไว้ไม่ได้ป้องกันตัวพอร์ตที่กำลังฟังอยู่ เอกสารของเว็บเซิร์ฟเวอร์เตือนว่าการผูกกับที่อยู่ที่ไม่ใช่ loopback "ยังคงเปิดเผยเส้นทางที่ไม่มีการป้องกันและ static assets ต่อเครือข่ายนั้น" และในเวอร์ชัน 0.2.0-rc.2 ปลั๊กอินเว็บเซิร์ฟเวอร์ไม่มี TLS ของตัวเอง สแกนเนอร์อัตโนมัติจะกวาดหาพอร์ตที่ไม่ธรรมดาอย่างต่อเนื่อง ดังนั้นให้ถือว่าพอร์ต 3080 ที่เปิดสู่สาธารณะนั้นถูกค้นพบแล้ว

ห้ามเปิดพอร์ต 3080 ในไฟร์วอลล์ของคุณ และห้ามตั้งค่า host ของเว็บเซิร์ฟเวอร์เป็น 0.0.0.0 หรือเป็น IP สาธารณะของคุณบน VPS สาธารณะ การตั้งค่าดังกล่าวจะทำให้ผู้ที่เชื่อมต่อเข้ามาสามารถรันคำสั่งบนเซิร์ฟเวอร์ของคุณได้ทันทีเพียงแค่มี URL ที่หลุดออกไป

รุ่นปัจจุบันได้ผลักดันให้คุณทำตามแนวทางนี้อยู่แล้ว: แฟล็ก --host ของเว็บแอปพลิเคชันปฏิเสธที่จะผูกกับทุกอินเทอร์เฟซ อย่างไรก็ตาม ในเวอร์ชัน 0.2.0-rc.2 คีย์การตั้งค่า host ของปลั๊กอินเว็บเซิร์ฟเวอร์ยังคงยอมรับ 0.0.0.0 ดังนั้นการแก้ไขไฟล์ตั้งค่าจึงยังคงทำให้พอร์ตถูกเปิดเผยได้ เอกสารเว็บเซิร์ฟเวอร์บน branch เริ่มต้นของโปรเจกต์ และในรุ่น 0.2.1-rc.5 ที่แท็ก latest ของ npm ชี้ไปนั้น ได้ดำเนินการไปไกลกว่าเดิม: โดยจะปฏิเสธที่อยู่ที่ไม่ได้ระบุไว้ขณะโหลดและเพิ่มการตั้งค่า tls เข้ามา แต่ก็ยังคงยอมรับที่อยู่เฉพาะใดๆ ของอินเทอร์เฟซภายในเครื่อง ดังนั้นการชี้ host ไปที่ IP สาธารณะของ VPS ของคุณจึงยังคงเปิดเผย UI ออกไปเช่นเดิม

เหตุผลเดียวกันนี้ใช้กับ agent runtime ทุกตัวที่คุณติดตั้งบนเซิร์ฟเวอร์ ซึ่งเป็นเหตุผลว่าทำไม การรัน coding agent บน VPS อย่างปลอดภัย จึงเริ่มต้นจากกฎเดียวกัน: พอร์ตควบคุมของ agent ต้องเป็นส่วนตัว และต้องมีสิ่งที่คุณเชื่อถือทำหน้าที่เป็นตัวกลางในการเข้าถึง

ฉันจะเปิด Web UI ของ dsh จากแล็ปท็อปได้อย่างไร

มีวิธีที่เหมาะสมอยู่ 3 วิธี และทุกวิธีจะยังคงผูก harness ไว้กับ loopback ตามเดิม

  • การทำ SSH tunnel: ไม่มีการเปิดพอร์ตใหม่บน public interface และคุณมี credential อยู่แล้ว นี่คือวิธีที่ควรเลือกใช้
  • การใช้ private overlay network: เพื่อให้สามารถเข้าถึง UI ได้จากอุปกรณ์ของคุณเองโดยที่ผู้อื่นไม่สามารถมองเห็นได้
  • การใช้ reverse proxy: เพื่อทำ TLS (transport layer security) termination และบังคับให้ใส่รหัสผ่านก่อนที่จะส่งต่อคำขอใดๆ

ความแตกต่างของแต่ละวิธีคือวิธีการนำเบราว์เซอร์ของคุณไปเชื่อมต่อกับ loopback โดยไม่ควรมีวิธีใดที่ต้องย้ายการทำงานของ harness ออกจาก loopback

เข้าถึงด้วย SSH tunnel

ให้รันคำสั่งนี้บนแล็ปท็อปของคุณ ไม่ใช่บน VPS:

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

ปล่อยให้คำสั่งทำงานทิ้งไว้ จากนั้นเปิด URL เต็มที่แสดงใน dsh ซึ่งรวมถึง token ใน http://127.0.0.1:3080/?token=... ผ่านเบราว์เซอร์ในเครื่องของคุณ Web UI จะโหลดขึ้นมา แลกเปลี่ยน token เป็น session cookie และลบ token ออกจากแถบที่อยู่ เบราว์เซอร์ของคุณจะส่ง 127.0.0.1:3080 เป็น Host ซึ่งเป็น loopback ดังนั้น tunnel จึงผ่านการตรวจสอบ Host โดยไม่ต้องตั้งค่าเพิ่มเติม

อาร์กิวเมนต์ -L ประกอบด้วยสามฟิลด์ที่คั่นด้วยเครื่องหมายโคลอน ฟิลด์แรกคือพอร์ตที่จะเปิดบนแล็ปท็อปของคุณ ฟิลด์ที่สองและสามคือที่อยู่และพอร์ตที่จะส่งต่อการเชื่อมต่อแต่ละรายการไป รายละเอียดที่สำคัญคือ 127.0.0.1 ในฟิลด์กลางจะถูก resolve โดย SSH server บน VPS หลังจากที่ทราฟฟิกของคุณไปถึงที่นั่นแล้ว ซึ่งหมายถึง loopback ของ VPS ไม่ใช่ของคุณ นี่คือที่อยู่ที่ dsh แสดงไว้ ซึ่งเป็นเหตุผลว่าทำไม tunnel ถึงทำงานได้ในขณะที่การเชื่อมต่อผ่านเบราว์เซอร์โดยตรงทำไม่ได้

-N บอกให้ SSH ไม่ต้องรันคำสั่งระยะไกล คุณจึงได้เพียงตัวส่งต่อโดยไม่มี shell สำหรับ tunnel ที่ทำงานเบื้องหลังและแจ้งเตือนหากเกิดข้อผิดพลาด:

ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps

-f จะส่งกระบวนการไปทำงานเบื้องหลังหลังจากการยืนยันตัวตน ExitOnForwardFailure=yes มีความสำคัญมากกว่าที่เห็น หากไม่มีอาร์กิวเมนต์นี้ SSH จะเชื่อมต่อสำเร็จแม้ว่าจะตั้งค่าการส่งต่อไม่ได้ ทำให้คุณได้ session ที่ใช้งานได้แต่ tunnel กลับใช้งานไม่ได้โดยไม่มีการแจ้งเตือน ServerAliveInterval=30 จะส่ง keepalive ทุก 30 วินาทีเพื่อให้ tunnel ที่ไม่ได้ใช้งานคงอยู่ได้แม้จะเจอกับ NAT (network address translation) timeout บนเราเตอร์ของร้านกาแฟหรือโรงแรม

สิ่งที่คุณควรเห็น

บน VPS ให้ยืนยันว่ามีอะไรกำลังฟังอยู่จริง:

ss -ltnp | grep 3080

ผลลัพธ์ที่ปกติจะระบุที่อยู่ loopback:

LISTEN 0  511  127.0.0.1:3080  0.0.0.0:*  users:(("node",pid=1042,fd=21))

หากคอลัมน์ที่อยู่ภายในเครื่องแสดงเป็น 0.0.0.0:3080 แสดงว่า Web UI กำลังทำงานบนทุกอินเทอร์เฟซรวมถึงอินเทอร์เฟซสาธารณะ หาก IP สาธารณะของ VPS ปรากฏในคอลัมน์นั้น หมายความว่ามีความเสี่ยงต่อการเข้าถึงจากภายนอก ให้หยุดการทำงานและแก้ไขการ bind ก่อนดำเนินการอื่น หาก ss แสดง socket แต่ปล่อยฟิลด์ users: ว่างไว้ ให้รันด้วย sudo เนื่องจากชื่อกระบวนการสำหรับ socket ที่เป็นเจ้าของโดยผู้ใช้อื่นจะถูกซ่อนไว้

เมื่อ tunnel ปฏิเสธที่จะเริ่มทำงาน

SSH จะแสดงข้อความนี้และออกจากโปรแกรม:

bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080

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

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

มีเพียงฟิลด์แรกเท่านั้นที่เปลี่ยนไป ดังนั้นตอนนี้คุณจึงเข้าถึง http://127.0.0.1:3081/?token=... ด้วย token เดิม ในขณะที่ harness ยังคงฟังอยู่ที่พอร์ต 3080 ตัวเลขทั้งสองไม่จำเป็นต้องตรงกัน session cookie จะผูกกับ host และพอร์ตในแถบที่อยู่ ดังนั้นพอร์ตในเครื่องใหม่จึงต้องใช้ URL ที่มี token อีกครั้ง

หาก tunnel เริ่มทำงานได้แต่เบราว์เซอร์รายงานว่าการเชื่อมต่อถูกปฏิเสธหรือไม่มีการตอบกลับ แสดงว่าทราฟฟิกส่งไปถึง VPS แล้วแต่ไม่พบปลายทาง ไม่ว่าจะเป็นเพราะ dsh ออกจากโปรแกรมไปแล้ว หรือมีการ bind พอร์ตอื่น ให้ตรวจสอบด้วย ss -ltnp | grep 3080 บนเซิร์ฟเวอร์ หากหน้าเว็บตอบกลับว่า 401 Unauthorized แสดงว่า tunnel ปกติดี แต่เบราว์เซอร์ของคุณไม่มี cookie ที่ถูกต้องสำหรับที่อยู่นั้น ให้เปิด URL ที่แสดงอีกครั้งรวมถึง token ด้วย หลังจากรีสตาร์ท ให้ใช้ URL จากผลลัพธ์ใหม่ เพราะแต่ละกระบวนการจะสร้าง token ใหม่เสมอ

อีกสิ่งหนึ่งที่มักเป็นปัญหาคือ npx @deepseek-ai/dsh web ที่รันอยู่เบื้องหน้าจะหยุดทำงานเมื่อปิด shell ดังนั้น harness จะหยุดทันทีที่คุณออกจากระบบ ให้เริ่มทำงานภายใน tmux หรือภายใต้ systemd user service ซึ่งเป็นปัญหาเดียวกันกับที่แก้ไขไว้ใน การรักษาให้ coding agent ทำงานบน VPS ภายใต้ systemd บรรทัด dsh web: รวมถึง token จะถูกบันทึกไว้ใน log ของ service ดังนั้นให้ตรวจสอบจากที่นั่น ในระหว่างที่คุณกำลังจัดการฝั่ง SSH การ เพิ่มความปลอดภัยให้กับ SSH บน VPS เป็นสิ่งที่ควรทำก่อน เพราะ tunnel จะทำให้การล็อกอิน SSH ของคุณเป็นประตูเดียวที่เข้าถึง agent ได้

การเข้าถึงผ่านเครือข่าย overlay ส่วนตัว

เครือข่าย overlay ช่วยให้ VPS และแล็ปท็อปของคุณมีที่อยู่บนเครือข่ายส่วนตัวที่มีเพียงอุปกรณ์ของคุณเท่านั้นที่เข้าร่วมได้ Tailscale เป็นตัวเลือกที่นิยมใช้ และคำสั่ง serve ของมันก็เหมาะสมกับกรณีนี้อย่างยิ่ง โดย tailscaled จะทำงานบน VPS และเชื่อมต่อเข้ากับ localhost:3080 ของตัวมันเอง ทำให้ harness ทำงานอยู่บน loopback เท่านั้น

tailscale serve --bg localhost:3080
tailscale serve status

จากนั้นคุณจะสามารถเข้าถึง UI ได้ผ่านชื่อเครื่องของคุณภายใน tailnet ผ่าน HTTPS โดยไม่ต้องเปิดพอร์ตใดๆ บนอินเทอร์เฟซสาธารณะ วิธีนี้จำเป็นต้องเปิดใช้งานใบรับรอง HTTPS สำหรับ tailnet ของคุณ มิฉะนั้น serve จะไม่มีใบรับรองสำหรับแสดงผล เนื่องจากเบราว์เซอร์ของคุณจะส่งชื่อ tailnet นั้นเป็น Host คุณจึงต้องเริ่ม harness โดยระบุชื่อที่เชื่อถือได้ มิฉะนั้นการเรียก API จะได้รับ 403 รายการที่ไม่มีพอร์ตจะตรงกับพอร์ตใดก็ได้:

npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host your-vps.your-tailnet.ts.net

จากนั้นเปิด https://your-vps.your-tailnet.ts.net/?token=... โดยนำ token จากบรรทัดที่แสดงผลมาใช้ หากต้องการปิดการใช้งาน ให้ทำซ้ำคำสั่งเดิมด้วย off:

tailscale serve --https=443 off

ให้ใช้ serve และห้ามใช้ funnel โดยเด็ดขาด เนื่องจาก Funnel จะเผยแพร่เป้าหมายเดียวกันไปยังอินเทอร์เน็ตสาธารณะ ซึ่งเป็นการนำ agent runtime ไปวางไว้บนพอร์ตที่เปิดอยู่โดยมีเพียง URL token ป้องกันไว้เท่านั้น คำสั่งทั้งสองดูเกือบจะเหมือนกันแต่ให้ผลลัพธ์ที่ตรงกันข้าม ดังนั้นโปรดอ่าน ความแตกต่างระหว่าง Tailscale Serve และ Funnel ก่อนที่คุณจะพิมพ์คำสั่งใดๆ ส่วน Tailscale ในฐานะเครือข่ายส่วนตัว จะครอบคลุมถึงขั้นตอนการตั้งค่าทั้งหมด

เข้าถึงผ่าน reverse proxy ที่มีการตรวจสอบรหัสผ่าน

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

ตัว harness จะทำงานบน 127.0.0.1:3080 โดยมี nginx ทำงานอยู่บนเครื่องเดียวกัน จึงสามารถเข้าถึง loopback ได้ และ nginx จะคอยฟังที่พอร์ต 443 พร้อมกับใบรับรองและไฟล์รหัสผ่าน

server {
    listen 443 ssl;
    server_name dsh.example.com;

    ssl_certificate     /etc/letsencrypt/live/dsh.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/dsh.example.com/privkey.pem;

    auth_basic           "dsh";
    auth_basic_user_file /etc/nginx/dsh.htpasswd;

    location / {
        proxy_pass http://127.0.0.1:3080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_read_timeout 3600s;
        proxy_buffering off;
    }
}

สร้างไฟล์รหัสผ่านและโหลดการตั้งค่าใหม่:

sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginx

nginx -t ควรแสดงผล syntax is ok ตามด้วย test is successful หากการโหลดใหม่ล้มเหลวเนื่องจากไฟล์มีปัญหา ระบบจะยังคงใช้การตั้งค่าเดิมที่ทำงานอยู่ ดังนั้นให้อ่านข้อความแสดงข้อผิดพลาดแทนการรีสตาร์ทแบบสุ่มสี่สุ่มห้า

บรรทัด proxy สามบรรทัดนั้นไม่ใช่แค่การตกแต่ง Header Upgrade และ Connection ช่วยให้การทำ WebSocket handshake ผ่านไปได้ หากไม่มีบรรทัดเหล่านี้ หน้าเว็บจะโหลดขึ้นมาแต่ไม่สามารถอัปเดตข้อมูลได้ proxy_read_timeout 3600s จะเพิ่มระยะเวลา inactivity timeout ของ nginx จาก 60 วินาทีเป็นหนึ่งชั่วโมง ซึ่งไม่ได้จำกัดระยะเวลาการทำงานรวมของ agent แต่อย่างใด เวอร์ชัน 0.2.0-rc.2 ที่ถูกล็อกไว้จะส่ง WebSocket pings ทุกสองวินาทีเป็นค่าเริ่มต้นอยู่แล้ว เพื่อรักษาการเชื่อมต่อให้คงอยู่ระหว่างการทำงานของ agent ที่ใช้เวลานาน proxy_buffering off จะปิดการทำ buffering สำหรับการตอบกลับ HTTP ที่ผ่าน proxy ซึ่งไม่ได้ควบคุมเฟรมของ WebSocket การตั้งค่า nginx reverse proxy ทีละบรรทัด อธิบายรายละเอียดส่วนที่เหลือ และ การเลือกใช้ระหว่าง nginx, Caddy และ Traefik ครอบคลุมถึงการทำสิ่งเดียวกันด้วยใบรับรองอัตโนมัติ

ตัว harness จำเป็นต้องรับรู้เกี่ยวกับ proxy ด้วยเช่นกัน proxy_set_header Host $host จะส่งชื่อที่เบราว์เซอร์มองเห็นผ่านไปโดยไม่มีการเปลี่ยนแปลง ซึ่งเป็นสิ่งที่คู่มือ proxy ของโปรเจกต์ระบุไว้ ดังนั้นให้เริ่ม dsh โดยระบุชื่อนั้นเป็น trusted มิฉะนั้นระบบจะตอบกลับด้วย 403:

npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host dsh.example.com

จากนั้นแต่ละคนจะเปิด https://dsh.example.com/?token=... หนึ่งครั้ง พร้อมกับ token จากบรรทัด dsh web: และเบราว์เซอร์จะเก็บ session cookie ไว้หลังจากนั้น ตัว backend จะตั้งค่า cookie ดังกล่าวโดยไม่มี flag Secure และคู่มือ proxy แนะนำให้เพิ่ม flag นี้ที่ฝั่ง proxy เมื่อใช้งานผ่าน HTTPS สำหรับ nginx เวอร์ชัน 1.19.3 ขึ้นไป สามารถใช้ proxy_cookie_flags ~ secure; ในบล็อก location เพื่อดำเนินการดังกล่าวได้

ปิดพอร์ต 3080 ที่ firewall ไว้เสมอไม่ว่าคุณจะเลือกใช้ proxy ตัวใด เพื่อให้เส้นทางเดียวในการเข้าถึงคือผ่านช่องทางที่มีการยืนยันตัวตนเท่านั้น พื้นฐานการใช้งาน ufw firewall ครอบคลุมถึงกฎต่างๆ การใช้ basic authentication ผ่าน TLS เป็นเพียงมาตรฐานขั้นต่ำ ไม่ใช่โมเดลความปลอดภัยที่สมบูรณ์แบบ เพราะใครก็ตามที่ถือรหัสผ่านและ URL ที่มี token จะสามารถเข้าถึง shell บนเซิร์ฟเวอร์ของคุณได้ ให้เลือกใช้ tunnel หากทำได้

ฉันจะเปลี่ยนพอร์ตที่ dsh web ใช้รับการเชื่อมต่อได้อย่างไร

--port เป็นส่วนของเว็บแอปพลิเคชัน ไม่ใช่ส่วนของตัวเรียกใช้งาน (launcher) เอกสารประกอบ CLI ได้ให้ตัวอย่างไว้โดยตรงดังนี้:

dsh --profile web --port 8080

dsh web เป็นนามแฝงของ --profile web ดังนั้น dsh web --port 8080 จึงเป็นคำสั่งเดียวกัน ตัวเรียกใช้งานจะประมวลผลเฉพาะแฟล็กของตัวมันเองเท่านั้น และจะส่งข้อมูลที่เหลือทั้งหมดหลังจากนั้นไปยังโปรไฟล์ที่ถูกเรียกขึ้นมา ดังนั้นแฟล็กของตัวเรียกใช้งานต้องอยู่ข้างหน้าเสมอ และโทเค็นแรกที่ตัวเรียกใช้งานไม่รู้จักจะถือเป็นจุดเริ่มต้นของอาร์กิวเมนต์สำหรับแอปพลิเคชัน ให้วาง --port ไว้หลังโปรไฟล์เสมอ ห้ามวางไว้ข้างหน้า

ให้อ่าน URL ที่คำสั่งแสดงผลออกมาแทนการคาดเดา เพราะบรรทัดนั้นจะรายงานที่อยู่จริงที่เซิร์ฟเวอร์ผูกไว้ (bound) พร้อมกับโทเค็นที่คุณต้องใช้ จากนั้นให้ปรับปรุงฟิลด์สุดท้ายของทันเนลของคุณให้ตรงกัน:

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

สำหรับการเปลี่ยนแปลงแบบถาวร พอร์ตจะถูกกำหนดไว้ในการตั้งค่าโปรไฟล์แทนที่จะกำหนดผ่านบรรทัดคำสั่ง โปรไฟล์ web และ headless จะเริ่มต้นการทำงานอัตโนมัติในการใช้งานครั้งแรกจากเทมเพลตที่มาพร้อมกับซอฟต์แวร์ ภายใต้ไดเรกทอรี ~/.dsh ไดเรกทอรีเดียวกันนี้ยังเป็นที่เก็บ API key และการตั้งค่า model endpoint ของคุณ ดังนั้น การตั้งค่า dsh keys, models และ endpoints จึงเป็นเนื้อหาที่ควรอ่านควบคู่กันไปเมื่อคุณต้องแก้ไขไฟล์เหล่านี้อยู่แล้ว หากต้องการดูว่าการตั้งค่าใดมีผลจริงหลังจากรวมเลเยอร์ทั้งหมดแล้ว ให้ใช้คำสั่ง:

dsh --dump-config

ที่อยู่สำหรับการรับการเชื่อมต่อ (listen address) มาจากคีย์สองตัวในปลั๊กอินเว็บเซิร์ฟเวอร์ คือ host และ port ในเวอร์ชัน 0.2.0-rc.2 คีย์อื่นๆ จะทำหน้าที่ปรับแต่งการบีบอัดข้อมูลตอบกลับเท่านั้น ส่วนในเวอร์ชัน 0.2.1-rc.2 และ branch เริ่มต้นได้มีการเพิ่มคีย์ tls เข้ามาเป็นทางเลือก การตั้งค่า port ให้เป็น 0 เป็นการร้องขอพอร์ตว่างจากระบบปฏิบัติการ ซึ่งมีระบุในเอกสารว่า "ค่าศูนย์เป็นการร้องขอพอร์ตที่ระบบปฏิบัติการจัดสรรให้" วิธีนี้รับประกันได้ว่าคุณจะไม่พบปัญหาพอร์ตชนกัน แต่ไม่เหมาะกับการใช้งานร่วมกับทันเนล เพราะหมายเลขพอร์ตจะเปลี่ยนไปทุกครั้งที่รีสตาร์ทเซิร์ฟเวอร์

เหตุใด dsh จึงล้มเหลวด้วยข้อความ address already in use?

เนื่องจากมีโพรเซสอื่นใช้งานแอดเดรสและพอร์ตนั้นอยู่แล้ว เคอร์เนลจึงปฏิเสธการ bind ครั้งที่สอง Node จะรายงานข้อผิดพลาดในลักษณะนี้:

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080

ให้ค้นหาโพรเซสที่ใช้งานอยู่ก่อนที่จะดำเนินการแก้ไขใดๆ:

sudo ss -ltnp | grep 3080

ฟิลด์ users:(("node",pid=1042,fd=21)) จะระบุชื่อโพรเซสและ PID ของโพรเซสนั้น คำตอบที่พบบ่อยคือมี dsh ตัวก่อนหน้าที่คุณคิดว่าหยุดทำงานไปแล้ว แต่จริงๆ ยังคงทำงานอยู่ในหน้าต่าง tmux ที่ถูกแยกออกมา ให้หยุดโพรเซสนั้นด้วย kill 1042 หรือเริ่มอินสแตนซ์ใหม่บนพอร์ตอื่น โปรดทราบว่า 127.0.0.1:3080 และ 0.0.0.0:3080 จะเกิดการชนกันเองเสมอ เนื่องจากการ bind ทุกอินเทอร์เฟซนั้นครอบคลุมถึง loopback อยู่แล้ว

ตรึงเวอร์ชันไว้ เนื่องจากนี่เป็นรุ่นตัวอย่างสำหรับนักพัฒนา (developer preview)

README ระบุไว้อย่างชัดเจนว่า DeepSeek Harness ยังอยู่ในสถานะตัวอย่างสำหรับนักพัฒนาและมีการพัฒนาอย่างรวดเร็ว ซึ่งจะมีการเปลี่ยนแปลงที่ส่งผลกระทบต่อความเข้ากันได้ (compatibility-breaking changes) หากความเร็วในการพัฒนานี้คือเหตุผลที่คุณลังเล การเปรียบเทียบ dsh กับ Claude Code และ Omnigent จะช่วยชั่งน้ำหนักระหว่างเครื่องมือทั้งสองตัวที่อยู่ในจุดต่างกันบนเส้นทางการพัฒนาเดียวกัน

การไม่ตรึงเวอร์ชันใน npx @deepseek-ai/dsh web หมายความว่าไม่มีการระบุเวอร์ชันไว้ คุณจึงไม่สามารถควบคุมได้ว่า build ใดจะถูกเรียกใช้งาน เอกสารของ npm ระบุว่าชื่อแพ็กเกจที่ไม่มีตัวระบุเวอร์ชัน "จะถูกจับคู่กับเวอร์ชันใดก็ตามที่มีอยู่ในโปรเจกต์ในเครื่อง" และหากแพ็กเกจนั้นไม่มีอยู่ในโปรเจกต์ ระบบจะติดตั้งลงในโฟลเดอร์ภายใน npm cache แทน ซึ่ง build ที่จะเริ่มทำงานนั้นขึ้นอยู่กับว่าเครื่องนั้นมีไฟล์อะไรอยู่ การรีสตาร์ทเครื่องจึงอาจทำให้ได้ CLI คนละตัวกับที่คุณเคยทดสอบไว้ และอาจมี flag ที่แตกต่างกัน คุณควรตรึงเวอร์ชันไว้เพื่อให้การรีสตาร์ทไม่กลายเป็นการอัปเกรดโดยไม่ตั้งใจ:

npx @deepseek-ai/dsh@0.2.0-rc.2 web

ณ เดือนพฤศจิกายน 2026 (ตรวจสอบเมื่อ 2026-11-01) แท็ก latest ของ npm ชี้ไปที่ 0.2.1-rc.5 ซึ่งปล่อยบน GitHub เมื่อ 2026-10-30 GitHub บันทึกว่า 0.2.1-rc.4 ถูกปล่อยเมื่อ 2026-10-28 เวลา 02:49 UTC ซึ่งห่างจาก 0.2.1-rc.3 เมื่อ 2026-10-23 เวลา 15:26 UTC ประมาณสี่วันกับอีกสิบเอ็ดชั่วโมง ดังนั้นบนเครื่องที่ไม่มีไฟล์ในเครื่อง การใช้คำสั่ง npx @deepseek-ai/dsh เปล่าๆ ในตอนนี้จะดึงเอา release candidate เวอร์ชัน 0.2.1 มา ไม่ใช่ build ที่คู่มือนี้แนะนำให้ตรึงไว้ ส่วน 0.2.0-rc.2 ที่แนะนำให้ตรึงนั้นถูกปล่อยบน GitHub เมื่อ 2026-09-29 สำหรับ build 0.1.0-rc.7 ที่คู่มือนี้เคยแนะนำให้ตรึงไว้ในเดือนสิงหาคมนั้น ปัจจุบันถือว่าล้าหลังไปหลายรุ่นตัวอย่างแล้ว ทั้งในสาย 0.1 และข้ามไปถึง 0.2 ตรวจสอบให้แน่ใจว่าคำสั่ง npx เปล่าๆ จะดึงเวอร์ชันใดมาก่อนที่คุณจะยอมรับมัน:

npm view @deepseek-ai/dsh version

npm view @deepseek-ai/dsh dist-tags จะแสดงรายการแท็กทั้งหมดพร้อมกัน ซึ่งเป็นวิธีที่คุณใช้แยกแยะ release candidate ออกจาก alpha ก่อนที่จะทำการตรึงเวอร์ชัน

หากการตรึงเวอร์ชันไม่สามารถติดตั้งได้ หรือ npx ยังคงเรียกใช้ build เก่าหลังจากที่คุณตรึงเวอร์ชันใหม่แล้ว ข้อผิดพลาดในการติดตั้งและเวอร์ชันที่อาจเกิดขึ้น จะครอบคลุมถึงวิธีการล้าง npx cache และการตรวจสอบว่า Node ของคุณใช้ npm ตัวใด

ในรุ่นตัวอย่าง (preview releases) มักมีการย้าย flag ระหว่างตัวเรียกใช้งาน (launcher) กับเว็บแอปพลิเคชัน หาก --port หยุดทำงานตามที่คู่มือนี้อธิบายไว้ ให้สอบถามรายการ flag จากตัวแอปพลิเคชันโดยตรงแทนการคาดเดา:

dsh --profile web --help

สำหรับการติดตั้ง การตั้งค่า workspace และ model key โปรดดู การติดตั้ง DeepSeek Harness บน VPS สำหรับขั้นตอนการเข้าถึงเพียงอย่างเดียวแบบสรุป การเข้าถึง dsh Web UI บน VPS จะอธิบายเฉพาะเรื่อง tunnel โดยไม่ลงรายละเอียดเชิงตรรกะเบื้องหลัง

FAQ

ทำไมฉันถึงเปิด http://127.0.0.1:3080 ในเบราว์เซอร์บนแล็ปท็อปไม่ได้

เพราะ 127.0.0.1 หมายถึงเครื่องที่คุณกำลังใช้งานอยู่ Web UI ของ DeepSeek Harness ถูกผูกไว้กับ loopback address ของ VPS ดังนั้นจะมีเพียงกระบวนการที่ทำงานบน VPS เท่านั้นที่เชื่อมต่อได้ แล็ปท็อปของคุณมี loopback แยกต่างหากและไม่มีบริการใดรอรับการเชื่อมต่อที่พอร์ต 3080 ในเครื่องนั้น ให้ทำการ forward พอร์ตผ่าน SSH ด้วย ssh -N -L 3080:127.0.0.1:3080 you@your-vps จากนั้นจึงโหลด URL เต็มที่แสดงขึ้นมาคือ http://127.0.0.1:3080/?token=... ในเครื่องของคุณ ฟิลด์ตรงกลางของอาร์กิวเมนต์ -L จะถูก resolve ที่ฝั่งเซิร์ฟเวอร์ ซึ่งทำให้มันชี้ไปยังตัว harness หากคุณไม่ใส่ token คุณจะได้รับ 401 Unauthorized จนกว่าเบราว์เซอร์ของคุณจะมี session cookie

การผูก dsh Web UI เข้ากับ 0.0.0.0 บน VPS สาธารณะปลอดภัยหรือไม่

ไม่ปลอดภัย Web UI เป็นส่วนควบคุมสำหรับ agent ที่ทำหน้าที่รันคำสั่ง shell และแก้ไขไฟล์ในฐานะผู้ใช้ที่รัน dsh มันไม่มีระบบบัญชีผู้ใช้และไม่มีหน้าจอเข้าสู่ระบบ ข้อมูลรับรองเพียงอย่างเดียวคือ token ใน URL ที่แสดงขึ้นมา ส่วน static asset จะถูกส่งโดยไม่มีการตรวจสอบ และเอกสารของโปรเจกต์ระบุเองว่าพอร์ตที่เปิดรับการเชื่อมต่อไม่มีการป้องกัน การผูกไว้กับทุกอินเทอร์เฟซบน IP สาธารณะทำให้ใครก็ตามที่เข้าถึงพอร์ต 3080 สามารถรันคำสั่งบนเซิร์ฟเวอร์ของคุณได้ทันทีหาก URL รั่วไหล การผูกไว้กับ IP สาธารณะโดยตรงก็มีความเสี่ยงเช่นเดียวกัน ให้คงการผูกไว้ที่ 127.0.0.1 ปิดพอร์ต 3080 ที่ firewall และใช้ SSH tunnel, private overlay network หรือ reverse proxy ที่ต้องใช้รหัสผ่านแทน

ฉันจะให้ dsh Web UI ทำงานต่อไปได้อย่างไรหลังจากปิด SSH session

npx @deepseek-ai/dsh web ที่รันอยู่เบื้องหน้าเป็น child process ของ login shell ของคุณ ดังนั้นมันจะถูกสั่งปิดเมื่อ shell นั้นจบการทำงาน ให้เริ่มการทำงานภายใน session ของ tmux แล้ว detach ด้วย Ctrl-b d หรือรันเป็น systemd user service โดยเปิดใช้งาน lingering ไว้ ตัว tunnel และตัว harness นั้นเป็นอิสระต่อกัน คุณสามารถตัดและสร้าง SSH tunnel ใหม่ได้บ่อยเท่าที่ต้องการโดยไม่กระทบต่อ harness ที่กำลังทำงานอยู่ ตราบใดที่ตัว harness มี parent process ที่ยังทำงานอยู่หลังจากที่คุณออกจากระบบไปแล้ว

ทำไม dsh Web UI ถึงค้างระหว่างการรัน agent เป็นเวลานานเมื่ออยู่หลัง nginx

ให้ตรวจสอบการเชื่อมต่อ WebSocket และ error log ของ nginx ค่าเริ่มต้นของ proxy_read_timeout ใน nginx คือ 60 วินาทีระหว่างการอ่านข้อมูล แต่เวอร์ชัน 0.2.0-rc.2 ที่ระบุไว้จะส่ง WebSocket ping ทุกสองวินาทีเป็นค่าเริ่มต้น ดังนั้นขั้นตอนการทำงานของ agent ที่ยาวนานเพียงอย่างเดียวจึงไม่ทำให้เกิด timeout นั้น proxy_read_timeout 3600s; จะเพิ่มระยะเวลาที่อนุญาตให้ไม่มีกิจกรรมได้นานถึงหนึ่งชั่วโมง proxy_buffering off; จะปิดการทำ buffering สำหรับ HTTP response แต่ไม่ใช่สำหรับ WebSocket frame ให้ส่ง header Upgrade และ Connection ด้วย proxy_http_version 1.1; เพื่อให้การทำ WebSocket handshake สำเร็จ หากไม่มี header เหล่านี้ หน้าเว็บจะโหลดขึ้นมาแต่จะไม่ได้รับข้อมูลอัปเดตใดๆ

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