DeepSeek Harness 启动报 3080 端口被占用是什么现象？为什么页面还能打开？

DeepSeek Harness 报 3080 端口被占用，是旧 dsh 进程还占着 3080 端口，新实例起不来或换了端口——浏览器打开的可能还是旧实例，所以页面正常但「配置改了不生效」。用 lsof -i :3080（macOS/Linux）或 netstat -ano | findstr :3080（Windows）看占用进程（[来源](https://www.dshbase.com/zh/troubleshooting/)）。

3080 端口被占用怎么释放？杀进程命令是什么？

释放 DeepSeek Harness 被占用的 3080 端口：macOS/Linux 先 lsof -i :3080 拿到 PID 再执行 kill -9 ；Windows 执行 netstat -ano | findstr :3080 拿 PID 后 taskkill /PID /F。杀掉后重启 dsh web，访问 http://127.0.0.1:3080 确认是新实例。

不想杀进程，怎么给 dsh web 换端口？--port 参数怎么用？

dsh web 支持 --port 参数：执行 dsh web --port 8080 改用 8080 端口，改完访问 http://127.0.0.1:8080。注意 --port 是 web 应用的参数，要放在 dsh web 之后（[来源](https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/reference/README.md)）。

怎么预防 3080 端口被占用？优雅退出和进程清单怎么查？

预防 DeepSeek Harness 端口占用：关闭 dsh 用 Ctrl+C 触发优雅关闭，别直接关终端窗口；多实例并存前先 ps aux | grep dsh（Windows 用 tasklist | findstr dsh）查一遍进程清单，确认没有旧实例残留再启动新的。

DeepSeek Harness 启动端口被占用：3080 端口冲突的定位、释放与换端口设置

DeepSeek Harness 启动报 3080 端口被占用，是残留进程或多实例占着端口、新实例起不来——浏览器打开的往往还是旧实例，所以「页面能开但配置改了不生效」。定位（lsof -i :3080 / netstat -ano | findstr :3080）→ 释放或换端口（dsh web --port 8080）→ 验证访问，三步解决；平时用优雅退出、启动前查进程清单预防。

DeepSeek Harness 报 3080 端口被占用：旧进程占着、新实例起不来

3080 端口被占用 的典型现象是：旧 dsh 进程还占着 3080，新实例启动时绑不上端口，浏览器打开的还是旧实例——功能看似正常，但配置改动永远不生效。这是 dshbase 排错页收录的运行时高频问题（来源）：

你启动 dsh web，终端提示 3080 端口被占用（或静默换端口、日志打印新端口）；
浏览器打开 http://127.0.0.1:3080 页面却能正常显示——因为连的是旧实例；
修改配置后重启，改动不生效——新实例根本没起来；
判断关键：页面能开 ≠ 服务健康，先确认你连的是不是新启动的实例。

DeepSeek Harness 端口冲突根因：残留进程、多实例与防火墙占用

3080 端口被占用的根因三类：旧进程没退干净（残留）、多个实例并存（多开）、防火墙或代理拦截（占用幻觉）。 逐一说明：

残留进程：直接关终端窗口、或强杀 dsh 时，子进程可能没被带走，仍占着 3080（来源）。
多实例并存：桌面端与 dsh web 同时挂同一个 profile、或重复启动多个 web 实例，后启动的绑不上端口。
防火墙 / 代理占用：系统防火墙或全局代理规则把 3080 的访问拦截/转发，表现为「端口看似被占用、实际没有进程」——这种情况 lsof 查不到进程，要查代理规则。
dsh web 默认监听 127.0.0.1:3080（官方 README 确认默认地址，来源），端口被占时最常见的就是第 1、2 类。

解决 DeepSeek Harness 端口占用：定位进程 → 释放或换端口 → 验证访问

按「先定位、再处理」的顺序：lsof/netstat 找到占用者，杀掉或换端口二选一，最后访问验证新实例。 逐步执行：

定位占用 3080 的进程： macOS / Linux：
bash
```
lsof -i :3080
```
（Linux 也可用 ss 直接看监听：ss -tlnp | grep :3080） Windows（PowerShell）：
powershell
```
netstat -ano | findstr :3080
```
记下输出里的 PID（lsof 的 PID 列 / netstat 的最后一列）。确认占用者不是系统服务后进入下一步；查不到任何进程却仍提示占用，跳到第 4 步查代理与防火墙。
释放端口（杀掉占用进程）： macOS / Linux：
bash
```
kill -9 <PID>
```
Windows：
powershell
```
taskkill /PID <PID> /F
```
杀掉后再次执行 lsof -i :3080（或 netstat），预期无输出——端口已释放。
换端口（不想杀进程时的备选）——--port 是 web 应用的参数，要放在 dsh web 之后：
bash
```
dsh web --port 8080
```
终端出现 http://127.0.0.1:8080 提示后，浏览器访问 http://127.0.0.1:8080（[来源](https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/reference/README.md)）。
排查防火墙 / 代理：lsof 查不到进程但端口仍打不开时，检查全局代理是否把 127.0.0.1 也转发出去——把本机地址加入直连/白名单，或临时关闭全局代理再访问。
验证访问：浏览器访问 http://127.0.0.1:3080（或换后的端口），确认页面为刚启动的新实例；改过的配置应立即生效。

DeepSeek Harness 换端口后怎么验证与恢复默认端口？

换完端口要验证两件事：新端口真的在监听、页面能打开；想恢复 3080，杀掉占用者后直接 dsh web 即可。 按顺序执行：

确认新端口在监听：
bash
```
lsof -i :8080
```
输出里有 dsh 进程监听 LISTEN 即成功；无输出说明服务没起来，回上节重查。
浏览器验证：访问 http://127.0.0.1:8080，页面正常加载、改动过的配置立即生效，即整条链路通。
恢复默认 3080：先杀掉占用 3080 的旧进程（macOS/Linux kill -9 <PID>，Windows taskkill /PID <PID> /F），再直接执行：
bash
```
dsh web
```
终端打印 dsh web: http://127.0.0.1:3080 即恢复默认端口。
Linux 一次性释放端口（备选）：确认占用者是 dsh 后，用 fuser 直接释放：
bash
```
fuser -k 3080/tcp
```
执行后再 lsof -i :3080，无输出即端口已释放。

注意事项：DeepSeek Harness 端口占用先定位再释放

关闭 dsh 用 Ctrl+C 触发优雅退出——第一次 Ctrl+C 让插件清理现场，卡住再按一次强退；直接关窗口最容易留残留进程。
启动前先查进程清单：macOS/Linux ps aux | grep dsh，Windows tasklist | findstr dsh——有旧实例先处理再启动。
桌面端与 dsh web 不要同时挂同一个 profile，双实例并发写还会带来会话类问题。
插件加载异常也可能让 Web UI 界面异常——遇到插件相关故障，到「设置 → 插件市场」用 DSH Plugin Hub 查安装记录与报错，比盲猜更快。
其他安装报错可参考安装报错排查。

来源：dshbase 常见问题排错、DeepSeek Harness CLI 行为参考、DeepSeek Harness README