本文详解Shadowrocket（俗称小火箭）的API配置方法，涵盖代理组类型选择、TUN模式与系统代理区别、分流规则写法及常见问题解决方案,帮助用户快速完成跨境网络访问客户端的优化配置。
基础配置步骤
1 获取订阅链接
首先需要从节点服务商获取Clash格式的订阅链接，复制链接后打开小火箭，点击右上角"+"号，选择"订阅"类型，将链接粘贴至URL输入框,系统会自动拉取节点信息并生成配置文件。
2 导入配置
导入成功后，在主界面可以看到节点列表和代理组信息，点击底部"配置"标签页，可查看完整的YAML配置文件内容，建议首次配置时仔细检查各项参数,确保符合自身网络环境需求。
代理组类型深度解析
1 select（手动选择）
proxy-groups:
- name: 手动选择节点
type: select
proxies:
- 节点A
- 节点B
- 节点C
适用于需要明确指定出口节点的用户场景，如特定业务需求或网络调试，系统不会自动切换,需手动选择目标节点。
2 url-test（自动测速）
proxy-groups:
- name: 自动测速
type: url-test
url: http://www.gstatic.com/generate_204
interval: 300
proxies:
- 节点A
- 节点B
根据预设URL进行延迟测试，每隔指定时间自动切换至延迟最低节点，适合日常网页浏览、视频播放等场景,能有效规避线路波动。
3 fallback（故障转移）
proxy-groups:
- name: 故障转移
type: fallback
url: http://www.gstatic.com/generate_204
interval: 300
proxies:
- 专线节点
- 中转节点
- 备用节点
按顺序检测节点可用性，当前节点不可用时自动切换至下一个，推荐用于对稳定性要求极高的业务场景,如跨境办公或视频会议。
TUN模式与系统代理的区别
1 系统代理模式
仅处理HTTP/HTTPS协议的流量，应用层代理，配置简单，兼容性较好，但无法处理UDP流量和部分不走系统代理的应用,适合普通网页浏览和HTTPS请求。
2 TUN模式
创建虚拟网卡，接管设备所有流量（包括UDP、游戏数据包），可实现全局代理效果，但会增加少量系统资源消耗，适用于需要跨境访问、玩外服游戏或使用UDP协议的应用场景。
配置建议：日常使用可选系统代理模式；有游戏或UDP需求时切换至TUN模式。
分流规则写法与优先级
1 规则类型
- DOMAIN：精确匹配域名
- DOMAIN-SUFFIX：域名后缀匹配
- DOMAIN-KEYWORD：域名关键词匹配
- IP-CIDR：IP段匹配
- GEOIP：国家/地区代码匹配
2 规则优先级
rules: # 直连规则（国内网站） - DOMAIN-SUFFIX,baidu.com,DIRECT - DOMAIN-SUFFIX,taobao.com,DIRECT - GEOIP,cn,DIRECT # 代理规则（国际网络加速） - DOMAIN-KEYWORD,google,自动选择 - DOMAIN-SUFFIX,youtube.com,自动选择 - IP-CIDR,8.8.8.8/32,自动选择 # 默认规则 - MATCH,自动选择
规则自上而下匹配，命中后即执行对应操作，建议将直连规则置于代理规则之前,减少不必要的代理转发。
常见问题FAQ
1 节点显示但无法连接
现象：节点列表正常显示,连接时提示超时或无法建立连接。
原因：订阅链接失效、节点服务器宕机或本地网络环境受限。
解决方法：重新获取最新订阅链接；尝试切换其他节点；检查本地网络是否对跨境访问有限制。
2 测速正常但无法打开网页
现象：代理组测速延迟正常,但浏览器无法加载页面。
原因：DNS污染、分流规则配置错误或TLS握手失败。
解决方法：在配置中添加DNS防污染规则；检查是否误将目标网站配置为直连；尝试更换TLS版本或启用TLS1.3。
3 TUN模式下部分应用无法联网
现象：开启TUN模式后,某些应用显示无网络连接。
原因：应用自带SSL证书校验或使用了非标准端口。
解决方法：将该应用添加至排除列表；或在系统代理模式下配合应用内置代理设置使用。
节点选择建议
不同使用场景对节点特性有差异化需求，建议根据实际用途选择：日常网页浏览可选中转节点，性价比适中；4K视频streaming需要高带宽专线；外服游戏则优先考虑低延迟线路；跨境办公场景推荐稳定性和安全性更高的企业级节点。
选择节点服务商时，重点关注其提供的线路类型、带宽容量、SLA保障及客户响应速度，避免仅看价格,稳定性才是跨境网络访问的核心需求。
通过以上配置指南，相信您已掌握小火箭API设置的核心要点，合理配置代理组类型和分流规则，可显著提升跨境网络访问的效率和稳定性，如需进一步优化,可根据实际使用体验调整测速间隔和故障转移策略。
