前言¶
DeepSeek Harness (DSH) 的插件生态允许开发者将功能打包扩展。在本地运行 DSH Web 界面时，默认监听地址仅为 127.0.0.1:3080，无法从外部网络直接访问。dsh-cftunnel 插件通过运行 Cloudflare Tunnel，将本地 Web GUI 暴露在公网，并自动处理 cloudflared 的下载与管理，省去了手动配置内网穿透的步骤。
插件定位¶
dsh-cftunnel 是一个 DeepSeek Harness bundle 插件。由用户 weicy98 维护。它主要解决本地 DSH 界面无法被公网访问的问题，通过 Cloudflare 的隧道技术实现内网穿透。
核心功能¶
该插件具备以下核心能力：
* 运行 Cloudflare Tunnel
* 自动下载和管理 cloudflared
* 支持 Quick tunnel / Tunnel token / API token 三种模式
* 通过 Loopback reverse proxy 暴露本地 GUI
* 提供令牌验证和 Cloudflare Access email OTP 访问控制
安装与启用¶
安装插件需要使用官方提供的安装命令：
dsh plugin --profile web add git+https://github.com/weicy98/dsh-cftunnel
安装完成后，重启 dsh web，在界面中打开 Settings -> Cloudflare Tunnel。
典型用法¶
- 在 Settings 中选择模式（Quick tunnel / Tunnel token / API token）。
- 填入对应的 Cloudflare 信息（如 API Token 或 Tunnel Token）。
- 点击 Connect 按钮。
- 插件会自动下载并运行 cloudflared，连接成功后，复制生成的访问 URL 即可分享给他人。
模式与安全¶
插件提供三种模式以适应不同的场景：
- Quick tunnel：无需账户信息，直接生成随机公网 URL。
- Tunnel token：使用已有的 Cloudflare Zero Trust 隧道。
- API token：使用 API 创建隧道、DNS，并可选配置邮箱 OTP 验证。
所有流量通过 Loopback reverse proxy (127.0.0.1:<proxyPort>) 转发，并在前端设有访问控制。默认开启令牌验证（proxyAuth: 'token'），可选开启 Cloudflare Access 的邮箱 OTP 验证。
注意事项¶
- 首次连接：插件首次 Connect 时会下载约 40MB 的
cloudflared二进制文件，网络较慢时可能需要几分钟。 - 源码更新：编辑源码后，需要使用
remove+add（或版本升级）命令来刷新插件，pnpm 将源码视为不可变。 - 访问控制：设置
proxyAuth: 'none'会禁用令牌验证门，仅依赖 Cloudflare Access 的邮箱 OTP 或不设限制。 - 权限要求：API token 模式需要特定的 API 权限才能创建隧道和 DNS。
总结¶
dsh-cftunnel 为本地运行的 DSH Harness 提供了一条简捷的公网暴露路径。通过集成的 Cloudflare Tunnel 和自动化的配置流程，开发者可以快速获得安全的访问入口。
- 目录：https://www.skillhub.cn/plugins/weicy98/dsh-cftunnel
- 源码：https://github.com/weicy98/dsh-cftunnel
