Shadowrocket 配置备份与换机迁移:iCloud 同步、导出配置文件、新设备恢复

备份范围：Config 文件不等于全部应用数据

Shadowrocket（小火箭）的迁移不能只看“文件是否复制成功”。Home 中的服务器和订阅、Config 中的配置文件、Settings 中的应用设置属于不同检查对象。导出一份规则配置，不应直接视为已经保存全部订阅地址、服务器凭据和系统 VPN 授权。

日常使用的配置文件可在 Config 中查看和管理。文件由应用管理，不要假定它一定出现在“文件”App 的某个固定文件夹中。通过分享面板选择“存储到‘文件’”后，才会在所选的 iCloud Drive 或本地目录得到一份独立副本；这个副本与应用内正在使用的文件不是同一个编辑位置。

迁移前，记录当前选中的 Config 文件名、Home 中的订阅分组、所选服务器以及 Global Routing 的状态。若使用自建规则或手动填写的服务器，分别保存原始文本和必要参数；记录中含有密码、私钥或 token 时，应按凭据保护，不能放进公开笔记或公开分享链接。

迁移顺序：先留副本，再处理同步

iCloud 同步便于设备间保持数据一致，但同步不是历史归档。修改或删除也可能传到其他设备，因此第一次换机前应另存一份带日期的手动副本。不要同时在新旧设备上整理、重命名和删除配置，否则很难判断哪一份才是准备迁移的内容。

1. 在旧设备打开 Home 和 Config，确认当前服务与规则仍能正常使用；如果旧设备本身已有故障，先记录故障现象，避免将它误判为迁移失败。
2. 保存正在使用的配置文件，另行保管已有订阅的原始地址及手动服务器参数。对远程规则文件，也记录其来源，防止恢复后无法重新取得。
3. 完成手动导出后再核对 iCloud；新设备先接收数据，不立即改写同名配置。
4. 在新设备逐项验证订阅、规则、连接和自动连接条件，确认后再决定是否清理旧设备。

iCloud 同步：核对账号、系统权限与应用开关

使用 iCloud 迁移的前提，是两台设备使用同一用于 iCloud 的 Apple 账户，并允许相关云端数据访问。App Store 的购买账号与 iCloud 同步账号承担不同职责：能重新获取已购应用，并不能证明正在读取同一份 iCloud 数据。

1. 在两台设备的系统“设置”中打开账户页，进入 iCloud，确认登录账户一致，并检查 iCloud Drive 是否可用。系统界面的具体分组名称随系统版本变化。
2. 在 iCloud 的应用列表中检查 Shadowrocket 的访问权限；若列表默认只显示部分应用，展开完整列表再查找。不要通过反复退出账户来尝试触发同步。
3. 打开 Shadowrocket → Settings，检查当前界面提供的 iCloud 同步选项及开关说明。以设备实际显示的项目为准，不将应用同步与整机 iCloud 备份当作同一个开关。
4. 让旧设备联网并打开应用，再在新设备查看 Config 和 Home。对照文件名、规则内容及订阅分组，确认实际到达的数据范围，而不是只看开关处于开启状态。

如果新设备暂时没有显示数据，按账号、系统权限、应用开关、可用存储空间和网络连接的顺序排查。不要承诺固定等待时间；是否完成应以新设备上能打开并核对实际内容为判断依据。旧设备数据完整时，可以继续采用手动导入，不必为了等待同步而删除原有配置。

手动导出：保存 Config 文件并检查敏感字段

手动导出适合保留迁移前快照，也适合只迁移一份已经整理好的规则。操作时先确定当前正在使用的文件，再打开该文件的操作菜单；文件行的长按菜单、编辑页或分享入口是否提供相应操作，以当前界面为准。应导出文件本身，而不只是复制文件名或远程地址。

1. 进入 Config，找到当前使用的配置文件，打开其文件操作菜单，选择可用的分享或导出操作。
2. 在系统分享面板中选择“存储到‘文件’”，明确选定 iCloud Drive 或“我的 iPhone／iPad”中的目标位置，保留原有文件扩展名。
3. 使用可辨认的文件名，例如 home-rules-before-migration.conf；另行记录备份日期和对应设备，避免用同名文件覆盖前一份快照。
4. 在“文件”App 中确认文件可以打开，核对末尾规则是否完整。若选择共享给自己的另一台设备，接收后同样检查实际文件内容。
5. 将订阅地址和服务器凭据另存到受保护的位置。若导出的是完整备份而非单个 Config 文件，按照导出界面说明核对其范围，仍需进行恢复验证。

下面仅用于检查规则文本是否保持逐行完整，不是需要直接覆盖原文件的通用配置。PROXY 必须在实际配置环境中有可用的对应策略；复制几行规则不会同时创建服务器或恢复订阅。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

配置可能包含服务器地址、认证信息、WireGuard 私钥或带 token 的远程资源地址。即使文件主要用于规则分流，也应检查其中的 URL 和附加参数。对外寻求排查帮助时，只提供删去凭据的必要片段，不直接发送整份原始备份。

新设备恢复：先服务，再规则，最后自动连接

在新 iPhone 或 iPad 上通过 App Store 获取 Shadowrocket，并核对开发者 Shadow Launch Technology Limited 与应用 ID 932747118。Shadowrocket 是一次性买断的闭源商业应用，客户端买断 ≠ 线路套餐；设备系统要求及通用购买适用性以 App Store 页面标注为准。恢复服务时使用用户已有的订阅或服务器参数。

1. 接收数据。先检查 iCloud 是否已带来所需内容。若未恢复完整，在“文件”App 中找到导出的配置，通过分享面板交给 Shadowrocket 打开或导入；完成后回到 Config 确认文件存在。
2. 恢复服务。在 Home 核对订阅地址和服务器列表。缺失时使用原订阅地址重新导入，再执行更新；手动服务器则逐项检查地址、端口、认证信息及协议相关字段。
3. 选中配置。在 Config 中选择恢复的文件，检查其中引用的策略或分组是否仍可用。文件名相同不代表内容相同，应查看自定义规则和末尾的 FINAL。
4. 确认路由。若需要按配置规则分流，将 Global Routing 设为 Config。Proxy、Direct 与 Scene 各有不同用途，不能因为配置已经导入就忽略当前姿态。
5. 建立连接。从 Home 发起连接，在系统提示时允许添加 VPN 配置。旧设备的授权不能代替新设备上的系统确认。
6. 恢复自动条件。手动连接验证通过后，再进入 Settings → On Demand 核对按需连接设置，并检查系统 VPN 设置中的对应状态。

订阅更新完成，只能说明取得并处理了订阅内容；它不等于规则文件已经恢复，也不等于每个服务器都可连接。同样，导入 Config 后仍需选择文件并确认 Global Routing，否则网页可能继续按另一种姿态访问。

迁移验收：按现象定位缺失项目

验收应包含实际访问，而不只是延迟数值。选择一个日常需要经已有服务访问的目标，再选择一个按自身规则应当 DIRECT 的目标，分别检查连接结果与规则匹配。测试目标应来自自己的正常使用场景，不要为了通过测试临时套用来源不明的配置。

• 确认 Home 中需要使用的服务器仍可选择，订阅更新后没有意外重复分组。
• 确认 Config 中手动添加的 DOMAIN-SUFFIX、IP-CIDR 和 FINAL 顺序保持一致。
• 确认手动连接、断开以及网络切换后的表现符合预期，再启用日常需要的 On Demand 条件。
• 保留迁移前副本和旧设备数据，直到常用网络与关键访问场景均已验证。

常见问题：同步、分享与订阅恢复