当前位置：首页 > news >正文

openEuler/raspberrypi-build参数详解：轻松定制树莓派镜像的终极指南

news 2026/7/12 0:25:39

openEuler/raspberrypi-build参数详解：轻松定制树莓派镜像的终极指南

【免费下载链接】raspberrypi-buildScripts of building images for Raspberry Pi项目地址: https://gitcode.com/openeuler/raspberrypi-build

前往项目官网免费下载：https://ar.openeuler.org/ar/

想要为树莓派打造专属的openEuler操作系统镜像吗？openEuler/raspberrypi-build项目正是您需要的终极工具！这个强大的脚本程序让树莓派镜像构建变得简单快捷，即使您是初学者也能轻松上手。本文将为您详细解析所有参数配置，带您掌握定制树莓派镜像的完整技巧。

🔧 核心参数深度解析

openEuler/raspberrypi-build提供了三个核心参数，让您完全掌控镜像构建过程。让我们逐一深入了解：

📁 输出目录参数：-d, --dir DIR

这是控制构建输出的关键参数！通过-d参数，您可以指定镜像和临时文件的存储位置。默认情况下，脚本会在当前目录运行，但您完全可以自定义：

sudo bash build-image.sh -d /home/user/raspberry_images -r "repo_url" -n openEuler-raspi.img

重要特性：

如果指定的目录不存在，脚本会自动创建
构建完成后，镜像默认保存在DIR/raspi_output/img/目录下
保持工作目录整洁，避免文件混乱

📦 软件源参数：-r, --repo REPO_INFO

这是必填参数，决定了系统从哪里获取软件包。openEuler/raspberrypi-build支持三种灵活的源配置方式：

方式一：repo文件路径

sudo bash build-image.sh -r ./openEuler-20.09.repo

方式二：repo文件URL

sudo bash build-image.sh -r "http://example.com/openEuler.repo"

方式三：baseurl列表（最常用）

sudo bash build-image.sh -r "http://repo1.example.com/ http://repo2.example.com/"

注意：使用baseurl列表时，必须用双引号包裹，各个URL之间用空格分隔！

🏷️ 镜像名称参数：-n, --name IMAGE_NAME

为您的镜像起个有意义的名字！-n参数让您自定义生成的镜像文件名：

sudo bash build-image.sh -n "openEuler-20.09-raspi-custom.img"

如果不指定此参数，默认会生成openEuler-raspi-aarch64.img文件。合理的命名有助于版本管理和识别。

🛠️ 配置文件详解

除了核心参数，openEuler/raspberrypi-build还提供了丰富的配置文件，让您深度定制系统：

系统配置目录：config/

这个目录包含了所有系统级的配置文件，是定制化镜像的灵魂所在：

config/chroot.sh- 系统初始化脚本
- 自动启用SSH服务（第2行）
- 设置时区为亚洲/上海（第8-13行）
- 配置root密码为"openeuler"（第7行）
config/extend-root.sh- 根分区扩展脚本
- 自动检测并扩展根分区到最大可用空间
- 只在首次启动时执行（第46行删除自身）
- 详细日志记录到/var/log/extend-root.log
config/config.txt- 树莓派固件配置
config/hosts- 主机名解析配置
config/ifcfg-eth0- 网络接口配置
config/rpmlist- 预装软件包列表

🚀 快速入门实战

基础构建命令

最简单的构建命令只需要指定软件源：

sudo bash build-image.sh -r "http://repo.openeuler.org/openEuler-20.09/standard_aarch64/"

完整定制示例

这是一个完整的定制化构建示例，展示了所有参数的组合使用：

sudo bash build-image.sh \ -d /opt/raspberrypi-build/output \ -r "http://repo1.openeuler.org/ http://repo2.openeuler.org/" \ -n "openEuler-20.09-raspi-server.img"

验证构建结果

构建完成后，您可以在输出目录找到生成的镜像：

/opt/raspberrypi-build/output/raspi_output/img/openEuler-20.09-raspi-server.img

💡 高级技巧与最佳实践

1. 软件包定制

编辑[config/rpmlist](https://link.gitcode.com/i/253ac61bda304177883ba5bcd0768fc7)文件，添加或删除您需要的软件包。每行一个包名，构建时会自动安装。

2. 网络配置优化

修改[config/ifcfg-eth0](https://link.gitcode.com/i/b4911abe397b194f1c5d28bfca4eae74)文件，预配置网络设置，让树莓派开机即联网。

3. 自动化构建脚本

创建自己的构建脚本，实现一键构建：

#!/bin/bash # auto-build.sh REPO_URLS="http://repo.openeuler.org/openEuler-20.09/standard_aarch64/" OUTPUT_DIR="/home/pi/images" IMAGE_NAME="openEuler-$(date +%Y%m%d)-raspi.img" sudo bash build-image.sh -d $OUTPUT_DIR -r "$REPO_URLS" -n $IMAGE_NAME