runzhliu/deepseek-harness

DeepSeek Harness Docker

https://github.com/runzhliu/deepseek-harness-docker/blob/main/README.en.md | 简体中文

镜像概述

这是一个可直接构建的DeepSeek Harness社区容器方案，默认运行官方@deepseek-ai/dsh的Web UI。它不修改DeepSeek Harness源码，仅将官方npm发行物装入精简、非root的Node.js 24运行时，支持amd64和arm64双架构。

当前基线：@deepseek-ai/dsh@0.1.5-alpha.1（预发布阶段，升级前需重新验证）。

核心功能

• 双架构支持：适配x86 Linux和Apple Silicon设备；
• 官方Web UI：默认启动带token认证的Web界面；
• 内置浏览器：集成Debian Chromium及桌面环境，支持WebUI内嵌交互；
• 隐私变体：可选ungoogled-chromium镜像，减少后台连接；
• 多部署方式：提供Docker、Compose、Helm三种部署方案；
• 插件支持：可独立安装社区插件，可选集成第三方插件市场。

使用场景

• 本地快速体验DeepSeek Harness的Agent功能；
• 开发环境中测试模型调用与工具集成；
• 小团队内部共享DeepSeek Harness服务；
• 学习容器化部署AI工具的实践方案。

配置说明

快速开始（Docker Compose）

1. 拉取镜像并启动：

bash
docker compose pull
DSH_WORKSPACE=/绝对路径/到/你的项目 docker compose up -d --no-build

2. 获取访问地址：

bash
docker compose logs --no-color deepseek-harness | grep 'dsh web:'

打开日志中带?token=...的完整地址（如[***]）。

直接Docker运行

构建镜像：

bash
docker build -t runzhliu/deepseek-harness:0.1.5-alpha.1-r1 .

启动Web UI：

bash
docker volume create dsh-home
docker run --rm \
  --name deepseek-harness \
  --publish 127.0.0.1:3080:3080 \
  --publish 127.0.0.1:6080:6080 \
  --shm-size docker.xuanyuan.run/1g \
  --mount type=volume,src=dsh-home,dst=/home/node/.dsh \
  --mount type=bind,src="$PWD",dst=/workspace \
  runzhliu/deepseek-harness:0.1.5-alpha.1-r1

**注意：**端口仅绑定本地回环，勿暴露到公网。

Headless模式

bash
docker run --rm \
  --env DEEPSEEK_API_KEY \
  --mount type=volume,src=dsh-home,dst=/home/node/.dsh \
  --mount type=bind,src="$PWD",dst=/workspace \
  docker.xuanyuan.run/runzhliu/deepseek-harness:0.1.5-alpha.1-r1 \
  --profile headless "summarize this repository"

API Key仅通过环境变量传入，禁止写入镜像。

Kubernetes/Helm部署

安装Chart：

bash
helm upgrade --install deepseek-harness charts/deepseek-harness \
  --namespace deepseek-harness \
  --create-namespace \
  --set image.tag=0.1.5-alpha.1-r1

端口转发到本地：

bash
kubectl -n deepseek-harness port-forward service/deepseek-harness 3080:3080 6080:6080

查看日志获取