如何同时控制多台 WLED 设备
用内置的 UDP 同步(端口 21324)和同步组让多个 WLED 控制器一起运行,或者从 App 把一个效果发送到多盏灯。
这件事您可能根本不需要 App。WLED 多年前就内置了灯与灯之间的同步:一盏灯通过 UDP 发送它的变化,其他灯照着复制。它的不足在于没法每次都选择哪些灯接收变化,这正是 App 分组的用处。下面教您判断自己需要哪一种。
| 您想要 | 用 |
|---|---|
| 始终跟随一盏“主”灯的灯 | WLED UDP 同步 |
| 几盏独立的灯,偶尔要同样的外观 | App 分组或“应用到多台设备” |
| 跨控制器的像素级动画(一场连续的灯光秀) | 来自 xLights、LedFx 或类似软件的实时协议(DDP、E1.31) |
| 按房间自动化 | 带 WLED 集成的 Home Assistant |
请记住 UDP 同步复制的是状态,不是画面帧。两盏运行相同效果的灯看起来相似,但不会逐帧同步。对大多数屋檐线和房间来说没人会注意。
用 UDP 同步多个控制器
在每个 WLED 版本的网页界面中都可用。
- 在您用来控制的那盏灯(发送方)上,打开 Config›Sync Interfaces。
- 在 WLED Broadcast 下,UDP 端口保持 21324。这是默认值,每盏灯都必须一致。
- 勾选 Send notifications on direct change。发送方发送所有内容,每个接收方自行决定接收什么。
- 在每盏接收灯上打开同一页面,勾选 Receive,再勾选您想复制的部分(Brightness、Color、Effects、Palette)。
- 可选:同步组。WLED 有 8 个。一盏灯只监听它接收的组,所以前院可以是组 1,露台是组 2,都由一个控制器驱动。
- 主网页界面中的 Sync 按钮可以快速开关发送。

一个发送方(紫色),前院监听组 1(橙色),露台监听组 2(蓝色)。
需要注意的地方:同步使用 UDP 广播,所以它只在一个网络内有效,没有额外手段就跨不了 VLAN。而且每次发送方有变化,它都会复制您勾选的所有内容。没有简单的办法说“只要这三盏灯,只这一次”。
网页界面还可以列出它发现的其他 WLED 灯(Info > Instance List,需要开启 Enable instance list),在它们之间跳转更快。不过每盏灯仍然有自己单独的页面。
WLED Max 中的分组
设备 标签页列出您的灯,带在线状态和各自的电源开关。新分组 创建一个带名称和图标(厨房、床、沙发)的分组。一盏灯可以同时属于多个分组,所以“楼下”和“圣诞”可以重叠。

每个区块的标题都有自己的开关(打开此部分中的所有设备 / 关闭此部分中的所有设备),不需要时分组可以折叠,列表变长后很有用。在 App 让您选择灯的任何地方,您都能看到自己的分组:全局预设、小组件、灯光提醒和“应用到多台设备”。
一个效果,多盏灯
“应用到多台设备”把一个效果或预设一次性发送到任意组合的灯,不会把它们永久绑在一起。
- 在 效果 标签页长按一个效果,或在 预设 标签页长按一个预设。
- 选择 应用到多台设备…

- 您的灯按分组列出。勾选想要的灯,或 全选。
- 点 应用。
预设还有每个分组的快捷项(应用到 后面跟分组名称)以及 应用到所有设备。
设备预设有一个坑。设备预设保存在一盏灯上的某个槽位号下,把预设 5 应用到多盏灯,是让每盏灯加载它自己的预设 5。如果另一盏灯的槽位 5 里是别的东西,那盏灯显示的就不一样。两个解决办法:
- 全局预设(“预设”标签页 > “全局”)保存在您的手机上,“所有控制器都可以使用”,可以发送到任意一盏灯、一个分组或全部灯。在 iOS 上,如果您开启了 通过 iCloud 同步,它们也会随之同步。“把所有灯都调成暖白”这类需求通常用它。
- 在设备之间复制预设 把一盏灯的预设复制到另一盏灯,让槽位一致。步骤见预设指南。
分组和“应用到多台设备”都在免费版中,但它们只有两盏以上的灯才有意义,而免费版只能控制一盏灯。所以实际上它们需要高级版。在设置分组之前先了解这一点比较好。
WLED 同步不起作用
同步的灯节奏不一致。 每盏灯按自己的时钟运行效果,因为同步只复制状态,别的什么都不复制。一次性把效果应用到所有灯会有帮助,保持 LED 数量一致也有帮助。要真正逐帧同步,请用 xLights 这类序列器通过 DDP 或 E1.31 输出(见 WLED 与 xLights)。
有些灯忽略同步。 检查它们是否都用同一个 UDP 端口和同步组,并且在同一个网段。访客网络和 VLAN 会阻断广播。
应用到多盏灯的预设在每盏灯上看起来不一样。 同一槽位里是不同的预设。用全局预设,或者先复制预设。
某盏固件较旧的灯上效果看起来不一样。 效果列表随版本变化。WLED 16 新增了效果并改动了效果 77(见效果列表)。把所有灯升到同一版本。
**分组里有一盏灯显示为离线。**App 连不上它。先看 WLED App 找不到您的灯。
这些需要 Home Assistant 吗?不需要。它很适合按房间或时间做自动化,但“多盏灯同样外观”靠同步和 App 就能做到。