无人值守运行 dsh web:CI 与服务器上的非交互启动、日志落盘、健康检查与退出码判断
无人值守运行 dsh web 和本机双击启动的差别不在命令,而在三件事必须固定:版本、监听地址与数据目录。 这三项不固定,同一个脚本今天能起、明天换个镜像就跑不起来。
dsh web 无人值守和本机启动差在哪
本机可以靠人补救,无人值守只能靠约定。 差别集中在四处:
| 维度 | 本机启动 | 无人值守 |
|---|---|---|
| 交互 | 可以回答 npx 询问 | 必须 -y 且版本写死 |
| 浏览器 | 自动打开,人能看见 | 没有桌面,不能依赖 |
| 日志 | 终端滚屏即可 | 必须落盘并可检索 |
| 失败判断 | 人看一眼 | 探活 + 退出码 |
把这四项都写成脚本的一部分,才算真正的无人值守。 少一项,出问题时就没有证据。
无人值守跑 dsh web 必须固定的三个输入
版本、地址、数据目录,三样都固定才能复现。 顺序如下:
- 版本:命令写成
npx -y @deepseek-ai/dsh@0.2.0-rc.2 web,不要依赖 latest;CI 与生产用同一串版本号。 - 监听地址:
--host只接受一个具体的本机地址,传0.0.0.0会以用法错误退出;只给本机进程用就保持默认回环,需要外部访问就填客户端实际能到达的那个地址,外部暴露交给反向代理。 - 数据目录:通过环境变量指定 DSH_HOME,并挂载持久化卷;否则容器重建后会话与插件全丢。
- 非交互:npx 加
-y,并确认没有其他需要确认的步骤。
固定的是输入,不是输出。 版本固定后,端口、日志格式、插件兼容性才有比较的基础(来源)。
dsh web 的日志与探活怎么写
探活要打 HTTP,不要只看进程。 进程在、端口没通的情况很常见。
- 启动命令把 stdout 与 stderr 一起重定向到
/var/log/dsh-web.log; - 循环请求
curl -fsS -o /dev/null http://127.0.0.1:3080,间隔 2 秒,最多 15 次; - 连续三次失败再判定失败,避免慢启动被误杀;
- 判定失败时输出日志最后 30 行,而不是只报「启动失败」;
- 成功后在日志里写一行带版本的启动标记,便于事后比对。
探活地址要和监听地址一致。 服务监听回环却去请求容器 IP,永远失败;服务绑定某个网卡地址却只探 127.0.0.1,在容器里也可能因网络命名空间不同而失败。
dsh web 的退出码与信号
优雅退出靠信号,不靠 kill -9。 两种托管方式各有注意点:
- systemd:
ExecStart直接写启动命令,Restart=on-failure,KillSignal=SIGTERM,并设置TimeoutStopSec; - 容器:入口进程必须是 dsh 本身,不要用 shell 包一层后放后台,否则 PID 1 收不到信号;
- CI:用超时控制任务时长,测试结束后主动发 SIGTERM,再等进程退出;
- 日志:记录退出码与最后一条错误,区分「启动失败」与「被外部停止」。
退出码 0 不等于服务可用。 它只说明入口脚本正常结束;服务是否可用由探活回答。
一个最小可用的 dsh web 启动脚本
脚本只做四件事:固定输入、前台运行、落盘日志、失败可读。 参考写法:
#!/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 无人值守常见失败与下一步
四类失败覆盖大多数无人值守问题。
- SSH 断开就停:没有托管层,进程跟着会话结束;改用 systemd 或容器。
- 一直起不来:版本被 latest 拉到不兼容的新版,或数据目录权限不足;固定版本并检查权限。
- 进程在、页面不通:监听地址与探活地址不一致,或端口被占用。
- 容器重建后数据没了:DSH_HOME 没挂卷,或挂载路径与配置不一致。
排查顺序固定:版本 → 目录 → 地址 → 日志。 先排除输入问题,再看服务行为。
这四类之外的情况,按下面几篇继续往下读。 先把输入固定,再谈自动化。想了解容器里的端口与挂载,读 容器化安装;想看端口与认证细节,读 dsh web 认证与端口;想远程访问,读 部署到远程服务器;想弄清 npx 到底拉了什么,读 npx 执行链路与风险控制。
来源:dsh CLI README、DeepSeek Harness 官方文档、deepseek-harness Releases
常见问题
npx @deepseek-ai/dsh web 默认跟着前台终端生命周期,SSH 断开就收到终止信号。要常驻应交给 systemd、容器或 tmux 托管,并把输出重定向到日志文件,而不是靠 nohup 硬撑。
判断 dsh web 是否可用要看端口与 HTTP 响应,而不是进程是否存在。用 curl 请求 127.0.0.1:3080 并检查返回码,连续失败三次再判定启动失败,避免把慢启动误判成崩溃。
在 CI 里用 npx 跑 DeepSeek Harness 会卡在首次下载的安装确认上,所以要加 -y 并把版本写死。命令改成 npx -y @deepseek-ai/dsh@版本 web,同时关闭浏览器自动打开,避免等待一个不存在的桌面环境。
dsh web 退出码 0 只说明入口脚本正常结束,不代表服务可用。容器里常见原因是进程被放到后台、PID 1 不是 dsh、或端口绑定在容器内不可达的地址;应以前台方式运行并配合探活判断。
相关术语
- 无人值守启动
- 无人值守启动是指没有人在终端前操作时启动服务,要求非交互、日志可查、失败可判定,通常由 systemd、容器或 CI 托管。— DeepSeek Harness 官方文档
- 健康检查
- 健康检查是定期请求服务地址并判断返回是否符合预期的手段,用于区分进程存活与服务可用。— dsh CLI README
- PID 1
- PID 1 是容器内的第一个进程,负责接收停止信号并回收子进程;如果它不转发信号,服务会无法优雅退出。— DeepSeek Harness 官方文档
- 监听地址
- 监听地址是服务绑定的本机地址,CLI 只接受具体的本机地址,通配地址会被拒绝;回环地址只允许本机访问。— dsh CLI 行为参考
来源
- dsh CLI README· deepseek-ai
- DeepSeek Harness 官方文档· deepseek-harness
- deepseek-harness Releases· deepseek-ai