DeepSeek Harness Cloudflare 零信任接入插件

前言¶

DeepSeek Harness (DSH) 允許用戶在本地部署模型。遠程訪問通常需要公網 IP 或開放入站端口。本插件通過 Cloudflare Zero Trust 提供認證與路由能力，無需公網 IP。

插件定位¶

sevoniva-labs/dsh-cloudflare-access 是爲 DSH 提供的 Cloudflare Zero Trust 訪問插件。它通過 Cloudflare Access 進行認證，通過 Cloudflare Tunnel 進行路由，無需公網 IP 或開放入站端口。插件管理 Access 應用、Tunnel 和 DNS 配置，登錄由 Cloudflare 處理。

安裝與啓用¶

安裝插件並啓動 DSH：

dsh plugin --profile web add github:sevoniva-labs/dsh-cloudflare-access#v0.1.0-alpha.12
dsh --profile web --host 127.0.0.1

使用前提¶

需要官方 DSH 0.1.6-alpha.2，使用 Node.js 22.19.0 或更高版本。
需要已初始化 Cloudflare Zero Trust 賬號和託管域名。
Harness 主機必須能夠連接 Cloudflare，並在遠程使用期間保持運行。

核心功能¶

Cloudflare Access 認證
Cloudflare Tunnel 配置
DNS 配置
無需公網 IP
文件目錄瀏覽
模型配置管理
連接恢復

配置流程¶

打開 DSH 輸出的本機啓動鏈接，進入 設置 → Cloudflare 零信任接入。
安裝 cloudflared，或指定已有官方可執行文件的路徑。
填寫 Cloudflare API Token，選擇域名，填寫訪問子域名並選擇登錄方式。
填寫允許訪問的郵箱。需要可信設備限制時，填寫已有的設備檢查 ID。
點擊“檢查配置”，覈對資源和訪問權限，輸入完整訪問域名後點擊“發佈配置”。
等待隧道連接成功，再通過 HTTPS 域名登錄。

API Token 僅用於配置操作，不持久保存。插件不會覆蓋其他部署的 DNS、Access 應用或 Tunnel。設備檢查必須預先在 Cloudflare Zero Trust 中配置。

本地配置覆蓋示例（cordis.patch.yml）：

- id: dsh-cloudflare-access
  name: '@sevoniva/dsh-cloudflare-access'
  config:
    instance: web
    gatewayPort: 3082
    maxTokenAgeSeconds: 7200

適用場景與注意事項¶

權限模型：僅適用於主機所有者和可信管理員。所有獲准用戶共享同一個 Harness 的會話、文件和工具權限，不提供用戶隔離。
兼容性：需要 DSH 0.1.6-alpha.2 和 Node.js 22.19.0+。Windows 暫不支持自動安裝。
資源隔離：插件不修改官方文件，僅在本地網關層適配。升級 DSH 後需驗證功能。
安全：API Token 僅用於配置操作，不持久保存。設備檢查必須預先在 Cloudflare 中配置。

更新與卸載¶

更新時查看目標 Release 的兼容說明，將安裝命令中的 #v0.1.0-alpha.12 替換爲目標版本，安裝後重啓 DSH。

完全卸載時：
1. 在插件設置中停用入口。
2. 重新填寫 API Token，輸入當前子域名並刪除配置。
3. 刪除成功後卸載插件：dsh plugin --profile web remove @sevoniva/dsh-cloudflare-access。

直接卸載不會清理 Cloudflare 資源。

生態與許可¶

這是獨立社區插件，非 DeepSeek 或 Cloudflare 官方產品，使用 MIT License。可通過 GitHub 獲取源碼。