1 · 准备客户端
已有 Shadowrocket 可直接继续，不需要另购 App；免费 sing-box MT 为本地文件备用路线。新安装只使用官方 App Store。
选择客户端下载如何选择架构／安装打不开？
iPhone 无需选择 APK、DMG 或 CPU 架构；在 App Store 确认应用名称、开发者和系统要求。不使用共享 Apple ID 或第三方 IPA。
下载页链接项目官方固定版本；按系统与架构选择，安装和导入结果以本人设备确认为准。
ROUTELUMA / SETUP
iPhone 连接教程
已有 Shadowrocket 2.2.92；免费 sing-box MT 为备用。三步：准备客户端 → 导入订阅 → 连接并验证。
导入后在客户端连接，再核对实际出口；网页当前无法确认本机连接。
2 · 导入订阅
先核对 Shadowrocket 的 VPN 状态；连接页选择 iPhone 并建立设备，点击一键导入 Shadowrocket，在 App 确认新增独立 RouteLuma 订阅。电脑操作时可显示本地二维码，从本人 Shadowrocket 内扫码；不要覆盖原节点。
取得私密订阅或更新配置订阅未就绪或需要手动导入
订阅入口未配置时，连接页会禁用订阅地址、二维码和远程导入；先使用本地文件退路。私密地址和二维码只交给本人客户端，不用浏览器打开、不转发；轮换后旧地址失效。
一键导入未打开或解析失败时，复制私密订阅地址，在 Shadowrocket 的订阅入口粘贴并保存。官方 sing-box iOS 可在连接页选择远程配置后点击导入；默认每 60 分钟尝试更新，后台刷新受 iOS 限制。网页的添加请求不等于完成导入、系统授权或连接。
没有 App 或导入失败
没有 App 时先选择官方商店候选。浏览器拒绝复制时，在连接页下载私有节点文本；先将 Safari 下载位置设为‘我的 iPhone’，在本人手机打开文本并复制整行，再让 Shadowrocket 识别。不能识别时联系支持，不把凭据送到第三方转换站。添加请求可能受客户端版本影响，手动打开 App 是退路。
一次性节点／免费备用客户端的本地 JSON
连接页的本地文件退路保留“复制并打开 Shadowrocket”；在 App 内允许粘贴并确认新增。节点文本与本地文件不自动更新。免费 sing-box MT 的 iPhone VPN JSON 保存到“我的 iPhone”，通过 Profiles → New Profile → Import from File 新建独立配置；实际应用/Core 版本和导入仍须核验。
3 · 连接并验证
确认本次新独立条目 RouteLuma 和客户端 VPN 状态，再按系统提示处理连接权限并核对实际出口。App 可能依据自己的设置连接；添加或绿色图标不能替代验证。
如何更新／换机或轮换后怎么办？
更新方式随 Shadowrocket 版本与设置变化；需要更新时，点击首页该订阅组的刷新图标。后台定时更新尚未验收。节点文本与本地 JSON 不自动更新；凭据轮换后重新导入地址或配置。
换机使用新设备凭据；服务到期、到额或撤销后，刷新可能被拒绝。无法确认时先核对服务状态，不反复新建设备。
安装与验证状态（支持核验）
Shadowrocket 2.2.92(3445) 的扫码、URL、一键导入和手动订阅更新已核验；后台定时更新、新版订阅的实际联网和其他客户端仍待实机验收。
真实出口、自动更新、断线、撤销及 DNS、UDP、IPv6 范围须在获授权的独立测试环境核验；终端、IDE、WSL 与容器不推断支持。
连接范围与隐私说明（支持核验）
Shadowrocket 节点导入只填写协议字段，不改变路由、DNS、UDP 或 IPv6 策略。支持需在授权的独立测试环境核对代理 DNS、UDP 无直连回退和 IPv6 拒绝，并分别记录 Wi-Fi、蜂窝、重连、到额与撤销。无法确认隔离时停止，不能把 TCP 节点当作全流量通过证明。
复制内容含设备专属凭据；通用剪贴板可能同步到同 Apple ID 的设备。导入后返回连接页清空剪贴板；不贴聊天、工单、云盘或第三方网页。记录 iOS、应用版本、导入提示与日志脱敏，不上传配置或凭据截图。
sing-box MT 备用路线的受控验收
其独立 JSON 捕获 IPv4/IPv6 默认路由，IPv4 TCP 与 DNS 通过 Reality，其余 UDP、ICMP 与 IPv6 拒绝。仅在获授权的隔离测试设备记录 Packet Tunnel 的 includeAllNetworks／exclude 设置和 Profile Override 的隐藏图标／排除路由设置，不推断现有全局设置；iOS 必需系统流量可能被排除，配置语法核验不等于真机全流量断网开关。
连不上或验证失败
核对服务有效期、额度和客户端选中的配置。订阅换代后在客户端刷新；一次性文件不会自动更新。凭据轮换后回到连接页重新导入。拒绝权限或导入错误时先停止；错误截图和工单不要包含私密地址、二维码或配置文件。