Actions-FriendlyWrt 固件怎么写进 eMMC？三条路线选一条，三个坑提前避开
【免费下载链接】Actions-FriendlyWrtBuild FriendlyWrt using GitHub Actions项目地址: https://gitcode.com/GitHub_Trending/ac/Actions-FriendlyWrt
Actions-FriendlyWrt 用 GitHub Actions 构建 FriendlyWrt 固件，这篇文章带你走完整套把成品固件写入开发板 eMMC 的流程：先判断该走哪条刷机路线，再点出最容易翻车的三个高危步骤，最后给出可以直接照抄的 dd 命令和验证办法。无论是首次安装，还是从 SD 卡迁过去，都能照做。
先选刷机路线：三种情况，两条路线
别急着抄 dd 命令，先看你的板子现在是什么状态，不同情况，走法不一样。
板子上还没有系统（首次安装）
你有两条路可以选：
- 路线 A，网页端 eMMC 刷机助手：先把 XYZ.img.gz 写进 SD 卡启动板子，登录后台（默认 IP 192.168.2.1，账号 root / 密码 password），进入 系统 → eMMC 刷机助手，上传固件文件即可刷入，不需要自己解压。刷完后弹出 SD 卡，设备会自动重启，转而从 eMMC 启动。
- 路线 B，电脑端 dd 直刷：让板子进入刷机模式，用 dd 把 XYZ.img.gz 直接写进 eMMC。本文重点讲的就是这条路。
小版本升级（例如 25.12.2 → 25.12.3）
用网页端的 eMMC 刷机助手刷入 images-XXYYZZ.tgz 升级包，可以选择保留已有数据。注意升级包只能交给刷机助手使用，拿 dd 直接写进卡里是起不来的。
大版本升级（例如 24.10 → 25.12）
先把当前配置备份出来，再用 XYZ.img.gz 做一次全量安装，避免旧数据带来兼容性问题。
dd 写 eMMC 最容易翻车的三个步骤 🛑
动手之前先对照检查这三处，能省掉大量返工。
坑一：dd 目标写错，系统盘被清掉
dd 不会跟你确认，一旦执行就直接覆盖 of 指定的那块盘。之所以要反复确认设备号，是因为电脑上同时挂着多块存储时，eMMC 和数据盘很容易认混。看到容量对不上，就立刻停下。
坑二：升级包和系统镜像混用
发布文件里有两种格式，分工明确：
- XYZ.img.gz 是系统镜像，可以写 SD 卡或 eMMC 直接启动
- images-XXYYZZ.tgz 是升级包，只供 "eMMC 刷机助手" 使用，不能直接写卡启动
拿错了，板子必然起不来。
坑三：刷完忘了弹 SD 卡
走路线 A 时，刷机助手完成后要先弹出 SD 卡，设备才会自动重启并切换 eMMC 启动。忘了弹，板子会一直从 SD 卡启动，你会误以为刷机失败。
拿到固件文件：用 Actions 怎么获取
1. 克隆构建仓库
git clone https://gitcode.com/GitHub_Trending/ac/Actions-FriendlyWrt以上是固定的构建仓库地址，原样复制即可，在任意空目录下执行都可以。
2. 查看默认固件选项（可选）
想知道固件默认启用了哪些内容，可以翻仓库里这两个文件：固件层配置 scripts/custome_config.sh、内核层配置 scripts/custome_kernel_config.sh。
3. 下载对的文件
固件由仓库的 GitHub Actions 自动构建产出，到项目 Releases 页面（或 Actions 页面）就能下载成品。按用途挑：写 eMMC / SD 卡启动选 XYZ.img.gz；网页助手原地小版本升级选 images-XXYYZZ.tgz。
dd 命令怎么写：从认设备到刷完三步走
第一步：让板子进入刷机模式
eMMC 只有在刷机模式下才能被电脑写入。以 NanoPi 为例：
- 给板子断电
- 长按板上的 Recovery 键不松手
- 接入 USB 数据线到电脑，设备被识别后即可松手
第二步：确认 eMMC 设备号
在终端里执行：
lsblk找到容量与板载 eMMC 吻合的那一行，它通常显示为 /dev/mmcblkX 或 /dev/sdX。把设备号记下来，下一步要用；电脑挂盘多时再对一遍大小，拿不准就别往下走。
第三步：执行写入
警示：执行前最后核对一次 of 的目标盘。dd 一旦开始就会抹掉你指定的整块磁盘，数据不可恢复。
sudo dd if=/path/to/firmware.img of=/dev/mmcblkX bs=4M status=progress把 if= 换成你下载的固件文件实际路径（如 XYZ.img.gz），of= 换成刚确认的 eMMC 设备号；bs=4M 和 status=progress 是固定参数，不用动。dd 会实时显示进度，期间别断电、别拔线，否则镜像不完整，只能从头再来。
刷完怎么确认启动，出了状况怎么排查
确认启动成功
- 拔掉 USB 线，给板子正常上电
- 看指示灯：闪烁有规律就属正常
- 用串口或网络接上后台（192.168.2.1，账号 root / 密码 password），页面能打开，说明刷机成了
出了状况，按这个顺序查
- 刷机后认不到设备或起不来：重新核对进入刷机模式的手法与 USB 线材、接口，换根线或换个口再试
- 怀疑镜像损坏：重新下载一遍固件文件再写入
- 怀疑型号不符：确认固件对应的板卡型号与手里这块一致
- 仍无解：对照 scripts/custome_config.sh 里的内容，确认默认配置匹配你的硬件
dd 写入属于破坏性操作，认准目标盘后建议一口气刷完。等首次安装跑通、板子正常启动之后，后续的小版本升级用后台的 eMMC 刷机助手就能完成，不必再走一遍 dd 流程。
【免费下载链接】Actions-FriendlyWrtBuild FriendlyWrt using GitHub Actions项目地址: https://gitcode.com/GitHub_Trending/ac/Actions-FriendlyWrt
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
