外部控制介面:用 RESTful API 操控 Clash
配置中的 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 與第三方面板》。