|
| 1 | +# DeepSeek Harness 安装部署 |
| 2 | + |
| 3 | +## 产品介绍 |
| 4 | + |
| 5 | +!!! note "" |
| 6 | + **DeepSeek Harness(简称 DSH)** 是 DeepSeek 面向开发者推出的开源智能体运行环境。它负责向大模型提供项目文件、工具和运行环境,让模型可以完成开发任务。 |
| 7 | + |
| 8 | + DeepSeek Harness 采用插件化架构,可按任务组合网页检索、Skills、计划、子 Agent 和工作流等能力,并提供以下四种运行模式: |
| 9 | + |
| 10 | + - **标准模式**:适合日常开发任务,建议初次使用时选择 |
| 11 | + - **PTC 模式**:适合多步骤、复杂的工具调用编排 |
| 12 | + - **极简模式**:仅保留基础命令和编辑工具 |
| 13 | + - **创造模式**:用于创建和调试自定义 Agent 预设 |
| 14 | + |
| 15 | + 更多产品信息,请参阅 [DeepSeek Harness 官方说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/README.zh.md)。 |
| 16 | + |
| 17 | +## 前提准备 |
| 18 | + |
| 19 | +!!! note "" |
| 20 | + 部署前请先确认以下条件: |
| 21 | + |
| 22 | + - 已安装并可正常访问 1Panel |
| 23 | + - 已准备 DeepSeek 或其他模型提供方的 API Key |
| 24 | + - 已在云安全组和系统防火墙中放行计划使用的 HTTPS 端口 |
| 25 | + - 已准备浏览器实际访问服务器时使用的 IPv4 地址或主机名 |
| 26 | + |
| 27 | +## 1. 安装 DeepSeek Harness |
| 28 | + |
| 29 | +!!! note "" |
| 30 | + 登录 1Panel 后台,进入 **应用商店**,搜索 **DeepSeek Harness**,进入应用详情页并点击 **安装**。 |
| 31 | + |
| 32 | + 按页面要求填写安装参数: |
| 33 | + |
| 34 | + - **名称**:应用名称,默认可填写为 `deepseek-harness` |
| 35 | + - **版本**:选择需要安装的 DeepSeek Harness 版本 |
| 36 | + - **HTTPS 端口**:用于访问 Web UI,例如 `10443` |
| 37 | + - **访问地址**:填写浏览器实际使用的 IPv4 地址或主机名,不包含 `https://` 和端口 |
| 38 | + - **Web 用户名**:访问 Web UI 时使用的认证用户名 |
| 39 | + - **Web 访问密码**:设置至少 12 位的强密码 |
| 40 | + - **高级设置**:一般保持默认即可 |
| 41 | + |
| 42 | + |
| 43 | + |
| 44 | +!!! note "" |
| 45 | + 1Panel 应用商店中的 DeepSeek Harness 集成了 Caddy HTTPS 和用户名密码认证。Harness 仅监听容器回环地址,外部请求需要先经过 Caddy 鉴权和解密,再转发到 Harness 服务。 |
| 46 | + |
| 47 | +## 2. 访问 DeepSeek Harness |
| 48 | + |
| 49 | +!!! note "" |
| 50 | + 安装完成后,在浏览器中访问: |
| 51 | + |
| 52 | + ```text |
| 53 | + https://<访问地址>:<HTTPS 端口> |
| 54 | + ``` |
| 55 | + |
| 56 | + 浏览器会先要求输入安装时设置的 Web 用户名和密码,认证通过后即可进入 DeepSeek Harness。 |
| 57 | + |
| 58 | +!!! warning "" |
| 59 | + Caddy 使用内部 CA 自动签发证书,首次访问时浏览器可能提示证书不受信任。测试体验时可以确认地址无误后继续访问;正式环境建议配置受浏览器信任的证书。 |
| 60 | + |
| 61 | +## 3. 配置 DeepSeek 官方模型 |
| 62 | + |
| 63 | +!!! note "" |
| 64 | + 首次进入 DeepSeek Harness 时,页面会提示添加 API Key。填写 DeepSeek 官方 API Key 后,点击 **保存并继续**。 |
| 65 | + |
| 66 | + 也可以点击 **稍后配置**,进入页面后再打开左下角的 **设置**,在 **模型** 页面中完成配置。 |
| 67 | + |
| 68 | + |
| 69 | + |
| 70 | +## 4. 配置第三方模型提供方 |
| 71 | + |
| 72 | +!!! note "" |
| 73 | + DeepSeek Harness 也支持配置第三方模型提供方。以 OpenCode Go 为例: |
| 74 | + |
| 75 | + 1. 打开左下角的 **设置**。 |
| 76 | + 2. 进入 **模型** 页面,选择 **添加提供方**。 |
| 77 | + 3. 选择 `opencode-go`,填写 API Key。 |
| 78 | + 4. 按需配置 API 地址和模型,确认无误后点击 **保存**。 |
| 79 | + |
| 80 | + |
| 81 | + |
| 82 | +## 5. 开始第一个任务 |
| 83 | + |
| 84 | +!!! note "" |
| 85 | + 返回首页,在输入框左下角选择工作区,在右下角确认模型和运行模式,然后输入任务内容即可开始对话。 |
| 86 | + |
| 87 | + 首次体验建议选择 **标准模式**,并使用不包含敏感数据的测试项目。 |
| 88 | + |
| 89 | + |
| 90 | + |
| 91 | +## 6. 安全与升级建议 |
| 92 | + |
| 93 | +!!! warning "" |
| 94 | + DeepSeek Harness 目前仍处于开发者预览阶段,建议仅用于测试体验,并注意以下事项: |
| 95 | + |
| 96 | + - 妥善保管 API Key 和 Web 访问密码 |
| 97 | + - 不要将宿主机根目录、Docker Socket 或 SSH 密钥目录挂载到工作区 |
| 98 | + - 不要在工作区中放置敏感数据 |
| 99 | + - 升级前备份重要数据 |
0 commit comments