NixOS
社区移植
成品发行版
需要动手能力
先说结论
声明式配置很香，但 riscv64 属于“能跑、别指望省心”的状态。
- 基于
- 独立（Nix/nixpkgs，systemd）
- 上游状态
- nixpkgs 的 nixpkgs-unstable 与 stable channel 都没有官方 riscv64-linux 支持；官方 wiki 明确写“所有 RISC-V 平台目前都是实验性”，镜像由社区提供。
- 版本
- 26.05（官方仅 x86_64/aarch64） · unstable（riscv64 社区构建）
- 文档语言
- en
- 下游衍生
- nixos-riscv64（社区镜像集）、nixos-licheepi4a / nixos-vf2（板级 flake）
- 核查日期
- 2026-11-01
支持的开发板
- QEMU virt 虚拟机型 社区可用 可模拟，但 wiki 明确提示部分程序在 QEMU 下会 segfault
- SiFive HiFive Unmatched 社区可用 最早的社区移植目标（zhaofengli/nixos-riscv64）
- StarFive VisionFive 2 社区可用 JH7110，社区镜像 + misuzu/nixos-vf2 flake
- 荔枝派 4A（LicheePi 4A） 社区可用 ryan4yin/nixos-licheepi4a 社区 flake
下载
安装文档与视频
坑
- 没有官方 ISO，必须用社区镜像或自己 cross-compile
- 官方 cache.nixos.org 无 riscv64 包，需挂第三方 substituter（如 cache.ztier.in / beam.attic.rs），否则几乎全量本地编译
- QEMU 下运行不稳定（segfault）
- 社区镜像多绑定特定内核/固件版本，升级易炸
RuyiSDK 实测报告7
RuyiSDK 在真机上逐块板测过的记录，点开报告能看完整安装步骤与结论。
| 支持的开发板 | 状态 | 版本 | 最近测试 | 报告 |
|---|---|---|---|---|
| 荔枝派 4A（LicheePi 4A） | ◐ 基本可用 | 23.05 | 2025-03-04 | 查看报告 |
| Milk-V Mars | ◐ 基本可用 | 25.05 | 2025-04-18 | 查看报告 |
| Milk-V Duo 系列（Duo / Duo 256M / Duo S） | ◐ 基本可用 | — | 2025-01-27 | 查看报告 |
| Milk-V Duo 系列（Duo / Duo 256M / Duo S） | ◐ 基本可用 | — | 2025-01-27 | 查看报告 |
| Milk-V Duo 系列（Duo / Duo 256M / Duo S） | ◐ 基本可用 | — | 2025-04-14 | 查看报告 |
| Star64 | ✕ 启动失败 | — | 2025-05-29 | 查看报告 |
| StarFive VisionFive 2 | ◐ 基本可用 | — | 2024-12-22 | 查看报告 |
状态含义：good 完整可用（能进桌面）、basic 基本可用（串口能起来）、part 部分功能、cft 有镜像待验证、cfh 文档称支持但启动失败、cfi 官方称支持但无镜像、wip 只有宣称。
出处10
- nixos.org/download/
- github.com/zhaofengli/nixos-riscv64
- wiki.nixos.org/wiki/RISC-V
- matrix.ruyisdk.org/reports/LicheePi4A/NixOS/README/
- matrix.ruyisdk.org/reports/Mars/NixOS/README/
- matrix.ruyisdk.org/reports/Duo/NixOS/README/
- matrix.ruyisdk.org/reports/Duo256m/NixOS/README/
- matrix.ruyisdk.org/reports/Duo_S/NixOS/README/
- matrix.ruyisdk.org/reports/STAR64/NixOS/README/
- matrix.ruyisdk.org/
完整来源清单与判定方法见 来源与致谢