dsh-jumpserver

DeepSeek Harness 插件：让 agent 通过 JumpServer 管理资产，并经 KoKo 堡垒在资产上执行命令 / 读写文件。流量不直连资产 IP，命令过滤、ACL、会话审计仍然生效。

本版本只支持 SSH / SFTP。RDP、数据库等协议不在范围内。

兼容版本

插件调用 JumpServer Core REST API v1（Access Key 签名、用户资产授权、connection-token、client-url、主机资产 CRUD）。Core 与 KoKo 须为同一发行版本。

产品	支持的版本
JumpServer	v3.10 LTS（v3.10.0 ～ 当前 v3.10.22）、v4.10 LTS（v4.10.0 ～ 当前 v4.10.18）
DeepSeek Harness	>= 0.1.0-rc.6（开发预览，接口可能变化）

安装

本机已安装 dsh 后，优先从 GitHub 安装：

dsh plugin --profile web add github:jumpserver-east/jumpserver-dsh

pnpm >= 10 可能拒绝执行 git 依赖的 prepare。把 pnpm 打印的包名写进该 profile 的 pnpm-workspace.yaml：

allowBuilds:
  dsh-jumpserver: true

然后重新执行 dsh plugin add。可以用 github:jumpserver-east/jumpserver-dsh# 钉死提交。

从本地仓库安装：

cd jumpserver-dsh
pnpm install
pnpm build
dsh plugin --profile web add .

配置

dsh 的「插件配置」页不会根据插件 Config 自动出表单，目前只展示 Host 白名单里的官方卡片（Shell、Agent loop、Web search）。第三方插件进不了这一页，所以 JumpServer 没有设置页。装好后新建下面的 .env，再重启 dsh。

需配置 — $DSH_HOME/.env

dsh 主目录默认为：

• macOS / Linux：~/.dsh
• Windows：%USERPROFILE%\.dsh

在该目录新建 .env（安装插件时不会自动生成，可对照本仓库的 .env.example）：

JUMPSERVER_URL=https://jms.example.com
JUMPSERVER_ORG_ID=00000000-0000-0000-0000-000000000002
JUMPSERVER_ACCESS_KEY_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
JUMPSERVER_ACCESS_KEY_SECRET=********************************
JUMPSERVER_ENABLE_ASSET_ADMIN=false

Access Key 在 JumpServer「个人设置」里创建。跑 dsh 的这台机器要能连上 JumpServer Core（HTTPS）和 KoKo SSH；KoKo 的地址和端口会从 connection-token 自动带出，不用单独填。

• JUMPSERVER_ORG_ID 不写则使用 JumpServer 的 Default 组织。换组织改这一行后重启 dsh 即可。