Clash RESTful API为开发者提供了程序化控制代理规则的能力，本文详解外部控制器配置、核心接口调用方法及自动化脚本实现，助你构建智能分流系统，提升跨境办公效率。
配置步骤详解
启用外部控制器
Clash RESTful API默认关闭，需手动开启，编辑配置文件config.yaml，添加以下字段：
external-controller: 127.0.0.1:9090 secret: "your-password-here"
建议绑定本地回环地址避免未授权访问,配置完成后重启内核，访问http://127.0.0.1:9090验证服务状态。
理解代理组类型与API控制
通过API切换节点前,需明确代理组工作逻辑，Clash支持三种核心类型：
- select：手动选择固定节点，适合需要指定出口IP的学术资源访问场景
- url-test：定时测速自动选优，适合日常国际网络加速
- fallback：按配置顺序故障转移，主节点失效时自动切换，保障跨境办公连续性
获取当前代理状态：
curl http://127.0.0.1:9090/proxies \ -H "Authorization: Bearer your-password-here"
编写自动化切换脚本
切换指定节点：
curl -X PUT http://127.0.0.1:9090/proxies/代理组名 \
-H "Content-Type: application/json" \
-d '{"name": "目标节点名"}'
动态更新规则：
curl -X PATCH http://127.0.0.1:9090/configs \
-d '{"path": "/path/to/new_config.yaml"}'
TUN模式与系统代理的技术差异
通过API切换代理模式时,需理解流量接管机制，系统代理仅处理HTTP/HTTPS请求，依赖应用识别系统代理设置；TUN模式创建虚拟网卡接管全流量，支持UDP转发与游戏加速。
配置TUN需确保管理员权限,并在配置文件中启用：
tun:
enable: true
stack: system
dns-hijack:
- 8.8.8.8:53
分流规则优先级与写法
精细化分流依赖规则匹配逻辑,Clash按配置顺序自上而下匹配，命中即停止：
rules: - DOMAIN,internal.company.com,DIRECT - DOMAIN-SUFFIX,google.com,Proxy - IP-CIDR,192.168.0.0/16,DIRECT - GEOIP,CN,DIRECT - MATCH,Proxy
- DOMAIN：精确匹配单域名
- DOMAIN-SUFFIX：匹配主域及所有子域
- IP-CIDR：针对网段规则，适合CDN IP段分流
- GEOIP：基于地理位置数据库，需定期更新GeoIP文件
规则越精确应越靠前,避免被宽泛规则拦截。
常见问题排查
现象：API返回401 Unauthorized
原因：Secret验证失败或未携带Authorization请求头
解决：检查请求头格式为Authorization: Bearer your-password-here，注意Bearer后保留空格
现象：调用接口切换节点后，已建立连接仍走旧线路
原因：Clash默认保持现有TCP连接，仅新连接走新节点
解决：先调用DELETE /connections清空活动连接，再切换节点
现象：TUN模式开启后无法访问局域网设备
原因：TUN网卡接管了所有路由，包括局域网网段
解决：在TUN配置中添加inet-route-exclude或调整系统路由表，确保192.168.x.x走物理网卡
自动化工作流建议
对于需要稳定国际网络加速的用户,建议搭配支持API的高质量节点订阅服务，通过定时脚本调用Clash RESTful API检测节点延迟，自动切换至最优线路，实现故障自愈。
选择节点服务商时,确认其提供Clash原生YAML格式订阅，避免频繁使用SubConverter转换导致配置延迟，建议将订阅更新与API规则重载结合，构建完整的智能代理工作流。
掌握Clash RESTful API的核心接口与配置逻辑，可将静态代理转化为动态可编程系统，通过外部控制器实现自动化管理，显著提升跨境办公场景下的网络稳定性与使用体验。
