前言¶
想在通勤路上用手機接着調家裏的 DSH,常見做法是內網穿透:要麼把流量交給第三方中繼,要麼在路由器和本機上裝隧道客戶端、加計劃任務。dsh-ipv6-gate 是 fzcohq 維護的一個 DSH 插件,換一條路走:國內家寬普遍已經分配公網 IPv6,插件直接用 IPv6 把 DSH 暴露出去,域名、證書、DDNS、認證全部在插件內部完成,數據不經第三方中繼。下面介紹它的能力、安裝與配置過程,以及適用前提。
這是什麼¶
一句話定位:把 DeepSeek Harness 通過家庭寬帶的 IPv6 直接暴露到公網的遠程訪問網關,零中繼、零費用、零系統配置。
| 項 | 值 |
|---|---|
| 插件名 | fzcohq/dsh-ipv6-gate |
| 維護者 | fzcohq |
| 分類 | 聯網工具 |
| 許可證 | MIT |
| package.json 版本 | 0.1.1 |
| Node 要求 | engines >=22.19.0 |
| 目錄頁 | https://www.skillhub.cn/plugins/fzcohq/dsh-ipv6-gate |
| 源碼 | https://github.com/fzcohq/dsh-ipv6-gate |
它解決的具體問題是:手機蜂窩網絡天然有 IPv6,家裏的電腦上也有公網 IPv6 地址;真正缺的是域名、證書和入口認證。插件把這三件事打包,裝一個插件、填一個 DuckDNS Token 就夠,不需要 Caddy / cloudflared 之類的外部二進制,也不需要計劃任務或註冊表之類的系統級配置。
核心功能¶
功能全部來自 README 的描述。
| 功能 | 說明 |
|---|---|
| HTTPS 遠程訪問 | Let’s Encrypt 證書自動簽發/續期(DNS-01 via DuckDNS) |
| DDNS | 檢測本機 IPv6 變化 → 自動更新 DNS AAAA 記錄(每小時) |
| 設置頁 UI | DSH 設置裏出現「手機 IPv6 遠程訪問」頁籤 |
| 二維碼掃碼 | 掃碼直達,密碼編入 URL,自動認證,不留瀏覽器歷史 |
| 雙通道 | HTTPS(8787,加密)+ HTTP(8788,明文,默認關),獨立密碼/開關 |
| 安全 | PIN 認證 + Cookie + 失敗鎖定 + IP 限速 |
反代層做 Host 改寫、PIN 認證和 WebSocket 透傳,掃碼入口通過 ?key= 自動認證,HTTP/2 ALPN 按協議分流。架構上不依賴任何外部進程:
┌─────────────────────────────────────────────┐
│ DSH 設置頁「手機 IPv6 遠程訪問」 │
│ ├─ IPv6 地址檢測(排除 Temporary 地址) │
│ ├─ HTTP 連接(端口 8788,默認關) │
│ ├─ DuckDNS 域名管理(子域名 + Token) │
│ └─ HTTPS 連接(端口 8787,TLS 證書自動管理) │
├─────────────────────────────────────────────┤
│ gate-manager(雙通道生命週期 + 持久化) │
├─────────────────────────────────────────────┤
│ 反代層:Host 改寫 + PIN 認證 + WS 透傳 │
│ + ?key= 掃碼自動認證 + HTTP/2 ALPN 分流 │
├─────────────────────────────────────────────┤
│ ACME DNS-01(DuckDNS API)+ 證書續期 │
│ DDNS 定時器(穩定地址 → AAAA 記錄,每小時) │
└─────────────────────────────────────────────┘
安裝與啓用¶
在終端執行,這是 README 給出的官方命令:
dsh plugin add github:fzcohq/dsh-ipv6-gate
如果用的是桌面版,安裝後設置頁沒有出現插件,換帶 profile 的命令:
dsh plugin --profile desktop add github:fzcohq/dsh-ipv6-gate
然後重啓桌面端。安裝後重啓 DSH,設置裏會出現「手機 IPv6 遠程訪問」頁籤。依賴要求 node >=22.19.0,可以先用 node -v 確認。
配置:三步¶
先註冊 DuckDNS 域名(免費)。打開 https://www.duckdns.org,用 GitHub 賬號登錄,輸入一個子域名(如 myhome)點 Add Domain,然後複製頁面右上角的 Token(36 位 UUID)。
回到 DSH 的設置頁配置。路徑是 DSH → 設置 → 「手機 IPv6 遠程訪問」;先確認 IPv6 地址檢測顯示綠色,再進入「域名區域」→「配置」,填子域名和 Token 保存,等待「正在配置域名…」完成,自動 DDNS + 證書籤發約 30 秒。
最後開啓 HTTPS。打開「HTTPS 連接」開關,展開面板,用手機掃描二維碼即可直達 DSH。若更喜歡手動輸入,訪問地址形如:
https://<子域名>.duckdns.org:8787
日常操作都在設置頁完成:
| 操作 | 方式 |
|---|---|
| 改密碼 | 設置頁 → 展開 HTTP/HTTPS → 「自定義」密碼,即時生效 |
| 關閉遠程訪問 | 設置頁關閉對應開關,端口停止監聽、外部不可達 |
| 臨時測試 | 開啓 HTTP 連接,明文,僅建議局域網調試 |
適用場景與注意¶
適合家裏寬帶已有公網 IPv6、手機有蜂窩 IPv6、並且願意自己註冊 DuckDNS 域名的用戶。前提條件如下:
| 條件 | 說明 |
|---|---|
| 電腦有公網 IPv6 | 國內電信/移動/聯通家寬普遍已分配,檢測見設置頁 |
| 手機有 IPv6 | 4G/5G 蜂窩默認支持;WiFi 需路由器開啓 IPv6 |
| 路由器防火牆 | 需允許入站 8787/8788 端口(多數家寬默認放行高位端口) |
幾點要注意。插件以當前 dsh 進程權限運行,它持有 DuckDNS Token、TLS 私鑰,並會監聽 8787/8788 端口,安裝前先讀一遍源碼和 MIT 許可證。HTTPS 走 DNS-01 簽發證書,域名和 Token 是必需輸入。HTTP 明文通道默認關閉,只在局域網調試時臨時打開。IPv6 地址變化由每小時一次的 DDNS 定時器兜底,不是實時切換。目前 GitHub 顯示 0 個星標,屬於較小項目,遇到問題可直接去倉庫提 issue。
結尾¶
這個插件的價值在於:在不引入中繼、不裝外部二進制的前提下,把 DSH 的遠程訪問壓到一個插件加一個免費域名。安裝、配置、驗證都走 DSH 設置頁,用完關掉開關端口即停止監聽。目錄頁與源碼分別在:
- https://www.skillhub.cn/plugins/fzcohq/dsh-ipv6-gate
- https://github.com/fzcohq/dsh-ipv6-gate