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

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

Shadowrocket 的迁移至少涉及三类数据。Home 中有连接条目、订阅分组及当前选择；Config 中有规则、DNS 等配置内容；Settings 中还有 On Demand 等行为设置。导出一个 Config 文件，并不代表订阅地址、所有连接凭据和设备系统授权都已保存。

先在旧设备记录当前可用状态，再做任何同步或更新。记录时不要把密码、私钥或完整订阅链接放入普通截图；可以用本地清单记录分组名称、条目数量、选中的 Config 名称与 Global Routing 姿态。需要保存的敏感字段应进入受保护的备份位置。

订阅返回的数据可能随时间变化。若迁移前后条目数量不同，先比较是否发生过订阅更新，再判断是否漏导。手动调整过名称、分组或参数的条目尤其需要单独记录，因为重新获取订阅不一定保留这些本地修改。

二、iCloud 同步：先确认旧设备上传，再检查新设备接收

iCloud 适合同一 Apple 账户下的设备接续，但同步不是独立的历史备份。它可能传递新增、修改和删除；一台设备上已经出现的数据，也不等于另一台设备必然已接收。换机前保留旧设备上的完整状态，不要先删除旧数据来“触发刷新”。

1. 检查系统账户。在 iPhone / iPad 的系统“设置 → Apple 账户 → iCloud”中确认登录账户，检查可用空间、iCloud Drive 和应用使用 iCloud 的权限。系统版本不同，列表可能位于“查看全部”中。
2. 检查应用同步设置。在 Shadowrocket 的 Settings 中检查当前安装提供的 iCloud 同步选项并启用；具体开关名称与可同步范围以实际界面为准，不把系统整机备份开关当作应用同步开关。
3. 保持联网并观察。在旧设备完成保存后，给同步留出时间，再到新设备打开应用检查。不要连续在两台设备上同时编辑同一份配置，以免无法判断哪个副本是预期状态。
4. 核对内容而非只看名称。确认 Config 文件可打开、关键规则存在，再检查 Home 中的分组与连接条目。仅看到相同文件名，不能证明内容完整或已选中生效。

如果新设备暂时没有内容，先排查两端账户、应用权限、云端空间和网络状态，再重新打开应用观察。不要把反复关闭同步、清空本地数据作为第一步。无法确认云端状态时，继续使用下面的独立文件备份路线，避免把迁移进度完全依赖于同步。

三、导出 Config：保留可独立读取的配置副本

在旧设备进入 Config，先确认哪份文件处于选中状态。打开目标配置的操作菜单，使用当前界面提供的导出或分享操作，将文件保存到系统“文件”中的受控目录。不同平台或界面布局的操作入口可能不同，关键是得到实际文件，而不是仅复制文件名或配置下载地址。

1. 逐份导出。先保存当前正在使用的 Config，再保存其他需要保留的配置。建议使用能区分用途与备份批次的文件名，避免同名覆盖。
2. 打开检查。在“文件”中确认导出项可以读取，检查是否包含预期的段落与规则。只有名称、空白内容或错误页面都不算有效副本。
3. 检查外部依赖。配置引用远程规则、脚本或其他外部资源时，保存文件不等于保存这些资源的全部内容。记录依赖用途，并在新设备上验证其能否正常获取。
4. 补齐连接数据。在 Home 中对照原有订阅与手动条目，使用当前界面支持的分享、导出或备份方式单独保存必要数据；导出前后核对其覆盖范围。
5. 保留第二份受控副本。除同步目录外，再存一份不受本次同步删除影响的副本。含凭据的文件应限制访问，传输完成后清理临时中转文件。

如果只保存了远程配置 URL，之后重新下载可能得到已经改变的内容。需要回到迁移前状态时，应保留当时导出的本地文件；需要跟随远程维护时，再单独执行更新。将“恢复旧状态”和“获取最新内容”拆成两步，才能定位差异来源。

四、新设备恢复：先安装，再导入并选中配置

iPhone / iPad 可在 App Store 的账户页面进入“已购项目”或相应的应用列表，使用购买时的账户查找 Shadowrocket 并重新下载；菜单名称随系统界面变化。重新安装应用与恢复应用数据是两件事，商店下载完成不会自动证明 Config、订阅和行为设置都已恢复。

获取入口统一使用本站下载页。iPhone / iPad 在 App Store 以 $2.99 一次性购买，系统要求以 App Store 页面标注为准；Mac（Apple 芯片 / Intel）、Windows、安卓、Linux 版免费。核对 iPhone / iPad 产品时，开发者为 Shadow Launch Technology Limited，应用 ID 为 932747118。客户端买断 ≠ 线路套餐，原有订阅仍由用户自行管理。

1. 先观察自动恢复结果。打开应用后检查 iCloud 已恢复哪些数据。已经存在且内容正确的文件，不必立即重复导入，避免出现同名副本。
2. 导入缺失的 Config。在 Config 中使用导入入口，或从系统“文件”通过分享方式交给 Shadowrocket 打开。导入后检查内容并明确选中要使用的配置。
3. 恢复连接来源。按备份恢复 Home 中的手动条目或用户已有订阅。只有订阅地址而没有本地条目时，需要联网更新；更新失败应单独排查，不能归结为 Config 无效。
4. 复核路由与行为。确认 Global Routing 与旧设备一致，再检查 Settings → On Demand。迁移初期可以先关闭自动触发，完成手动测试后再恢复原有条件。
5. 完成系统授权。首次开启连接时，按系统提示允许添加 VPN 配置。应用内数据恢复不替代新设备上的系统授权。

跨平台迁移时不要套用 App Store“已购项目”的恢复步骤，也不要假设 iCloud 会覆盖 Windows、安卓或 Linux。应通过下载页安装对应平台版本，再确认目标版本支持的导入格式。系统 VPN 权限、文件访问权限及自动连接条件仍需在目标设备重新设置。

五、恢复验收：分别检查连接参数与规则动作

迁移后的第一轮测试应保持变量尽量少：使用同一网络、同一个已有连接条目、同一份 Config。不要一边更新订阅，一边修改 DNS，再同时切换 Global Routing。否则即使出现差异，也很难确定是哪项变化造成。

Global Routing 中，Proxy 用于全局代理姿态，Direct 用于直接连接，Config 按配置规则分流，Scene 按已设置的场景条件选择相应行为。要验证 Config 中的规则，先确认当前不是停在 Direct；要验证 Scene，必须同时核对场景条件，不能只比较配置文件。

规则通常自上而下匹配，首条命中决定动作。DOMAIN-SUFFIX 检查域名后缀，IP-CIDR 检查目标 IP 所在网段，GEOIP 按 IP 地理数据库分类，FINAL 承接此前未命中的连接。相同规则若顺序不同，结果也可能不同；因此恢复时不仅要核对条目是否存在，还要核对排列与策略名称。

• 先看条目参数。Shadowsocks 的加密方式与密码、VMess / VLESS 的身份与传输参数、Trojan 的密码与 TLS 相关参数，应与原值一致；Hysteria2 与 WireGuard 也应按各自参数逐项核对，不套用其他协议的字段。
• 再看实际请求。对同一个已知可访问目标发起请求，结合可用的连接记录检查命中动作。单次延迟测试成功，只能说明对应测试路径有响应，不能证明所有应用和规则均正常。
• 最后看自动行为。手动连接通过后，再恢复 On Demand 条件，分别观察 Wi-Fi 与蜂窝网络切换后的状态，避免把自动断开误判为连接数据丢失。

六、迁移常见问题：按缺失层级处理

七、何时清理旧设备：完成验收后再处理敏感副本

迁移完成的标志不是“新设备已经装好应用”，而是连接数据、当前 Config、规则行为和自动连接条件都已核对。旧设备仍可正常访问时，它是最直接的比对来源；在新设备完成一轮实际使用前，不急于删除原始文件。

• 确认新设备能独立打开备份文件，不依赖旧设备临时分享入口。
• 确认 Home 中必要条目与订阅来源齐全，手动条目的特殊参数已保留。
• 确认 Config 的选中状态、规则顺序和外部依赖符合预期。
• 确认系统 VPN 授权与 On Demand 行为经过实际测试，而非只看到开关开启。
• 保留受保护的最终备份，删除传输过程中产生的临时敏感副本；旧设备交接前按系统流程清除个人数据。

以后修改规则或手动连接参数前，也可沿用同一套方法：先保存已验证的副本，再改动一项，最后记录结果。这样下一次换机或误改恢复时，可以区分“备份本身缺失”和“新环境条件不同”，减少重复导入与反复重置。