FoxRay 是 iOS 上少数把 sing-box 能力暴露得比较多的客户端。它能导入 Clash、sing-box、V2Ray base64 等常见订阅格式，也能处理 ss://、vless://、trojan://、vmess:// 这类单节点链接。
不建议把它当成第一个代理客户端来学。FoxRay 的优势在订阅管理、路由策略和协议链，界面里的概念比「扫码、选节点、打开开关」多一些。
FoxRay 适合谁，不适合谁？
| 你现在的情况 | FoxRay 是否合适 | 看哪里 |
|---|---|---|
| 已经有 sing-box / Clash / V2Ray 订阅 | 合适 | 先导入订阅，再看日志 |
| 想在 iPhone 上测试协议链 | 合适 | 读协议链一节 |
| 只想免费、简单、少配置 | 不一定 | 先比较 Streisand / Karing |
| 订阅导入后节点为空 | 合适排查 | 看订阅格式和返回内容 |
| 完全不想碰配置名词 | 不太合适 | 换更简单的客户端 |
FoxRay 的定位是「免费但偏进阶」的 sing-box 图形界面。新手也能用，但遇到订阅格式错误、路由规则冲突时，容易找不到该看哪里。
FoxRay 和 Karing、Streisand 差在哪？
| 客户端 | 内核 | 上手难度 | 协议链入口 | 跨平台 |
|---|---|---|---|---|
| FoxRay | sing-box | 中等 | 明显 | iOS / macOS |
| Karing | sing-box | 较低 | 不作为主卖点 | iOS / macOS / Windows / Android |
| Streisand | sing-box | 较低 | 不作为主卖点 | iOS / macOS |
| SFI | sing-box 官方客户端 | 中等 | 偏原生配置 | iOS |
默认建议是：跨设备同步先看 Karing，iPhone 上轻量使用先看 Streisand，想研究 sing-box 细项再看 FoxRay。
FoxRay 的强项是把复杂能力放到界面里。代价也很直接：你会看到更多配置入口，排错时要分清订阅、出站、路由和 DNS 分别出了什么问题。
iPhone 上怎么下载安装 FoxRay？
- 准备美区或港区 Apple ID。
- 打开 App Store，搜索
FoxRay。 - 比对开发者和 App 图标，避免下载同名仿冒应用。
- 点击获取，安装完成后先不要急着开关。
- 第一次启动时，等导入配置后再授权 VPN 权限。
macOS Apple Silicon 设备可以在 Mac App Store 用同账号下载 iOS 版应用。Intel Mac 是否可用，以 App Store 当前页面显示为准。
第一次导入订阅怎么做？
在 FoxRay 里先走 URL 导入，不要一开始就手搓 JSON。
- 打开 FoxRay 主界面。
- 进入配置或订阅管理页面。
- 点击添加，选择从 URL 导入。
- 粘贴订阅链接。
- 保存后刷新一次订阅。
- 回到节点列表，确认节点名称、地区和延迟是否出现。
常见格式里，Clash / Mihomo YAML、sing-box JSON、V2Ray base64 都可能被服务商称为「订阅」。如果导入失败，在服务商后台切换导出格式，不要连续改 FoxRay 里的 DNS 和路由规则。
如果你的订阅链接经常返回登录页、过期页或空内容，即使 FoxRay 本身没问题，也会表现为节点为空。用于 iPhone、Mac 和其他客户端共用时，可以准备一份兼容 Clash / Singbox / V2Ray 的订阅，避免每个客户端都要单独转换格式。
导入后怎么确认已经可用？
不要只看开关是否变绿。FoxRay 至少要检查 4 个信号：
| 检查项 | 正常表现 | 异常时先查 |
|---|---|---|
| 订阅刷新 | 节点列表有内容 | 链接是否过期、是否返回登录页 |
| 节点延迟 | 能测出延迟或失败原因 | 节点协议、端口、TLS 字段 |
| VPN 权限 | iOS 顶部出现 VPN 标识 | 系统 VPN 权限是否被拒绝 |
| 网页访问 | Safari 能打开目标网站 | DNS、路由规则、节点可用性 |
最小验证路径是：刷新订阅 → 手动选 1 个节点 → 打开开关 → Safari 访问一个你平时使用的海外服务 → 回到 FoxRay 看日志。
协议链到底怎么用？
FoxRay 把 sing-box 的协议链能力做进了界面。它可以把多个出站串成一条链：
client → VPS-A Shadowsocks → VPS-B VLESS Reality → 目标网站这个功能不是日常必开项。它更适合两类人：一类是想测试不同出口组合的用户，另一类是要把现有节点按顺序串起来做实验的人。
配置时不要一次串 3 跳以上，确认单个节点都能正常连，再建立 2 跳链路；如果 2 跳都不通，继续加节点只会让日志更难读。
FoxRay 常见报错先看哪里？
| 表现 | 更可能原因 | 处理顺序 |
|---|---|---|
| 导入成功但节点为空 | 订阅返回内容不是有效配置 | 浏览器打开订阅链接，确认不是登录页 |
| 节点全部超时 | 节点不可用或协议字段不匹配 | 换单个节点测试，再看日志 |
| 打开开关后网页打不开 | DNS 或路由规则冲突 | 临时切回默认规则，保留一个节点测试 |
| 协议链不通 | 第一跳到第二跳不可达 | 分别测试两跳，再建链 |
| App 后台回来后断开 | iOS 后台策略或 VPN 状态变化 | 回到 FoxRay 重连，并检查系统 VPN 页面 |
日志里优先看 outbound、route、dns 相关行。不要看到红字就同时改订阅、DNS、规则和节点；一次只改一个变量，改完马上复测。
什么时候该换客户端？
如果你只是想在 iPhone 上导入一条订阅，FoxRay 不是唯一选择。遇到下面几种情况，可以直接换客户端对照：
- FoxRay 导入失败，但 Karing 能导入同一条订阅。
- FoxRay 里规则太多，看不懂哪条生效。
- 你还需要 Windows 或 Android 同步同一套配置。
- 你不使用协议链，也不打算调 sing-box 细项。
反过来，如果你想看到更细的 sing-box 行为、愿意读日志、愿意比较 Clash / V2Ray / sing-box 订阅差异，FoxRay 就值得保留。