本文适用于已有自己的连接资料与订阅、准备更换设备或重装 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 授权。
配置内容恢复后,仍需核对选择状态与设备权限。
迁移前先保留旧设备上的可用状态。不要一边整理规则、一边更新订阅、一边开始同步,否则出现差异时难以判断是哪一步改变了数据。本文不提供、不销售、不推荐节点或订阅,后续步骤均以用户已有自己的连接资料为前提。
二、建立备份顺序,保留可回退的副本
同步与备份的用途不同。同步会传播修改,也可能传播删除;独立导出的文件用于保留某一时点的内容。换机前建议两种方式并用:先导出本地副本,再执行同步,最后在新设备验收。
- 在旧设备打开 Home,记录订阅分组名称、手动连接数量和当前选中的连接。不要把包含密码的详情页发到公共聊天中。
- 进入 Config,确认实际启用的是哪一个文件。文件列表中存在多个名称相近的配置时,逐个区分本地副本与远程来源。
- 保存已经修改过的文件内容,再进行导出。可用
migration-before.conf作为自己创建的备份文件名,避免覆盖原文件。 - 记录 Global Routing 与 Settings → On Demand 的状态。记录的作用是恢复行为,不是要求新旧设备必须使用完全相同的网络条件。
- 保留旧设备,直到新设备完成订阅、规则与实际连接测试。不要以首次启动成功作为清理旧设备的依据。
三、使用 iCloud 同步到新 iPhone 或 iPad
先确认两台设备登录的是同一个用于 iCloud 的 Apple 账号。App Store 的购买账号与 iCloud 账号可以不同,因此“已经恢复购买”不能证明“同步账号相同”。应用安装与配置同步是两个独立环节。
- 在旧设备的系统“设置 → Apple 账号 → iCloud”中确认 iCloud Drive 已开启,并检查可用储存空间。系统页面名称随系统版本可能略有差异。
- 在 iCloud 的应用列表中检查 Shadowrocket 的使用权限。若当前系统将应用列表折叠,先展开完整列表。
- 打开 Shadowrocket → Settings,查看当前版本提供的 iCloud 同步或备份选项。按界面列出的数据范围操作,不将整个设备的 iCloud 云备份等同于应用内同步。
- 在旧设备完成保存与上传后,再到新设备开启相同的 iCloud 条件。若应用提供上传、下载或恢复方向选择,先确认数据来源是旧设备的有效副本。
- 分别进入新设备的 Home 和 Config 检查结果。某个配置文件出现,只能证明该文件已到达,不能证明订阅来源和所有运行偏好也已恢复。
如果界面没有显示某类数据的同步入口,就不要假定它会自动随其他数据迁移。手动添加的连接、订阅地址和本地 Config 都应分别验收。同步期间保持可用网络,并根据应用显示的完成状态判断,不使用固定等待几秒的办法代替确认。
结论:先确认旧设备上传,再让新设备恢复
新设备为空时,先检查同步方向与冲突提示。不要在尚未看到有效副本时反复执行覆盖操作;有疑问就暂停同步,使用已经独立导出的文件继续迁移。
四、导出 Config,并在新设备导入
文件迁移的重点是明确导出的范围。Config 文件主要承载配置文本;Home 中单独保存的连接和订阅来源,需要通过对应的导出能力或原始资料另行恢复。只拿到规则文件时,缺少可用连接并不代表文件损坏。
- 在旧设备进入 Config,找到要迁移的文件,核对名称与内容。打开该文件的操作菜单,使用当前界面提供的分享或导出入口。
- 通过系统分享面板将文件存入“文件”应用中的本人目录,或传到由本人控制的目标设备。保留配置文件原有的扩展名,避免把配置内容复制进富文本笔记后再导入。
- 在保存位置重新打开文件,确认不是空文件。检查规则段是否存在,并核对自己修改过的关键行。
- 在新设备的 Config 中使用文件导入入口,或从系统“文件”应用的分享面板交给 Shadowrocket。具体可用入口以目标平台界面为准。
- 导入后明确选择该配置文件,再返回 Home 检查 Global Routing。导入到列表与启用文件是两步操作。
- 恢复 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 条件,减少状态自动变化带来的干扰。
- 订阅来源:检查来源地址与分组是否存在,再执行一次更新。更新得到的条目数量可能因订阅内容变化而不同,不能单凭数量不同认定迁移失败。
- 手动连接:逐项核对协议、服务器、端口与认证字段。例如旧设备记录为端口
443时,新设备也应保持原值;不能因为连接失败就自行改为80。 - 协议参数:Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的参数结构不同。按原始资料核对,不能只复制服务器地址和端口。
- 配置文件:确认 Config 中启用的是迁移文件,而不是安装后已有的其他文件。检查 DNS、规则顺序以及远程引用是否完整。
- Global Routing:按规则运行时选择 Config。Proxy 与 Direct 不等同于按 Config 规则分流;若原来使用 Scene,还要核对对应场景条件。
- On Demand:在 Settings → 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 与蜂窝网络切换检查。没有蜂窝网络的设备,可以使用另一个已知可用的网络验证。每一步应记录实际结果,而不是只记录“已导入”。
- 独立备份文件可以从保存位置再次打开,关键配置行完整。
- Home 中需要保留的手动连接与订阅来源均已核对。
- Config 文件已启用,远程引用能够加载,规则顺序没有改变。
- Global Routing 与 On Demand 符合新设备的使用条件。
- 测试记录中能解释 PROXY 与 DIRECT 各自的匹配结果。
确认恢复完成后,再按自己的设备处置计划清理旧设备。独立备份应继续保存在受控位置,不要与日常同步目录中的唯一副本混为一谈。需要更详细的网络排查步骤时,可查看故障排查;需要重新确认基本操作时,可查看使用教程。