香蕉派 BPI-R4 刷机教程：SW3 启动开关、TF 卡与 NAND、eMMC 刷 OpenWrt

先确认型号

本页只适用于香蕉派 Banana Pi BPI-R4（MediaTek MT7988A，板载 8 GB eMMC 和 128 MB SPI-NAND，2 个 10G SFP 口、4 个千兆网口）。名字相近的 BPI-R4 Pro、BPI-R4 Lite、BPI-R4 Mini 是不同的板子，不能用本页的文件。

BPI-R4 按内存和 PoE 分成几种版本，用同一套系统文件：

分不清内存大小时，香蕉派的说明是：4 GB 板的内存芯片是三星（Samsung），8 GB 板是 TAIXIN；系统里运行 free -h 也能看到。

准备

• 电源：DC 12V 适配器。香蕉派说明裸板功耗不超过 10W，最低用 12V/2A；接了 Wi-Fi 网卡、5G 模块、硬盘等配件要换更大功率的（规格表列的是 12V/5.2A 或 19V/3.2A）。
• TF（microSD）卡：8 GB 以上，一台电脑和读卡器。
• 建议准备 USB 转 TTL 串口线（3.3V，波特率 115200），启动不了时能看到日志。
• 网线一根。

下载哪个文件

打开 香蕉派 BPI-R4 官方镜像页：

文件是未压缩的 .img，不用解压。香蕉派没有公布这个文件的校验值，页面上的 SHA-256 是本站从官方渠道获取时计算的，下载后照样核对，方法见 如何核对下载文件的 SHA-256。

注意香蕉派标注过另一个更早的 MP4.1 版本（20240318）只能用于 8 GB 内存版，不能用在 4 GB 版上；本站这个 20241216 版香蕉派没有标注内存限制，用 4 GB 版时如果起不来，请看文末“官方资料”里香蕉派的最新说明。

写入板载 NAND 或 eMMC 要用另外的 NAND、EMMC 镜像和 bl2_emmc-r4.img，本站暂未收录，从文末“官方资料”进入香蕉派 BPI-R4 页面获取。

先认识启动开关 SW3

BPI-R4 从哪里启动由板上的拨码开关 SW3（A、B 两位）决定，改之前先断电：

开关上哪一边是“1”，以板上丝印为准。串口日志里出现 System halt!，说明开关选中的存储里没有系统。

方法一：从 TF 卡启动（本站文件）

1. 先把 TF 卡彻底清空。香蕉派特别提醒：要做低级格式化，不能只做“快速格式化”，否则启动时可能出现 jffs2 错误。Linux 电脑可以用 dd 往整张卡写零。
2. 打开 balenaEtcher，点“从文件烧录（Flash from file）”选 mtk-bpi-r4-MP4_1-SD-20241216.img，点“选择目标（Select target）”选你的 TF 卡，再点“现在烧录（Flash!）”。
3. 断电，把 SW3 两位都拨到“1”（TF 卡启动），插卡，接上电源。

应看到：板子右上角的 PWR 灯亮起；接了串口的话能看到启动日志。

警告写入会清空整张卡，选目标时看清容量。

方法二：写进 NAND 或 eMMC（需要厂商另外的镜像）

香蕉派的做法是在板子上用命令写入，需要一个 U 盘放镜像：

• 写 NAND：先按方法一从 TF 卡启动，插上放着 NAND 镜像的 U 盘，挂载后运行：

mount -t vfat /dev/sda1 /mnt
cd /mnt
mtd erase /dev/mtd0
dd if=mtk-bpi-r4-NAND-日期.img of=/dev/mtdblock0

断电，拔掉 U 盘，把 SW3 拨到 NAND 启动（A=0，B=1）。

• 写 eMMC：TF 卡和 eMMC 共用同一个控制器，所以要先从 NAND 启动（不是从 TF 卡），再把 U 盘里的 eMMC 镜像（压缩的要先解压）写进去：

mount -t vfat /dev/sda1 /mnt
cd /mnt
echo 0 > /sys/block/mmcblk0boot0/force_ro
dd if=bl2_emmc-r4.img of=/dev/mmcblk0boot0
dd if=mtk-bpi-r4-EMMC-日期.img of=/dev/mmcblk0
mmc bootpart enable 1 1 /dev/mmcblk0

断电，拔掉 U 盘，把 SW3 拨到 eMMC 启动（A=1，B=0）。

警告mtd erase 和 dd 会直接覆盖板载存储。文件名里的“日期”要换成你实际下载的文件名，U 盘的设备名以 ls /dev/sd* 看到的为准。

第一次开机：怎么登录

1. 电脑网线接 LAN 口，网卡设为自动获取地址。
2. 浏览器打开 外部资料（请使用来源按钮访问） SSH 登录 root@192.168.1.1。香蕉派说明这个 MP4.1 镜像的用户名是 root`，没有密码；登录后请马上设置密码。
3. 网口分工：香蕉派的说明里，WAN 是 lan0 网口和一个 SFP 口（eth2），其余的 lan1～lan3 网口和另一个 SFP 口（eth1）是 LAN。哪个物理网口对应 lan0，以板上丝印和香蕉派说明为准。
4. 装了 BE14 Wi-Fi 7 网卡时，无线名称是 AP_MTK_MT7990_2G、AP_MTK_MT7990_5G、AP_MTK_MT7990_6G。网卡不工作时，先确认板上开关 SW4 拨在 ON，这样主板才会给网卡供 12V 电。

警告SW4 拨到 ON 后，miniPCIe 插槽会带 12V 电。香蕉派提醒：插的是其他模块、又不确定它能不能承受 12V 时，一定要把 SW4 拨到 OFF。

刷坏了怎么救

• 起不来：先检查 SW3 是否拨对、PWR 灯是否亮；重新插拔 TF 卡；把卡低级格式化后重新写一次镜像。
• NAND 里的系统坏了：拨到 TF 卡启动，按方法二重新写 NAND。
• eMMC 里的系统坏了：拨到 NAND 启动，按方法二重新写 eMMC。出厂时 NAND 里就有系统，所以只要 NAND 没被改过，拨到 NAND 就能先开机。
• 只想恢复默认设置：网页里执行重置（Perform reset），或在终端运行 firstboot -y && reboot。
• 看启动日志：串口线 GND 接 GND，板子的 RX 接串口线 TX，板子的 TX 接串口线 RX，波特率 115200。见 用 USB 转 TTL 串口调试开发板。

常见问题

• 用过 TF 卡上的 Ubuntu 或 Debian（6.1 内核）后 NAND 起不来：香蕉派说明这是已知现象，需要重新写一次 NAND。本站的 OpenWrt 文件不属于这种情况。
• MAC 地址每次开机都变：香蕉派发布的镜像每次启动使用随机 MAC 地址，不读取板载 EEPROM。

资料来源

按香蕉派 Banana Pi 官方文档（BPI-R4 产品页、BPI-R4 入门指南、BPI-R4 常见问题）整理（2026-10-22 查阅）。本站文件为香蕉派发布的 MP4.1 TF 卡镜像（20241216 版），厂商未公布校验值。

提示本页按厂商官方文档整理，本站没有在实机上测试。开关位置、网口顺序和默认密码以你的板子和香蕉派官方说明为准。