szcq/deepseek-harness Docker 镜像

镜像概述

szcq/deepseek-harness是面向DeepSeek Harness的非官方Docker镜像，预安装官方@deepseek-ai/dsh运行包，在原生功能之外新增持久化更新、版本回滚、服务端统一认证的本地管理员体系、可配置的管理隔离、受管出站代理路由、故障恢复工具以及可选开发工具扩展，提供更稳定易用的容器化部署体验。

注意：DeepSeek Harness当前处于开发者预览阶段，后续可能引入不兼容变更，本项目与DeepSeek AI官方无隶属关系。

镜像变体

镜像提供两个可用变体，均原生支持linux/amd64和linux/arm64架构：

Docker Hub镜像标签与上游DSH版本保持同步。ghcr.io/yjrszcq/dsh-docker仅同步发布标准版镜像，提供环境版本标签和dsh-<version>格式的查询标签，不提供开发工具版镜像。

核心功能

1. 独立管理中心：DSH运行时停止或故障时仍可访问，独立提供系统运维能力
2. 版本生命周期管理：支持稳定/实验双更新通道，内置自动健康校验与一键回滚能力
3. 细粒度代理路由：可独立为更新、插件、模型请求等不同出站流量范围配置HTTP/SOCKS5代理，不会对外暴露公共代理服务
4. 全链路数据持久化：分离存储运行配置、平台状态与工作区数据，升级容器不会丢失业务数据
5. 多因素身份认证：支持独立管理员会话、可选管理密码与TOTP两步验证，多维度保护访问安全
6. 内置运维能力：提供实时日志检索、特权终端、全容器文件管理与认证故障恢复工具

使用场景

• 本地快速部署DeepSeek Harness开发运行环境，无需手动配置依赖
• 企业内部局域网部署受控的AI Agent工作台，实现团队本地协作开发
• 开发人员在隔离环境中调试AI插件、自定义技能与Agent工作流
• 生产环境中稳定运行DSH服务，支持在线无停机更新与故障快速恢复

配置说明

使用前须知

1. 目录权限要求：绑定挂载的data/dsh、data/platform和workspace目录必须开放给容器内UID/GID为1000:1000的用户读写
2. 数据持久化要求：重新创建或升级容器时必须同时保留data/dsh与data/platform两个目录，二者存储内容独立不可混用合并
3. 端口安全要求：默认快速配置仅绑定本地回环地址3080端口，仅宿主机可访问；如需对外暴露请务必配置可信访问规则并启用HTTPS
4. Root权限控制：DSH与Agent的免密码sudo能力默认关闭，仅在确有必要时手动开启，避免授权不当引发宿主机安全风险

环境变量配置

部署示例

前置准备

创建持久化目录并修正所有权：

bash
mkdir -p data/dsh data/platform workspace
sudo chown -R 1000:1000 data workspace

docker-compose部署

编写docker-compose.yaml文件：

yaml
services:
  deepseek-harness:
    image: docker.xuanyuan.run/szcq/deepseek-harness:latest
    container_name: deepseek-harness
    restart: unless-stopped
    ports:
      - "127.0.0.1:3080:3080"
    volumes:
      - ./data/dsh:/data/dsh
      - ./data/platform:/data/platform
      - ./workspace:/workspace

启动服务：

bash
docker compose up -d

docker run部署

直接执行命令启动容器：

bash
docker run -d \
  --name deepseek-harness \
  --restart unless-stopped \
  -p 127.0.0.1:3080:3080 \
  -v "$(pwd)/data/dsh:/data/dsh" \
  -v "$(pwd)/data/platform:/data/platform" \
  -v "$(pwd)/workspace:/workspace" \
  docker.xuanyuan.run/szcq/deepseek-harness:latest

部署完成后访问http://127.0.0.1:3080即可进入DSH界面，访问http://127.0.0.1:3080/_dsh_platform/console/可进入独立管理中心完成初始化配置。

常用运维命令

bash
# 查看平台运行状态
docker exec deepseek-harness dsh-platform status
# 检查可用更新
docker exec deepseek-harness dsh-platform check
# 执行更新并等待完成
docker exec deepseek-harness dsh-platform update --wait
# 一键回滚到上一个稳定版本
docker exec deepseek-harness dsh-platform rollback

安全提示

远程访问部署时请搭配强密码、HTTPS反向代理与防火墙规则，仅开放给可信网络范围使用；除非明确了解风险，请勿同时启用免密码sudo、容器特权模式与挂载宿主机Docker Socket，避免容器被攻陷后失控影响宿主机安全。