nestos-installer命令行参考：所有子命令与参数详解

nestos-installer命令行参考：所有子命令与参数详解

【免费下载链接】nestos-installernestos-installer is a program to assist with installing nestos项目地址: https://gitcode.com/openeuler/nestos-installer

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

nestos-installer是一款专为NestOS设计的强大安装工具，它能够帮助用户轻松完成NestOS的安装、配置和管理工作。无论你是系统管理员、开发者还是普通用户，掌握nestos-installer的命令行使用技巧都能让你更高效地部署和管理NestOS系统。本文将为你提供完整的nestos-installer命令行参考指南，详细介绍所有子命令和参数的使用方法。

📋 核心功能介绍

nestos-installer主要提供以下五大功能模块：

1. 系统安装- 将NestOS安装到目标磁盘
2. 镜像下载- 下载并验证NestOS镜像文件
3. 流管理- 列出可用的NestOS流镜像
4. ISO镜像管理- 定制和管理NestOS Live ISO镜像
5. PXE启动管理- 配置和管理PXE网络启动环境

每个功能都包含多个子命令，让我们逐一深入了解。

🚀 安装命令详解

nestos-installer install- 安装NestOS系统

这是最常用的命令，用于将NestOS安装到目标磁盘。

基本用法：

nestos-installer install /dev/sda

主要参数说明：

参数	说明	示例
-s, --stream <name>	指定NestOS流（stable/testing/next）	-s stable
-i, --ignition-file <path>	嵌入Ignition配置文件	-i config.ign
-a, --architecture <name>	目标CPU架构	-a x86_64
-p, --platform <name>	覆盖Ignition平台ID	-p vmware
-n, --copy-network	复制网络配置	-n
--append-karg <arg>	添加内核参数	--append-karg "console=ttyS0"

高级配置示例：

nestos-installer install \ -s stable \ -i ignition.json \ --append-karg "console=ttyS0,115200n8" \ --copy-network \ /dev/nvme0n1

📥 下载命令详解

nestos-installer download- 下载NestOS镜像

这个命令用于下载各种平台的NestOS镜像文件。

常用示例：

# 下载稳定版x86_64架构的metal平台镜像 nestos-installer download -s stable -a x86_64 -p metal # 下载并解压缩镜像 nestos-installer download -d -C /tmp # 指定镜像格式和存储目录 nestos-installer download -f raw.xz -C ~/downloads

参数速查表：

参数	默认值	描述
-s, --stream	stable	NestOS流名称
-a, --architecture	x86_64	目标CPU架构
-p, --platform	metal	平台名称
-f, --format	raw.xz	镜像格式
-C, --directory	.	目标目录

🔍 流管理命令

nestos-installer list-stream- 列出可用镜像

查看指定NestOS流中可用的所有镜像。

使用示例：

# 列出稳定流中的可用镜像 nestos-installer list-stream -s stable # 使用自定义流元数据URL nestos-installer list-stream --stream-base-url https://custom.example.com

📀 ISO镜像管理命令

ISO管理是nestos-installer的重要功能，提供了丰富的子命令来定制Live ISO镜像。

nestos-installer iso customize- 定制ISO镜像

这个功能强大的命令可以一次性完成多种定制操作：

nestos-installer iso customize \ --dest-ignition config.ign \ --dest-device /dev/sda \ --network-keyfile eth0.nmconnection \ input.iso -o customized.iso

ISO Ignition管理子命令

子命令	功能	示例
iso ignition embed	嵌入Ignition配置	iso ignition embed -i config.ign input.iso
iso ignition show	显示嵌入的配置	iso ignition show input.iso
iso ignition remove	移除配置	iso ignition remove input.iso -o clean.iso

ISO网络配置管理

# 嵌入网络配置 nestos-installer iso network embed -k eth0.nmconnection input.iso # 提取网络配置 nestos-installer iso network extract input.iso -C ./network # 移除网络配置 nestos-installer iso network remove input.iso -o clean.iso

ISO内核参数管理

# 修改内核参数 nestos-installer iso kargs modify \ -a "console=ttyS0" \ -d "quiet" \ input.iso -o modified.iso # 重置内核参数 nestos-installer iso kargs reset input.iso -o reset.iso # 显示内核参数 nestos-installer iso kargs show input.iso

🌐 PXE启动管理命令

nestos-installer pxe customize- 定制PXE启动

创建自定义的PXE启动配置：

nestos-installer pxe customize \ --dest-ignition config.ign \ --dest-device /dev/sda \ --output custom-initrd.img \ initramfs.img

PXE Ignition包装命令

# 包装Ignition配置到initrd nestos-installer pxe ignition wrap -i config.ign -o ignition.img # 解包查看Ignition配置 nestos-installer pxe ignition unwrap ignition.img

PXE网络配置包装

# 包装网络配置 nestos-installer pxe network wrap -k eth0.nmconnection -o network.img # 解包网络配置 nestos-installer pxe network unwrap network.img -C ./extracted

⚙️ 配置文件使用技巧

nestos-installer支持YAML配置文件，可以简化复杂的安装配置：

示例配置文件：install-config.yaml

stream: stable architecture: x86_64 platform: metal ignition-file: /path/to/config.ign append-karg: - "console=ttyS0,115200n8" - "ip=dhcp" copy-network: true dest-device: /dev/sda

使用配置文件安装：

nestos-installer install -c install-config.yaml

💡 实用技巧与最佳实践

1.批量安装配置

使用配置文件可以轻松实现批量部署，确保所有系统配置一致。

2.安全验证

始终验证镜像签名，除非在受信任的环境中：

# 安全下载（默认验证签名） nestos-installer download -s stable # 不安全模式（仅用于测试） nestos-installer download --insecure

3.网络安装优化

对于无网络环境，可以预先下载镜像：

# 下载镜像到本地 nestos-installer download -C /mnt/nestos # 离线安装 nestos-installer install -f /mnt/nestos/nestos-metal.x86_64.raw.xz /dev/sda

4.错误处理

安装失败时保留分区表用于调试：

nestos-installer install --preserve-on-error /dev/sda

🔧 高级功能探索

保留特定分区

在安装时保留现有数据分区：

nestos-installer install \ --save-partlabel "data*" \ --save-partindex "5-" \ /dev/sda

自定义控制台配置

为串口控制台配置内核参数：

nestos-installer install \ --console "ttyS0,115200n8" \ --append-karg "console=ttyS0,115200n8" \ /dev/sda

📊 命令速查表

主要命令	功能描述	常用场景
install	安装NestOS	系统部署
download	下载镜像	镜像准备
list-stream	列出镜像	版本选择
iso customize	定制ISO	自动化安装
iso ignition	Ignition管理	配置注入
iso network	网络配置	网络预配
iso kargs	内核参数	启动优化
pxe customize	PXE定制	网络启动

🎯 总结

nestos-installer是一个功能全面且强大的NestOS安装工具，通过掌握这些命令行参数，你可以：

1. 快速部署- 使用简洁的命令完成系统安装
2. 灵活定制- 根据需求定制ISO和PXE镜像
3. 批量管理- 通过配置文件实现一致性部署
4. 安全验证- 确保镜像和配置的完整性

无论你是需要部署单台服务器还是大规模集群，nestos-installer都能提供高效可靠的解决方案。记住使用--help参数可以随时查看每个命令的详细帮助信息！

官方文档参考：docs/cmd.md、docs/cmd/install.md、docs/cmd/iso.md

现在你已经掌握了nestos-installer的所有核心命令，可以开始你的NestOS部署之旅了！🚀

【免费下载链接】nestos-installernestos-installer is a program to assist with installing nestos项目地址: https://gitcode.com/openeuler/nestos-installer