SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor · Cập nhật ngày 2026-11-06

Cách chạy dsh trên VPS bằng systemd service

Hướng dẫn cấu hình dsh chạy ngầm trên VPS với systemd. Thiết lập user riêng, chính sách Restart, quản lý log qua journalctl và tạo SSH tunnel để truy cập UI an toàn.

Chạy dsh ở chế độ không có terminal trên VPS

Chạy dsh ở chế độ không có terminal trên VPS chỉ cần một file unit của systemd và một user riêng để sở hữu service này. dsh là CLI launcher cho DeepSeek Harness, runtime agent của DeepSeek, được phát hành theo giấy phép MIT ở bản developer preview vào tháng 8 năm 2026. Harness là chương trình chạy xung quanh model, không phải bản thân model. Vì vậy, thứ bạn đưa vào systemd là vòng lặp, các tool và quyền truy cập, không phải phần inference của DeepSeek. Quickstart yêu cầu bạn nhập npx @deepseek-ai/dsh web. Cách này đúng, nhưng tiến trình cũng dừng ngay khi bạn đóng phiên SSH (secure shell).

Một file unit giải quyết đồng thời 4 vấn đề. Service sẽ khởi động lại sau khi reboot. Output được ghi vào journal thay vì chạy hết trên terminal. Service chạy bằng một account không phải root. Phiên bản được chạy là phiên bản bạn đã chọn. Điều này đặc biệt quan trọng trong trường hợp này vì upstream cảnh báo bằng chữ in hoa:

DeepSeek Harness hiện đang ở giai đoạn developer preview và được phát triển rất nhanh. SẼ CÓ CÁC THAY ĐỔI LÀM MẤT TƯƠNG THÍCH.

Hướng dẫn này giả định dsh đã chạy được khi bạn khởi động thủ công. Nếu chưa, hãy bắt đầu với cài đặt DeepSeek Harness trên VPS, rồi quay lại sau khi npx @deepseek-ai/dsh web phục vụ được một trang.

Cài Node trước vì cảnh báo của npm là chưa đủ

node -v

Package của Ubuntu 24.04 là Node 18 (18.19.1 vào tháng 8 năm 2026), đã cũ đối với một package được phát hành trong năm nay. npm có kiểm tra phiên bản Node: tài liệu của npm nói rằng trường engines của package “chỉ tạo cảnh báo” nếu bạn chưa bật engine-strict. Các manifest @deepseek-ai/dsh đã phát hành hoàn toàn không có trường engines (được kiểm tra vào ngày 27 tháng 10 năm 2026 đối với 0.1.0-rc.7, 0.2.1-rc.2 và 0.2.1-rc.4), dù repository có khai báo trường này; npm cũng kiểm tra yêu cầu engine của các dependency. Bản phát hành 0.2.1-rc.2 được ghim phiên bản khai báo commander: ^15.0.0, còn Commander 15 yêu cầu Node >=22.12.0, nên cài đặt package này trên Node 18 của Ubuntu sẽ tạo cảnh báo EBADENGINE với thiết lập npm mặc định. Theo mặc định, cảnh báo đó không dừng quá trình cài đặt. Vì vậy, hãy kiểm tra Node trước khi gặp lỗi lúc chạy.

Mức phiên bản tối thiểu của repository cũng đã tăng. Mã nguồn 0.2.1-rc.2 chấp nhận ^22.19.0 || >=24.0.0, nhưng CLI package trên nhánh master hiện khai báo >=24.9.0, và Node 22 không đáp ứng yêu cầu này. Hãy cài Node 24 từ NodeSource. Đây là dòng long term support (LTS), đang trong giai đoạn maintenance từ ngày 20 tháng 10 năm 2026, và các bản build hiện tại đáp ứng cả hai khoảng phiên bản. Theo lịch phát hành Node.js, Node 26 trở thành LTS vào ngày 28 tháng 10 năm 2026.

curl -fsSL https://deb.nodesource.com/setup_24.x -o /tmp/nodesource_setup.sh
less /tmp/nodesource_setup.sh
sudo -E bash /tmp/nodesource_setup.sh
sudo apt install -y nodejs
node -v

node -v lúc này phải in ra phiên bản v24, 24.9.0 hoặc mới hơn. Dòng less có mặt vì pipe trực tiếp một script từ xa vào bash sẽ chạy đoạn code mà bạn chưa đọc.

Chạy thử trước khi viết unit

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

Giữ tiến trình đó đang chạy. Mở một phiên SSH thứ hai:

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/

Bất kỳ mã trạng thái HTTP nào cũng cho biết web profile đang lắng nghe trên loopback, đây là địa chỉ bind mặc định của nó. Hãy chờ 401 và xem đó là kết quả đạt: UI xác thực trình duyệt bằng launch token trong URL được in ra, rồi đổi token đó lấy signed session cookie. Request không chứa cả hai thông tin này sẽ nhận mã 401. 000 cùng với curl: (7) Failed to connect to 127.0.0.1 port 3080 cho biết ứng dụng không lắng nghe, và terminal thứ nhất sẽ cho biết nguyên nhân. Dừng lần chạy thủ công bằng Ctrl+C trước khi tiếp tục: unit cố bind vào một port đã bị tiến trình khác chiếm sẽ fail với Error: listen EADDRINUSE: address already in use 127.0.0.1:3080.

0.1.0-rc.7 là phiên bản được công bố vào ngày 18 August 2026 và có trước cơ chế xác thực trình duyệt mà hướng dẫn này dựa vào: README Connection của phiên bản đó nói rằng fence là một chính sách reachability và "Web carrier provides no authentication layer". Vào ngày 11 October 2026, tag latest trỏ đến 0.2.0-rc.2. Vào ngày 27 October 2026, latest trỏ đến 0.2.1-rc.2 còn next trỏ đến 0.2.1-rc.4, vì vậy các command ở đây pin 0.2.1-rc.2. Vào ngày 4 November 2026, danh sách phiên bản của npm cho thấy cả latest và next đều ở 0.2.1-rc.5; các command ở đây giữ nguyên pin hiện có. Kiểm tra phiên bản hiện tại bằng npm view @deepseek-ai/dsh version, rồi pin phiên bản bạn quyết định chạy.

Cài phiên bản đã pin vào hệ thống

npx là công cụ không phù hợp khi dùng trong unit file. Nếu không chỉ định phiên bản hoặc không có bản cài đặt cục bộ tương ứng, nó sẽ phân giải phiên bản package khi process khởi động. Vì vậy, một lần restart sau 3 tháng có thể chạy một build khác của agent đang ở giai đoạn preview mà bạn không thay đổi gì. Package hoặc dữ liệu cache bị thiếu cũng yêu cầu truy cập npm registry, nên registry chậm có thể làm startup bị trì hoãn hoặc thất bại; npm cũng hỗ trợ chạy bằng cache và chạy offline. Hãy cài đặt một lần với phiên bản bạn đã ghi lại:

sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dsh

command -v dsh in /usr/bin/dsh khi npm được cài từ NodeSource và /usr/local/bin/dsh khi npm đến từ package riêng của Ubuntu. Hãy dùng path mà lệnh thực tế in ra trong unit file. npm ls -g in chính xác phiên bản đang dùng. Đây là thông tin bạn cần sau 6 tuần, khi hành vi thay đổi và bạn không còn nhớ mình đã cài phiên bản nào. Nếu cài đặt thất bại, command -v dsh không in gì sau đó hoặc phiên bản trả về không đúng phiên bản bạn yêu cầu, hãy xử lý các lỗi cài đặt và kiểm tra phiên bản dsh thường gặp trước khi viết unit file.

Một user sở hữu service và không làm gì khác

Agent chạy các shell command. Đó là nhiệm vụ của nó. Chạy agent bằng root khiến mọi tool call đều chạy với quyền root, vì vậy hãy cấp cho nó một account riêng không có login shell.

sudo useradd --system --create-home --home-dir /var/lib/dsh --shell /usr/sbin/nologin dsh
sudo install -d -o dsh -g dsh -m 750 /var/lib/dsh/harness /var/lib/dsh/workspace
id dsh

/var/lib/dsh/harness trở thành DSH_HOME, thư mục nơi dsh lưu các profile. Profile là một stack có tên gồm các plugin bundle, kèm theo patch layer riêng của bạn ở trên cùng. Các profile web và headless tự tạo từ template được cung cấp trong lần đầu bạn boot chúng. Mọi thứ bạn thêm vào stack sau đó đều chạy bằng user này, với quyền truy cập file và shell riêng của agent. Vì vậy, kiểm tra plugin trước khi cài cũng thuộc cùng công việc với việc tạo account. Lần boot đầu tiên sẽ ghi file và có thể tải bundle, nên hãy thực hiện thủ công ở nơi bạn có thể theo dõi.

sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile web

Đặt HOME một cách tường minh thay vì tin vào cách sudo xử lý biến này, vì việc sudo giữ nguyên hay ghi lại HOME phụ thuộc vào các thiết lập như env_reset, env_keep và always_set_home trong /etc/sudoers. Nếu đặt sai, lần chạy đầu tiên sẽ cố dùng thư mục home của bạn để lưu cache và state. Điều này gây lỗi quyền hoặc đặt state vào nơi service sẽ không dùng sau đó. Dừng bằng Ctrl+C khi bước kiểm tra curl in ra status code.

Tệp unit

Viết /etc/systemd/system/dsh.service:

[Unit]
Description=DeepSeek Harness (dsh) web profile
Documentation=https://github.com/deepseek-ai/deepseek-harness
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5

[Service]
Type=exec
User=dsh
Group=dsh
WorkingDirectory=/var/lib/dsh/workspace
Environment=HOME=/var/lib/dsh
Environment=DSH_HOME=/var/lib/dsh/harness
ExecStart=/usr/bin/dsh --profile web
Restart=on-failure
RestartSec=5s
TimeoutStopSec=30s
SyslogIdentifier=dsh
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=full
ProtectHome=true

[Install]
WantedBy=multi-user.target

ExecStart= nhận đường dẫn tuyệt đối lấy được từ command -v dsh. systemd sẽ tìm trong một danh sách đường dẫn cố định khi gặp tên lệnh không có đường dẫn đầy đủ. Danh sách đó không phải là PATH của shell, nên dùng đường dẫn tuyệt đối sẽ loại bỏ việc phải đoán.

WorkingDirectory= là nơi các đường dẫn tương đối được phân giải. Đây cũng là nơi một lần gọi tool chạy ls không có tham số sẽ bắt đầu. Trỏ nó đến workspace mà bạn cấp cho agent. Nếu thư mục không tồn tại hoặc service user không thể truy cập thư mục đó, unit sẽ fail với status=200/CHDIR trước khi dsh chạy.

ProtectHome=true ẩn /home và /root khỏi process. Cách này an toàn ở đây vì mọi thứ service truy cập đều nằm dưới /var/lib/dsh. Nếu trỏ workspace đến một đường dẫn dưới /home, agent sẽ báo thư mục không tồn tại. Điều này dễ gây nhầm lẫn nếu bạn quên dòng này. ProtectSystem=full đặt /usr, /boot và /etc ở chế độ chỉ đọc. Service không cần ghi vào các thư mục này.

Đi xa hơn thường rất hấp dẫn nhưng thường là sai. ProtectSystem=strict làm toàn bộ filesystem ở chế độ chỉ đọc, ngoại trừ các pseudo-filesystem của kernel và, với PrivateTmp=true, /tmp và /var/tmp của unit này, việc ghi vào workspace sẽ fail với EROFS: read-only file system. Nếu muốn mức hạn chế đó, thêm ReadWritePaths=/var/lib/dsh trong cùng lần chỉnh sửa.

Type= nào phù hợp ở đây

Type=exec, vì dsh chạy ở foreground và không bao giờ fork. So với giá trị mặc định, cách này cho bạn một thông báo lỗi thực sự. Với Type=simple, systemd coi thao tác start là thành công ngay sau khi đã fork, trước khi biết binary có tồn tại hay không. Vì vậy, systemctl start dsh trả về bình thường và lỗi chỉ xuất hiện trong journal. Với Type=exec, systemd chờ execve() thành công. Do đó, lỗi gõ sai trong ExecStart= sẽ làm lệnh bạn vừa nhập thất bại và bạn thấy lỗi ngay tại đó.

Hai đáp án sai đều bị treo. Type=forking yêu cầu systemd chờ một process cha thoát, nhưng dsh không bao giờ thoát. Vì vậy, thao tác start bị chặn cho đến khi TimeoutStartSec hết thời gian chờ (mặc định là 90 giây), rồi báo Job for dsh.service failed because a timeout was exceeded. Type=notify chờ một thông báo READY=1 qua sd_notify. Một process Node không bao giờ gửi thông báo này cũng bị treo tương tự. So sánh đầy đủ các loại service của systemd trình bày các trường hợp còn lại, bao gồm khi nào việc cấu hình notify là đáng công.

Quy tắc restart phải báo lỗi rõ ràng

Restart=on-failure sẽ restart khi tiến trình thoát với mã khác 0 hoặc kết thúc do signal không sạch, đồng thời không tác động đến unit sau khi tiến trình thoát sạch; systemd xem SIGHUP, SIGINT, SIGTERM và SIGPIPE là các signal kết thúc sạch đối với loại service này. Đây là hành vi phù hợp với một bản build preview. Nếu dsh thoát với mã 0 vì đọc phải một config không hợp lệ, unit sẽ dừng và giữ nguyên trạng thái dừng; systemctl status dsh hiển thị inactive (dead) để bạn kiểm tra. Restart=always biến cùng sự kiện đó thành một vòng lặp restart mà nhìn từ xa vẫn có vẻ đang hoạt động bình thường.

Giới hạn tần suất là phần thường bị bỏ sót. Giá trị mặc định của systemd là 5 lần start trong 10 giây; với RestartSec=5s, bạn không bao giờ đạt 5 lần start trong một khoảng 10 giây. Vì vậy, unit bị crash khi khởi động sẽ restart mãi và chỉ journal biết điều đó. StartLimitIntervalSec=300 cùng với StartLimitBurst=5 cho phép 5 lần start trong 5 phút, sau đó từ chối các lần start tiếp theo trong khoảng thời gian đó. systemd sẽ bỏ cuộc và đưa unit vào trạng thái failed, đồng thời ghi log Start request repeated too quickly.. Xóa trạng thái này bằng sudo systemctl reset-failed dsh sau khi bạn đã sửa nguyên nhân. Cả hai thiết lập phải nằm trong [Unit], không phải [Service]; các option không được nhận diện sẽ tạo warning log thay vì bị bỏ qua âm thầm.

Khởi động và kiểm tra dịch vụ

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

enable --now thực hiện hai nhiệm vụ. enable là lệnh giúp dịch vụ tự khởi động sau khi reboot, còn --now khởi động dịch vụ ngay trong phiên làm việc hiện tại. Nếu chỉ dùng systemctl start, dịch vụ sẽ mất sau lần reboot tiếp theo, và các bản cập nhật kernel thường yêu cầu reboot.

systemctl status dsh sẽ hiển thị Active: active (running), một Main PID, và một dòng Memory:. Sau đó, hãy xác nhận cổng đang lắng nghe:

sudo ss -lntp | grep 3080

Bạn cần kết quả là 127.0.0.1:3080. Nếu thấy bất kỳ địa chỉ nào khác, một flag --host đã chuyển listener sang network tương ứng, và dịch vụ sẽ phục vụ HTTP thuần nếu không cấu hình TLS. Tên tiến trình trong kết quả đó là node, không phải dsh, vì binary dsh là một Node script, nên pgrep -x dsh sẽ không tìm thấy gì. Hãy dùng systemctl show -p MainPID dsh thay thế.

Sau đó, hãy reboot một lần. Một dịch vụ chưa từng sống sót qua một lần reboot thì chưa được coi là một dịch vụ hoàn chỉnh.

sudo reboot

Kết nối lại và chạy systemctl is-active dsh. Nó sẽ in ra active.

Đọc log bằng journalctl

Mọi thứ dsh ghi vào stdout và stderr đều được đưa vào journal dưới tên unit.

journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err

-f theo dõi các dòng mới, -n hiển thị N dòng cuối, -p err lọc theo mức độ ưu tiên. SyslogIdentifier=dsh trong unit là lý do các dòng đó được gắn nhãn dsh thay vì node. Điều này quan trọng khi bạn đọc journal output chưa được lọc theo unit lần đầu.

Hãy kiểm tra journal có tồn tại sau khi reboot trước khi bạn cần đến nó:

journalctl -u dsh -b -1

Nếu lệnh in ra Specifying boot ID or boot offset has no effect, no persistent journal was found, journal nằm trong /run và bị xóa sau mỗi lần reboot. Với Storage=auto, hãy tạo directory rồi restart daemon. Nếu đã cấu hình Storage=volatile, trước tiên đổi thành persistent:

sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journald

Chạy sudo journalctl --flush để chuyển sang lưu trữ persistent và flush log của boot hiện tại xuống disk.

Truy cập UI qua SSH tunnel, không mở public port

dsh phục vụ web UI (giao diện người dùng) tại 127.0.0.1:3080 theo mặc định. Loopback là giá trị mặc định, không phải lựa chọn duy nhất: --host chấp nhận một địa chỉ IPv4 hoặc IPv6 cụ thể của interface cục bộ, và mọi địa chỉ không phải loopback sẽ phục vụ mạng chứa địa chỉ đó qua HTTP thuần, đồng thời hiển thị cảnh báo khi khởi động, trừ khi bạn cũng truyền --tls-cert và --tls-key. dsh không chấp nhận wildcard. Hãy yêu cầu --host 0.0.0.0 và lỗi sẽ bắt đầu như sau:

webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:

Thông báo tiếp tục nói rằng “binding every interface would expose remote code execution to the network” và yêu cầu bạn “bind one concrete IPv4 or IPv6 address of a local interface instead”. Một giá trị hoàn toàn không phải IP literal, chẳng hạn hostname, sẽ lỗi với is not a concrete IPv4 or IPv6 address literal.

Dù vậy, hãy giữ giá trị mặc định. Web API (application programming interface) điều khiển agent, còn agent chạy shell command. dsh có đặt lớp xác thực trước API đó: kiểm tra Host và Origin, cùng launch token trong URL được in ra. UI đổi token này lấy signed session cookie. Tuy nhiên, khi dùng HTTP thuần, token sẽ đi qua mạng dưới dạng cleartext. Tài liệu của upstream cũng nói rằng kiểm tra Host không bảo vệ chính listening port. Nếu cần UI trên một hostname thật, hướng dẫn triển khai public của DeepSeek có phần cấu hình reverse proxy với --public-url và --trusted-host, hoặc TLS native với --tls-cert và --tls-key. Dòng 127.0.0.1:3080 trong output khởi động thực sự có nghĩa gì đáng đọc trước khi bạn thử thay đổi cấu hình này. Với máy chỉ mình bạn sử dụng, hãy forward port từ máy của bạn:

ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10

-L 3080:127.0.0.1:3080 mở port 3080 trên laptop và gửi mọi dữ liệu đến đó tới 127.0.0.1:3080, được phân giải trên VPS. -N có nghĩa là không chạy remote command, nên session chỉ giữ tunnel mở. Hãy để tunnel chạy, dùng journalctl -u dsh -n 100 --no-pager để tìm URL mà dsh đã in khi khởi động, rồi mở URL đó trong trình duyệt. URL này chứa launch token. Mở http://127.0.0.1:3080/ trong một trình duyệt chưa đăng nhập sẽ nhận 401. Token thuộc về process đang chạy, nhưng session cookie được cấp từ token này tồn tại lâu hơn process: cookie được ký bằng secret mà dsh lưu trong $DSH_HOME/.credentials.yaml và mặc định có thời hạn 30 ngày. Vì vậy, trình duyệt đã đăng nhập có thể mở lại URL gốc, kể cả sau khi restart. Bạn chỉ cần lấy URL mới từ journal khi dùng trình duyệt mới hoặc khi cookie đã hết hạn. Hãy coi URL này như một credential: upstream nói chỉ chia sẻ URL cho những người được chỉ định, và bất kỳ ai đọc được system journal đều có thể đọc nó. Sau khi đăng nhập, bạn nhập DeepSeek API key trong Settings rồi Models, đồng thời chọn workspace directory tại đây. Trỏ workspace đến /var/lib/dsh/workspace, là directory do service user sở hữu, nếu không các file tool của agent sẽ lỗi với EACCES: permission denied.

Nếu port 3080 đang được sử dụng trên laptop, ssh sẽ báo:

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

Hãy chọn một local port khác bằng ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10, rồi mở URL đã in ra sau khi thay 3080 bằng 3081. Lưu thao tác nhập này trong ~/.ssh/config trên máy của bạn:

Host dsh-vps
  HostName 203.0.113.10
  User you
  LocalForward 3080 127.0.0.1:3080

Sau đó, ssh -N dsh-vps là toàn bộ command cần chạy. Tunnel này giờ là cánh cửa duy nhất vào agent, nên SSH daemon là thành phần bảo vệ nó: chỉ dùng key, tắt password authentication, và áp dụng toàn bộ hardening SSH trên VPS của bạn nghiêm ngặt hơn bình thường. Nếu VPS phát triển thành một private network nhỏ, có database hoặc staging box phía sau, quảng bá các địa chỉ đó vào tailnet bằng subnet router sẽ giúp bạn không phải forward từng service. Tuy nhiên, với dsh dùng loopback theo mặc định, bản thân UI vẫn phải đi qua tunnel.

Key không được đặt trong unit file. Các giá trị Environment= được systemctl show dsh -p Environment in ra, và mọi user trên máy đều có thể chạy command này. Nếu plugin bạn cài cần key trong environment, hãy đặt key trong /etc/dsh.env với mode 600, do root sở hữu, rồi tham chiếu file bằng EnvironmentFile=/etc/dsh.env. systemd đọc file đó với quyền root tại thời điểm exec, còn systemctl show không in nội dung file. Mỗi setting thực sự được lưu vào file nào trên disk, và dữ liệu gì rời khỏi máy khi bạn trỏ dsh đến local Ollama endpoint thay vì API của DeepSeek, là nội dung của cấu hình key, model và endpoint cho dsh.

Chi phí vận hành

Inference diễn ra trên API của DeepSeek, không phải trên VPS của bạn. Máy chủ của bạn chỉ phải chạy tiến trình Node, UI mà tiến trình này phục vụ và mọi lệnh mà agent quyết định chạy. Hai phần đầu có mức sử dụng ổn định và thấp. Phần thứ ba không bị giới hạn bởi bất kỳ thiết lập nào trong unit file này.

Hãy tự đo mức sử dụng cơ bản trên máy chủ của bạn thay vì tin vào con số từ máy của người khác:

systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2

MemoryCurrent có đơn vị là byte. Hãy theo dõi giá trị này khi agent đang làm việc, không phải khi agent đang ở trạng thái idle.

Các tool call là tiến trình con của service, nên chúng thuộc cùng control group và chịu cùng các giới hạn. Agent chạy npm install hoặc một test suite bên trong workspace có thể dùng nhiều memory hơn chính harness với mức chênh lệch rất lớn. Trên VPS 1 GB, đây là lúc sự cố xảy ra: kernel chọn một tiến trình và kill nó, còn journalctl -k | grep -i "out of memory" hiển thị dòng Out of memory: Killed process nêu tên tiến trình được chọn. Tiến trình đó thường không phải là tiến trình gây ra vấn đề.

Cách xử lý là chủ động đặt giới hạn. MemoryMax= và CPUQuota= trong section [Service] giữ tác động của sự cố bên trong unit, để một build chạy mất kiểm soát bị kill thay vì khiến toàn bộ máy chủ bị treo. Giới hạn memory và CPU bằng systemd trình bày các giá trị giới hạn và cách hệ thống xử lý khi vượt giới hạn. Disk cũng tăng do lịch sử session trong DSH_HOME và do mọi dữ liệu agent ghi vào workspace, vì vậy hãy đưa du -sh /var/lib/dsh vào công cụ bạn đang dùng để theo dõi disk.

Nếu bạn cần một agent tương tác mà bạn có thể attach và detach, service không phải mô hình phù hợp; chạy agent trong session tmux persistent sẽ phù hợp hơn. Hãy chạy dsh dưới dạng unit khi bạn muốn nó luôn hoạt động và có thể truy cập qua tunnel.

Các dạng lỗi và chuỗi bạn sẽ thấy

status=203/EXEC. systemd không thể chạy file và log Failed to locate executable /usr/local/bin/dsh: No such file or directory. Đường dẫn trong ExecStart= không khớp với kết quả command -v dsh đã in. Đây là lỗi mà Type=exec báo tại thời điểm systemctl start thay vì che giấu.

status=217/USER. systemd không thể xác định hoặc thay đổi thông tin xác thực người dùng từ User= và Group=, hoặc không thể thiết lập user namespace. Với unit này, nguyên nhân thường gặp là account không tồn tại. Xác nhận bằng id dsh.

status=200/CHDIR. WorkingDirectory= bị thiếu hoặc service user không thể truy cập vào đó. sudo -u dsh ls /var/lib/dsh/workspace tái hiện trực tiếp lỗi này.

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. Một tiến trình khác đang giữ port, thường là do lần chạy npx trước vẫn còn mở trong một terminal khác. sudo ss -lntp | grep 3080 cho biết process đó.

EACCES: permission denied kèm theo một đường dẫn. Ownership bên dưới /var/lib/dsh không đúng, thường vì lần chạy đầu tiên được thực hiện bằng root hoặc với HOME không đúng. sudo chown -R dsh:dsh /var/lib/dsh sẽ sửa lỗi này.

Start request repeated too quickly. Unit đã chạm rate limit khởi động và systemd từ bỏ. Lỗi thực sự nằm ở các dòng phía trên. Chạy sudo systemctl reset-failed dsh trước khi thử lại.

Unit là active (running) nhưng trình duyệt không hiển thị gì. Chạy phép kiểm tra trên VPS: nếu curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ in ra status code tại đó, listener đang trả lời trên VPS, nên kiểm tra port forward tiếp theo. Status code đó không chứng minh mọi thành phần đã được load: upstream cho biết lỗi của plugin tùy chọn không làm mất trạng thái sẵn sàng, vì vậy hãy đọc journalctl -u dsh -n 200 --no-pager để kiểm tra cả lỗi plugin. Trình duyệt hiển thị 401 nghĩa là nó không có session cookie hợp lệ và URL không chứa launch token hợp lệ, có thể vì bạn mở URL gốc hoặc token được tạo trước lần restart gần nhất. Hãy mở URL mà process hiện tại đã in ra.

Nâng cấp có chủ đích

Pinning có nghĩa là bạn chủ động nâng cấp, thay vì để hệ thống tự động nâng cấp. Hãy đọc release notes trước, vì cảnh báo của upstream về các thay đổi phá vỡ compatibility chính là lý do cần pinning. Sao lưu state directory, rồi đổi sang version mới:

sudo systemctl stop dsh
sudo tar czf /root/dsh-home-$(date +%F).tgz -C /var/lib/dsh harness
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
sudo systemctl start dsh
journalctl -u dsh -n 50 --no-pager

Rollback cũng tương tự npm install -g với version cũ, sau đó khôi phục tarball đó. Cách này chỉ hiệu quả nếu bạn đã tạo tarball trước. Preview-stage agent runtime chính là loại phần mềm có thể ghi đè định dạng config mà bạn đang dùng khi nâng cấp.

FAQ

Vì sao dsh dừng khi tôi đóng phiên SSH?

Vì npx @deepseek-ai/dsh web là một tiến trình foreground thuộc phiên đăng nhập của bạn, nên nó bị dừng khi phiên kết thúc. Một systemd unit thuộc init system, nên nó tiếp tục chạy sau khi bạn ngắt kết nối và khởi động lại sau reboot. sudo systemctl enable --now dsh là cặp bước giúp bạn có cả hai: enable cho các lần reboot, --now cho lần boot này.

Tôi nên dùng Type=simple hay Type=exec cho dsh?

Type=exec. dsh chạy ở foreground và không bao giờ fork, nên cả hai đều hoạt động, nhưng Type=exec khiến systemd chờ execve() chạy thành công trước khi xác nhận thao tác start thành công. Khi đó, đường dẫn sai trong ExecStart= sẽ làm systemctl start fail với status=203/EXEC ngay trước mắt bạn. Với Type=simple, cùng lỗi đó vẫn trả về thành công và bị ẩn trong journal. Type=forking và Type=notify đều không phù hợp ở đây, và cả hai sẽ treo cho đến khi TimeoutStartSec hết hạn sau 90 giây theo mặc định.

Làm cách nào để mở web UI của dsh từ laptop?

Forward cổng qua SSH: ssh -N -L 3080:127.0.0.1:3080 you@your-vps, sau đó mở URL mà dsh in ra khi khởi động. Bạn có thể tìm URL này bằng journalctl -u dsh trong trình duyệt. URL đó chứa launch token; trình duyệt chưa đăng nhập sẽ nhận 401 nếu thiếu token. Sau khi đăng nhập, session cookie mặc định có hiệu lực 30 ngày và vẫn còn sau khi service restart. Hãy giữ service dùng giá trị loopback mặc định. dsh từ chối wildcard như --host 0.0.0.0 vì đây là địa chỉ không cụ thể. Dù dsh chấp nhận một địa chỉ local cụ thể, bind vào địa chỉ không phải loopback sẽ cung cấp HTTP thuần nếu bạn chưa thiết lập TLS. Khi đó launch token của agent chạy shell command qua mạng sẽ được truyền dưới dạng cleartext.

Tôi có thể chạy dsh bằng root để đơn giản hóa quyền không?

Không. Harness này dùng để chạy command và ghi file, nên service có quyền gì thì agent cũng có các quyền đó. Hãy tạo một system account bằng useradd --system --shell /usr/sbin/nologin dsh, đặt /var/lib/dsh thuộc account đó và thêm NoNewPrivileges=true vào unit. Nếu sau đó bạn gặp EACCES: permission denied, nguyên nhân thường là một lần chạy trước đó bằng root đã để lại các file thuộc root; sudo chown -R dsh:dsh /var/lib/dsh sẽ dọn các file này.

Tôi nên ghim phiên bản dsh nào trong unit?

Dùng phiên bản mà npm view @deepseek-ai/dsh version báo cáo khi bạn thiết lập service, cài bằng npm install -g @deepseek-ai/dsh@<that version> và ghi lại ở một nơi bạn có thể tìm thấy. 0.1.0-rc.7 là phiên bản hiện tại vào ngày 18 August 2026, 0.2.0-rc.2 vào ngày 11 October 2026 và 0.2.1-rc.2 vào ngày 27 October 2026; khi đó next đã ở phiên bản 0.2.1-rc.4. Vào ngày 4 November 2026, cả latest và next đều trỏ đến 0.2.1-rc.5. Các build cũ đến mức 0.1.0-rc.7 chưa có browser authentication, nên không ghim một build như vậy cho web profile. Vấn đề không nằm ở con số phiên bản, mà là npx không có version sẽ resolve package tại thời điểm start. Vì vậy, một lần restart không có người giám sát có thể âm thầm chuyển bạn sang build dùng config format khác.

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