幸狐 Luckfox Pico WebBee 刷机教程：SocToolKit 烧录 SPI NAND 系统

先确认型号

Luckfox WebBee（本站也写作 Luckfox Pico WebBee）是带外壳的 RV1103 小板：64 MB 内存、128 MB 板载 SPI NAND、一个百兆网口，没有摄像头接口。它默认从 SPI NAND 启动，不需要 TF 卡。没有外壳、带摄像头接口的是 Pico / Pico Plus / Pico Mini，请看 幸狐 Luckfox Pico / Mini / Plus 刷机教程。

准备

• 一根能传数据的 USB-A 转 USB-C 线。
• Windows 电脑：本站的 SocToolKit，以及 RKDevTool 页 里的驱动助手 DriverAssistant。Linux 或 macOS 用 upgrade_tool。
• 先装驱动：运行驱动助手，点“驱动安装”，装完重启电脑。这一步不用接板子。
• 只有打算从 TF 卡启动时，才需要 8 GB 以上的 TF 卡、读卡器和 SD Card Formatter（本站暂未收录，从文末“官方资料”进入 Luckfox 页面获取）。

下载哪个文件

打开 Luckfox Pico WebBee 镜像页：

• Luckfox 不推荐 WebBee 用 TF 卡启动：换卡要拆外壳，比较麻烦。需要 TF 卡启动的项目，Luckfox 建议改用带 TF 卡槽、没有外壳的 Pico Plus。
• Buildroot 是 Luckfox 的官方镜像，本站目前最新是 250607 版；Ubuntu 镜像被 Luckfox 列为“第三方镜像”，本站收录的是 250313 版，只能放在 TF 卡上。
• 文件名里的 6 位数字是镜像日期。Luckfox 要求烧最新日期的镜像，厂商网盘上可能有比本站更新的版本。
• 下载后先核对 SHA-256，方法见 如何核对下载文件的 SHA-256，再用 7-Zip 完整解压，得到一个同名文件夹。

注意这些压缩包都要用 SocToolKit 写入，不能用 balenaEtcher 等写卡工具直接写。

方法一：刷进板载 SPI NAND（推荐）

1. 右键 SocToolKit，以管理员身份运行。弹出“选择芯片（Chip Selection）”时选 RV1106（RV1103 的板子也选它），点 OK。
2. 让 WebBee 进入刷机模式：系统能正常开机时，用 USB 线接电脑，执行 adb shell 登录后运行 reboot loader；能按到 BOOT 键时，也可以按住 BOOT 键再用 USB 线接电脑，然后松开。

应看到：SocToolKit 顶部 USB 一栏显示 Maskrom 或 Loader 设备（后面的编号每台电脑不同）。

1. 在“固件下载（Download）”页，点“固件...（Firmware...）”，选 Luckfox_Pico_WebBee_Flash_… 文件夹里的 update.img。
2. 点“升级（Upgrade）”，等右侧日志走完。

应看到：日志里出现 Upgrade firmware ok.，最后一行是 Upgrade update...OK（中文界面为“升级update...成功”）。下载页的“重启设备（reset）”保持勾选时，板子随后会自动重启。

第一次在 Linux 上使用时，先按 Luckfox 的步骤安装本站 upgrade_tool 页的 Linux 版（2.17）：

sudo unzip upgrade_tool_v2.17.zip
cd upgrade_tool_v2.17_for_linux/
sudo cp upgrade_tool /usr/local/bin
sudo chmod +x /usr/local/bin/upgrade_tool
sudo upgrade_tool -v

应看到：Upgrade Tool v2.17。macOS 版解压后在工具所在目录用 sudo ./upgrade_tool 运行。

Linux 或 macOS：板子进入刷机模式后，在解压出来的文件夹里执行 sudo upgrade_tool uf update.img（macOS 版为 sudo ./upgrade_tool uf 镜像路径/update.img），最后一行是 Upgrade firmware ok. 就完成了。

方法二：做 TF 卡启动（不推荐）

1. 打开外壳：撕下机身贴纸，拧松固定螺丝。
2. 用读卡器把 TF 卡接到电脑，拔掉其他 U 盘和存储卡。打开 SD Card Formatter，选中这张卡，点 Format。
3. 以管理员身份运行 SocToolKit，芯片选 RV1106，切到“SD卡工具（SDTool）”页，在“Usb 磁盘（Usb Disk）”一栏确认是这张卡。
4. 选“SD 启动（SD Boot）”，点“选择启动文件...（Boot Files...）”，选中 …_MicroSD_… 文件夹里的 boot.img、env.img、idblock.img、oem.img、rootfs.img、uboot.img、userdata.img。不要选 `update.img`。
5. 点“创建SD（Create SD）”，确认目标磁盘后开始写入。

应看到：右侧日志最后出现 Create sdcard OK（中文界面为“创建SD卡成功”）。

1. 把卡插进板子的 TF 卡槽，装回外壳后上电。

警告创建 TF 卡会清空整张卡。工具识别不到卡时，关掉 SocToolKit，重新以管理员身份运行。

第一次开机：怎么登录

• 最简单：ADB。用 USB 线接电脑，执行 adb shell 直接进入板子。
• SSH（网线）：接上路由器后板子会自动获取 IP，在路由器后台找到它，然后 ssh root@板子IP。
• SSH（USB 线）：把电脑上新出现的 RNDIS 虚拟网卡的 IPv4 设成 172.32.0.100，再 ssh root@172.32.0.93（Ubuntu 镜像为 ssh pico@172.32.0.70）。

提示USB 线 SSH 连不上时，检查 Windows 防火墙是否拦截了这个 RNDIS 虚拟网卡。

登录后先用 passwd 改掉默认密码。更多方式见 开发板首次启动。

刷坏了怎么救

• 系统还能起来：用 reboot loader 进入刷机模式，按方法一重新刷 Flash 包。
• 系统起不来、`adb` 连不上：只能按住 BOOT 键再接电脑进入刷机模式。按键被外壳挡住时，需要按方法二第 1 步打开外壳。
• 想清空 SPI NAND：Luckfox 的方法是在 SocToolKit 里载入 update.img 后执行擦除（Luckfox 文档写作 Erase Flash），然后重新刷。
• SocToolKit 识别不到设备：确认驱动助手装好并重启过；临时关闭可能误删工具文件的杀毒软件；改插电脑后面板的 USB 口，不要经过 USB 集线器；日志卡在“下载 DownloadBin...失败”时换一根好的 USB-C 数据线。

其他情况见 开发板刷坏了怎么办。

资料来源

按幸狐 Luckfox Wiki 的 Luckfox Pico RV1103 版型介绍、Luckfox WebBee 镜像烧录与登录、Luckfox Pico 常见问题页面整理（2026-10-22 查阅），SocToolKit 中文按钮名取自本站收录的 2.2 版。

提示本页按厂商官方文档整理，本站没有在实机上测试。按键位置和文件名以你的板子和 Luckfox 官方说明为准。