WLED iCloud 同步 备份 换新手机 WLED Max 操作指南

把您的 WLED App 设置迁移到新手机或 iPad

换手机时的 WLED:哪些保存在灯上,哪些保存在 App 里,以及 iCloud 同步(iOS)和数据导出(Android)如何迁移它们。

作者:

先说好消息:您的 WLED 设置大部分从来都不在手机上。效果、预设、播放列表、分段、定时计划和设置都保存在灯上,所以新手机(或任何浏览器)一找到灯就能看到它们。App 保存在手机上的是周边的小东西:您的灯列表、名称和顺序、分组、收藏,以及只存在于 App 中的预设。

什么保存在哪里

项目保存位置会迁移到新手机吗?
预设和播放列表灯上(presets.json)会,无需操作
分段、当前效果、颜色灯上会
定时计划(定时器)、Wi-Fi、LED 设置灯上(cfg.json)会
自定义调色板灯上会
灯列表、App 内名称、顺序App需要同步或导出
分组App需要同步或导出
全局预设App需要同步或导出
收藏App需要同步或导出
在 App 中做的灯备份App不会,请重新备份或保留一份网页界面备份

即使完全不同步,新手机也只需要重新找到灯。在同一 Wi-Fi 下,WLED 会通过 mDNS 广播自己,大多数 App(包括免费的 WLED Native App)几秒内就会列出您的灯。

如果您只用 WLED 网页界面,就没有什么需要迁移的。在新手机上把每盏灯的地址(或 http://wled-xxxx.local)加入书签就行。不过仍然值得把每盏灯的 cfg.json 和 presets.json 保存在电脑上,备份指南介绍了方法。

iPhone 和 iPad:通过 iCloud 同步

WLED Max 1.1.4 在 iPhone 和 iPad 上新增的功能。前往 设置›通过 iCloud 同步 并打开它,在您使用的每台 iPhone 和 iPad 上都打开。它们都需要登录同一个 Apple 账户。

它会同步您的灯(名称、顺序、收藏)、分组和全局预设,最多约 200 盏灯。它不同步您的高级版购买,购买记录由每台设备从 App Store 获取(在新设备上点“恢复购买”,同一 Apple 账户,不额外收费)。保存在灯上的设置留在灯上,每台设备反正都能看到。

iOS 1.1.4 新增
WLED Max 的“通过 iCloud 同步”页面:“通过 iCloud 同步”开关已打开,一条“正在等待 iCloud”提示和一个“立即同步”按钮,以及“同步的内容”、“未同步”两个部分、一条免费版说明和一段关于关闭同步的说明
通过 iCloud 同步。这台测试 iPhone 没有登录 iCloud,所以显示“正在等待 iCloud”。

一些值得了解的细节:

  • 在免费版上,您在每台设备上最先添加的灯在该设备上保持可用。从其他设备同步来的灯会以锁定状态添加,直到您拥有高级版。
  • 关闭同步或退出 iCloud,会保留那台 iPhone 或 iPad 上的所有内容。您其他设备上的东西不会被删除。
  • 如果您的全局预设太大无法同步,它们会留在那台设备上,灯和分组仍然照常同步。发生这种情况时“通过 iCloud 同步”页面会告诉您。
  • 如果另一台设备运行的 WLED Max 版本更新,旧的那台会提示您更新 WLED Max 以继续同步。

页面上显示“上次同步”和时间。“正在等待 iCloud”通常表示您没有在 iOS 设置 App 中登录 iCloud。iOS 上没有 App 数据的文件导出,所以 iCloud 是迁移它的途径。

Android:导出应用数据和导入应用数据

Android

仅在 Android 上,WLED Max 在 设置›备份与恢复 的“应用数据”下提供 导出应用数据和 导入应用数据。

  1. 在旧手机上点 导出应用数据。您会得到一个名称类似 WLED Max 应用数据 2026-10-12.json 的 JSON 文件,包含您的灯、分组、全局预设、收藏、快捷效果调整和 App 设置。
  2. 用任何方便的方式把文件传到新手机:云盘、发邮件给自己、USB。
  3. 在新手机上安装 WLED Max,点 导入应用数据。您会看到预览,然后选择 合并(添加新内容,手机上已有的一切保持不变)或 替换(改用备份中的灯、分组、预设、收藏和设置)。
  4. 新加入的灯会显示为离线,直到 WLED Max 在您的网络上找到它们。

该文件不包含 Wi-Fi 密码、灯自身的配置(那些在灯上)或您的购买记录(请用同一 Google 账户点“恢复购买”)。Android 目前还没有自动云同步。

请注意

导出文件未加密,请保存在私密的地方。

从 iOS 换到 Android,或反过来

灯不在乎您用哪种手机,所以它们会原样跟过来。但 App 数据不能跨平台。没有办法把 iOS 的同步数据导入 Android,反过来也不行,所以分组需要重新设置。高级版也绑定在商店上:App Store 的购买不会转移到 Android App,反之亦然。详情见免费版和高级版指南。如果您反正要换平台,也想看看其他 App,我们写了一篇 WLED App 对比,包括我们自己的不足之处。

如果新手机什么都看不到

一盏灯都没有。 手机必须和灯在同一个 Wi-Fi 上,不能是访客网络。在 iPhone 上,App 询问时请允许“本地网络”权限(或稍后在设置 > WLED Max 中允许)。如果设备发现仍然失败,按 IP 地址添加灯。更多内容见 WLED App 找不到您的灯。

我的 iPad 上灯显示为已锁定。 免费版按设备计算,所以只有在那台设备上最先添加的灯是可用的。如果您用同一 Apple 账户购买了高级版,请点“恢复购买”。

**同步显示“尚未同步”。**打开后等一分钟,保持 App 在前台,并确认已登录 iCloud。