使用指南 / 進階技巧

外部控制介面:用 RESTful API 操控 Clash

進階技巧 · 2026-03-02 更新 · 約 2 分鐘

配置中的 external-controller: 127.0.0.1:9090 讓核心暴露一套 HTTP API——Clash for Windows 的介面本質上也是透過它工作的。你同樣可以用指令碼呼叫,實現自動化。

常用端點速覽

# 查詢所有策略組與節點
curl http://127.0.0.1:9090/proxies

# 把「節點選擇」組切換到「香港01」
curl -X PUT http://127.0.0.1:9090/proxies/節點選擇 ^
     -d "{\"name\": \"香港01\"}"

# 查詢實時流量(長連線,持續輸出)
curl http://127.0.0.1:9090/traffic

# 斷開全部連線
curl -X DELETE http://127.0.0.1:9090/connections

# 對某節點發起延遲測試
curl "http://127.0.0.1:9090/proxies/香港01/delay?timeout=3000&url=http://www.gstatic.com/generate_204"

安全提醒

如果把監聽地址改成 0.0.0.0:9090(例如想在手機上遠端控制),務必同時設定 secret 欄位作為訪問令牌,呼叫時帶 Authorization: Bearer <secret> 頭——否則區域網內任何人都能改你的代理。API 的完整能力可以配合第三方面板使用,見《External Controller 與第三方面板》。