Surfboard是一款iOS平台的网络代理客户端，支持Clash配置标准，由于App Store未上架该应用，需通过TestFlight或第三方渠道获取安装包，本文详细介绍两种配置文件导入方式,帮助用户快速完成跨境网络访问的客户端配置。
Surfboard获取与安装
Surfboard目前未在App Store上架,用户可通过以下途径获取：
- TestFlight测试版：关注官方社交媒体获取测试邀请链接
- 第三方分发：部分技术社区提供IPA文件下载，需使用AltStore或Sideloadly签名安装
安装完成后,打开应用会提示需要添加配置文件才能正常使用。
订阅链接导入（推荐方式）
1 操作步骤
- 复制服务商提供的订阅链接（通常为URL格式）
- 打开Surfboard应用，点击底部「配置」 tab
- 点击右上角「+」按钮，选择「从URL导入」
- 在弹窗中粘贴订阅链接，点击「确定」
- 等待配置下载完成，系统会自动解析YAML内容
2 订阅格式说明
主流订阅链接返回YAML格式配置,核心结构如下：
proxies:
- name: 节点名称
type: ss
server: 节点地址
port: 端口号
cipher: 加密方式
password: 密码
proxy-groups:
- name: 手动选择
type: select
proxies:
- 节点名称
rules:
- DOMAIN-SUFFIX,example.com,手动选择
- GEOIP,CN,DIRECT
- MATCH,手动选择
导入成功后，订阅内容会显示在配置列表中,点击即可启用。
手动配置文件导入
1 适用场景
- 自建节点需要自定义配置
- 需要导入多个独立配置文件
- 订阅链接更新频繁，希望使用本地固定配置
2 导入流程
- 将YAML配置文件保存至iCloud Drive或Files应用
- 在Surfboard中点击「从文件导入」
- 选择已保存的配置文件
- 确认配置内容无误后保存
3 配置结构要点
Surfboard完全兼容Clash配置格式,关键配置项包括：
| 配置项 | 说明 |
|---|---|
| proxies | 节点信息，支持SS、VMess、Trojan等协议 |
| proxy-groups | 代理组，select手动选择、url-test自动测速、fallback故障转移 |
| rules | 分流规则，DOMAIN匹配域名、IP-CIDR匹配IP段、GEOIP匹配国家/地区 |
配置验证与常见问题
1 验证配置生效
导入配置后，点击配置右侧开关启用，观察是否出现代理流量图标，若未生效,检查以下内容：
- 订阅链接是否过期或失效
- YAML格式是否存在语法错误
- 网络环境是否允许访问订阅服务器
2 常见问题处理
现象：导入配置后节点列表为空
原因：订阅链接返回内容非标准Clash YAML格式
解决方法：使用SubConverter工具转换订阅格式，或联系服务商获取正确链接
现象：部分节点无法连接
原因：节点服务器故障或本地网络对该节点优化不足
解决方法：在proxy-groups中切换至其他节点，或使用url-test自动选择低延迟节点
现象：开启代理后国内网站访问变慢
原因：分流规则未正确配置，导致国内流量走代理
解决方法：确保rules中包含GEOIP,CN,DIRECT规则，优先放行国内流量
配置更新建议
定期更新订阅可获取最新节点，建议设置每周自动更新，Surfboard支持在配置详情中点击「更新」按钮手动刷新，更新后如遇节点失效,删除旧配置重新导入即可。
对于有多地区访问需求的用户，可在proxy-groups中创建多个代理组，分别配置不同节点，实现游戏、4K视频、跨境办公等场景的精细化分流。
