AppGoBox

教程

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.zipBianbu 24.04 精简版(命令行,无桌面)
milkv-jupiter-bianbu-24.04-nas-k1-v<版本>-release-<日期>.img.zipBianbu 24.04 NAS 版(内置 OpenMediaVault)
milkv-jupiter-ubuntu-23.10-desktop-k1-v<版本>-release-<日期>.img.zipUbuntu 23.10 桌面版

Bianbu 是进迭时空为 RISC-V 优化的系统,基于 Ubuntu。要命令行选精简版,做 NAS 选 NAS 版,要桌面选 Ubuntu 23.10。Bianbu 桌面版的镜像超过 2 GB,Milk-V 分成 .001、.002 两个分卷发布,本站暂未收录。下载后可以按 如何核对下载文件的 SHA-256 核对。

方法一:写进 microSD 卡

  1. 打开 balenaEtcher,点“从文件烧录”,直接选 .img.zip(balenaEtcher 能读 zip,不用先解压;其他工具可能要先用 7-Zip 解压成 .img)。
  2. 点“选择目标”选 microSD 卡,再点“现在烧录”。
  3. 把卡插进 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 包不用解压。

  1. 用 Type-C 线把 Jupiter 的 Type-C 口接到电脑。
  2. 按住板上的 RECOVERY 键(或短接 RECOVERY 针脚),再给 Jupiter 上电,进入 USB 刷机模式。
  3. 打开 titanflasher,选 Dev Tools,再选 USB Download。
  4. 点 Scan Devices,选中识别到的 dfu-device。
  5. 点 Select Zip File 选 .zip 镜像,工具会先解压,等一会儿。需要刷完自动重启就勾选 Reboot After Flashing。
  6. 点 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 官方说明为准。

适用的固件与系统镜像(1)

按适用范围匹配到 1 个固件条目。下载前仍需核对具体型号和硬件版本。

整理:AppGoBox · 依据 · 本站未在实机上逐一验证