---
title: "DSH Web UI 启动失败：从环境到端口逐项排查"
description: "遇到 DSH Web UI 无法启动时，按命令来源、运行时、端口、网络、权限和日志顺序缩小问题范围。"
canonical: https://52dsh.com/errors/web-ui-start-failed/
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: low
---

# DSH Web UI 启动失败：从环境到端口逐项排查

遇到 DSH Web UI 无法启动时，按命令来源、运行时、端口、网络、权限和日志顺序缩小问题范围。

## 先保存完整错误原文

不要只记录“打不开”。保存执行的命令、工作目录、第一条错误、最后一条错误、运行时版本和操作系统。截图适合保留界面，但可复制的错误文本更适合搜索和比较。

在公开求助前删除用户名、目录中的客户名称、Token、Cookie、内网地址和其他敏感信息。

## 确认命令和运行时

官方启动命令是 `npx @deepseek-ai/dsh web`，默认地址是 `http://127.0.0.1:3080`。`0.1.0-rc.5` 要求 Node.js `^22.19.0 || >=24.0.0`。确认当前终端实际调用的是预期 Node.js，而不是系统中另一个旧版本。详细步骤见[安装与 Web UI 指南](/tutorials/deepseek-harness-install-web-ui/)。

## 排查端口和残留进程

如果日志提示端口被占用，先确认占用者是否是另一个仍在运行的 DSH 实例。不要为了释放端口批量结束不认识的系统进程。优先正常关闭旧实例，或使用 `--port` 选择另一个端口。具体命令与 Host 限制见[3080 端口占用修复](/errors/dsh-port-3080-in-use/)。

## 区分网络、权限和配置问题

下载依赖失败通常与网络、代理或证书有关；写入失败通常与目录权限或安全软件有关；启动后模型不可用则更可能是配置或凭据问题。一次只改变一个变量，并记录变化后的错误。

页面打开但输入框不可用时，先检查是否[选择了 Workspace](/errors/dsh-workspace-not-selected/)。启动后模型不可用时，按[模型与 Provider 配置](/tutorials/deepseek-harness-model-provider/)检查凭据和路由。

修复后重新执行一个最小任务，确认界面、日志和产物都正常。如果问题仍然存在，把脱敏后的环境、命令、错误和已尝试步骤一起提交，而不是重复执行未经理解的修复脚本。

## 原始来源

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