Clash API自动切换节点：external-controller进阶配置指南

# 仅允许本机访问，适合桌面端脚本
external-controller: 127.0.0.1:9090

# API 认证密钥，生产环境不要留空
secret: replace-with-a-long-random-secret

# 如需局域网管理，可改为 0.0.0.0，但必须配合防火墙
# external-controller: 0.0.0.0:9090

# 使用 curl 查询策略组
curl -s \
  -H "Authorization: Bearer ${CLASH_SECRET}" \
  "http://127.0.0.1:9090/proxies/$(python3 -c 'import urllib.parse; print(urllib.parse.quote("自动选择"))')"

# 节点名称为“节点-HK-01”时，先进行 URL 编码
curl -s \
  -H "Authorization: Bearer ${CLASH_SECRET}" \
  "http://127.0.0.1:9090/proxies/%E8%8A%82%E7%82%B9-HK-01/delay?url=https%3A%2F%2Fwww.gstatic.com%2Fgenerate_204&timeout=5000"

# 将“自动选择”切换到“节点-JP-01”
curl -X PUT \
  -H "Authorization: Bearer ${CLASH_SECRET}" \
  -H "Content-Type: application/json" \
  -d '{"name":"节点-JP-01"}' \
  "http://127.0.0.1:9090/proxies/%E8%87%AA%E5%8A%A8%E9%80%89%E6%8B%A9"

import json
import os
import time
import urllib.parse
import urllib.request
import urllib.error

API = os.getenv("CLASH_API", "http://127.0.0.1:9090")
SECRET = os.environ["CLASH_SECRET"]
GROUP = "自动选择"
TEST_URL = "https://www.gstatic.com/generate_204"
TIMEOUT = 5000
FAIL_LIMIT = 2

headers = {
    "Authorization": "Bearer " + SECRET,
    "Content-Type": "application/json",
}

def request(path, method="GET", data=None):
    body = None if data is None else json.dumps(data).encode("utf-8")
    req = urllib.request.Request(
        API + path, headers=headers, method=method, data=body
    )
    with urllib.request.urlopen(req, timeout=8) as response:
        return json.loads(response.read().decode("utf-8"))

def quote(value):
    return urllib.parse.quote(value, safe="")

def test_proxy(proxy):
    path = "/proxies/" + quote(proxy) + "/delay?url=" + quote(TEST_URL)
    path += "&timeout=" + str(TIMEOUT)
    try:
        result = request(path)
        return int(result.get("delay", 0))
    except (urllib.error.URLError, ValueError, TimeoutError):
        return None

def switch_to(proxy):
    request("/proxies/" + quote(GROUP), "PUT", {"name": proxy})
    print("switched to:", proxy)

def main():
    group = request("/proxies/" + quote(GROUP))
    current = group.get("now")
    candidates = group.get("all", [])
    failures = 0

    while True:
        delay = test_proxy(current)
        if delay is None:
            failures += 1
            print("unavailable:", current, "failure:", failures)
        else:
            failures = 0
            print("healthy:", current, "delay:", delay, "ms")

        if failures >= FAIL_LIMIT:
            for candidate in candidates:
                if candidate == current:
                    continue
                candidate_delay = test_proxy(candidate)
                if candidate_delay is not None:
                    switch_to(candidate)
                    current = candidate
                    failures = 0
                    break

        time.sleep(60)

if __name__ == "__main__":
    main()

# Linux/macOS
export CLASH_API="http://127.0.0.1:9090"
export CLASH_SECRET="replace-with-your-secret"
python3 auto_switch.py

# Windows PowerShell
$env:CLASH_API = "http://127.0.0.1:9090"
$env:CLASH_SECRET = "replace-with-your-secret"
python .\auto_switch.py