GHJIVHIDD/dsh-plugin-container

Docker 容器沙箱部署级插件(与 dsh-plugin-vm-sandbox 全能力对齐,无需 OrbStack):39 个 docker_* 模型工具、快照/回滚、文件传输、端口转发、后台任务、审计、共享/配额/回收、网络策略与华丽原生 UI。

Project Overview项目介绍

This is a native Docker container sandbox plugin built exclusively for DeepSeek Harness (DSH), designed to extend DSH's sandbox capability to all platforms that support Docker. The official DSH VM sandbox plugin relies on OrbStack, a macOS-only tool that left Linux and Windows users without access to session-level sandbox features. This plugin adds a dedicated "Container" tab to the DSH session view UI, with dual modes: read-only (default, hides all write operations) and intervention (shows full management controls). It ships with 39 docker_* tools and 15 /dock-api/* HTTP routes, and fully replicates all core capabilities of the official dsh-plugin-vm-sandbox plugin.

To install and use this plugin, you only need a working local Docker Engine and Docker CLI on your system. No extra runtime dependencies are required: the host side only uses Node.js built-in modules and the official Docker CLI, while the client side only depends on React browser modules. It works across all major desktop platforms: any system that can run Docker (including Linux, Windows with Docker Desktop, and macOS with Docker Desktop or OrbStack) can run this plugin without issues. To start using it, install it via the DSH plugin marketplace, then enable it and connect your local Docker Engine.

The plugin follows the official DSH plugin directory structure and development conventions, making it easy for maintainers to update and extend. It includes built-in verification and smoke test scripts to ensure all tools and routes work as expected after any code changes. It is released under the permissive Apache 2.0 open source license, so you can use, modify, and distribute it freely without any cost. The current stable version v1.0.3 includes bug fixes for common issues, improving overall runtime stability for end users.

这是DeepSeek Harness(DSH)原生的Docker容器沙箱部署级插件,用于替代仅支持macOS的官方OrbStack虚拟机沙箱。它在DSH会话视图中新增「容器」页签,提供仅观察/干预双模式原生UI,包含39个docker操作工具和15个HTTP路由,完整对齐官方dsh-plugin-vm-sandbox的全部能力。

官方原虚拟机沙箱依赖macOS专属的OrbStack,Linux和Windows用户长期无法使用会话级沙箱能力。本插件基于本地Docker Engine实现,把原虚拟机沙箱的所有核心能力(包括快照回滚、文件传输、端口转发、多容器并行等)一一映射到Docker容器,实现了跨平台支持。

本插件遵循官方插件目录结构,零额外运行时依赖,宿主端仅使用Node内置模块和官方Docker CLI,客户端仅依赖React浏览器模块。只要系统能运行Docker Engine,就可以安装使用,支持Linux、Windows和macOS全平台,采用Apache 2.0开源许可。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:GHJIVHIDD/dsh-plugin-container

把 GHJIVHIDD/dsh-plugin-container 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plugin-container

DeepSeek Harness(DSH)的 Docker 容器沙箱 部署级插件。
在会话视图环中新增「容器」页签,提供 仅观察 / 干预 双模式原生 UI、39 个 docker_* 模型工具、15 个 /dock-api/* HTTP 路由,并完整对齐官方 dsh-plugin-vm-sandbox v0.1.0 的全部能力:快照/回滚、文件传输、端口转发、后台任务、审计、共享协作、配额与回收、网络策略、自定义资源、初始化脚本、多容器并行执行、增强状态查询。


为什么需要这个插件?

官方 dsh-plugin-vm-sandbox 依赖 OrbStack(macOS 专属)。Linux 用户与 Windows 用户没有 OrbStack,就无法获得会话级沙箱能力。

本插件以 本地 Docker Engine 作为底层,把 VM 沙箱的能力一一映射到 Docker:

能力 dsh-plugin-vm-sandbox dsh-plugin-container v1.0.0
清单 / 创建 / 删除 vm_list / vm_create / vm_delete docker_ps / docker_create / docker_run / docker_rm
生命周期 vm_start / vm_stop / vm_restart docker_start / docker_stop / docker_restart
增强状态 vm_status docker_status
快照 / 回滚 vm_snapshot / vm_snapshot_list / vm_restore / vm_snapshot_delete docker_snapshot / docker_snapshot_list / docker_restore / docker_snapshot_delete
文件传输 vm_upload / vm_download docker_upload / docker_download
端口转发 vm_port_forward / vm_port_forward_list / vm_port_forward_stop docker_port_forward / docker_port_forward_list / docker_port_forward_stop
后台任务 vm_job_submit / vm_job_list / vm_job_status / vm_job_stop / vm_job_output docker_job_submit / docker_job_list / docker_job_status / docker_job_stop / docker_job_output
操作审计 vm_audit docker_audit
共享协作 vm_share / vm_unshare / vm_policy docker_share / docker_unshare / docker_policy
网络策略 vm_network docker_network_policy
命令执行 vm_exec(支持 machines 并行) docker_exec(支持 containers 并行)
自定义资源 cpus / memory / disk cpus / memory / memory_swap / shm_size / pids_limit / disk_quota
初始化脚本 init_script / cloud_init init_script / command

Docker 与 OrbStack 是两种不同抽象:OrbStack 的 orb clone 按需复制磁盘、orb push/pull 直接进入 VM;Docker 版本使用 docker commit 镜像快照与 docker cp 文件传输,语义等价、实现完全 Docker-native。网络策略则通过 dsh-sandbox 公网 bridge 与 dsh-sandbox-internal 内部网络(docker network create --internal)实现。


项目定位

  • 部署级插件:与官方 VM 沙箱一致,不依赖私有 RPC。面板数据全部通过宿主 webServer 暴露的 /dock-api/* 标准 HTTP 路由获取。
  • 官方目录结构:严格参照 dsh-plugin-vm-sandbox 仓库布局(根包 prepare → dsh-plugin-container/lib 发布入口;内层 dsh-plugin-container/ 为 npm 发布包;cordis.patch.yml 自动插入 ui-container)。
  • 零运行时依赖:Host 半区只使用 Node 内置模块与官方 docker CLI;Client 半区仅依赖 react 浏览器模块。
  • 跨平台:只要 Docker CLI 能连上 Docker Engine 即可使用 —— Linux、Windows(Docker Desktop)、macOS(Docker Desktop / OrbStack Docker context)全部支持。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev safe-find-dsh-plugins 下一个 Next dsh-desktop →