Gentoo 安装不再劝退：用 gentoo-install 图形化向导 30 分钟装好系统

Gentoo 安装不再劝退：用 gentoo-install 图形化向导 30 分钟装好系统

【免费下载链接】gentoo-installA gentoo installer with a TUI interface that supports systemd and OpenRC, EFI and BIOS, as well as variable disk layouts using ext4, zfs, btrfs, luks and mdraid.项目地址: https://gitcode.com/gh_mirrors/ge/gentoo-install

你是否也曾因为听说"Gentoo 万物皆可编译"而心动，却在打开官方手册、看到几十个步骤后默默关掉了浏览器？分区、stage3、内核、引导、网络……每一步都像一场小考试，稍有不慎就前功尽弃。如果你正卡在这一步，那么gentoo-install这款带 TUI 图形配置界面的 Gentoo 安装工具，可能就是把你从"劝退边缘"拉回来的那个救星。它把系统d/OpenRC 选择、EFI/BIOS 启动、ext4/ZFS/btrfs 磁盘方案、LUKS 加密和 mdraid 软 RAID 全部封装成一套可复现的安装流程，让新手也能轻松完成 Gentoo 安装配置。

为什么说它是新手友好的 Gentoo 安装工具

手工安装 Gentoo，就像照着菜谱从零做一桌满汉全席——练手艺没错，但累是真的累。而 gentoo-install 更像是一位熟悉后厨的大厨配上自动炒菜机：它把官方手册里的最佳实践固化成一条流水线，你只需要在向导里点选，剩下的事交给脚本。

它尤其适合两类人：

• 想尝尝 Gentoo 滋味的新手：不想一开始就投入大量时间，也还没做好完全"入坑"的心理准备；
• 经验丰富的老玩家：想要一次自动、可重复、遵循最佳实践的安装，而不是每次重装都手工敲几十条命令。

项目支持的能力覆盖了绝大多数装机场景：systemd 和 OpenRC两套 init 系统、EFI 和 BIOS两种引导方式、ext4 / ZFS / btrfs三种现代文件系统，还能叠加LUKS 磁盘加密与mdraid 软 RAID（RAID0 提速、RAID1 冗余）。换句话说，从一台普通笔记本到多块 NVMe 的服务器，它都能接得住。

三步快速安装：克隆、配置、开跑

假设你现在面对的是一台空白机器或虚拟机，整个流程只有三步。建议使用 Arch Linux 的 live ISO 作为临时环境，因为安装器在 Live 环境里能自动下载依赖、并在现场准备 ZFS 支持。

第一步：联网并获取项目

pacman -Sy git # 在 live 环境里安装 git git clone https://gitcode.com/gh_mirrors/ge/gentoo-install cd gentoo-install

预期效果：当前目录下多出gentoo-install文件夹，里面有install、configure两个入口脚本和scripts/目录。

第二步：用图形化向导做初始化配置

./configure # 打开 TUI 配置菜单，逐项设置后保存为 gentoo.conf

预期效果：屏幕上弹出类似内核 menuconfig 风格的分层菜单，从上到下依次是分区方案、引导类型、swap、文件系统、主机名、时区、镜像、init 系统、SSH 等选项，每个选项都能按<Help>查看说明。确认无误后保存退出。

第三步：开始正式安装

sudo ./install # 必须以 root 运行，开始安装

预期效果：脚本按顺序执行——分区 → 下载并做密码学校验 stage3 → 配置 Portage → 设置基础系统 → 安装内核 → 生成 initramfs → 写入引导项 → 设置 root 密码。其中分区会在执行任何关键操作前让你复核一遍；之后基本无需人工盯守。

一个贴心的小细节：如果你直接运行./install而仓库里还没有gentoo.conf，它不会傻傻报错，而是自动帮你拉起配置向导，等你保存后再继续。

常见安装场景的配置技巧

gentoo.conf本质是一份会被 bash 解释的脚本，每个选项在gentoo.conf.example里都有详细注释。下面按几个最常见的场景，直接给出可用的示例。

场景一：单块硬盘，经典布局 + LUKS 加密

这是最熟悉、最稳妥的方案：一个 boot 分区、一个 swap、一个加密 root，根文件系统用 ext4：

function disk_configuration() { create_classic_single_disk_layout swap=8GiB type=efi luks=true root_fs=ext4 /dev/sdX }

场景二：想要现代文件系统 ZFS

如果你想要透明压缩、秒级快照和全盘加密，ZFS 几乎是当下最省心的选择：

create_zfs_centric_layout type=efi swap=8GiB encrypt=true compress=zstd /dev/sdX

场景三：多块 NVMe 提速或冗余

两块盘组 RAID0 提升读写速度，或组 RAID1 保证数据安全：

create_raid0_luks_layout swap=4GiB type=efi root_fs=ext4 /dev/sd{X,Y} # RAID0 提速 create_raid1_luks_layout swap=4GiB type=efi root_fs=ext4 /dev/sd{X,Y} # RAID1 冗余

场景四：装完直接用 SSH 远程管理

ENABLE_SSHD=true ROOT_SSH_AUTHORIZED_KEYS="ssh-ed25519 AAAA...你的公钥"

ENABLE_SSHD会部署一份默认只允许 ed25519 公钥登录、禁用密码认证的安全 sshd 配置，装完系统就能无缝接上你的自动化工具继续折腾。

场景五：在 systemd 和 OpenRC 之间做选择

STAGE3_VARIANT="systemd" # 或 "openrc" KERNEL_TYPE=bin # bin=二进制内核，source=本地编译

顺带一提，系统默认使用 Gentoo 的二进制内核gentoo-kernel-bin配合 dracut 生成的 initramfs，保证在常见硬件上都能启动；想要极致定制再切换到源码编译即可。

新手避坑指南：常见报错解决办法

1../install一上来就报 "You have not properly read the config"

• 症状：还没开始分区就被拒绝。
• 原因：项目强制你通读配置，避免误操作。
• 解决：编辑gentoo.conf，把I_HAVE_READ_AND_EDITED_THE_CONFIG_PROPERLY改为true。

2. 分区后 blkid 找不到 UUID

• 症状：脚本报 "blkid not being able to find a UUID"。
• 原因：磁盘上残留了旧文件系统签名，ZFS 的签名尤其容易和其他签名共存，导致 blkid 读到冲突信息。
• 解决：开始前用wipefs -a <设备>彻底擦干净磁盘，并确保所有分区都已卸载、没有被占用。

3. chroot 里装 ZFS 报内核版本不支持

• 症状：ZFS 模块因内核版本太新/太旧而安装失败。
• 原因：最新稳定版 ZFS 模块要求的内核比 Gentoo stable 提供的更新。
• 解决：在失败提示处按S进入紧急 shell，写入echo 'ACCEPT_KEYWORDS="~amd64"' >> /etc/portage/make.conf，重新emerge -v gentoo-kernel-bin，退出后选择 retry 继续。

4. LUKS 密码明明对了却解不开

• 症状：重启后输入口令一直无法解锁。
• 原因：口令里带了换行符，initramfs 从 stdin 读取时被截断。
• 解决：使用不含换行的长口令，或者在运行./install前用export GENTOO_INSTALL_ENCRYPTION_KEY="my strong passphrase"传递。

5. 配置明明存在却提示找不到

• 症状：用-c指定了仓库外的配置文件被拒绝。
• 原因：配置文件必须在安装目录内部，否则进入 chroot 后访问不到。
• 解决：把gentoo.conf放到克隆下来的仓库根目录，再用默认方式加载。

安装完成之后，这只是开始

到这一步，你已经拥有一个最小可用的 Gentoo 系统——这正是这个项目刻意为之的边界：只负责把系统装到"按最佳实践可用"的程度，剩下的交给你自由发挥。这也是它最打动人的地方：既有向导的省心，又保留了极客的自由度，把最痛苦的装配环节自动化，把最有趣的调教环节留给你。

接下来的进阶路线也帮你规划好了：

• 用eselect news read阅读 Gentoo 新闻；
• 把KERNEL_TYPE从二进制内核切换到源码版，逐步定制属于自己的内核；
• 优化/etc/portage/make.conf，借助resolve-march-native和cpuid2cpuflags让编译真正"为你的 CPU 而生"；
• 万一之后系统出了状况，随时可以挂载好磁盘后运行./install --chroot /mnt进入 chroot 救急；
• 如果还想更深入理解每一步在做什么，官方 Gentoo AMD64 Handbook 和 Sakaki 的 EFI 安装指南都是极好的下一站。

装 Gentoo 从来不是一件容易的事，但有了 gentoo-install，它至少可以不再是一件劝退的事。动手试试吧，那个"万物皆可编译"的世界，离你只差三行命令的距离。

【免费下载链接】gentoo-installA gentoo installer with a TUI interface that supports systemd and OpenRC, EFI and BIOS, as well as variable disk layouts using ext4, zfs, btrfs, luks and mdraid.项目地址: https://gitcode.com/gh_mirrors/ge/gentoo-install