企业官网建设流程全解析

10 分钟把 Actions-FriendlyWrt 固件写入 eMMC：nanopi 等开发板完整刷机指南

【免费下载链接】Actions-FriendlyWrtBuild FriendlyWrt using GitHub Actions项目地址: https://gitcode.com/GitHub_Trending/ac/Actions-FriendlyWrt

Actions-FriendlyWrt 是一个用 GitHub Actions 在云端编译 FriendlyWrt 固件的项目。这篇文章带你完成一次完整的「Actions-FriendlyWrt 固件写入 eMMC」流程：云端编出自定义镜像、让开发板进入刷机模式、用 dd 落盘，最后确认系统点亮。

刷之前先核对三件事

• 设备：待刷的开发板（本文以 nanopi 为例），以及一根 USB 数据线和电源适配器。
• 固件：从 Actions 编译产出的镜像文件（形如*.img），且版本与你的板子型号匹配。
• 工具：一台电脑（Linux / Windows / macOS 均可）。Linux 下写入依赖dd，通常系统已自带；缺了就先补上：

sudo apt-get install -y dd

跑完再用dd --version验证一下，能打印出版本号就可用。

把一句话记牢：接下来每一步都发生在真实硬件上，动手前先确认设备名，再执行命令。

拿到你的固件：用 Actions 编译自定义镜像

整个流程只在终端和 Actions 页面之间来回：

1. 把仓库拉到本地：

git clone https://gitcode.com/GitHub_Trending/ac/Actions-FriendlyWrt

这一步把完整项目拷贝到本地，之后的自定义都基于这份代码进行。

2. 打开两个配置入口按需修改：
   • scripts/custome_config.sh：固件的菜单配置，增删功能包都在这里改；
   • scripts/custome_kernel_config.sh：内核参数开关。
3. 提交并推送代码，Actions 会自动接手编译；任务结束后直接在 Actions 页面下载生成的固件镜像。

检查点：拿到的应当是完整的.img镜像。文件小得离谱（几十 KB 量级）说明构建没成功，回 Actions 日志里找原因。

如何让 nanopi 进入 Recovery 刷机模式

顺序不能乱，手感上就是"先断电 → 按住不放 → 再插线"：

1. 先给板子断电。
2. 按住板上的 "Recovery" 按钮，一直别松手。
3. 保持按住的状态，把 USB 数据线插到电脑上。
4. 确认电脑这边已经冒出新的存储设备后，再松开按钮。

此时板子自身系统处于待机，eMMC 整体作为一块可写存储设备交给了你。

用 dd 写入并验证启动

用 lsblk 找到真实设备名

插好线先别急着写，执行：

lsblk

它列出当前所有块设备。盯住新出现的那一条——eMMC 一般显示为/dev/mmcblkX或/dev/sdX（X 为具体编号），把设备名和容量抄下来备用。

dd 写入命令与关键参数

⚠️危险：dd不可撤销。of指错设备 = 该设备上的数据全部清零，指到电脑硬盘上后果更严重。逐字符核对下面命令里的两个路径；拿不准时，先把无关的 U 盘、移动存储全部拔掉。

sudo dd if=/path/to/firmware.img of=/dev/mmcblkX bs=4M status=progress

• if：固件镜像的实际路径，就是上一步下载的那个文件；
• of：lsblk里确认的整盘设备名——注意是mmcblkX本身，不是mmcblkXp1这类分区；
• bs=4M：按 4M 块读写，速度稳定；status=progress实时打印进度。

写入期间别碰数据线、别断电。直到命令返回 shell 并输出 copied 统计，才算落盘完毕。

上电看指示灯，确认系统启动

1. 拔掉 USB 线，再给板子接上电源，顺序别反。
2. 观察指示灯：有规律地闪烁，状态正常。
3. 确认启动：接串口看登录提示，或者从局域网访问 FriendlyWrt 后台——默认地址192.168.2.1，账号root，密码password，页面能打开即点亮成功。

出错了怎么办

按症状对号入座，每条都是可以直接做的动作：

写入失败

• 重刷 Recovery 模式：断电、按住 Recovery 键再插 USB，确认设备重新出现后重试。
• 核对of后的设备名是否与lsblk输出一致；再换一个 USB 口或换一根线试试。

板子不启动 / 后台进不去

• 怀疑镜像不完整就重新下载固件，从头再写一遍。
• 核对固件版本与板子型号是否匹配，并重看 scripts/custome_config.sh 里为这个型号保留的配置。

设备识别不到

• 再跑一次lsblk确认设备是否出现；没出现就换线、换口。
• 分不清是哪个设备时：拔线跑一次lsblk，插线再跑一次，对比两次输出的差集，新增的那条就是目标。

点亮之后，第一时间登录后台改掉默认密码，这块板子就正式交付给你用了。

【免费下载链接】Actions-FriendlyWrtBuild FriendlyWrt using GitHub Actions项目地址: https://gitcode.com/GitHub_Trending/ac/Actions-FriendlyWrt