我把自己的一台 Linux 机器(家宽、没有公网 IP)变成了随时随地能用的一台「工作机」: 上面跑 DeepSeek Harness(dsh) 的 Web 界面,用 systemd 保证它开机自启、崩了自己回来, 再用 Tailscale 组网,让手机和笔记本在外面也能直接打开它 —— 没有开任何公网端口,也没有买域名。
这篇就把这套搭法从零写一遍。文中命令都在我自己的机器上跑过(Ubuntu 24.04 / Node v22.23.2 /
dsh 0.1.1-rc.2 / tailscale 1.102.3),把里面的 100.x.y.z、机器名、令牌换成你自己的就能照做。
目录
- 0. 五分钟快速开始
- 1. 环境要求
- 2. 安装 dsh
- 3. 第一次启动 Web 界面
- 4. 用 systemd 常驻 + 开机自启
- 5. Tailscale:远程访问,不暴露公网
- 6. 没有 root 也能玩:用户态模式
- 7. 我踩过的坑
0. 五分钟快速开始
有 root 的普通 Linux 机器(Ubuntu/Debian 系):
# 1) 装 dsh(全局)
npm i -g @deepseek-ai/dsh
dsh --version # 能打印版本号就算装好
# 2) 起 Web 界面(首次会自动初始化 profile,可能要装一会儿依赖)
dsh web --port 3080 --no-open
# 3) 按打印出来的地址在本机浏览器打开(默认 http://127.0.0.1:3080/)
# 4) 想常驻 + 开机自启:抄第 4 节的 systemd 单元
# 5) 想在外面访问:装 Tailscale,见第 5 节
1. 环境要求
| 项 | 要求 | 说明 |
|---|---|---|
| 系统 | Linux x86_64 / arm64 | 我用的 Ubuntu 24.04,本文只覆盖 Linux |
| Node.js | ≥ 22 | 版本太低会在启动时报模块/语法错 |
| 包管理器 | npm 或 pnpm | profile 内部用的是 pnpm |
| 用户 | 一个非 root 账号(下文叫 agent) |
用 root 跑会因为 profile 目录属主混乱而 EACCES |
| 权限 | 建议有 sudo |
只为装 systemd 单元;没有 sudo 也能跑(见第 6 节) |
| 网络 | 能访问 npm registry | 首次启动要装 profile 依赖 |
dsh 的家目录默认 ~/.dsh(可用 DSH_HOME 环境变量改):
~/.dsh/
├── profiles/<名字>/ # 每个 profile 一套:package.json + cordis.patch.yml + node_modules
├── sessions/ # 会话记录
├── settings.yaml # 全局设置
└── storages/ memory/ attachments/
2. 安装 dsh
npm i -g @deepseek-ai/dsh # 或:pnpm add -g @deepseek-ai/dsh
dsh --version # 例:0.1.1-rc.2
dsh --help # launcher 自己的帮助
几个概念先弄清楚,能省掉后面一堆疑惑:
- profile = 一组插件包(bundle)+ 补丁层,按顺序叠成一棵树。
web、headless、sdk、acp是内置的几个。 dsh --profile <name>启动指定 profile;dsh web就是dsh --profile web的别名。- launcher 只认自己的参数(
--profile、--patch、--dump-config等);它遇到第一个不认识的参数, 后面的全部交给 profile 里的 App —— 所以 Web 自己的参数必须写在dsh web之后。 web/headless/sdk/sdk-minimal/acp首次使用时自动初始化(从自带模板装依赖); 其它名字的 profile 要自己用dsh plugin --profile <名字> ...建。
想从源码跑(开发用):仓库根目录
pnpm run build,然后pnpm dsh <参数...>。
3. 第一次启动 Web 界面
dsh web
首次启动会在 ~/.dsh/profiles/web/ 下初始化 profile 并安装依赖(等几分钟属正常)。起来后终端会打印:
dsh web: http://127.0.0.1:3080/ (LAN: http://192.168.x.y:3080/)
常用参数(都写在 dsh web 后面):
| 参数 | 作用 |
|---|---|
--host <ip> |
绑定哪张网卡。默认只绑回环(127.0.0.1),所以只有本机能访问 |
--port <n> |
端口,例如 3080 |
--trusted-host <ip> |
信任围栏:额外信任的访问来源地址,可重复。从别的机器访问时不加就会被打回 |
--no-open |
不自动开浏览器(服务器上建议加) |
--help |
看 Web App 自己的参数 |
3.1 从别的机器访问,要同时满足两件事
- 绑定:
--host绑到对方能打到的那张网卡的地址(不是回环); - 信任:把你浏览器地址栏里用的那个地址加进
--trusted-host。
本机自己用,默认就行:
dsh web --port 3080 --no-open
内网 / Tailscale 上访问,两个都要写:
dsh web --host 100.x.y.z --port 3080 --trusted-host 100.x.y.z --no-open
3.2 远程暴露就该配一个访问令牌
只靠 IP 信任围栏是不够的 —— 同一个内网里谁都能试。远程访问时建议开启访问令牌门卫
(页面、/api、WebSocket 全部挡在门卫后面)。我用的是 @studyzy/dsh-web-remote-access
这个插件,它同时解锁 --host 0.0.0.0:
dsh plugin --profile web add @studyzy/dsh-web-remote-access
# 令牌走环境变量(推荐,systemd 里也是这么放的)
DSH_WEB_TOKEN='换成你自己的长随机串' dsh web --host 0.0.0.0 --port 3080 --no-open
浏览器首次访问要带令牌:http://<地址>:3080/?web_token=<令牌>,
服务器校验后 302 到干净路径并下发会话 Cookie(HttpOnly),之后正常用即可。
不装这个插件也能远程 —— 用第 5 节的
tailscale serve(我最推荐),或者绑 tailnet 地址 +--trusted-host。
4. 用 systemd 常驻 + 开机自启
新建 /etc/systemd/system/dsh.service:
[Unit]
Description=DeepSeek Harness (web GUI)
After=network-online.target
Wants=network-online.target
[Service]
User=agent
WorkingDirectory=~
EnvironmentFile=-/etc/dsh.env # 里面写 DSH_WEB_TOKEN=... (chmod 600)
ExecStart=/usr/bin/dsh web --host 0.0.0.0 --port 3080 --trusted-host 127.0.0.1 --no-open
Restart=on-failure
RestartSec=10
KillMode=mixed
TimeoutStopSec=20
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now dsh
systemctl status dsh --no-pager
journalctl -u dsh -f # 看日志(也会打印那行 dsh web: URL)
几个要点:
ExecStart用绝对路径(which dsh查一下,通常是/usr/bin/dsh);- 令牌别写进仓库:用
EnvironmentFile(chmod 600); User=要和 profile 目录的属主一致,否则EACCES(见第 7 节);- 重启电脑后 systemd 自己拉起来,不用管。
5. Tailscale:远程访问,不暴露公网
Tailscale 是基于 WireGuard 的组网:你的设备之间点对点加密直连,地址形如 100.x.y.z,
不需要公网 IP、不用开端口、不用域名。dsh 只要在这个网里,你的手机和笔记本就能访问它。
5.1 安装(有 root 的机器)
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up # 会打印登录链接,浏览器点开授权
tailscale ip -4 # 例:100.x.y.z
tailscale status # 看网内都有谁
5.2 把 dsh 暴露给 tailnet(三种方式)
A. tailscale serve(最推荐:dsh 仍然只听本机)
sudo tailscale serve --bg https / http://127.0.0.1:3080
tailscale serve status # 显示 https://<机器名>.<你的tailnet>.ts.net
之后在 tailnet 内任何设备打开那个 https://…ts.net 地址即可,证书由 Tailscale 自动签。
好处:dsh 不用绑 0.0.0.0、不用配信任围栏,公网也进不来。
B. 直接绑 tailnet 地址
dsh web --host 100.x.y.z --port 3080 --trusted-host 100.x.y.z --no-open
然后访问 http://100.x.y.z:3080/。
C. 绑所有网卡 + 令牌门卫(配 @studyzy/dsh-web-remote-access,见 3.2)
DSH_WEB_TOKEN='…' dsh web --host 0.0.0.0 --port 3080 --no-open
三种方式的差别:A 不暴露端口、最省心;B 简单直接;C 方便,但一定要有令牌。
5.3 从你的其它设备访问
在手机 / 另一台电脑上装 Tailscale 客户端,登录同一个 tailnet,然后:
- A 方式:浏览器打开
https://<机器名>.<tailnet>.ts.net/ - B / C 方式:浏览器打开
http://100.x.y.z:3080/(C 要带?web_token=…)
5.4 自检两行
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ # 本机应返回 200/302
tailscale status | head -5 # 对端应显示在线
6. 没有 root 也能玩:用户态模式
在容器里、或没有 sudo 的账号下,tailscaled 默认模式起不来 —— 它要建 TUN 设备(要 root)。
换成用户态网络就绕开了:普通用户就能跑。
# 1) 下静态包(版本按需换)
curl -fsSLO https://pkgs.tailscale.com/stable/tailscale_1.102.3_amd64.tgz
tar xzf tailscale_1.102.3_amd64.tgz && cd tailscale_1.102.3_amd64
# 2) 起守护进程(state 和 socket 都放自己的目录)
./tailscaled --tun=userspace-networking \
--state=./state/tailscaled.state \
--socket=./tailscaled.sock &
# 3) 登录(authkey 在 Tailscale 后台 Settings → Keys 生成)
./tailscale --socket=./tailscaled.sock up --authkey=tskey-auth-xxxxxxxx
# 4) 看地址
./tailscale --socket=./tailscaled.sock ip -4
./tailscale --socket=./tailscaled.sock status
要点与限制:
- 入站访问是通的:tailnet 里别的机器可以直接访问本机的
100.x.y.z:3080✅ —— 这正是我们要的方向; - 本机看不到虚拟网卡,出站要走它自带的 SOCKS5/HTTP 代理
(
--socks5-server=127.0.0.1:1055、--outbound-http-proxy-listen=127.0.0.1:1056); - 所有
tailscale子命令都要带--socket=指向你自定义的 socket,否则会找不到守护进程; - 保活:有 root 就写个 systemd 单元;没 root 就写个
while true; do 检查 & 拉起; sleep 30; done的看门狗脚本,挂到你能用的常驻机制上。
保活用的 systemd 单元长这样(/etc/systemd/system/tailscaled-user.service):
[Unit]
Description=Tailscale daemon (userspace networking, per-user install)
After=network-online.target
Wants=network-online.target
[Service]
User=agent
WorkingDirectory=~/tailscale
ExecStart=~/tailscale/tailscale_1.102.3_amd64/tailscaled \
--tun=userspace-networking \
--state=~/tailscale/state/tailscaled.state \
--socket=~/tailscale/tailscaled.sock \
--socks5-server=127.0.0.1:1055 \
--outbound-http-proxy-listen=127.0.0.1:1056
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
7. 我踩过的坑
| 现象 | 原因 / 解法 |
|---|---|
EACCES: permission denied, open '…/profiles/web/cordis.yml' |
用了和 profile 目录属主不同的用户跑(比如 root 跑过、之后换普通用户)。ls -l ~/.dsh/profiles/web,把属主改回来或换用户跑 |
| 页面打不开 / 一直转圈,日志说被信任围栏拦了 | --trusted-host 少了你浏览器地址栏里那个地址。走 Tailscale 就写 100.x.y.z,别写 127.0.0.1 |
--host 0.0.0.0 启动直接报错 |
新版本 CLI 拒绝全接口绑定:改用 --host <具体IP>,或加 @studyzy/dsh-web-remote-access 插件,或用 tailscale serve |
| 从 SSH 里启动没自动开浏览器 | 有意为之(SSH 转发场景下,浏览器该由你的 SSH 客户端负责)。用打印出来的 URL 手动开 |
| 改了端口 / 绑定没生效 | Web 参数必须写在 dsh web 后面;写在前面会被 launcher 当成非法参数 |
端口被占:EADDRINUSE |
ss -ltnp | grep 3080 找出占用者,或换 --port |
| Node 版本太低启动就崩 | 升到 Node ≥ 22(node -v 确认) |
| 远程能连但一刷新就掉登录 | 令牌 Cookie 是会话级、HttpOnly,带 ?web_token= 重新进一次即可 |
| 重启机器 dsh 就没了 | 没装 systemd 单元,或者单元没 enable:systemctl is-enabled dsh |
小结
这套组合的好处是简单:dsh 负责界面,systemd 负责常驻,Tailscale 负责「在哪都能连上」, 三者之间只有一个端口、一个令牌要管。机器在家、在外面一样用,公网上什么都看不到。
有 root 就用 tailscale serve;没 root 就用用户态模式 —— 两条路我都跑通了,
真正麻烦的从来不是技术,而是「信任围栏到底该写哪个 IP」这种细节:写你地址栏里的那个地址。
参考:dsh --help、dsh web --help 和安装目录里的 @deepseek-ai/dsh/README.md;
Tailscale 的 https://tailscale.com/download 与官方知识库(serve / funnel / auth key)。