ChatGPTClaudeGrok / X / CursorGemini

无人值守运行 dsh web:CI 与服务器上的非交互启动、日志落盘、健康检查与退出码判断

安装与快速上手发布于 2026-11-02作者: DeepSeek Plugin 插件市场
npx无人值守CIdsh web健康检查
无人值守运行 npx @deepseek-ai/dsh web 要固定三件事:版本、监听地址与数据目录。本文给出日志落盘、3080 探活、退出码判断与 systemd/CI 的最小可用写法。

无人值守运行 dsh web 和本机双击启动的差别不在命令,而在三件事必须固定:版本、监听地址与数据目录。 这三项不固定,同一个脚本今天能起、明天换个镜像就跑不起来。

dsh web 无人值守和本机启动差在哪

本机可以靠人补救,无人值守只能靠约定。 差别集中在四处:

维度本机启动无人值守
交互可以回答 npx 询问必须 -y 且版本写死
浏览器自动打开,人能看见没有桌面,不能依赖
日志终端滚屏即可必须落盘并可检索
失败判断人看一眼探活 + 退出码

把这四项都写成脚本的一部分,才算真正的无人值守。 少一项,出问题时就没有证据。

无人值守跑 dsh web 必须固定的三个输入

版本、地址、数据目录,三样都固定才能复现。 顺序如下:

  1. 版本:命令写成 npx -y @deepseek-ai/dsh@0.2.0-rc.2 web,不要依赖 latest;CI 与生产用同一串版本号。
  2. 监听地址:--host 只接受一个具体的本机地址,传 0.0.0.0 会以用法错误退出;只给本机进程用就保持默认回环,需要外部访问就填客户端实际能到达的那个地址,外部暴露交给反向代理。
  3. 数据目录:通过环境变量指定 DSH_HOME,并挂载持久化卷;否则容器重建后会话与插件全丢。
  4. 非交互:npx 加 -y,并确认没有其他需要确认的步骤。

固定的是输入,不是输出。 版本固定后,端口、日志格式、插件兼容性才有比较的基础(来源)。

dsh web 的日志与探活怎么写

探活要打 HTTP,不要只看进程。 进程在、端口没通的情况很常见。

  1. 启动命令把 stdout 与 stderr 一起重定向到 /var/log/dsh-web.log;
  2. 循环请求 curl -fsS -o /dev/null http://127.0.0.1:3080,间隔 2 秒,最多 15 次;
  3. 连续三次失败再判定失败,避免慢启动被误杀;
  4. 判定失败时输出日志最后 30 行,而不是只报「启动失败」;
  5. 成功后在日志里写一行带版本的启动标记,便于事后比对。

探活地址要和监听地址一致。 服务监听回环却去请求容器 IP,永远失败;服务绑定某个网卡地址却只探 127.0.0.1,在容器里也可能因网络命名空间不同而失败。

dsh web 的退出码与信号

优雅退出靠信号,不靠 kill -9。 两种托管方式各有注意点:

  1. systemd:ExecStart 直接写启动命令,Restart=on-failure,KillSignal=SIGTERM,并设置 TimeoutStopSec;
  2. 容器:入口进程必须是 dsh 本身,不要用 shell 包一层后放后台,否则 PID 1 收不到信号;
  3. CI:用超时控制任务时长,测试结束后主动发 SIGTERM,再等进程退出;
  4. 日志:记录退出码与最后一条错误,区分「启动失败」与「被外部停止」。

退出码 0 不等于服务可用。 它只说明入口脚本正常结束;服务是否可用由探活回答。

一个最小可用的 dsh web 启动脚本

脚本只做四件事:固定输入、前台运行、落盘日志、失败可读。 参考写法:

bash
#!/usr/bin/env bash
set -euo pipefail
export DSH_HOME=/data/dsh
LOG=/var/log/dsh-web.log
npx -y @deepseek-ai/dsh@0.2.0-rc.2 web --port 3080 >>"$LOG" 2>&1 &
PID=$!
for i in $(seq 1 15); do
  if curl -fsS -o /dev/null http://127.0.0.1:3080; then
    echo "dsh web ready" >>"$LOG"; break
  fi
  sleep 2
  if [ "$i" -eq 15 ]; then
    tail -n 30 "$LOG"; kill "$PID"; exit 1
  fi
done
wait "$PID"

这段脚本的价值在失败时。 它会把最后 30 行日志打出来,并主动结束进程,避免留下半启动状态。

容器里请去掉 & 与探活循环,让 dsh 直接作为 PID 1 前台运行,探活交给容器编排层(来源)。

dsh web 无人值守常见失败与下一步

四类失败覆盖大多数无人值守问题。

  1. SSH 断开就停:没有托管层,进程跟着会话结束;改用 systemd 或容器。
  2. 一直起不来:版本被 latest 拉到不兼容的新版,或数据目录权限不足;固定版本并检查权限。
  3. 进程在、页面不通:监听地址与探活地址不一致,或端口被占用。
  4. 容器重建后数据没了:DSH_HOME 没挂卷,或挂载路径与配置不一致。

排查顺序固定:版本 → 目录 → 地址 → 日志。 先排除输入问题,再看服务行为。

这四类之外的情况,按下面几篇继续往下读。 先把输入固定,再谈自动化。想了解容器里的端口与挂载,读 容器化安装;想看端口与认证细节,读 dsh web 认证与端口;想远程访问,读 部署到远程服务器;想弄清 npx 到底拉了什么,读 npx 执行链路与风险控制。

来源:dsh CLI README、DeepSeek Harness 官方文档、deepseek-harness Releases

ChatGPTClaudeGrok / X / CursorGemini

常见问题

服务器上用 npx @deepseek-ai/dsh web 启动后 SSH 一断开服务就停,怎么让它常驻?

npx @deepseek-ai/dsh web 默认跟着前台终端生命周期,SSH 断开就收到终止信号。要常驻应交给 systemd、容器或 tmux 托管,并把输出重定向到日志文件,而不是靠 nohup 硬撑。

无人值守启动时怎么判断 dsh web 真的起来了,而不是进程还在但页面打不开?

判断 dsh web 是否可用要看端口与 HTTP 响应,而不是进程是否存在。用 curl 请求 127.0.0.1:3080 并检查返回码,连续失败三次再判定启动失败,避免把慢启动误判成崩溃。

CI 里跑 dsh web 提示需要交互确认,怎么改成非交互?

在 CI 里用 npx 跑 DeepSeek Harness 会卡在首次下载的安装确认上,所以要加 -y 并把版本写死。命令改成 npx -y @deepseek-ai/dsh@版本 web,同时关闭浏览器自动打开,避免等待一个不存在的桌面环境。

容器或 CI 里 dsh web 退出码是 0,但服务没起来,是什么原因?

dsh web 退出码 0 只说明入口脚本正常结束,不代表服务可用。容器里常见原因是进程被放到后台、PID 1 不是 dsh、或端口绑定在容器内不可达的地址;应以前台方式运行并配合探活判断。

相关术语

无人值守启动
无人值守启动是指没有人在终端前操作时启动服务,要求非交互、日志可查、失败可判定,通常由 systemd、容器或 CI 托管。— DeepSeek Harness 官方文档
健康检查
健康检查是定期请求服务地址并判断返回是否符合预期的手段,用于区分进程存活与服务可用。— dsh CLI README
PID 1
PID 1 是容器内的第一个进程,负责接收停止信号并回收子进程;如果它不转发信号,服务会无法优雅退出。— DeepSeek Harness 官方文档
监听地址
监听地址是服务绑定的本机地址,CLI 只接受具体的本机地址,通配地址会被拒绝;回环地址只允许本机访问。— dsh CLI 行为参考

来源