前言¶
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
