---
title: "DeepSeek Harness 安装与 Web UI 启动指南"
description: "准确说明 DSH 的 Node.js 版本要求、npx 启动命令、默认 3080 地址、源码运行步骤和首次打开 Web UI 的验证方法。"
canonical: https://52dsh.com/tutorials/deepseek-harness-install-web-ui/
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 安装与 Web UI 启动指南

准确说明 DSH 的 Node.js 版本要求、npx 启动命令、默认 3080 地址、源码运行步骤和首次打开 Web UI 的验证方法。

## 最短安装方式

DeepSeek Harness 官方当前推荐通过 npx 启动 Web UI，不要求先全局安装 DSH：

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

启动成功后访问 `http://127.0.0.1:3080`。本文适用于官方源码版本 `0.1.0-rc.5`；DSH 是 Developer Preview，若未来版本改变命令，应以官方 README 为准。

## 检查 Node.js 版本

根包声明的 Node.js 范围不是笼统的“Node 22+”，而是 `^22.19.0 || >=24.0.0`。执行：

```bash
node --version
npx --version
```

符合条件的例子包括 Node 22.19.0 及之后的 22.x，以及 Node 24 或更高版本。Node 23 不在官方声明范围内。版本不符合时先切换 Node，再处理 DSH 错误，否则容易把运行时问题误判成项目故障。

## 选择启动目录

在准备作为默认 workspace 根目录的项目目录中运行启动命令：

```bash
cd /path/to/your-project
npx @deepseek-ai/dsh web
```

Windows PowerShell、macOS 和 Linux 的核心命令一致，路径写法按各自终端调整。启动目录提供默认工作区位置，但新的 Web UI 仍要求你在界面中添加并选中 workspace；没有选中时输入区可能不可用。

## 验证 Web UI

浏览器打开 `http://127.0.0.1:3080`，然后依次验证：页面能加载；Settings → Models 可用；能添加并选择测试 workspace；输入区变为可用；配置模型后能完成只读任务。

输入框不可用时看[工作区未选择修复](/errors/dsh-workspace-not-selected/)；地址打不开且终端提示端口冲突时看[3080 端口占用修复](/errors/dsh-port-3080-in-use/)。

## 修改端口

默认 3080 已被占用时，可以指定另一个本地端口：

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

然后访问 `http://127.0.0.1:8080`。官方 CLI 当前有意拒绝 `--host 0.0.0.0`，因此不能把普通 Web 框架的监听参数直接套用到 DSH。`--trusted-host` 增加的是浏览器 API 接受的具名 authority，并不等价于开放监听地址。

## 从源码运行

需要参与开发或审计源码时，官方步骤是：

```bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
```

源码运行需要 pnpm；普通 npx 快速启动与插件管理不是同一个流程。CLI 的插件管理命令会把参数转发给 pnpm，因此准备安装第三方插件时也必须保证 pnpm 在 PATH 中。

## 安装完成后做什么

继续按[DeepSeek Harness 中文入门](/tutorials/dsh-complete-guide/)配置模型和第一次任务。API Key、Provider 或模型 ID 有问题时，进入[模型与 Provider 配置指南](/tutorials/deepseek-harness-model-provider/)。

不要把“Web UI 打开”当作完整验收。真正的完成条件是：版本符合、模型路由有效、工作区明确、任务结果可验证，并且没有把凭据或敏感目录暴露给不必要的工具。

## 原始来源

- 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