為什麼「控制面」寧可鎖在本機

許多使用者在 Clash Verge Rev 裡把訂閱與規則都跑順了,下一步會想開啟儀表板看連線、切節點,或用腳本呼叫 RESTful API 做自動化。與「代理連線埠」不同的是,external-controller 暴露出去等於把整個核心的管理介面交給能連上那一埠的人:讀組態、看連線、部份情境還可能改策略。若監聽在 0.0.0.0、或綁在區網位址又沒有防火牆與夠強的 Secret,同一路由器下的裝置、甚至誤開到對外的介面時,風險會被動放大。

也因此,實務上最常見、也最穩的預設心智模型是:控制 API 只服務本機迴環 127.0.0.1;需要遠端管理時,再改用 SSH 轉送、專用反向通道或企業級零信任方案,而不是直接把 9090 丟在區網廣播。本篇不談 TUN/DNS 大套裝,只把 external-controller、secret、bind-address(若你的組態層有)與驗收步驟對齊。

安全提醒:當控制面可走區網或外網,攻擊面不只有「猜到 Secret」;也包括組態洩漏、CSRF/惡意網頁在內網環境下的連帶風險。把監聽壓在 127.0.0.1 是最單純、也最容易審計的防線。

external-controller、Secret、Web 面板各自在做什麼

Clash Verge Rev 底層使用 Mihomo(Clash Meta)核心時,會在執行中的 YAML 組態裡看到類似鍵名:external-controller 描述「HTTP 控制 API 要開在哪個位址與連接埠」,而 secret 則是呼叫多數受保護端點時要帶的授權權杖(實作細節隨版本演進,仍以你正在跑的發行說明為準)。有些組態還會看到 external-ui 指向內嵌儀表板的靜態檔案路徑;不論面板是內建或外掛,實際和核心對話的仍是 RESTful API,因此「鎖控制埠」等同保護面板背後的那條管線。

bind-address 則與「整個程式或 mixin 層監聽的介面」有關:不同版本與前端包裝可能把它藏在進階設定或覆寫檔裡,但語意上仍要把握一句話——只監聽本機就選會落在 loopback 的設定;想讓「區網其他裝置」連進來,就等於自願把管制面往外推一層,必須配套更嚴格的策略。

127.0.0.1、區網 IP 與 0.0.0.0:怎麼選才不踩雷

用最直觀的方式理解:127.0.0.1 代表「只有這台機器自己」;把手機拿去連你電腦的 192.168.x.x:9090,本來就不該成功,這正是我們多數情境想要的結果。相對的,0.0.0.0 常被解讀為「所有介面都聽」,在多網路卡的筆電、同時開熱點或虛擬交換器時,很容易出現你以為「只在本機」其實別台裝置也摸得到的情況。

如果你在找「區網其他裝置能不能共用這顆核心」這種題目,本質上已經跨到「把代理服務暴露給 LAN」而不是單純開面板;這時候該優先閱讀防火牆、Windows 進階安全性、mixin 連接埠與帳號隔離,而不是只改一行 external-controller。底下流程預設你要的是僅本機管理。

連接埠數字不是安全邊界,連接埠換成冷門數字也不等於安全。對本機使用者來說,有意義的是「綁定介面 + Secret + 作業系統防火牆」三件套一起對齊。

在 Clash Verge Rev 裡落地設定的務實順序

不同版本的 Verge 介面用詞可能略有出入,但你可以用下列順序對照,並在每次修改後執行「重載/重啟核心」避免舊監聽行程殘留。

  1. 先查「現在到底聽在哪裡」
    打開設定或進階設定中與 Clash/Mihomo 核心相關的分頁,找到對應 external-controller 的編輯入口。預設常見寫法是 127.0.0.1:9090;若你看到的是 :9090、或前面掛了區網 IP,就要提高警覺。
  2. 把監聽改回「本機迴環 + 固定埠」
    將欄位調整為 127.0.0.1:9090(或你刻意指定的本機埠)。若介面分開詢問位址與埠,兩邊要一致,避免只改一半造成實際 YAML 仍然是舊值。
  3. 同步檢查 bind-address(若有)
    若同一層選單或覆寫檔案提供 bind-address,請確認語意是不是被設成「所有介面」。在本機管理場景下,應讓它與「只屬於本機的控制流量」一致,而不是順手沿用代理 mixed-port 的邏輯。
  4. 為 Secret 準備一段長隨機密碼
    用密碼管理員或可靠的隨機產生器,產生足夠長度的字串寫入 secret。請避免沿用測試用的 123456 或與訂閱網址相同的片段;這些在實務上等同沒設。
  5. 存檔、重載後再回到 UI 確認
    Verge 有時會在覆寫層與訂閱產生的最終檔之間做合併,若重載後 UI 顯示的值與預期不同,請用「檢視目前生效組態」的功能核對最終欄位,而不是只看訂閱模板。

在 YAML 裡你可以對照哪些鍵

當你需要跨機器備份、或要與別人討論「你到底開了哪個洞」時,直接看生效中的 YAML 最不容易雞同鴨講。下列片段僅為結構示意,實際欄位請以你的核心版本為準:

# Illustrative snippet — align with your Mihomo/Clash version
external-controller: 127.0.0.1:9090
secret: "replace-with-a-long-random-token"
# external-ui: "./ui"   # if your build ships a dashboard path

若你發現自己的檔案長期停留在「沒有 secret」或 external-controller 前面掛了公網或 0.0.0.0,把它視為高優先修正項,而不是「之後有空再看」。這類設定通常與訂閱無關,卻能一筆改動就縮小掃描面。

驗收:本機應該通、區網應該不通

改完後別只盯著儀表板能不能開,建議用兩層驗證:第一層在本機瀏覽器開 http://127.0.0.1:9090/(實際路徑依你的儀表板掛載方式而定),或在終端機用 curl 對 /version 類端點做探測,並帶上正確的授權標頭或查詢參數(依核心文件);第二層換到同區網的手機,對你電腦的區網 IP 進行同埠連線測試,應該要無法建立連線或一直被拒絕,才符合「只給本機」的預期。

若第二層竟然連得上,回頭依序查:Windows/macOS 防火牆是否放行、是否還有另一份 mixin 覆寫把位址打開、是否有第二個核心行程用舊組態佔著埠、或是否把儀表板架在反向代理後面卻對外監聽。這些都是我們在論壇與 issue 裡常見的「以為很本機、其實還有一條路」案例。

你也可以在 Verge 的連線或日誌檢視裡觀察管理埠是否有「非預期的遠端來源」;若長期為空,通常表示控制流量只留在本機。此作法不能取代防火牆,但能當作輔助心證。

RESTful API、外部儀表板與 Secret 的協作方式

一些進階玩家會用第三方儀表板專案,透過瀏覽器圖表化呈現連線;這些專案大多假設你能安全地觸及 external-controller。當你把控制器壓在 127.0.0.1 時,瀏覽器與儀表板仍然可以與核心溝通,因為它們跑在同一台桌面環境;但若你想「用手機在區網直接看」,就等於要求把 API 暴露到 LAN——這時請先停下來評估是不是改用 VPN 回家、或 SSH 轉送,而不是直接把 Secret 丟在區網 HTTP 裡。

總結一句話:Secret 解決的是「誰能呼叫 API」;綁定 127.0.0.1 解決的是「誰根本碰不到那一條管線」。兩個都要,才足以對應多數桌面使用者的威脅模型。

常見問題

external-controller 一定要綁 127.0.0.1 嗎?

若你的需求僅是「這台 PC/Mac 自己開面板」,那是最安全的預設值。只有在你明確知道要給區網裝置管理、並願意處理對應風險時,才考慮綁 LAN IP;即便如此也應有強 Secret、限定來源 IP,並盡量走 HTTPS 終端與憑證。

Secret 可以留空嗎?

不建議。留空等於把「是否安全」完全押在網路隔離上;一旦監聽面因設定誤觸而變寬,就沒有第二層煞車。維護上也不利於稽核,因為你無法從組態看出誰應該有管理權限。

為什麼我改成 127.0.0.1 後,區網裝置反而不能走我電腦的代理?

因為那是兩條完全不同的管線:代理連線埠(mixed-port 等)若要給區網用,本來就要另外評估監聽位址與防火牆;控制埠不應該順手扮演這個角色。若你在找「手機同一 Wi‑Fi 用電腦 Clash」,請改讀專門講區網代理與防火牆放行的教學,而不是把 external-controller 打開。

相較之下,部分同類工具會把「代理服務」與「管理後台」的邊界模糊掉,介面上一步到位卻讓使用者看不清哪個連接埠該對區網開放;一旦依照社群片段教學把 listen 位址改大,就很難察覺自己其實把組態介面一起送了出去。Clash/Mihomo 家族在模型上把路由核心與 REST 控制面分開描述,讓你能先決定「資料面的連接埠策略」,再獨立審核「控制面是否只留在 127.0.0.1」,搭配 secret 後,對常見的桌面使用情境更直覺,也比較容易在換機或備份 YAML 時維持一致邊界。

如果你希望先把用戶端來源統一,再回頭依本文收緊 external-controller 與 secret,可到本站用戶端下載頁取得目前平台的構建與更新節奏說明。

→ 立即免費下載 Clash,開啟更清楚分流與安全邊界

前往本站下載頁取得用戶端