Milk-V Duo 刷机教程：写 microSD 卡与 USB 登录

先确认是 Duo（64M），不是 Duo 256M

Duo 256M 是 Duo 的内存升级版，两者芯片不同，镜像不能混用：

是 Duo 256M 的话，请看 Milk-V Duo 256M 刷机教程。Milk-V 文档里，Duo 的系统装在 microSD 卡上运行。

准备

• microSD 卡，1 GB 以上，加读卡器。
• 一根 USB Type-C 数据线：既给板子供电（5V 电源适配器或电脑 USB 口都行），也用来连电脑登录。
• 可选：USB 转 TTL 串口线，用来看启动日志。

下载哪个文件

打开 Milk-V Duo（64M）系统镜像页，下载 milkv-duo-sd-v<版本>.img.zip。

Milk-V 的官方镜像分 V1、V2 两代。V1 只支持 RISC-V 核，Milk-V 推荐 Duo（64M）用 V1，因为内存小，V2 里的 AI 应用在 Duo（64M）上跑不起来。本站收录的就是 V1 的 v1.1.4。下载后可以按 如何核对下载文件的 SHA-256 核对。

写入 microSD 卡

1. 打开 balenaEtcher，点“从文件烧录”，选下载的 .img.zip。
2. 点“选择目标”，选你的 microSD 卡。
3. 点“现在烧录”，等到显示完成。也可以用 Rufus 写入。
4. 把卡插进 Duo 的卡槽，用 Type-C 线接上 5V 电源或电脑。

应看到：板子上的蓝色 LED 开始闪烁，说明系统已经正常运行。

警告写入会清空整张卡。选目标时看清容量，别选成电脑上的硬盘。

第一次登录

Duo 的镜像默认开启了 SSH 和 USB 虚拟网卡（CDC-NCM），用 Type-C 线接电脑就能登录：

1. 用 Type-C 线把 Duo 接到电脑，等蓝灯开始闪烁。
2. 在电脑终端运行：

ssh root@192.168.42.1

1. 第一次连接提示时输入 yes，然后输入密码 milkv（输入时不显示）。

• Linux、macOS 和新版 Windows 不用装驱动。较旧的 Windows 在设备管理器里会看到带黄色感叹号的 CDC NCM 设备：右键选“更新驱动程序（Update Driver）” → “浏览我的电脑以查找驱动程序（Browse my computer for drivers）” → “让我从计算机上的可用驱动程序列表中选取（Let me pick from a list…）” → “网络适配器（Network Adapters）” → 厂商选 Microsoft、型号选 UsbNcm Host Device，忽略警告完成安装。
• 同一台电脑接多块 Duo 时，需要改板子上的 USB 网卡地址（/mnt/system/usb-ncm.sh 和 /etc/dnsmasq.conf），方法见 Milk-V 文档。
• 不想让蓝灯一直闪：运行 mv /mnt/system/blink.sh /mnt/system/blink.sh_backup && sync 后重启。

用满整张卡

写入后根分区不会自动占满整张卡（Milk-V 文档的例子里只有 752 MB）。Milk-V 给的扩容方法如下，先运行 fdisk -l 确认根分区是第 3 个分区 mmcblk0p3（Milk-V 例子里如此），再执行：

parted -s -a opt /dev/mmcblk0 "resizepart 3 100%"
resize2fs /dev/mmcblk0p3

运行 df -h 确认 /dev/root 已经变大。

刷坏了怎么救

• 蓝灯不闪：多半是卡没写好。换 balenaEtcher、Rufus 或 Win32DiskImager 重新写一次卡；还不行就接串口看启动日志。
• 想恢复出厂状态：Duo 的系统全部在 microSD 卡里，重新写一次卡就是全新系统。
• 用的是旧版镜像、电脑上看不到网卡：V1.1.2 之前的镜像用的是 RNDIS 而不是 CDC-NCM，换成本站的新版镜像。
• 串口接法：Duo 的 TX（16 脚）接 USB 转 TTL 的白线，RX（17 脚）接绿线，GND（18 脚）接黑线，红线不要接；串口电平 3.3V，参数 115200、8N1、无流控。见 用 USB 转 TTL 串口调试开发板。

资料来源

按 Milk-V 官方文档（Duo 介绍、Boot from microSD card、Set up the working environment、Resource Download Summary）和 Milk-V 在 GitHub 发布的 duo-buildroot-sdk v1.1.4 版本说明整理，2026-10-22 查阅。

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