dsh-ipv6-gate:用家庭寬帶的公網 IPv6 遠程訪問 DeepSeek Harness

前言

想在通勤路上用手機接着調家裏的 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜