系统服务模板 NOR1EQ0/deepseek-harness-systemd

DeepSeek Harness - systemd service 模板

把 DeepSeek Harness（dsh）的 Web UI 作为 systemd 服务运行的模板包。

- dsh.service - systemd 单元文件（默认以当前用户、user unit 方式运行）
- dsh.env.example - 环境文件示例（启动方式 / 密钥 / 端口等全部可覆盖）
- install.sh - 一键安装（--user 默认，--system 可选）

由于 DeepSeek Harness 处于 _开发者预览_ 阶段，目前锁定版本为 0.1.0-rc.6

快速开始

./install.sh # 安装 user unit，并生成 ~/.config/dsh/dsh.env

[!NOTE]
安装时会先检查上游版本：若 npm 上的 @deepseek-ai/dsh 最新版不同于模板锁定的版本号，会给出三个选项：y 用固定版（默认）、l 用最新版（不稳定）、n 取消安装。非交互环境可用 ./install.sh -y 直接采用固定版。

然后：

1. 编辑 ~/.config/dsh/dsh.env，根据里面的注释说明配置你需要的环境变量

2. 启用并启动：

systemctl --user enable --now dsh

3. 打开 或者你配置好的地址。

[!TIP]
如果安装的是 user unit，可以执行如下命令：

sudo loginctl enable-linger "$USER"

这样将允许当前用户在未登录时在后台运行服务。更多信息请运行 man loginctl 或查看 loginctl(1) - Linux manual page。

但这样做是影响整个用户的后台服务运行策略，你也可以考虑以系统服务运行并指定 User，请自行斟酌。

以系统服务方式运行

sudo ./install.sh --system # 安装到 /etc/systemd/system，环境文件放 /etc/dsh/dsh.env
sudo systemctl edit dsh
sudo systemctl enable --now dsh

[!WARNING]
默认服务单元文件没有指定 User，请留意。

配置参考

所有配置都在环境文件中（user unit 的 ~/.config/dsh/dsh.env，system unit 的 /etc/dsh/dsh.env），不需要改动单元文件本身。

以下表格列出了 service 文件自身使用的环境变量。dsh.env.example 文件里有更详细的注释说明，请自行查看。

| 变量 | 默认值 | 说明 |
| DSH_BIN | npx --yes @deepseek-ai/dsh@0.1.0-rc.6 | 启动 dsh 的命令，可换成全局二进制路径或 pin 版本 |
| DSH_WEB_HOST | 127.0.0.1 | web 绑定地址（转为 --host） |
| DSH_WEB_PORT | 3080 | web 监听端口（转为 --port；0 表示系统分配） |
| DSH_WEB_TRUSTED_HOST | （空） | /api 信任栅栏额外地址，空格分隔多个（每个转为 --trusted-host） |
| DSH_WEB_ARGS | （空） | 额外追加给 web 应用的参数，见下方说明 |

[!NOTE]
模板把 DSH_WEB_HOST / DSH_WEB_PORT / DSH_WEB_TRUSTED_HOST 自动组装成 --host / --port / --trusted-host（可重复）。DSH_WEB_ARGS 仅用于模板未覆盖的额外选项，会追加在最后。

示例（user unit 环境文件）：

DSH_WEB_PORT="8080"
DSH_WEB_TRUSTED_HOST="dsh.example 192.168.1.2"

[!WARNING]
dsh 的 web 应用现在只能监听在 127.0.0.1，禁止监听 0.0.0.0，其他 IP 会直接报错，可能需要等待官方修复或调整。