SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor

Cài DeepSeek Harness trên VPS, giữ private qua SSH

Cài DeepSeek Harness trên Linux VPS, pin npm version, hiểu plugin làm được gì và mở web UI port 3080 qua SSH tunnel mà không public cổng.

DeepSeek Harness là gì

DeepSeek Harness (dsh) là một runtime agent Node.js có thể chạy trên VPS (virtual private server). Cách an toàn để chạy là bind vào 127.0.0.1 và để trình duyệt truy cập thông qua tunnel SSH (secure shell). Nó cung cấp web UI (user interface) trên port 3080 thay vì chạy trong terminal. Trong bản release 0.1.0-rc.6 mà bài hướng dẫn này cố định phiên bản, web server không yêu cầu password riêng. Vì vậy, nếu publish port 3080, bất kỳ ai tìm thấy port này đều có thể truy cập một agent có quyền đọc file và chạy command bằng user Linux của bạn. Các release mới hơn, từ 0.2.0-rc.2 đến 0.2.2-rc.2, phát hành ngày 11 November 2026 và là release mới nhất GitHub liệt kê ngày 12 November 2026, in ra URL khởi động chứa token mới cho process đó rồi đổi token này thành session cookie. Tuy nhiên, các release này vẫn listen trên loopback theo mặc định và vẫn từ chối bind vào mọi interface.

DeepSeek phát hành nó theo giấy phép MIT, dưới dạng npm package @deepseek-ai/dsh. Project tự mô tả là bản developer preview và nêu rõ rằng có thể sẽ có các thay đổi làm mất compatibility. Phiên bản được cố định bên dưới là release tháng August 2026. Ngày 12 November 2026, tag latest của npm trỏ đến 0.2.2-rc.1. GitHub liệt kê prerelease mới hơn là 0.2.2-rc.2, có tag dsh-v0.2.2-rc.2 và được phát hành ngày 11 November 2026. Hãy kiểm tra repository trước khi copy bất kỳ phần nào lên một máy chủ quan trọng.

Một ý tưởng xuyên suốt toàn bộ thiết kế: mọi thứ đều là plugin. Model adapter, tool registry, session log, sandbox, scheduler và chính agent loop đều là các plugin được load vào cùng một context, và bất kỳ thành phần nào cũng có thể được thay thế. Không có core đặc quyền để plugin chỉ mở rộng thêm chức năng. Đây là lý do harness đáng để thử, nhưng cũng là nơi tồn tại rủi ro thực sự duy nhất. Trade-off này có phù hợp hay không phụ thuộc vào tiêu chí bạn dùng để so sánh. Phần so sánh với Claude Code và Omnigent đặt thiết kế mọi thứ là plugin cạnh hai cách tiếp cận khác về mức độ phụ thuộc vào model, giấy phép và lượng tài nguyên VPS mà mỗi công cụ yêu cầu.

Harness không phải là model

Harness chạy vòng lặp agent. Phần suy luận diễn ra trong một model ở nơi khác, nên mọi thứ sẽ không hoạt động cho đến khi bạn cung cấp API (application programming interface) key hoặc địa chỉ của một model endpoint do bạn tự host. Toàn bộ nội dung trong bài này là cấu hình harness, không phải hành vi của model. Bạn nên phân biệt rõ ranh giới giữa hai phần này trước khi mất cả buổi chiều để xác định sự cố nằm ở phía nào.

Bạn cấu hình phần này trong UI, vào Settings rồi chọn Models. DeepSeek có card riêng. Trong các bản phát hành hiện tại, nút "Add model provider" bên dưới card này mở ra 2 chế độ. "Third-party model provider" dành cho các provider mà harness có sẵn catalog, chẳng hạn OpenAI và Anthropic. Bạn dán key vào, còn catalog cung cấp endpoint và danh sách model. "Custom model API" là tùy chọn đáng chú ý: tùy chọn này nhận provider ID viết thường, tên hiển thị, base URL, API protocol, credential và ít nhất một model. Bộ chọn protocol có OpenAI Chat Completions, OpenAI Responses, Anthropic Messages và Gemini API. Vì vậy, bạn có thể cấu hình gateway hoặc local server nói một trong các protocol này. Các endpoint có khác biệt về request format cần dùng compatibility settings. Custom provider cũng có thể truy vấn endpoint tương thích với OpenAI GET /models để tự điền danh sách model cho bạn.

Đó là cách trỏ harness đến một model trên cùng VPS. Ollama cung cấp API tương thích với OpenAI tại http://127.0.0.1:11434/v1/. Trường API key nhận bất kỳ chuỗi nào, theo quy ước là ollama, vì client kiểu OpenAI yêu cầu một giá trị còn Ollama bỏ qua giá trị đó. Tài liệu riêng của Ollama cũng mô tả ollama launch dsh. Lệnh này cài @deepseek-ai/dsh nếu chưa có và khởi động nó với một Ollama model, nên hãy kiểm tra phiên bản mà lệnh cài đặt trước khi dựa vào pin bên dưới. Model đủ nhỏ để chạy trên VPS có điều khiển agent đủ tốt hay không là câu hỏi khó hơn. Sự khác biệt giữa Ollama và vLLM với vai trò local model server quyết định câu trả lời sẽ tiêu tốn bao nhiêu RAM của bạn.

Các key nhập vào UI chỉ có thể ghi, không thể đọc lại. Harness lưu chúng trong $DSH_HOME/.credentials.yaml. Phần settings chỉ lưu credential reference và các bản phát hành hiện tại ghi reference này vào patch file của profile đang active, $DSH_HOME/profiles/<profile>/cordis.patch.yml (profile là web cho dsh web). $DSH_HOME có giá trị mặc định là ~/.dsh. Hãy coi credentials file như một password file, vì đúng là như vậy: bất kỳ ai đọc được file này đều có thể sử dụng ngân sách API của bạn. Nếu muốn sửa trực tiếp các file đó thay vì thao tác qua Settings, hướng dẫn về file cấu hình dsh, key và model endpoint giải thích chức năng của từng key và dữ liệu nào rời khỏi máy của bạn trong từng chế độ.

Bạn cần chuẩn bị gì trước khi cài đặt

  • một VPS chạy Ubuntu 24.04 hoặc một Linux hiện hành khác, có quyền truy cập SSH
  • Node.js 24.9 trở lên, vì nhánh chính của project và 0.2.2-alpha.2 hiện khai báo >=24.9.0, còn CI kiểm thử Node 24 bằng kiểm tra tương thích trên Node 24.9 và Node 26, không có job cho Node 22; các bản release được gắn tag đến 0.2.1-rc.4 vẫn liệt kê Node 22.19 là phiên bản được chấp nhận, nhưng đây không còn là phiên bản tối thiểu mà project build trên đó
  • một tài khoản người dùng thông thường, không phải root, vì agent chạy shell command với tư cách người khởi chạy process
  • pnpm trong PATH nếu bạn định cài plugin, vì lệnh plugin gọi shell đến chương trình này
  • đóng cổng 3080 trên firewall của bạn và trên firewall mạng riêng do nhà cung cấp quản lý

Gói nodejs của Ubuntu 24.04 cũ hơn yêu cầu của harness, nên trên bản phát hành này hãy cài Node từ NodeSource hoặc nvm thay vì dùng apt install nodejs. Repository chính thức của Ubuntu 26.10 liệt kê Node 24.19.0, cao hơn mức tối thiểu Node 24.9. Nếu VPS mới được tạo, hardening SSH trước mọi việc khác là việc đáng dành mười phút, vì tunnel mà bạn sắp phụ thuộc chỉ an toàn tương đương SSH server phía sau nó.

Cài DeepSeek Harness trên VPS và cố định một version

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

npx tải package và chạy binary dsh của package đó. web là alias của --profile web, lệnh khởi động ứng dụng trình duyệt; process sẽ in ra địa chỉ mà nó đang listen. Giá trị mặc định là http://127.0.0.1:3080. Các số này quyết định binding chứ không chỉ là giá trị mặc định mang tính hình thức. Lý do dsh in địa chỉ loopback giải thích harness sẽ và sẽ không phản hồi ở đâu trước khi bạn thử truy cập từ laptop.

Hãy cố định version. npx @deepseek-ai/dsh web resolve tag mà latest đang trỏ tới tại thời điểm bạn chạy lệnh, trừ khi project nơi bạn chạy lệnh đã cài sẵn một bản copy; khi đó npx sẽ âm thầm dùng bản copy đó. Dù theo cách nào, bạn cũng không phải người chọn version, trong khi project đã phát hành vài release candidate và thông báo sẽ có breaking changes. 0.1.0-rc.6 là version tháng 8 năm 2026 được cố định ở đây. Ngày 12 tháng 11 năm 2026, latest trỏ tới 0.2.2-rc.1, một bản release in ra startup URL có token; GitHub liệt kê prerelease mới hơn là 0.2.2-rc.2. Vì vậy, nếu chuyển sang version khác, hãy chủ động nâng cấp sau khi đọc repository. Cố định version nghĩa là máy bạn thiết lập hôm nay sẽ hoạt động giống như tháng sau. Khi đó, upgrade là quyết định do bạn đưa ra thay vì một sự cố tình cờ phát hiện sau này. Nếu command đã cố định version nhưng vẫn khởi động sai build hoặc hoàn toàn không cài được, Các lỗi cài đặt và version dsh thường gặp hướng dẫn xóa npx cache và kiểm tra npm đi kèm với Node của bạn.

Để sử dụng hằng ngày, hãy cài một lần thay vì resolve lại mỗi lần khởi động.

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

Dòng thứ hai đáng chạy vì launcher và web app dùng các bộ flag riêng. dsh --help hiển thị các option riêng của launcher. dsh --profile web --help hiển thị các flag mà web application chấp nhận. Đây là nơi có --port, --host và --trusted-host có thể lặp lại.

Bây giờ hãy xác nhận process đang listen ở đâu.

ss -tlnp | grep 3080

Cột địa chỉ local phải hiển thị 127.0.0.1:3080. Nếu hiển thị 0.0.0.0:3080, UI đang listen trên mọi interface. Khi đó, chỉ còn firewall ngăn nó tiếp xúc với Internet. Hãy dừng process trước khi làm bất kỳ việc gì khác.

Tại sao không bao giờ được public port 3080

Web server trong 0.1.0-rc.6 không có lớp xác thực. Cấu hình của nó chỉ khai báo listen host và listen port. Đó là toàn bộ bề mặt truy cập. Kiểm soát truy cập cho các deployment không chạy trên loopback là một setting trusted-host riêng. Nó không phải màn hình đăng nhập.

Các release mới hơn đã bổ sung lớp này. Từ 0.2.0-rc.2, khi khởi động, chương trình in ra một URL chứa token mới cho process đó. Browser mở URL này sẽ nhận một signed session cookie, rồi được redirect đến cùng địa chỉ nhưng không còn token. Một Host/Origin fence đặt trước /api chỉ cho phép route từ loopback, địa chỉ bind của listener và các authority được chỉ định bằng --trusted-host. Đây là một credential thực sự. Tuy nhiên, tài liệu của dự án cảnh báo rằng URL được in ra là credential chỉ được chia sẻ với người dùng được phép, và HTTP thuần sẽ gửi URL này không mã hóa. Từ 0.2.1-alpha.2, web app cũng có thể bind vào một địa chỉ local cụ thể và tự phục vụ HTTPS bằng --tls-cert và --tls-key. Cách này giải quyết vấn đề plaintext, không giải quyết vấn đề exposure. Nó khiến port bị expose khó bị lạm dụng hơn. Nó không biến port đó thành thứ được phép public.

Tiếp theo, hãy xem những gì nằm phía sau port này. Agent chỉnh sửa file trong workspace và chạy shell command. Credential của provider cũng nằm trên disk bên cạnh nó. Vì vậy, trên release được pin, port 3080 mở ra tương đương một remote shell có chat interface, chạy dưới user đã khởi động nó và có API key của bạn. Không cần exploit để truy cập. Kẻ tấn công chỉ cần biết số port. Trên release có launch token, họ còn cần token đó. Tuy nhiên, bất kỳ ai đọc được terminal, service log hoặc network traffic không mã hóa của bạn đều đã có token.

CLI (command line interface) cũng xác nhận điều này. Kể từ 0.1.0-rc.6, CLI cố ý không hỗ trợ --host 0.0.0.0 và thoát với usage error thay vì khởi động. 0.2.2-alpha.2 mới hơn vẫn từ chối tùy chọn này khi khởi động. Việc từ chối là một tính năng. Vì vậy, đừng tìm patch để gỡ bỏ nó.

Có 2 kiểu deployment khác phù hợp khi tunnel không đáp ứng yêu cầu. Đưa máy chủ vào private overlay network để máy chỉ có một địa chỉ mà các thiết bị của bạn có thể route đến. Đây là chức năng mà một self-hosted Headscale control server cung cấp. Hoặc đặt reverse proxy phía trước để xác thực request trước khi request đến port 3080, chẳng hạn dùng một Authentik single sign-on server với forward auth. Reverse proxy không có auth ở phía trước không phải là một security control. Nó chỉ là một URL dài hơn.

Truy cập giao diện web qua SSH tunnel

Chạy lệnh này trên laptop của bạn, không phải trên server.

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

-L mở cổng 3080 trên laptop và chuyển tiếp mọi kết nối đến cổng đó qua phiên SSH được mã hóa. Phần 127.0.0.1:3080 được phân giải trên server, nên kết nối đến harness từ loopback, giống hệt như khi bạn đang ngồi trực tiếp trên máy. -N cho biết không khởi động remote shell, vì bạn chỉ cần forward và không cần thực hiện thêm việc gì.

Sau đó, mở http://127.0.0.1:3080 trong trình duyệt cục bộ. Với bản release có launch token, hãy mở đầy đủ startup URL mà server đã in ra thay vào đó, bao gồm cả token; khi harness được khởi động qua SSH, nó vẫn in dòng startup nhưng không tự mở trình duyệt cho bạn. Nếu cổng 3080 đã được sử dụng trên laptop, hãy đổi số ở bên trái: ssh -N -L 3180:127.0.0.1:3080 you@your-server, rồi truy cập http://127.0.0.1:3180, đồng thời đổi cổng trong URL có token theo cách tương tự. Số bên trái là cổng cục bộ, còn số bên phải thuộc về server, nên chỉ thay đổi số bên trái.

Lưu lại trong ~/.ssh/config và không phải nhập lại.

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

Sau đó, ssh -N dsh sẽ khởi động tunnel. Nếu trình duyệt báo kết nối bị từ chối, thường là tunnel đã hoạt động nhưng không có tiến trình nào listening ở đầu bên kia, vì SSH forward cổng bất kể harness có đang chạy hay không. Kiểm tra server bằng lệnh ss ở trên.

Duy trì harness chạy sau khi đăng xuất

Một lệnh npx sẽ dừng cùng shell của bạn. systemd user service vẫn tiếp tục chạy và khởi động lại harness sau khi bị crash hoặc sau khi reboot. Unit ở đây được cố ý giữ ở mức tối giản; nếu bạn muốn chạy harness dưới một account riêng đã khóa quyền, pin version trong unit và có log dễ tìm kiếm, cấu hình systemd headless cho dsh trình bày đầy đủ.

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

enable-linger quan trọng vì user service thường dừng khi session cuối cùng của bạn kết thúc. Nếu thiếu tùy chọn này, harness sẽ dừng ngay khi bạn đóng tunnel. Lấy đường dẫn tuyệt đối do command -v dsh in ra và đặt đường dẫn đó vào unit, vì systemd không tìm trong PATH mà login shell của bạn tạo ra.

[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 không phải tùy chọn cho có. Process dsh sử dụng thư mục nơi nó được gọi làm vị trí filesystem mặc định, nên service khởi động sai chỗ sẽ trỏ agent đến sai thư mục. Tuy nhiên, thư mục đó chỉ là giá trị mặc định: Web UI mới không có workspace được chọn cho đến khi bạn thêm một workspace trong Choose workspace, và guide của project yêu cầu bạn thêm thư mục nơi bạn đã khởi động dsh. Guide không có version marker, và cùng nội dung đó đã có trong 0.1.0-rc.7, nên release đã pin cũng sẽ có nội dung này. Đặt thư mục của unit trỏ đến project, rồi chọn workspace đó trong UI.

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

Unit không khởi động được gần như luôn do đường dẫn ExecStart sai hoặc do binary không chấp nhận version Node đang dùng; journalctl --user -u dsh -n 50 cho biết nguyên nhân cụ thể. Với release có launch token, journal cũng là nơi URL khởi động chứa token xuất hiện, và mỗi lần restart sẽ in ra một URL mới. Cùng cách này cũng áp dụng cho duy trì mọi coding agent chạy trên VPS, và các dạng lỗi cũng giống nhau.

Plugin được phép làm gì

Plugin là một module cung cấp service, typed event và effect có thể hoàn tác cho một context dùng chung. Cần đọc kỹ các extension point sau:

  • đăng ký model provider trên ctx.llm
  • thêm tool dành cho model trên ctx.tools
  • cung cấp shell backend phía sau ctx.shell
  • cung cấp quyền truy cập filesystem hoặc policy phía sau ctx.fs
  • đăng ký human command trên ctx.commands
  • chạy tác vụ nền thông qua ctx.jobs
  • bọc các process được spawn bằng backend ctx.sandbox
  • intercept request và tool call thông qua các event agent/* và tools/*
  • mở rộng durable session state
  • điều khiển UI thông qua ctx.agents

Hãy đọc danh sách này theo góc nhìn của attacker. Plugin có thể cung cấp filesystem layer và shell layer, đồng thời nằm giữa mọi tool call do model thực hiện. Không có permission dialog nào ngăn plugin truy cập các điểm nối này, vì plugin là code Node thông thường được load vào cùng process với mọi thành phần khác. Cài một plugin nghĩa là chạy code của một bên không đáng tin cậy với quyền của agent, mà quyền của agent chính là quyền của Unix user đang chạy agent.

Đây là cùng một quyết định về mức độ tin cậy mà bạn đưa ra khi gắn MCP server vào agent trên VPS, trong đó MCP là model context protocol. Đây cũng là lý do chạy coding agent an toàn trên VPS phải bắt đầu từ account mà agent sử dụng, thay vì bắt đầu từ model, và là lý do các cuộc tấn công supply chain qua npm gây hậu quả nghiêm trọng trên server: bước install chính là lúc server bị breach, và không có prompt nào hỏi bạn.

Nguồn gốc của plugin

Plugin nằm trong các profile. Profile là một cấu hình composition có tên, được lưu dưới $DSH_HOME. Mặc định, thư mục này là ~/.dsh. Mỗi thư mục profile chứa các plugin out-of-tree mà profile đó cài đặt. CLI quản lý chúng bằng cách chuyển thẳng các đối số của bạn tới pnpm và dùng thư mục profile làm working directory.

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

Vì các đối số được chuyển tới pnpm mà không thay đổi, add, remove, update và why hoạt động như trong mọi project pnpm. Plugin có thể là một npm package hoặc một GitHub reference. pnpm phải có sẵn trong PATH trước. Trên Node 24, corepack enable pnpm thêm nó vào PATH. Node 25 không còn phân phối Corepack, nên trên Node 25 và các phiên bản mới hơn, hãy cài nó bằng npm install -g pnpm.

Cơ chế discovery dùng một GitHub topic. Tác giả plugin thêm topic dsh-plugin vào repository của họ. Bạn tìm plugin bằng cách duyệt topic này. Topic là nhãn do tác giả tự gắn vào repository của mình. Không có ai review hoặc ký xác nhận topic đó. Trang topic xếp hạng theo số star, chỉ phản ánh độ phổ biến chứ không phản ánh độ an toàn.

Các bản phát hành hiện tại cũng có một bundle Custom plugin indexes thử nghiệm. Bật tính năng này trong Plugins để xuất hiện tab Discover. Tab này cho phép bạn thêm một index, tức một file JSON được tải từ URL do bạn cung cấp. Harness không kèm index riêng, chỉ kiểm tra format của file chứ không kiểm tra title, tác giả hoặc nguồn mà market công bố. Bất kỳ ai nằm trên đường truyền mạng cũng có thể sửa index được phục vụ qua http: không mã hóa. Market là catalogue do người khác viết, không phải kết quả review.

Bốn thói quen sau giúp việc này dễ kiểm soát. Đọc source trước khi cài, vì hầu hết plugin đủ nhỏ để đọc trong mười phút. Pin chính xác version hoặc commit thay vì theo dõi một branch. Chạy harness bằng một user không sở hữu tài nguyên nào khác, trên một VPS mà bạn sẵn sàng rebuild. Cấp cho agent một API key riêng với spending limit riêng, tách khỏi key mà các service production sử dụng. Khi đọc plugin và muốn biết file nào có rủi ro, phần hướng dẫn kiểm tra plugin dsh trình bày manifest, entry point và các extension point mà plugin đăng ký.

Nếu muốn so sánh các thiết kế trước khi chọn, harness multi-agent Omnigent giải quyết cùng vấn đề bằng một cấu trúc khác. Khi plugin được đưa vào sử dụng, các trade-off sẽ rõ ràng hơn. Nếu bạn giữ lại hai hoặc ba harness trên cùng một máy thay vì chọn một, đặt mọi harness phía sau một API tự host giúp bạn không phải tạo một tunnel cho từng port. Đổi lại, bạn phải bind thêm một service vào loopback và đặt password thực ngay từ ngày đầu.

Điều gì hỏng trước

Node quá cũ. Nhánh chính của dự án và 0.2.2-alpha.2 yêu cầu Node 24.9 trở lên. CI của dự án kiểm thử Node 24, đồng thời kiểm tra khả năng tương thích trên Node 24.9 và Node 26, nhưng không có gì trên Node 22. Các bản release được tag cũ hơn, đến 0.2.1-rc.4, liệt kê Node 22.19 là phiên bản được chấp nhận, nhưng dự án hiện không còn build với Node 22.19. Runtime cũ sẽ fail khi khởi động vì code sử dụng cú pháp và API mà runtime đó không có. Chạy node --version trước mọi việc khác.

Cổng 3080 đã được sử dụng. Có thể một harness thứ hai, một process cũ hoặc một ứng dụng không liên quan cũng đang dùng 3080. Tìm process đó bằng ss -tlnp | grep 3080, rồi dừng nó hoặc khởi động harness ở nơi khác bằng dsh web --port 3180. --port thuộc về web app, nên đặt nó sau web.

Browser không thể kết nối qua tunnel. Xác nhận bạn đã truy cập 127.0.0.1, không phải địa chỉ public của server, vì port được forward chỉ tồn tại trên laptop của bạn. Sau đó xác nhận harness đang listen trên server, vì SSH vẫn thiết lập forward dù đầu xa có process trả lời hay không.

dsh plugin fail ngay lập tức. Lệnh này là wrapper quanh pnpm, nên nếu thiếu binary pnpm thì lệnh sẽ dừng trước khi bắt đầu xử lý plugin. Trên Node 25 trở lên, đây là trạng thái mặc định vì Corepack không còn được ship cùng Node.

Agent không nhìn thấy project của bạn. Web UI mới không có workspace được chọn cho đến khi bạn thêm một workspace. Session composer cũng vẫn không khả dụng cho đến lúc đó. Process chỉ dùng thư mục nơi nó được khởi động làm vị trí filesystem mặc định. Vì vậy, unit có WorkingDirectory là thư mục home của bạn sẽ trỏ agent vào thư mục home đó. Chọn workspace trong UI, hoặc sửa unit rồi reload nó.

FAQ

Có an toàn khi mở giao diện web DeepSeek Harness trên cổng 3080 không?

Không. Trong 0.1.0-rc.6 đã ghim, web server không có cơ chế đăng nhập riêng. Agent phía sau có thể chỉnh sửa file và chạy shell command với tài khoản đã khởi động tiến trình. API key của provider cũng được lưu trên cùng ổ đĩa. Từ 0.2.0-rc.2 trở đi, bao gồm 0.2.2-rc.1, bản phát hành latest của npm vào ngày 12 November 2026 và bản prerelease mới hơn 0.2.2-rc.2, URL khởi động được in ra có chứa launch token. Trình duyệt dùng token này để đổi lấy session cookie. Tuy nhiên, URL đó là một credential và HTTP thông thường gửi nó mà không mã hóa. Vì vậy, khuyến nghị không thay đổi. Giữ listener trên 127.0.0.1 và truy cập qua SSH tunnel. Bạn cũng có thể dùng private overlay network hoặc reverse proxy xác thực mọi request trước khi request đến cổng này. Từ version 0.1.0-rc.6, CLI từ chối --host 0.0.0.0 và thoát với lỗi sử dụng. 0.2.2-alpha.2 vẫn từ chối tùy chọn này. Điều đó cho thấy các tác giả đánh giá ý tưởng này như thế nào.

Tôi có cần DeepSeek API key không, hay có thể dùng local model?

Cả hai đều được, vì harness là runtime chứ không phải model. Trong Settings, sau đó vào Models, bạn có thể dán key vào thẻ DeepSeek hoặc một catalog provider. Bạn cũng có thể chọn "Add model provider", sau đó chọn "Custom model API" và cung cấp base URL tương thích với OpenAI Chat Completions, OpenAI Responses, Anthropic Messages hoặc Gemini API. Local Ollama server phản hồi tại http://127.0.0.1:11434/v1/ và chấp nhận mọi chuỗi trong trường API key. Các key được lưu tại $DSH_HOME/.credentials.yaml, mặc định là ~/.dsh/.credentials.yaml.

Việc cài plugin DeepSeek Harness thực sự cấp cho plugin những gì?

Plugin có các quyền của account đang chạy harness. Plugin là mã Node được load vào cùng process. Các extension point bao gồm shell backend, filesystem layer, tool registry và event bao quanh mọi tool call. Không có cơ chế sandbox nào ngăn plugin truy cập các điểm tích hợp đó, trừ khi chính plugin cung cấp sandbox. Hãy đọc source trước khi cài. Chạy harness bằng một user không sở hữu dữ liệu hoặc tài nguyên quan trọng đối với bạn.

Nên cài version nào, và nó có tiếp tục hoạt động không?

Hãy cài một version cụ thể, ví dụ npx @deepseek-ai/dsh@0.1.0-rc.6 web. Đây là version tháng August 2026 được ghim trong tài liệu này. Vào ngày 12 November 2026, npm tag latest trỏ đến 0.2.2-rc.1. GitHub liệt kê prerelease mới hơn là 0.2.2-rc.2, được phát hành ngày 11 November. CLI hiện tại yêu cầu Node 24.9 trở lên. Dự án tự mô tả là developer preview và cho biết các thay đổi phá vỡ khả năng tương thích là điều được dự kiến. Vì vậy, một command không ghim version có thể hoạt động khác nhau từ ngày này sang ngày khác. Hãy kiểm tra repository trước khi upgrade. Bạn cũng nên dự kiến config key và plugin interface sẽ thay đổi trong thời gian version vẫn bắt đầu bằng 0.

Bài viết này có hữu ích không?