本文详解Clash RESTful API的启用方法与核心接口调用，涵盖代理组切换、规则查询及TUN模式控制，帮助开发者实现网络配置的自动化管理,提升跨境办公效率。
什么是Clash RESTful API
Clash RESTful API是内核暴露的HTTP控制接口，默认监听9090端口，通过标准化请求，开发者可编程管理代理节点、切换代理组、查询连接状态，无需手动修改YAML配置文件，掌握Clash RESTful API使用教程,能实现国际网络加速的自动化运维。
启用API服务的三个步骤
修改配置文件
在config.yaml顶部添加：
external-controller: 127.0.0.1:9090 secret: "your-password"
external-controller指定监听地址，secret设置鉴权密钥，生产环境建议绑定127.0.0.1避免未授权访问。
重启服务生效
保存配置后重启Clash内核，Windows用户可在日志查看"RESTful API listening at"确认启动状态。
测试连通性
使用curl验证：
curl http://127.0.0.1:9090/proxies -H "Authorization: Bearer your-password"
返回JSON即表示基础环境搭建完成。
核心接口与代理组控制
代理组类型差异
Clash支持三种核心代理组,API调用时需明确目标：
- select：手动选择节点，适合固定线路需求
- url-test：自动测速选优，延迟敏感场景首选
- fallback：故障自动转移，保障跨境办公稳定性
切换代理组示例
将"Proxy"组切换至指定节点：
curl -X PUT http://127.0.0.1:9090/proxies/Proxy \
-H "Content-Type: application/json" \
-d '{"name": "香港节点"}'
TUN模式与系统代理的API控制
通过/configs接口可动态调整流量接管模式：
TUN模式：接管全流量（含UDP、ICMP），适合游戏加速与复杂应用 系统代理：仅HTTP/HTTPS流量，浏览器场景轻量运行
切换TUN配置需重启内核,建议通过API查询当前模式后再决策：
curl http://127.0.0.1:9090/configs
分流规则优先级管理
API支持实时查询规则匹配情况,理解规则类型有助于调试学术资源访问策略：
- DOMAIN：精确匹配域名
- DOMAIN-SUFFIX：后缀匹配，覆盖子域名
- IP-CIDR：IP段匹配，优先级高于域名规则
- GEOIP：地理位置分流，适合区域限定内容
查询特定连接匹配规则：
curl http://127.0.0.1:9090/connections
常见问题排查
现象：API返回401 Unauthorized
原因：secret鉴权失败或请求头格式错误
解决：检查Authorization: Bearer前缀及密钥拼写，注意大小写敏感
现象：切换代理组后流量未变更 原因：目标组非select类型或节点名称含特殊字符 解决：确认代理组类型，URL编码中文节点名
现象：TUN模式开启后DNS解析异常
原因：系统DNS与Clash DNS劫持冲突
解决：API调用前关闭系统IPv6，或修改redir-port配置
自动化场景与订阅整合
对于需要频繁切换节点的用户，可编写脚本定时调用API测试延迟，自动选择最优线路，配合稳定的服务商提供的Clash YAML格式订阅,能实现无人值守的智能路由。
有国际网络加速需求的开发者，建议选择支持Clash订阅格式的服务商，确保API接口能完整读取节点元数据，优质订阅通常包含完整的规则集与代理组定义，减少手动配置成本，让Clash RESTful API使用教程中的自动化方案真正落地。
