Shadowrocket 配置备份与迁移:iCloud 同步与导出配置到新设备

介绍两种迁移方式:用 iCloud 同步保存节点与 Config,或导出配置文件后在新设备上导入。换机后按顺序检查订阅、规则和 Global Routing 是否完整恢复。

本文速览

本文适用于已有自己的连接资料与订阅、准备更换设备或重装 Shadowrocket 的用户。先区分 Home 中的连接资料、Config 中的配置文件和设备上的运行设置,再选择 iCloud 同步或文件迁移。完成后逐项验收,不把“看见文件”当作“恢复完成”。

一、迁移前先区分三类数据

Shadowrocket(小火箭)的迁移不只是复制一个文件。Home 中的服务器、订阅来源与当前选择,Config 中的规则与 DNS 设置,以及 Settings 中的运行偏好,属于不同的检查对象。单独导出某个 Config 文件,不能据此认定 Home 中的全部资料也已保存。

iCloud 同步适合同一 iCloud 账号下的 Apple 设备。文件导出适合保留一个可独立取回的副本,也适合向其他平台转移可兼容的配置内容。Mac、Windows、安卓、Linux 之间迁移时,应以目标端的导入能力为准,不把 iCloud 当作通用跨平台传输方式。

连接资料与配置文件

Home
记录订阅来源、分组、手动添加的连接和当前选择。
Config
记录当前启用的文件,保存本地修改、规则与 DNS 设置。
外部依赖
登记远程规则地址及其他被引用文件,确认新设备可以重新获取。

一份 Config 不一定包含完整的连接凭据与订阅来源。

设备上的运行状态

Global Routing
记录旧设备当前使用的 Config、Proxy、Direct 或 Scene。
On Demand
在 Settings → On Demand 中记录启用状态与触发条件。
系统授权
新设备首次连接时重新确认系统 VPN 授权。

配置内容恢复后,仍需核对选择状态与设备权限。

迁移前先保留旧设备上的可用状态。不要一边整理规则、一边更新订阅、一边开始同步,否则出现差异时难以判断是哪一步改变了数据。本文不提供、不销售、不推荐节点或订阅,后续步骤均以用户已有自己的连接资料为前提。

二、建立备份顺序,保留可回退的副本

同步与备份的用途不同。同步会传播修改,也可能传播删除;独立导出的文件用于保留某一时点的内容。换机前建议两种方式并用:先导出本地副本,再执行同步,最后在新设备验收。

资料盘点 独立导出 同步传输 新机导入 逐项验收
  1. 在旧设备打开 Home,记录订阅分组名称、手动连接数量和当前选中的连接。不要把包含密码的详情页发到公共聊天中。
  2. 进入 Config,确认实际启用的是哪一个文件。文件列表中存在多个名称相近的配置时,逐个区分本地副本与远程来源。
  3. 保存已经修改过的文件内容,再进行导出。可用 migration-before.conf 作为自己创建的备份文件名,避免覆盖原文件。
  4. 记录 Global Routing 与 Settings → On Demand 的状态。记录的作用是恢复行为,不是要求新旧设备必须使用完全相同的网络条件。
  5. 保留旧设备,直到新设备完成订阅、规则与实际连接测试。不要以首次启动成功作为清理旧设备的依据。

三、使用 iCloud 同步到新 iPhone 或 iPad

先确认两台设备登录的是同一个用于 iCloud 的 Apple 账号。App Store 的购买账号与 iCloud 账号可以不同,因此“已经恢复购买”不能证明“同步账号相同”。应用安装与配置同步是两个独立环节。

  1. 在旧设备的系统“设置 → Apple 账号 → iCloud”中确认 iCloud Drive 已开启,并检查可用储存空间。系统页面名称随系统版本可能略有差异。
  2. 在 iCloud 的应用列表中检查 Shadowrocket 的使用权限。若当前系统将应用列表折叠,先展开完整列表。
  3. 打开 Shadowrocket → Settings,查看当前版本提供的 iCloud 同步或备份选项。按界面列出的数据范围操作,不将整个设备的 iCloud 云备份等同于应用内同步。
  4. 在旧设备完成保存与上传后,再到新设备开启相同的 iCloud 条件。若应用提供上传、下载或恢复方向选择,先确认数据来源是旧设备的有效副本。
  5. 分别进入新设备的 Home 和 Config 检查结果。某个配置文件出现,只能证明该文件已到达,不能证明订阅来源和所有运行偏好也已恢复。

如果界面没有显示某类数据的同步入口,就不要假定它会自动随其他数据迁移。手动添加的连接、订阅地址和本地 Config 都应分别验收。同步期间保持可用网络,并根据应用显示的完成状态判断,不使用固定等待几秒的办法代替确认。

结论:先确认旧设备上传,再让新设备恢复

新设备为空时,先检查同步方向与冲突提示。不要在尚未看到有效副本时反复执行覆盖操作;有疑问就暂停同步,使用已经独立导出的文件继续迁移。

四、导出 Config,并在新设备导入

文件迁移的重点是明确导出的范围。Config 文件主要承载配置文本;Home 中单独保存的连接和订阅来源,需要通过对应的导出能力或原始资料另行恢复。只拿到规则文件时,缺少可用连接并不代表文件损坏。

  1. 在旧设备进入 Config,找到要迁移的文件,核对名称与内容。打开该文件的操作菜单,使用当前界面提供的分享或导出入口。
  2. 通过系统分享面板将文件存入“文件”应用中的本人目录,或传到由本人控制的目标设备。保留配置文件原有的扩展名,避免把配置内容复制进富文本笔记后再导入。
  3. 在保存位置重新打开文件,确认不是空文件。检查规则段是否存在,并核对自己修改过的关键行。
  4. 在新设备的 Config 中使用文件导入入口,或从系统“文件”应用的分享面板交给 Shadowrocket。具体可用入口以目标平台界面为准。
  5. 导入后明确选择该配置文件,再返回 Home 检查 Global Routing。导入到列表与启用文件是两步操作。
  6. 恢复 Home 中的订阅来源或手动连接。若旧设备没有相应导出入口,使用自己保存的原始连接资料重新添加。

跨平台时应先导入副本。若目标端提示不支持某个字段,保留原文件,依据提示逐项检查,不能直接删掉整段 DNS 或规则来消除报错。远程规则、证书引用以及本地文件路径都可能依赖原设备,需要单独处理。

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

上面只是核对语法用的规则片段,不是完整迁移文件。DOMAIN-SUFFIX 匹配指定域名后缀;IP-CIDR 示例匹配私有地址段;GEOIP 按地理归属匹配;FINAL 负责兜底。规则按顺序判断,迁移时不能只核对行数,还要核对排列位置与目标策略。

五、按订阅、规则、运行模式验收

恢复后先检查静态资料,再检查运行结果。首次连接出现系统 VPN 授权提示时,应在新设备上完成确认;旧设备的授权不能替代新设备的授权。测试期间先停用可能触发自动连接的 On Demand 条件,减少状态自动变化带来的干扰。

测试至少覆盖两个方向:一个应按规则使用 PROXY 的目标,以及一个应使用 DIRECT 的目标。重新发起请求,再查看连接记录中的目标、匹配规则与出站结果。网页能够打开不等于规则已经正确恢复,因为 Direct 或已有连接也可能产生相同的表面现象。

六、迁移常见问题与对应处理

新手机登录了账号,为什么还是看不到配置?

先在系统“设置 → Apple 账号 → iCloud”确认登录的账号,再检查 iCloud Drive 与 Shadowrocket 的权限。回到旧设备查看应用内同步状态。如果只是从 App Store 重新安装了应用,还需要单独执行配置恢复。

Config 已经导入,Home 为什么还是空的?

先检查导出文件实际包含什么。规则配置与连接资料不一定存于同一份文件。使用自己原来保存的订阅来源重新导入,或迁移手动连接资料,然后在 Home 选择要使用的连接。

订阅恢复了,但更新一直超时,怎么办?

核对 URL 是否完整,尤其是问号后的令牌参数。先确认设备网络可用,再检查订阅地址是否需要通过已有可用连接访问。不要在没有可用连接时反复切换 Global Routing;地址失效时应向自己的资料提供方核实。

规则一样,新手机却全部直连,是哪里没恢复?

先回 Home 检查 Global Routing 是否为 Direct,再确认 Config 中的目标文件已启用。切到 Config 后重新发起请求,并在连接记录中查看匹配结果。若使用 Scene,继续检查场景是否选择了不同的运行方式。

能连接,但切换 Wi-Fi 后状态变了,正常吗?

进入 Settings → On Demand 核对网络触发条件,同时检查系统中的 VPN 状态。先关闭自动触发,用手动连接复现问题;手动连接稳定后,再逐条恢复条件,避免一次修改多处设置。

七、验收完成后再整理旧设备

旧设备至少保留到新设备完成一次订阅更新、一次规则命中检查,以及一次 Wi-Fi 与蜂窝网络切换检查。没有蜂窝网络的设备,可以使用另一个已知可用的网络验证。每一步应记录实际结果,而不是只记录“已导入”。

确认恢复完成后,再按自己的设备处置计划清理旧设备。独立备份应继续保存在受控位置,不要与日常同步目录中的唯一副本混为一谈。需要更详细的网络排查步骤时,可查看故障排查;需要重新确认基本操作时,可查看使用教程。

下载 Shadowrocket