Milk-V Jupiter 刷机教程:microSD 卡、eMMC 与 SSD 安装 Bianbu
Milk-V Jupiter 装系统:分清 .img.zip 和 .zip 镜像,写 microSD 卡并手动扩容,用 titanflasher 刷 eMMC 或 SSD,附 root 密码、NAS 版登录和启动顺序。约 20 分钟。
适用于Milk-V Jupiter 官方系统镜像
先确认是 Milk-V Jupiter
Milk-V Jupiter 是一块 Mini-ITX 尺寸的 RISC-V 主板,芯片是进迭时空(SpacemiT)K1/M1,带 24 针 ATX 电源接口和机箱前面板(F_PANEL)接口。镜像文件名以 milkv-jupiter- 开头,不能和 Milk-V 其他板子的镜像混用。
Jupiter 可以从三种存储启动,优先级是:microSD 卡 > SSD(M.2 NVMe)> eMMC。
准备
- 电源任选一种:5.5×2.5mm 圆口 DC 12V/3A 以上、USB Type-C PD 电源、电脑 ATX 24 针电源,或网口 PoE(要另配 PoE 模块)。接上电源会自动开机,不用按电源键。
- microSD 卡和读卡器。
- HDMI 显示器,或 USB 转 TTL 串口线:只有用 ATX 电源时板上的蓝色电源灯才会亮,其他供电方式下板子没有电源指示灯,要靠显示器或串口确认是否开机。
下载哪个文件
打开 Milk-V Jupiter 系统镜像页。Milk-V 的镜像分两种格式,本站收录的都是第一种:
| 文件后缀 | 用途 | 本站 |
|---|---|---|
.img.zip | 只用于 microSD 卡 | 已收录 |
.zip(不带 .img) | 用 titanflasher 刷进 eMMC 或 SSD | 本站暂未收录 |
本站的 microSD 卡镜像:
| 文件名 | 系统 |
|---|---|
milkv-jupiter-bianbu-24.04-minimal-k1-v<版本>-release-<日期>.img.zip | Bianbu 24.04 精简版(命令行,无桌面) |
milkv-jupiter-bianbu-24.04-nas-k1-v<版本>-release-<日期>.img.zip | Bianbu 24.04 NAS 版(内置 OpenMediaVault) |
milkv-jupiter-ubuntu-23.10-desktop-k1-v<版本>-release-<日期>.img.zip | Ubuntu 23.10 桌面版 |
Bianbu 是进迭时空为 RISC-V 优化的系统,基于 Ubuntu。要命令行选精简版,做 NAS 选 NAS 版,要桌面选 Ubuntu 23.10。Bianbu 桌面版的镜像超过 2 GB,Milk-V 分成 .001、.002 两个分卷发布,本站暂未收录。下载后可以按 如何核对下载文件的 SHA-256 核对。
方法一:写进 microSD 卡
- 打开 balenaEtcher,点“从文件烧录”,直接选
.img.zip(balenaEtcher 能读 zip,不用先解压;其他工具可能要先用 7-Zip 解压成.img)。 - 点“选择目标”选 microSD 卡,再点“现在烧录”。
- 把卡插进 Jupiter,接上显示器或串口,再接通电源。microSD 卡启动优先级最高,即使 eMMC 或 SSD 里有系统,也会从卡启动。
警告写入会清空整张卡。选目标时看清容量。
写卡后扩容
Milk-V 说明 microSD 卡系统启动后不会自动扩容,不扩容会提示空间不足,甚至重启后进不了桌面。Milk-V 以图形界面的 gparted 为例(适合 Ubuntu 23.10 桌面版);精简版和 NAS 版没有桌面,Milk-V 只说可以改用你熟悉的其他分区工具,没有给出具体命令。gparted 的做法:
sudo apt update
sudo apt install gparted
sudo gparted在右上角选 microSD 卡,右键根分区 / 选 Resize/Move,把大小设为至少 16 GB(填 16384),或把 Free space following 设为 0 用满整张卡,点 Resize,再点工具栏的对勾,弹窗里选 Apply。eMMC 和 SSD 上的系统会自动扩容,不用做这一步。
方法二:刷进 eMMC 或 SSD
需要 Milk-V 的 .zip 格式镜像和进迭时空的 titanflasher 工具(Windows x64 和 Linux 版),两者本站暂未收录,从文末“官方资料”进入 Milk-V 页面获取。zip 包不用解压。
- 用 Type-C 线把 Jupiter 的 Type-C 口接到电脑。
- 按住板上的 RECOVERY 键(或短接 RECOVERY 针脚),再给 Jupiter 上电,进入 USB 刷机模式。
- 打开 titanflasher,选 Dev Tools,再选 USB Download。
- 点 Scan Devices,选中识别到的
dfu-device。 - 点 Select Zip File 选
.zip镜像,工具会先解压,等一会儿。需要刷完自动重启就勾选 Reboot After Flashing。 - 点 Start Flashing。
应看到:进度显示 100% 完成。断电再上电即可进入系统。
注意刷写顺序和启动顺序一样,SSD 和 eMMC 都在时会刷进 SSD;两者都没有时只把 u-boot 写进 SPI 闪存。
第一次开机和登录
- Bianbu 和 Ubuntu 23.10:
root账号的默认密码是milkv。 - Bianbu NAS 版:在串口里运行
ip a,或在路由器后台查到 Jupiter 的 IP,用浏览器打开这个 IP 进入 OpenMediaVault,管理员账号admin,密码openmediavault。
刷坏了怎么救
- eMMC 或 SSD 里的系统起不来:做一张 microSD 卡插上。卡的启动优先级最高,microSD 卡上的系统自带全部引导程序,不经过 SPI 闪存。
- 重新刷 eMMC 或 SSD:按住 RECOVERY 上电进入 USB 刷机模式,按方法二再刷一次。
- 短接了 eMMC 跳线:短接后板载 SPI 闪存会被禁用,刷 eMMC 时也要保持短接,并把引导程序一起刷进 eMMC。平时不需要短接它。
- 想看启动日志:USB 转 TTL 串口接板上调试口的 GND、RX、TX(RX 接串口线的 TX 绿线,TX 接 RX 白线),红线不要接;电平 3.3V,参数 115200、8N1、无流控。见 用 USB 转 TTL 串口调试开发板。
资料来源
按 Milk-V 官方文档(Jupiter Install OS Image、Common Settings、Hardware、Resource Download Summary)和 Milk-V 在 GitHub 发布的 jupiter-bianbu-build v2.1.1、jupiter-ubuntu-build v1.0.9 版本说明整理,2026-10-22 查阅。
提示本页按厂商官方文档整理,本站没有在实机上测试。按键、跳线位置和文件名以你的板子和 Milk-V 官方说明为准。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证