如何在 VPS 上用 systemd 无终端运行 dsh
通过专用用户和固定版本运行 DeepSeek Harness,配置 systemd 自动重启、journalctl 日志,并用 SSH 隧道安全访问 UI,避免 SSH 断开后进程退出。
在 VPS 上以无终端方式运行 dsh
在 VPS 上以无终端方式运行 dsh,只需要一个 systemd 单元文件,以及一个专门用于拥有该服务的用户。dsh 是 DeepSeek Harness 的命令行启动器。DeepSeek Harness 是 DeepSeek 的代理运行时,于 2026 年 8 月以 MIT 许可证发布开发者预览版。Harness 是围绕模型运行的程序,而不是模型本身。因此,交给 systemd 管理的是循环、工具和权限,不是 DeepSeek 的推理过程。快速入门要求您输入 npx @deepseek-ai/dsh web,这本身没有问题,但 SSH(安全 Shell)会话一关闭,该进程也会立即退出。
单元文件可以同时解决四个问题。服务会在重启后自动恢复。输出会写入 journal,而不是不断滚过终端。服务会以非 root 账户运行。服务运行的是您选择的版本。这一点在此处尤其重要,因为上游明确声明:
DeepSeek Harness 当前处于开发者预览版,并且正在快速迭代。将会发生不兼容变更。
本指南假设您已经可以手动运行 dsh。如果还不能运行,请先阅读在 VPS 上安装 DeepSeek Harness,然后在 npx @deepseek-ai/dsh web 可以提供页面后再继续。
先确认 Node,因为 npm 警告不足以说明问题
node -vUbuntu 24.04 自带的软件包提供 Node 18(截至 2026 年 8 月为 18.19.1)。对于今年发布的软件包来说,这个版本过旧。npm 本身确实会检查 Node 版本:其文档说明,除非启用 engine-strict,否则软件包的 engines 字段“只会产生警告”。已发布的 @deepseek-ai/dsh 清单完全没有 engines 字段(2026 年 10 月 27 日检查 0.1.0-rc.7、0.2.1-rc.2 和 0.2.1-rc.4 时确认),但仓库声明了该字段;此外,npm 也会检查依赖项的引擎要求。固定的 0.2.1-rc.2 版本声明了 commander: ^15.0.0,而 Commander 15 要求 Node >=22.12.0,因此在 Ubuntu 的 Node 18 上安装它时,使用 npm 默认设置会产生 EBADENGINE 警告。默认情况下,该警告不会阻止安装,因此应在遇到运行时失败之前检查 Node 版本。
仓库要求的最低版本也已提高。0.2.1-rc.2 源代码接受 ^22.19.0 || >=24.0.0,但 master 分支中的 CLI 软件包现在声明了 >=24.9.0,Node 22 不满足该要求。请从 NodeSource 安装 Node 24。它属于长期支持(LTS)系列,自 2026 年 10 月 20 日起进入维护阶段,其当前构建同时满足这两个版本范围。根据 Node.js 发布计划,Node 26 已于 2026 年 10 月 28 日成为 LTS 版本。
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 -vnode -v 现在应输出 v24 版本,即 24.9.0 或更高版本。保留 less 这一行,是因为将远程脚本直接通过管道传给 bash 会执行你尚未阅读的代码。
在编写 unit 之前,先确认它可以运行
npx @deepseek-ai/dsh@0.2.1-rc.2 web让它保持运行。在第二个 SSH 会话中执行:
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/任何 HTTP 状态码都表示 Web 配置正在 loopback 上监听,这是它的默认绑定地址。预期会得到 401,应将其视为通过:UI 使用打印 URL 中的启动令牌对浏览器进行身份验证,再将该令牌交换为签名会话 cookie;不携带这两者的请求会得到 401。000 与 curl: (7) Failed to connect to 127.0.0.1 port 3080 同时出现表示它没有在监听,第一个终端会说明原因。继续之前,使用 Ctrl+C 停止手动运行:如果 unit 尝试绑定已被其他程序占用的端口,就会以 Error: listen EADDRINUSE: address already in use 127.0.0.1:3080 失败。
0.1.0-rc.7 是 18 August 2026 发布的版本,早于本指南依赖的浏览器身份验证:其 Connection README 说明,防护机制是可达性策略,并且“Web carrier 不提供身份验证层”。在 11 October 2026,latest 标签指向 0.2.0-rc.2。在 27 October 2026,latest 指向 0.2.1-rc.2,next 指向 0.2.1-rc.4,因此此处的命令固定使用 0.2.1-rc.2。在 4 November 2026,npm 版本列表显示 latest 和 next 均为 0.2.1-rc.5;此处的命令保留现有固定版本。使用 npm view @deepseek-ai/dsh version 检查当前版本,然后固定你决定运行的版本。
全局安装固定的版本
在单元文件中使用 npx 是错误的做法。如果未指定版本或本地没有匹配的安装,进程启动时会解析软件包版本。因此,三个月后重启时,可能会启动预览阶段代理的另一个构建版本,而您没有做任何更改。缺少软件包或缓存数据时,还需要访问 npm registry,因此 registry 响应缓慢可能会延迟启动或导致启动失败;npm 也支持使用缓存和离线执行。请一次性安装您记录下来的指定版本:
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dsh如果 npm 来自 NodeSource,command -v dsh 会输出 /usr/bin/dsh;如果来自 Ubuntu 自带的软件包,command -v dsh 会输出 /usr/local/bin/dsh。在单元文件中使用它实际输出的路径。npm ls -g 会输出确切版本。六周后行为发生变化,而您记不起安装了哪个版本时,这就是需要核对的答案。如果安装失败,或者之后 command -v dsh 没有输出内容,或者返回的版本不是您指定的版本,请先排查常见的 dsh 安装和版本问题,再编写单元文件。
仅运行该服务的用户
代理会运行 shell 命令。这是它的职责。以 root 运行代理会使每次工具调用都以 root 权限执行,因此应为它创建一个专用账户,并禁用登录 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 变为 DSH_HOME,这是 dsh 存储配置文件的目录。配置文件是一组命名的插件包,并在其上叠加您自己的补丁层。web 和 headless 配置文件会在首次启动时根据随附的模板自动构建。之后添加到该配置栈中的任何内容都会以此用户身份运行,并使用代理自己的文件和 shell 访问权限。因此,安装前检查插件与创建账户同样重要。首次启动会写入文件,并可能获取插件包,因此应尽量手动执行,以便监控过程。
sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile web请显式设置 HOME,不要依赖 sudo 对它的处理方式。因为 sudo 是保留还是重写 HOME,取决于 /etc/sudoers 中包括 env_reset、env_keep 和 always_set_home 在内的设置。如果设置错误,首次运行会尝试使用您的主目录存放缓存和状态数据,从而导致权限错误,或将状态数据写入服务之后不会使用的位置。当 curl 检查输出状态码后,按 Ctrl+C 停止它。
单元文件
编写 /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.targetExecStart=使用从 command -v dsh 获取的绝对路径。systemd 会为不带路径的命令名搜索固定的路径列表,但该列表不是 shell 的 PATH。因此,使用绝对路径可以避免路径解析错误。
WorkingDirectory=是相对路径的解析位置,也是无参数运行 ls 的工具调用的起始目录。将其设置为提供给代理的工作区。如果目录不存在,或服务用户无法进入该目录,单元会在 dsh 运行前因 status=200/CHDIR 失败。
ProtectHome=true会将 /home 和 /root 隐藏在进程之外。这在此处是安全的,因为服务访问的所有内容都位于 /var/lib/dsh 下。将工作区设置为 /home 下的路径后,代理会报告目录不存在;只有记住这一行,才能理解原因。ProtectSystem=full会使 /usr、/boot 和 /etc只读,而服务不需要向其中写入内容。
继续收紧限制很诱人,但通常是错误的。ProtectSystem=strict会使整个文件系统只读,但内核伪文件系统以及通过此单元的 PrivateTmp=true、/tmp 和 /var/tmp 提供的文件系统除外,因此向工作区写入时会因 EROFS: read-only file system 失败。如果需要这种级别的限制,请在同一次编辑中添加 ReadWritePaths=/var/lib/dsh。
哪种 Type= 应写在这里
Type=exec,因为 dsh 在前台运行且从不派生进程。与默认值相比,这样可以获得真正的错误消息。使用 Type=simple 时,systemd 只要完成派生就会将启动判定为成功,此时它甚至还不知道二进制文件是否存在,因此 systemctl start dsh 会正常返回,失败信息只会出现在日志中。使用 Type=exec 时,systemd 会等待 execve() 成功,因此 ExecStart= 中的拼写错误会直接导致刚输入的命令失败,您可以立即看到错误。
另外两个错误答案都会导致命令挂起。Type=forking 告诉 systemd 等待父进程退出,而 dsh 从不退出,因此启动会一直阻塞,直到 TimeoutStartSec 到期(默认 90 秒),然后报告 Job for dsh.service failed because a timeout was exceeded. Type=notify 会等待通过 sd_notify 发送的 READY=1 消息,而不会发送该消息的 Node 进程也会以同样的方式导致启动停滞。systemd 服务类型的完整比较还介绍了其余内容,包括何时值得配置 notify。
会明确暴露问题的重启规则
Restart=on-failure会在进程以非零状态退出或因未清理的信号终止时重启;如果进程正常退出,则保持单元停止状态。对于此服务类型,systemd 将 SIGHUP、SIGINT、SIGTERM 和 SIGPIPE 视为正常信号。这正是预览版本所需的行为。如果 dsh 因读取到不接受的配置而以 0 状态退出,单元会停止并保持停止状态;systemctl status dsh 会显示 inactive (dead),您可以在那里查看相关信息。Restart=always 会将同一事件变成重启循环,从远处看起来像是服务运行正常。
速率限制是经常被遗漏的部分。systemd 的默认值是在十秒内最多启动五次;使用 RestartSec=5s 后,永远无法在十秒窗口内达到五次启动,因此在启动时崩溃的单元会无限重启,只有 journal 能记录这一点。StartLimitIntervalSec=300 配合 StartLimitBurst=5 后,允许在五分钟内启动五次,随后在该时间段内拒绝再次启动。systemd 会放弃启动,并将单元置于 failed,同时记录 Start request repeated too quickly.。修复原因后,使用 sudo systemctl reset-failed dsh 清除该状态。这两个设置应放在 [Unit] 中,而不是 [Service] 中;无法识别的选项会生成警告日志,不会被静默忽略。
启动服务,然后检查
sudo systemctl daemon-reload
sudo systemctl enable --now dsh
systemctl status dshenable --now有两个作用。enable用于在重启后自动恢复服务,--now用于在本次启动中启动服务。单独执行 systemctl start 的效果会在下次重启后失效,而内核更新会要求重启。
systemctl status dsh 的输出应包含 Active: active (running)、一个 Main PID 和一个 Memory: 行。然后确认服务的监听地址:
sudo ss -lntp | grep 3080应看到 127.0.0.1:3080。如果显示其他地址,说明 --host 标志已将监听器移到该地址所属的网络,并且在未配置 TLS 时提供普通 HTTP。该输出中的进程名称是 node,而不是 dsh,因为 dsh 二进制文件是 Node 脚本,所以 pgrep -x dsh 无法找到它。请改用 systemctl show -p MainPID dsh。
然后重启一次。一个从未成功经受重启的服务,还不能算作可用服务。
sudo reboot重新连接后运行 systemctl is-active dsh。该命令会输出 active。
使用 journalctl 读取日志
dsh 写入 stdout 和 stderr 的所有内容都会以该单元名称写入 journal。
journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err-f 跟踪新增行,-n 显示最后 N 行,-p err 按优先级筛选。该单元中的 SyslogIdentifier=dsh 使这些行被标记为 dsh,而不是 node。如果首次读取未按单元筛选的 journal 输出,这一点很重要。
请在需要之前确认 journal 可以跨重启保留:
journalctl -u dsh -b -1如果输出 Specifying boot ID or boot offset has no effect, no persistent journal was found,说明 journal 位于 /run 中,每次重启都会将其丢弃。使用 Storage=auto 时,请创建该目录并重启 daemon;如果已配置 Storage=volatile,请先将其改为 persistent:
sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journald运行 sudo journalctl --flush 可切换到持久化存储,并将当前启动周期的日志刷新到磁盘。
通过 SSH 隧道访问 UI,而不是开放公网端口
dsh 默认在 127.0.0.1:3080 上提供 Web UI(用户界面)。默认绑定回环地址,但这不是唯一选择:--host 接受本地接口的一个具体 IPv4 或 IPv6 地址。除回环地址外,绑定到其他地址时,dsh 会通过普通 HTTP 为该地址所属的网络提供服务,并在启动时发出警告,除非同时传入 --tls-cert 和 --tls-key。dsh 拒绝通配地址。请求 --host 0.0.0.0 时,错误信息开头如下:
webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:后续信息会说明,“绑定所有接口会将远程代码执行暴露给网络”,并要求“改为绑定本地接口的一个具体 IPv4 或 IPv6 地址”。如果传入的值根本不是 IP 字面量,例如主机名,则会改为返回 is not a concrete IPv4 or IPv6 address literal。
仍应保留默认设置。Web API(应用程序编程接口)负责驱动代理,而代理会执行 shell 命令。dsh 确实在该 API 前面加入了身份验证:包括 Host 和 Origin 检查,以及打印在 URL 中的启动令牌。UI 会使用该令牌换取签名的会话 Cookie。不过,在普通 HTTP 上,该令牌会以明文形式通过网络传输;上游文档还明确说明,Host 检查本身无法保护监听端口。如果需要通过实际主机名访问 UI,DeepSeek 的公开部署指南介绍了使用 --public-url 和 --trusted-host 配置反向代理的方法,也介绍了使用 --tls-cert 和 --tls-key 启用原生 TLS 的方法。在尝试迁移 UI 之前,建议阅读启动输出中的 127.0.0.1:3080 到底表示什么。如果这台服务器只有您自己使用,请从自己的计算机转发端口:
ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10-L 3080:127.0.0.1:3080 会在您的笔记本电脑上开放端口 3080,并将该端口收到的所有内容转发到 127.0.0.1:3080;其中的主机名解析发生在 VPS 上。-N 表示不执行远程命令,因此该会话只负责保持隧道打开。保持该命令运行,使用 journalctl -u dsh -n 100 --no-pager 找到 dsh 启动时打印的 URL,然后在浏览器中打开。该 URL 包含启动令牌。在未登录的浏览器中打开不带令牌的 http://127.0.0.1:3080/ 时,会收到 401。令牌属于正在运行的进程,但使用该令牌换取的会话 Cookie 的有效期会超过该进程:Cookie 使用 dsh 保存在 $DSH_HOME/.credentials.yaml 中的密钥签名,默认有效期为 30 天。因此,已经登录过的浏览器即使在服务重启后,也可以再次打开不带令牌的 URL。只有新浏览器,或 Cookie 已过期时,才需要从日志中获取新的 URL。应将该 URL 视为凭据:上游文档要求仅与预期用户共享该 URL,而且任何能够读取系统日志的用户都可以读取它。进入 UI 后,在 Settings 的 Models 下输入 DeepSeek API 密钥,并选择工作区目录。将工作区设置为 /var/lib/dsh/workspace,即由服务用户拥有的目录,否则代理的文件工具会因 EACCES: permission denied 而失败。
如果端口 3080 已被笔记本电脑上的其他程序占用,ssh 会报告错误:
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080使用 ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10 选择其他本地端口,然后将打印出的 URL 中的 3080 改为 3081 后打开。将输入命令保存到您自己的计算机上的 ~/.ssh/config:
Host dsh-vps
HostName 203.0.113.10
User you
LocalForward 3080 127.0.0.1:3080之后,ssh -N dsh-vps 就是完整命令。现在,该隧道是访问代理的唯一入口,因此保护它的关键是 SSH daemon:只允许密钥认证,禁用密码认证,并按更严格的要求应用加固 VPS 上的 SSH中的其余措施。如果该 VPS 逐渐发展成一个小型私有网络,后面还有数据库或预发布服务器,那么通过子网路由器向 tailnet 发布这些地址可以免去为每个服务分别配置端口转发。不过,由于 dsh 默认监听回环地址,UI 仍需通过隧道访问。
不要将密钥放入 unit 文件。Environment= 值由 systemctl show dsh -p Environment 打印,服务器上的任何用户都可以运行该命令。如果安装的插件需要从环境变量读取密钥,请将密钥放入 /etc/dsh.env,设置权限为 600,并将所有者设为 root,然后使用 EnvironmentFile=/etc/dsh.env 引用该文件。systemd 会在执行时以 root 身份读取该文件,而 systemctl show 不会打印文件内容。各项设置实际写入磁盘上的哪个文件,以及将 dsh 指向本地 Ollama endpoint 而不是 DeepSeek API 时哪些内容会离开服务器,将在配置 dsh 的密钥、模型和 endpoint中介绍。
运行成本
推理过程在 DeepSeek 的 API 端进行,而非您的 VPS 上。您的服务器需要承担 Node 进程、其提供的 UI 以及代理决定执行的每条命令的开销。前两者开销稳定且较小。第三项在当前 unit 文件中没有任何限制。
请自行测量服务器的基准负载,不要盲目信任他人的数据:
systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2MemoryCurrent 的单位是字节。请在代理工作时进行监控,而非空闲时。
工具调用属于该服务的子进程,因此它们位于同一个控制组(control group)中,并计入相同的限制。在工作区内运行 npm install 或测试套件的代理,其内存占用可能远超程序本身。在 1 GB 内存的 VPS 上,这正是故障点:内核会选择一个进程并将其杀死,此时 journalctl -k | grep -i "out of memory" 会显示 Out of memory: Killed process 行,指出被杀死的进程。该进程往往并非导致问题的元凶。
解决方法是手动设置限制。在 [Service] 部分设置 MemoryMax= 和 CPUQuota=,可以将影响限制在 unit 内部,从而在构建失控时仅终止该进程,避免整台服务器死锁。使用 systemd 限制内存和 CPU 涵盖了相关数值及故障表现。磁盘占用也会随之增长,包括 DSH_HOME 下的会话历史以及代理在工作区写入的任何内容,因此请将 du -sh /var/lib/dsh 加入到您现有的磁盘监控方案中。
如果您需要一个可以随时挂载和分离的交互式代理,使用服务(service)并不合适,在持久化的 tmux 会话中运行代理 会更贴切。当您希望 dsh 始终运行并通过隧道访问它时,可以将 dsh 作为 unit 运行。
故障模式及日志中的提示
status=203/EXEC。 systemd 无法运行该文件,日志中显示 Failed to locate executable /usr/local/bin/dsh: No such file or directory。ExecStart= 中的路径与 command -v dsh 输出的路径不一致。这就是 Type=exec 在 systemctl start 时报告的故障,而不是被隐藏的故障。
status=217/USER。 systemd 无法根据 User= 和 Group= 确定或更改用户凭据,或无法设置用户命名空间。对于此单元,最常见的原因是指定的账户不存在。使用 id dsh 确认。
status=200/CHDIR。 WorkingDirectory= 不存在,或服务用户无法进入该目录。sudo -u dsh ls /var/lib/dsh/workspace 可直接复现此问题。
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080。 该端口已被其他进程占用,通常是另一个终端中运行的 npx 仍未退出。sudo ss -lntp | grep 3080 可显示占用该端口的进程。
EACCES: permission denied 后跟路径。 /var/lib/dsh 下的所有权不正确,通常是因为首次运行时使用了 root,或使用了错误的 HOME。sudo chown -R dsh:dsh /var/lib/dsh 可修复此问题。
Start request repeated too quickly. 该单元触发了启动速率限制,因而放弃启动。真正的错误位于上方的日志行中。再次尝试前,先运行 sudo systemctl reset-failed dsh。
单元状态为 active (running),但浏览器没有显示内容。 在 VPS 上运行检查命令:如果 curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ 在 VPS 上输出状态码,说明 VPS 上的监听器可以响应,下一步应检查端口转发。该状态码不能证明所有内容都已加载:上游说明,可选插件失败不会阻止服务报告就绪,因此还应读取 journalctl -u dsh -n 200 --no-pager,检查插件错误。浏览器显示 401,表示没有有效的会话 Cookie,且 URL 中没有有效的启动令牌。这可能是因为打开了不带令牌的 URL,也可能是因为令牌来自上次重启之前。请打开当前进程输出的 URL。
有计划地升级
版本固定意味着升级由您主动执行,而不是被动发生。先阅读发行说明,因为上游关于不兼容变更的警告正是固定版本的原因。备份状态目录,然后切换版本:
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回滚过程相同,只需将 npm install -g 替换为旧版本,并恢复该 tarball;但前提是您之前已创建它。处于预览阶段的 agent 运行时尤其可能在升级时改写配置格式。
FAQ
为什么关闭 SSH 会话后 dsh 会停止?
因为 npx @deepseek-ai/dsh web 是由登录会话拥有的前台进程,会在会话结束时被终止。systemd 单元由 init 系统管理,因此断开连接后仍会继续运行,并在重启后再次启动。sudo systemctl enable --now dsh 是同时实现这两点的一组步骤:enable 负责本次重启后的启动,--now 负责当前启动。
dsh 应使用 Type=simple 还是 Type=exec?
Type=exec。dsh 在前台运行且不会派生子进程,因此两者都可以使用。但 Type=exec 会让 systemd 等待 execve() 成功后,才将启动标记为成功。若 ExecStart= 中的路径错误,systemctl start 会立即失败,并在您面前显示 status=203/EXEC。使用 Type=simple 时,同样的错误会返回成功,并隐藏在日志中。Type=forking 和 Type=notify 在这里都不正确,并且都会一直等待,直到默认 90 秒后 TimeoutStartSec 超时。
如何从笔记本电脑打开 dsh Web 界面?
通过 SSH 转发端口:ssh -N -L 3080:127.0.0.1:3080 you@your-vps,然后在浏览器中打开 dsh 启动时输出的 URL。您可以使用 journalctl -u dsh 找到该 URL。该 URL 包含启动令牌,未登录的浏览器缺少该令牌时会收到 401。登录后,会话 cookie 默认持续 30 天,并且在服务重启后仍然有效。保持服务使用默认的回环地址。dsh 会拒绝类似 --host 0.0.0.0 的通配地址,并将其视为未指定地址。虽然 dsh 接受一个具体的本地地址,但绑定到非回环地址时会提供明文 HTTP,除非您配置 TLS。否则,启动令牌会以明文发送给一个可通过网络运行 shell 命令的代理。
可以将 dsh 作为 root 运行,以简化权限管理吗?
不可以。该执行框架用于运行命令和写入文件,因此服务拥有的权限也会被代理继承。使用 useradd --system --shell /usr/sbin/nologin dsh 创建系统账户,用该账户拥有 /var/lib/dsh,并将 NoNewPrivileges=true 添加到该单元中。如果之后遇到 EACCES: permission denied,通常是因为之前曾以 root 运行,留下了由 root 拥有的文件;sudo chown -R dsh:dsh /var/lib/dsh 可以清理这些文件。
应在单元中固定哪个 dsh 版本?
固定 npm view @deepseek-ai/dsh version 在配置服务时报告的版本。使用 npm install -g @deepseek-ai/dsh@<that version> 安装,并将版本记录在您能找到的位置。2026 年 8 月 18 日,0.1.0-rc.7 是当前版本;2026 年 10 月 11 日,0.2.0-rc.2 是当前版本;2026 年 10 月 27 日,0.2.1-rc.2 是当前版本,此时 next 已经是 0.2.1-rc.4。2026 年 11 月 4 日,latest 和 next 都指向 0.2.1-rc.5。版本早至 0.1.0-rc.7 的构建不提供浏览器身份验证,因此不要为 Web 配置固定此类版本。重点不在版本号本身,而在于 npx 不带版本时会在启动时解析软件包,因此无人值守重启可能会静默切换到配置格式不同的构建。