如何让新的 WLED 设备连上 Wi-Fi(WLED-AP)
把新的 WLED 开发板连到家里的 Wi-Fi:加入 WLED-AP(密码 wled1234),打开 4.3.2.1,输入您的网络。还有 iPhone 的问题处理、Wi-Fi 重置和恢复出厂设置。
**快速回答:**加入开发板自己的热点 WLED-AP,密码 wled1234。打开 4.3.2.1,点 WIFI SETTINGS,输入您家里的网络名和密码,保存。开发板会重启并连上您的 Wi-Fi,同一网络上的任何 WLED App 都能找到它。
顺利的话,这样就完成了。这一页剩下的内容是给不顺利的情况准备的,还有一件没人提前告诉您的事:之后怎么重新找到这盏灯。
WLED-AP 密码和 4.3.2.1 地址
- 网络名: WLED-AP
- 密码: wled1234
- 地址: http://4.3.2.1
这些是 WLED 源代码中的默认值(0.14、0.15 和 16)。少数控制器出厂时带有自己的名称或密码,所以如果 WLED-AP 不接受 wled1234,请查看包装盒或卖家页面。两者都可以之后在 Config > WiFi Setup(WLED 16 上是 WiFi & Network)中修改(AP SSID 和 AP password;密码至少 8 个字符,或者留空作为开放热点)。那里还有一个 Hide AP name 选项。如果有人勾选了它,这个网络就不会出现在列表里,您得手动输入名称来加入。
热点什么时候出现?在默认设置(AP opens: No connection after boot)下,开发板在无法加入已保存的网络时会打开 WLED-AP,大约在它开始尝试连接的 12 秒之后。一旦连上了您的 Wi-Fi,热点就会消失。其他选项有 Disconnected(之后连接断开时也会打开)、Always、Never (not recommended)(只有按键能把它叫回来),以及 0.15 和 16 上的 Temporary,它会在启动约 5 分钟后、无人连接的情况下再次关闭热点。
先检查这些
- 开发板上必须已经装有 WLED。 很多控制器出厂就带(GLEDOPTO、Athom、QuinLED 等)。裸的 ESP32 或 ESP8266 需要先刷固件。官方网页安装器 install.wled.me 可以在桌面浏览器里通过 USB 完成(详细步骤),接线方法见 WLED 文档。
- 只支持 2.4 GHz。 ESP32 和 ESP8266 芯片无法加入 5 GHz Wi-Fi。两个频段共用一个网络名通常没问题,因为开发板会自己选 2.4 GHz。仅 5 GHz 的网络永远不会出现在列表里。
- 跳过访客网络。 许多路由器会阻止访客设备之间互相通信(“客户端隔离”)。灯能正常加入,然后却没有任何 App 能连到它。
- 把 Wi-Fi 密码放在手边。 打错字是设置“失败”最常见的原因。
在浏览器中(任何手机)
- 给控制器通电。没有保存过 Wi-Fi 的开发板会自己启动热点。对于之前设置过的开发板,大多数控制器在按住按键时会重新打开热点(请查阅您那款的说明书)。
- 在手机的 Wi-Fi 设置里,用密码 wled1234 加入 WLED-AP。
- 通常会弹出一个登录页面。如果没有,打开浏览器访问 **http://4.3.2.1**。
- 点 WIFI SETTINGS。
- 输入您的网络名(SSID)和密码。除非您确定需要,否则静态 IP 字段留空。
- 点 Save & Connect。开发板重启,加入您的 Wi-Fi 后 WLED-AP 就会消失。
- 把手机切回家里的 Wi-Fi,然后去找这盏灯。试试 **http://wled-xxxxxx.local**(开发板 MAC 地址的最后六个字符),在路由器的客户端列表里找新设备,或者用一个带设备发现功能的 App。
WLED-AP 页面上真正重要的字段。其他的都可以等灯上了您的网络再说。
第 7 步是大家卡住的地方。您的手机刚离开灯的网络,灯从路由器拿到了一个新地址,现在您得去找它。
用 WLED Max 中的“设置新设备”
在 设备 标签页,点 +(添加设备),然后点 设置新设备(“通过 Wi-Fi 热点配置全新的 WLED 设备”)。步骤和网页一样。区别在于,最后由 App 替您找到这盏灯。


- 连接到 WLED-AP。在 iOS 上,您确认后 App 会自己加入热点。Android 会把您带到 Wi-Fi 设置:在那里加入 WLED-AP,回来后点 我已连接到 WLED-AP。如果您的开发板用的是别的热点名或密码,打开 使用自定义 AP 设置 并输入。按钮上随后会显示您热点的名称。
- 扫描网络。灯会搜索附近的网络,大约需要 10 秒。选您自己的。隐藏了或者没扫到?点 列表中没有您的网络?请输入它的名称。
- 输入密码,如果想要的话再填一个 设备名称。
- 点 配置设备。App 发送您的 Wi-Fi 信息,灯重启,App 等它出现在您的家庭网络上。它会自动进入您的设备列表。您也可以点 完成,在后台添加,让它在后台完成。
如果某一步失败了,重试 会重做那一步,不会把您送回起点,重新开始 则从热点重新开始。1.1.4 版还允许您手动输入扫描漏掉的网络名。
两个平台都没有蓝牙或 Improv 方式的设置。所有流程都经由 WLED-AP 热点进行,所以您只需要一个处于 AP 模式的较新 WLED 版本。
iPhone 上 WLED-AP 不能用
iPhone 对没有互联网的网络很挑剔,而 WLED-AP 正是这样的网络。有帮助的做法:
- 设置的那几分钟里关掉蜂窝数据。 开着蜂窝数据时,iPhone 可能一边连着 WLED-AP 一边继续走蜂窝网络,设置页面或 App 的请求就发到了没用的地方。
- 别让它跳回去。 如果手机不断切回家里的网络,在 Wi-Fi 设置中打开家庭网络的详情,把自动加入关掉,直到设置完成。
- 忘掉旧条目。 之前某块开发板用不同密码保存下来的 WLED-AP 会碍事。在 Wi-Fi 设置中点它,选择忽略此网络。
- 让登录页面做完它的事,或者关掉它。 弹出来的页面就是 WLED 页面。如果您用取消关闭了它,请选择不使用互联网而不是使用其他网络,然后在 Safari 中打开 http://4.3.2.1。
- 给网络扫描一点时间。 灯自己扫描 Wi-Fi 网络,需要好几秒。如果您的网络不在列表里,先再扫一次,再怀疑是不是出了问题。
如果 WLED-AP 根本没出现,开发板很可能仍连着一个它已知的网络(上线后热点会关闭),或者它根本没在运行。见下面的重置部分。
设置后 WLED 没有出现在 Wi-Fi 上
大多数失败的设置都是 Wi-Fi 密码打错、仅 5 GHz 的网络,或者访客网络。先检查这三项,再看别的。
出现了一个“登录”界面。 那是强制门户,很正常。在 iOS 上的 WLED Max 流程中,点取消,然后点不使用互联网。不要选使用其他网络,因为那会断开与灯的连接。
我的手机不断跳回家里的 Wi-Fi。 手机喜欢离开没有互联网的网络。在 Android 上,当它提示 WLED-AP 没有互联网时,点保持连接(或是),并在设置期间关闭“切换到移动数据”之类的功能。在 iOS 上,一个用不同密码保存的旧 WLED-AP 条目可能会碍事。在 Wi-Fi 设置中忽略它,然后重试。
扫描不到任何网络。 设置时把开发板拿到离路由器更近的地方,点“重新扫描”,或者自己输入网络名。
点了“配置设备”之后什么都没出现。 十有八九是密码错了。灯过一小会儿会退回 WLED-AP,所以再加入它,重做 Wi-Fi 那一步。同时确认网络是 2.4 GHz,而且不是访客网络。
它连上了,但我现在找不到它。 这是设备发现的问题,不是设置的问题。手机开着 VPN、灯在另一个 VLAN、路由器开了客户端隔离,这些是常见原因,WLED App 找不到您的灯逐一讲了每一种。
LED 看起来不对。 Wi-Fi 设置不涉及 LED 类型、数量或数据引脚。那些在网页界面的 Config > LED & Hardware(0.14 和 0.15 上是 LED Preferences),或者 WLED Max 的 设备设置 > LED 设置 里。只有前几颗 LED 亮?LED 数量设得太少。红色显示成绿色?颜色顺序错了。
重置 WLED 的 Wi-Fi 或恢复出厂设置
只重置 Wi-Fi。 如果您还能打开这盏灯,在 Config > WiFi Setup(WLED 16 上是 WiFi & Network)中更换网络。如果打不开(换了路由器、改了密码),给灯通电然后等。它连不上旧网络,所以过一小会儿会再次打开 WLED-AP,您就像设置新开发板一样设置它。
用按键。 对于把按键接到 WLED 第一个按键输入(默认 GPIO 0)的控制器,按住的时长决定了会发生什么。WLED 在您松手时判断:
| 按住后松开 | 发生什么 |
|---|---|
| 不到 0.6 秒 | 短按:切换灯的开关 |
| 超过 5 秒 | 打开 WLED-AP,保留所有设置 |
| 超过 10 秒 | 恢复出厂设置:擦除文件系统,所有设置和预设都会丢失,然后重启 |
WLED 0.14、0.15 和 16 上都一样。不是每个控制器都把按键接到那个输入上,所以在按住 10 秒之前,先确认您的那款。
从网页操作。 Config > Security & Updates,勾选 Factory reset,然后保存。WLED 说得很直白:“All settings and presets will be erased.”(所有设置和预设都会被擦除。)先备份(同一页面,Backup presets 和 Backup configuration),恢复方法见备份和恢复 WLED 配置。
不用家庭 Wi-Fi 使用 WLED
您完全不需要路由器。没有保存网络的开发板会一直开着 WLED-AP,手机加入它之后,您在 http://4.3.2.1 控制它。如果开发板保存了网络,但您有时会把它带去别的地方(集市摊位、露营车),把 AP opens 设为 Disconnected,这样只要家里的网络不在,热点就会出现。
有两个限制:没有互联网,灯无法通过 NTP 获取时间,所以日落和时钟定时器无法在正确的时间运行。而且手机连着 WLED-AP 时没有互联网。
连上网络之后
给它一个您认得出的名字。在 WLED Max 中,这是“控制”菜单里的 重命名(最多 24 个字符,也会写入灯本身)。顺便在“LED 设置”里设置 LED 数量和功率上限;WLED 设置详解给出了具体数值。然后玩几个效果。带实时预览的效果列表解释了各个滑块的作用。

常见问题
WLED-AP 的默认密码是什么? wled1234。您可以在灯的 Wi-Fi 设置中更改热点名称和密码。
WLED 在 AP 模式下用什么 IP 地址? 4.3.2.1。
我需要电脑吗? 只有给裸开发板刷 WLED 时才需要。Wi-Fi 设置用手机就行,在浏览器或 App 中都可以。
WLED 能用 5 GHz 网络吗? 不能。ESP32 和 ESP8266 开发板只支持 2.4 GHz。
WLED Max 能用和手机不同的语言吗? 可以,1.2.0 版起支持。在 iOS 上,打开 App 中的 设置 > App 偏好设置 > 语言(Settings > App Preferences > Language),会跳到 iOS“设置”里本 App 的页面,在那里选择语言。在 Android 上,打开 设置 > 应用偏好设置 > 语言,直接从列表中选择。