能否通过OTA更新NodeMCU ESP8266-01的Lua文件？

阿华AIGC实验室

2026-5-28

NodeMCU ESP8266-01 Lua文件OTA更新方案

当然可以实现Lua文件的OTA更新啦！现在NodeMCU的生态已经很成熟了，完全不用纠结2015年的老资料——你不需要更新固件，只需要用Lua代码就能完成远程更新设备上的init.lua这类文件，下面给你几个可行的方案：

方案1：HTTP远程下载更新（最常用）

这个思路是让设备连接WiFi后，从你的HTTP服务器下载新的Lua文件，覆盖本地文件。只要你的固件包含net、http、file模块（默认编译的固件一般都有，或者在nodemcu-build.com编译时勾选这些模块），就能实现。

示例代码

-- 连接WiFi
wifi.setmode(wifi.STATION)
wifi.sta.config("你的WiFi名称", "WiFi密码")
wifi.sta.connect()

-- 等待WiFi连接成功
tmr.alarm(1, 1000, tmr.ALARM_AUTO, function()
    local ip = wifi.sta.getip()
    if ip ~= nil then
        tmr.stop(1)
        print("WiFi已连接，IP地址：" .. ip)
        
        -- 从服务器下载新的init.lua
        http.get("http://你的服务器地址/init_new.lua", nil, function(code, data)
            if code == 200 then
                -- 先备份旧文件，防止更新失败变砖
                if file.exists("init.lua") then
                    file.rename("init.lua", "init_backup.lua")
                end
                
                -- 写入新文件
                file.open("init.lua", "w")
                file.write(data)
                file.close()
                
                -- 验证新文件是否能正常加载
                local ok, err = pcall(dofile, "init.lua")
                if ok then
                    file.remove("init_backup.lua") -- 验证成功，删除备份
                    print("Lua文件更新完成，即将重启设备")
                    node.restart()
                else
                    -- 验证失败，恢复备份
                    file.rename("init_backup.lua", "init.lua")
                    print("新文件加载失败，已恢复旧版本：" .. err)
                end
            else
                print("文件下载失败，错误码：" .. code)
            end
        end)
    end
end)

注意事项

你的HTTP服务器要能被ESP8266访问（同一局域网或公网均可）
服务器上的文件权限要设置正确，确保能正常下载
建议给文件加MD5校验（如果固件包含crypto模块），避免下载损坏的文件

方案2：设备自建Web服务器上传更新

如果你想通过浏览器手动上传Lua文件，可以在设备上搭建一个简单的Web服务器，接收上传的文件并覆盖本地文件。

简化示例代码

wifi.setmode(wifi.STATION)
wifi.sta.config("你的WiFi名称", "WiFi密码")
wifi.sta.connect()

tmr.alarm(1, 1000, tmr.ALARM_AUTO, function()
    local ip = wifi.sta.getip()
    if ip ~= nil then
        tmr.stop(1)
        print("Web服务器已启动，访问：http://" .. ip)
        
        -- 创建TCP服务器
        local srv = net.createServer(net.TCP)
        srv:listen(80, function(conn)
            conn:on("receive", function(conn, data)
                -- 解析上传的文件内容（简化处理，仅适用于纯文本Lua文件）
                local content = string.match(data, "\r\n\r\n(.*)")
                if content then
                    -- 备份旧文件
                    if file.exists("init.lua") then
                        file.rename("init.lua", "init_backup.lua")
                    end
                    
                    -- 写入新文件
                    file.open("init.lua", "w")
                    file.write(content)
                    file.close()
                    
                    -- 验证并反馈结果
                    local ok, err = pcall(dofile, "init.lua")
                    if ok then
                        file.remove("init_backup.lua")
                        conn:send("HTTP/1.1 200 OK\r\nContent-Type: text/html\r\n\r\n文件更新成功！设备即将重启")
                        node.restart()
                    else
                        file.rename("init_backup.lua", "init.lua")
                        conn:send("HTTP/1.1 500 Error\r\nContent-Type: text/html\r\n\r\n文件验证失败：" .. err)
                    end
                else
                    -- 返回上传页面（简单HTML）
                    local html = [[
                        <html>
                            <body>
                                <h1>上传Lua文件</h1>
                                <form method="post" enctype="multipart/form-data">
                                    <input type="file" name="luaFile">
                                    <button type="submit">上传</button>
                                </form>
                            </body>
                        </html>
                    ]]
                    conn:send("HTTP/1.1 200 OK\r\nContent-Type: text/html\r\n\r\n" .. html)
                end
            end)
            conn:on("sent", function(conn) conn:close() end)
        end)
    end
end)