WLED 备份 预设 配置 WLED Max 操作指南

备份与恢复 WLED 配置(cfg.json、presets.json 和调色板)

该保存哪些 WLED 文件(cfg.json、presets.json、调色板),如何把它们恢复到一块新的 ESP32,以及为什么定时计划存在 cfg.json 里。

作者: 发布于 更新于

大多数人都是在丢了设置之后,才知道 WLED 把设置存在哪里。一切都在灯自身闪存里的几个 JSON 文件中:cfg.json 存设置(Wi-Fi、LED 输出、同步、定时器),presets.json 存预设和播放列表。自定义调色板、ledmap 和遥控映射是单独的文件。每次固件更新前、更换控制器前都复制一份。下面的网页界面方法免费,只需要一个浏览器。

哪些文件重要

文件内容要备份吗?
cfg.jsonWi-Fi、LED 输出、GPIO、电流限制、同步、时间和定时器、用户模块设置要
presets.json所有预设和播放列表要
palette0.json、palette1.json…自定义调色板(WLED 0.14 及更高版本;0.14、0.15 以及 ESP8266 上最多 10 个,ESP32 上的 WLED 16 可以多得多)如果您做过
ledmap.json、ledmap1.json…矩阵和特殊布局的自定义像素映射如果您用到
ir.json、remote.json红外遥控和 ESP-NOW 遥控的按键映射如果您用到

定时器和定时计划在 cfg.json 里,不在 presets.json 里。有人恢复了预设,去找自己的日落定时器,发现没了。原因就在这里。

从浏览器备份

  1. 在浏览器里打开灯,进入 Config›Security & Updates。
  2. 点 Backup presets。浏览器会下载 presets.json。
  3. 点 Backup configuration。浏览器会下载 cfg.json。
  4. 把两个文件按灯的名字和日期重命名,比如 porch-cfg-2026-05-10.json。否则您最后会有十个全叫 cfg.json 的文件。
WLED 网页界面
WLED 的 Security and Updates 页面中的 Backup and Restore 部分:一条恢复会覆盖当前预设和配置的警告,Backup presets,带文件选择器和 Upload 的 Restore presets,Backup configuration,带文件选择器和 Upload 的 Restore configuration
WLED 16.0.1 上的备份和恢复按钮。旧版本看起来一样。

调色板和 ledmap 不在那个页面上。打开 http://<light-ip>/edit,也就是 WLED 的文件编辑器,从那里逐个下载文件。

恢复

同一个页面:Restore presets 和 Restore configuration。选好文件,点 Upload。配置恢复后灯会重启。密码不包含在备份里,所以把配置放到一块全新的板子上时,Wi-Fi 密码要重新输入。

把配置恢复到另一块板子上要稍微小心。

Wi-Fi 和网络设置会跟过去。如果旧灯用的是静态 IP 并且还在运行,您现在就有两盏地址相同的灯。

GPIO 和 LED 类型也一样。如果新板子用的数据引脚不同(比如 QuinLED 板和 D1 mini),灯带会一直不亮,直到您在 LED & Hardware(0.15 及更早版本叫 LED Preferences)里改好输出。

注意

配置恢复会把旧板子的网络设置和数据引脚一起带过来。在另一块板子上,恢复后立刻检查 IP 和 LED 输出。

从 ESP8266 换到 ESP32,或反过来,都可以,但之后要检查每一个输出。两种芯片的引脚编号和限制不同。

预设比配置安全得多,因为预设存的是灯效,不是硬件设置。唯一的坑是效果 ID:WLED 16 改变了其中一些的含义(比如效果 77),所以在 0.15 上做的预设在 16 上可能看起来不同。

WLED Max 中的备份与恢复

在 WLED Max 中,它在 设置 > 备份与恢复 下,iOS 和 Android 都一样。

在 创建备份 下,在 设备 旁边选一盏灯(只有一盏灯时已经自动填好),点 立即备份。

iOS
iPhone 上 WLED Max 的“备份与恢复”界面:“创建备份”中的“设备”选择器设为 Porch Lights,有一个“立即备份”按钮,“已保存的备份”为空(“没有备份”,“请先在上方创建您的第一个备份”),以及“迁移”下的“在设备之间复制预设”
第一次备份之前的“备份与恢复”。
App 会保存 cfg.json 和 presets.json、每个自定义调色板文件(palette0.json 及之后)、ledmap,以及 ir.json 和 remote.json。从未保存过预设的灯没有 presets.json,这时 App 会存一个空文件,而不是报错。

这些备份加密存放在您手机上的 App 内部,没有导出为文件的按钮,所以它们只留在这一台手机上。Android 的 导出应用数据(同样在“备份与恢复”下)会把您的灯列表、分组和全局预设保存到一个文件,但不包含这些灯的备份。想在手机之外留一份,就再从网页界面下载原始文件。

要恢复,在 已保存的备份 下点一个备份。恢复到 [原来的灯] 把一切放回它原来的灯。恢复到其他设备… 把它放到另一盏灯上,比如一块替换坏板子的新 ESP32。

关键在于它不会动哪些设置。恢复会保留目标灯自己的网络和身份设置。把门廊灯的备份恢复到一块新板子上,不会复制门廊灯的 Wi-Fi、静态 IP 或名字,所以不会出现两盏灯争一个地址。灯效、预设、调色板和定时计划会过去。LED 接线设置只在安全时才会过去(见下文)。

从 1.1.4 版起,在 iOS 和 Android 上,App 会检查您选的灯,并用直白的话告诉您会发生什么。用 1.1.4 或更高版本做的备份会记住自己来自哪盏灯。

  • **同一盏灯。**您会看到一个普通的 恢复,一切都会恢复。
  • **同一种芯片的另一盏灯。**您可以在 全部恢复(新 ESP32 替换坏掉的那块、接线相同时很方便)和 恢复,但保留这盏灯的 LED 设置 之间选择。
  • **不同的芯片,**比如 ESP32 的备份恢复到 ESP8266,或者到 ESP32-S3 或 C3 上。只提供 恢复,但保留这盏灯的 LED 设置。灯保留自己的 LED 输出、数据引脚、LED 类型和数量、按钮、红外和继电器引脚、矩阵布局、ledmap 以及用户模块设置。其他一切来自备份。
  • **灯上没有的引脚。**和不同芯片一样:灯保留自己的 LED 设置,App 会指出具体的引脚,例如 GPIO 25。
  • 旧备份(1.1.4 之前做的)不记录来源,所以 App 会建议保留灯的 LED 设置。如果您确定接线一致,全部恢复 仍然可选。

它还会就固件给出提醒。较新 WLED 的备份恢复到较旧的 WLED 上时,旧版本不认识的设置会被跳过,定时计划也可能表现不同。从 0.15 到 16,有几个效果变了,所以某些预设可能看起来略有不同。WLED MoonModules 的备份恢复到标准 WLED 上,或反过来,也会收到一条提示。

恢复到 [原来的灯] 在路由器给灯分配了新地址之后,依然能找到正确的灯。如果现在是另一盏灯在旧地址上应答,App 会停下来告诉您(“这是另一盏灯”),不做任何更改。

同一界面的“迁移”下还有 在设备之间复制预设。步骤和注意事项在预设指南里。

如果一盏灯的 presets.json 损坏了(保存途中断电就会这样),“预设”标签页会察觉到,并在做任何其他事之前提供 保存文件副本。留着这份副本。大多数预设通常都能从里面手工找回来。

什么时候备份

一盏灯设置完成之后。每次固件更新之前。大改预设或分段之前,尤其是每年节日的重新布置。

另外在电脑上也留一份网页界面的备份。只存在手机上的备份,在您重置 App 或丢了手机时就没了。

恢复问题

**恢复完成,但灯带不亮。**配置来自一块数据引脚或 LED 类型不同的板子。在 LED & Hardware(0.15 上叫 LED Preferences)里检查输出。WLED Max 1.1.4 在芯片不同时会自动保留目标的 LED 设置,所以这种情况多半出现在网页界面恢复或“全部恢复”之后。

**预设恢复了,但效果看起来不对。**要么是固件差异(见上面的效果 ID 说明),要么是目标固件里没有这个效果,比如在没有 AudioReactive 的固件上用音频效果。

**恢复后定时计划不见了。**您只恢复了 presets.json。定时器在 cfg.json 里。

**自定义调色板不见了。**它们是单独的文件。通过 /edit 放回去,或者用包含它们的 WLED Max 备份。

接下来打算更新固件?先读在 ESP8266 和 ESP02 上 OTA 更新 WLED。如果您要搬的其实是手机而不是灯,请看把 WLED App 的设置迁移到新手机。

本文作者

Jamie Conde,在 MeowScript 开发 WLED Max App。WLED 本身是独立的开源项目,我们不是它的一部分。 我们的 iOS 和 Android App WLED Max,一盏灯免费,功能不打折。一次性购买即可添加更多灯。