前言¶

DeepSeek Harness (dsh) 運行在本地，若要在外網設備上使用，通常需要將端口暴露到公網，存在安全隱患。dsh-relay 提供了一種通過雲端中繼（Cloud Relay）和宿主機插件（Host Plugin）結合的方案，在不修改 dsh 核心代碼的前提下，將本地實例完整映射到公網，實現零端口暴露的遠程訪問。

插件概況¶

• 名稱: dsh-relay
• 作者: SunNull
• 分類: 聯網工具
• 許可: MIT

核心功能¶

• Cloud relay for DeepSeek Harness: 通過雲端中繼服務轉發請求。
• Expose your home dsh instance: 將家中的 dsh 實例完整暴露給任何設備，支持會話實時同步、流式輸出等所有原生功能。
• Out-of-tree plugin + wire-trunk architecture: 作爲樹外插件，使用 Wire-Trunk 架構實現通信。
• Process invisible browser: 家端插件以迴環身份復放請求，進程不可見。
• HTTPS support: 支持公網訪問的加密連接。
• Cordis architecture: 基於 Cordis 生態開發。

安裝與啓用¶

該插件依賴 Node.js 環境（需 Node >= 22）。

安裝命令:

dsh plugin --profile web add "github:SunNull/dsh-relay"

典型用法¶

生成認證憑據（用於配置中繼連接）:
* 生成幹線令牌（32位）：

    node -e "console.log(require('crypto').randomBytes(24).toString('hex'))"

• 生成配對碼（8位）：

    node -e "console.log(require('crypto').randomBytes(4).toString('hex'))"

安裝方式:
* 標準安裝（推薦用於啓用管理面板）：

    dsh plugin --profile web add "github:SunNull/dsh-relay"

• 使用安裝器（可自動配置）：

    node install.mjs --relay-url ws://<你的服務器IP>:8443/trunk --token <TOKEN>

工作原理¶

Wire-Trunk 架構:
* 家端: 作爲樹外插件，運行在 dsh 進程內部。它充當”隱形瀏覽器”，複用本地 127.0.0.1:3080 的 dsh 協議連接，並將請求原封不動轉發至雲端。
* 雲端: 純轉發面，負責將 HTTPS 請求中繼至家端。
* 安全性: 家端無需開放入站端口，請求以迴環身份進入；認證（配對碼）在雲端入口處理，天然穿透 NAT。

注意事項¶

• 環境要求: Node.js 版本需 >= 22。
• 配置文件: 插件使用 ~/.dsh/profiles/web/cordis.patch.yml 進行配置。
• 插件類型: 基於 host-plugin 開發，運行在 dsh 進程內部。
• 許可協議: MIT。

參考鏈接¶

• GitHub: https://github.com/SunNull/dsh-relay
• 插件目錄: https://www.skillhub.cn/plugins/SunNull/dsh-relay