Clash RESTful API提供了外部程序控制代理的能力，本文详解API启用方法、核心端点调用逻辑，以及结合脚本实现节点自动切换与流量监控的实战方案,适用于跨境办公自动化需求。
启用API服务与鉴权配置
Clash RESTful API默认关闭，需在配置文件中显式开启，编辑config.yaml,在顶部添加：
external-controller: 127.0.0.1:9090 secret: "your-password"
external-controller绑定监听地址，建议本地回环避免暴露。secret用于请求鉴权，留空则无需认证，重启内核后，访问http://127.0.0.1:9090验证服务状态，本Clash RESTful API使用教程基于Meta内核版本,部分端点与Premium版本存在差异。
核心端点与代理组控制逻辑
Clash RESTful API采用标准HTTP协议，所有响应均为JSON格式,掌握以下三个端点即可实现基础自动化：
获取代理组状态
GET /proxies返回所有代理组与节点信息，重点关注Selector类型组，其now字段显示当前选中节点。
切换节点
PUT /proxies/{group-name}请求体指定目标节点：
{"name": "节点名称"}
延迟测试
GET /proxies/{group-name}/delay?url=http://www.gstatic.com/generate_204&timeout=5000此接口配合url-test类型组实现自动选优。
代理组类型差异与适用场景
配置文件中proxy-groups定义三种核心类型：
- select：手动选择，适合固定线路需求，API切换后保持直至下次调用
- url-test：定时测速自动切换，适合多节点负载均衡，API手动切换可能被自动覆盖
- fallback：按顺序选择首个可用节点，故障时自动转移，适合国际网络加速的稳定性优先场景
实战：自动化脚本与模式切换
结合Python示例演示Clash RESTful API调用逻辑：
import requests
def switch_node(group, node, secret):
url = f"http://127.0.0.1:9090/proxies/{group}"
headers = {"Authorization": f"Bearer {secret}"}
requests.put(url, json={"name": node}, headers=headers)
def get_traffic():
return requests.get("http://127.0.0.1:9090/traffic").json()
TUN模式与系统代理的区别
通过API切换模式前需明确流量接管范围：
- 系统代理：仅接管HTTP/HTTPS流量，浏览器和应用需显式设置代理端口，轻量但覆盖不全
- TUN模式：虚拟网卡接管所有流量（含UDP、游戏、ICMP），实现全局透明代理，适合需要完整国际网络加速的环境
API中/configs端点可动态切换TUN状态,无需重启内核。
分流规则优先级配置
配置rules时,Clash按顺序匹配：
rules: - DOMAIN,google.com,Proxy - DOMAIN-SUFFIX,cn,DIRECT - IP-CIDR,192.168.0.0/16,DIRECT - GEOIP,CN,DIRECT - MATCH,Proxy
优先级：DOMAIN > DOMAIN-SUFFIX > IP-CIDR > GEOIP > MATCH，建议将精确规则置前，避免被宽泛规则拦截,学术资源访问等特定需求建议单独定义DOMAIN规则。
常见问题排查
现象：API返回401 Unauthorized
原因：未携带secret或鉴权头格式错误。
解决：请求头添加Authorization: Bearer your-password,或检查配置文件secret字段。
现象：切换节点后流量未变更 原因：应用缓存了旧连接，或代理组类型为url-test/fallback被自动覆盖。 解决：先切换至select类型组，或调整url-test的interval参数。
现象：TUN模式开启后特定应用断连
原因：该应用使用UDP或特殊协议，被TUN网卡拦截但规则未正确处理。
解决：检查rules中是否包含PROCESS-NAME或DST-PORT规则,必要时添加绕过条目。
对于需要稳定跨境办公的用户，建议搭配支持Clash订阅格式的服务商，通过API动态切换优质线路节点，选择节点时关注延迟测试数据与带宽稳定性，避免频繁手动切换影响工作效率，通过本Clash RESTful API使用教程配置完成后，可实现基于网络质量监控的自动故障转移,大幅提升国际网络加速体验。
