---
title: "DeepSeek Harness 3080 端口占用：修改端口与 Host 限制"
description: "解决 DSH Web UI 默认 3080 端口占用，给出 --port 用法、验证方式，并解释为什么 --host 0.0.0.0 会被拒绝。"
canonical: https://52dsh.com/errors/dsh-port-3080-in-use/
authors: ["52DSH 编辑部"]
published_at: 2026-08-18
updated_at: 2026-08-18
verified_on: 2026-08-18
maintenance_status: community
verification_level: source_reviewed
risk_level: medium
---

# DeepSeek Harness 3080 端口占用：修改端口与 Host 限制

解决 DSH Web UI 默认 3080 端口占用，给出 --port 用法、验证方式，并解释为什么 --host 0.0.0.0 会被拒绝。

## 直接修复

DeepSeek Harness Web UI 默认使用 `127.0.0.1:3080`。3080 被其他进程占用时，换一个空闲端口启动：

```bash
npx @deepseek-ai/dsh web --port 8080
```

然后访问 `http://127.0.0.1:8080`。如果使用已安装的 CLI，也可以运行 `dsh web --port 8080`。端口值来自本次命令行参数，优先于默认配置。

## 确认是不是端口问题

先查看启动终端。若 DSH 在绑定 3080 时报告地址已被使用，才属于本页问题。若命令根本不存在、Node 版本不支持或进程在配置解析阶段退出，应回到[安装与 Web UI 指南](/tutorials/deepseek-harness-install-web-ui/)或[Web UI 启动失败总排查](/errors/web-ui-start-failed/)。

你也可以先停止已经运行的旧 DSH 进程，再重试默认端口。不要在不清楚进程用途时强制结束任意占用者；使用新端口通常更安全、也更容易回滚。

## 为什么 --host 0.0.0.0 不可用

官方 CLI 参考明确说明，当前生产 Web 运行器有意不支持：

```bash
dsh web --host 0.0.0.0
```

该参数会以用法错误退出。这不是端口占用，也不应通过反复换端口解决。DSH 默认只提供本机回环地址，不能把其他 Node Web 项目的公网监听教程直接套用进来。

`--trusted-host` 用于增加 `/api` 浏览器信任围栏接受的具名 authority，但它不是“监听所有网卡”的替代参数。需要远程或局域网访问时，应等待或遵循官方部署方案，并额外处理 TLS、认证、反向代理和访问控制，不能只扩大监听范围。

## 验证修复

1. 终端保持运行，没有新的绑定错误。
2. 新地址能加载 Web UI。
3. 原来的 3080 服务不受影响。
4. Settings 和 workspace 入口可用。
5. 关闭本次 DSH 后，新端口不再被它占用。

## 回滚

停止使用 `--port` 启动的进程，下次不带该参数运行，就会恢复默认 3080。若你同时修改了 Profile patch，请不要假设命令停止后配置也自动恢复；用 `dsh --profile web --dump-config` 检查实际配置层。

页面打开但输入框不可用通常不是端口错误，请看[DSH 工作区未选择](/errors/dsh-workspace-not-selected/)。

## 原始来源

- https://github.com/deepseek-ai/deepseek-harness/blob/master/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/reference/README.zh.md