Gentoo Linux 安装指南（基础篇）

ISO_DIR=https://distfiles.gentoo.org/releases/amd64/autobuilds/current-install-amd64-minimal
ISO=$(wget -qO- "$ISO_DIR/latest-install-amd64-minimal.txt" | grep -E '^install-amd64-minimal-[0-9]{8}T[0-9]{6}Z[.]iso ' | cut -d' ' -f1)
test -n "$ISO" || exit 1
wget "$ISO_DIR/$ISO" "$ISO_DIR/$ISO.asc"

# 导入 Gentoo 官方发布签名公钥。
# 推荐方式：使用 Live media 或 sec-keys/openpgp-keys-gentoo-release 提供的本地副本
gpg --import /usr/share/openpgp-keys/gentoo-release.asc
# 备用方式：autobuild 由每周自动发布密钥签名；没有本地副本时，从 keyserver 获取：
#   gpg --keyserver hkps://keys.gentoo.org --recv-keys 13EBBDBEDE7A12775DFDB1BABB572E0E2D182910

# 验证 ISO 文件的数字签名
gpg --verify "$ISO.asc" "$ISO"
# "$ISO.asc"：签名文件（ASCII armored）
# "$ISO"：待验证的 ISO 文件

sudo dd if="$ISO" of=/dev/sdX bs=4M status=progress oflag=sync
# if=输入文件 of=输出设备 bs=块大小 status=显示进度

nmtui   # 交互式：选择「Activate a connection」或「Edit a connection」

ping -c3 gentoo.org

ip link              # 查看网卡接口名称 (如 eno1, wlan0)
dhcpcd eno1          # 对有线网卡启用 DHCP 自动获取 IP
ping -c3 gentoo.org  # 测试网络连通性

net-setup

wpa_passphrase "SSID" "PASSWORD" | tee /etc/wpa_supplicant/wpa_supplicant.conf
wpa_supplicant -B -i wlp0s20f3 -c /etc/wpa_supplicant/wpa_supplicant.conf
dhcpcd wlp0s20f3

cfdisk /dev/nvme0n1

                                                                 Disk: /dev/nvme0n1
                                              Size: 931.51 GiB, 1000204886016 bytes, 1953525168 sectors
                                            Label: gpt, identifier: 9737D323-129E-4B5F-9049-8080EDD29C02

    设备                                       Start                   终点                  扇区               Size 类型
    /dev/nvme0n1p1                                34                  32767                 32734                16M Microsoft reserved
    /dev/nvme0n1p2                             32768              879779839             879747072             419.5G Microsoft basic data
    /dev/nvme0n1p3                        1416650752             1418747903               2097152                 1G EFI System
    /dev/nvme0n1p4                        1418747904             1437622271              18874368                 9G Linux swap
    /dev/nvme0n1p5                        1437622272             1953523711             515901440               246G Linux filesystem
>>  /dev/nvme0n1p6                         879779840             1416650751             536870912               256G Linux filesystem

 ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
 │  Partition UUID: F2F1EF58-82EA-46A6-BF49-896AA40C6060                                                                                           │
 │  Partition type: Linux filesystem (0FC63DAF-8483-4772-8E79-3D69D8477DE4)                                                                        │
 │ Filesystem UUID: b4b0b42d-20be-4cf8-be81-9775efa6c151                                                                                           │
 │Filesystem LABEL: crypthomevar                                                                                                                   │
 │      Filesystem: crypto_LUKS                                                                                                                    │
 └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
                                   [ 删除 ]  [Resize]  [ 退出 ]  [ 类型 ]  [ 帮助 ]  [ 排序 ]  [ 写入 ]  [ 导出 ]


                                                        Quit program without writing changes

mkfs.fat -F 32 /dev/nvme0n1p1  # 格式化 ESP 分区为 FAT32
mkswap /dev/nvme0n1p2          # 格式化 Swap 分区
mkfs.xfs /dev/nvme0n1p3        # 格式化 Root 分区为 XFS

mkfs.btrfs -L gentoo /dev/nvme0n1p3

mkfs.ext4 /dev/nvme0n1p3

mount /dev/nvme0n1p3 /mnt/gentoo        # 挂载根分区
mkdir -p /mnt/gentoo/efi                # 创建 ESP 挂载点
mount /dev/nvme0n1p1 /mnt/gentoo/efi    # 挂载 ESP 分区
swapon /dev/nvme0n1p2                   # 启用 Swap 分区

cd /mnt/gentoo
# OpenRC：
BASE=https://distfiles.gentoo.org/releases/amd64/autobuilds
STAGE3=$(wget -qO- "$BASE/latest-stage3-amd64-openrc.txt" | grep -E '^[0-9]{8}T[0-9]{6}Z/stage3-amd64-openrc-[0-9]{8}T[0-9]{6}Z[.]tar[.]xz ' | cut -d' ' -f1)
# systemd：将上一行中的两个 openrc 替换为 systemd。
test -n "$STAGE3" || exit 1
wget "$BASE/$STAGE3"
wget "$BASE/$STAGE3.asc"
gpg --verify "${STAGE3##*/}.asc" "${STAGE3##*/}"
tar xpvf "${STAGE3##*/}" --xattrs-include='*.*' --numeric-owner

cp --dereference /etc/resolv.conf /mnt/gentoo/etc/ # 复制 DNS 配置
mount --types proc /proc /mnt/gentoo/proc          # 挂载进程信息
mount --rbind /sys /mnt/gentoo/sys                 # 绑定挂载系统信息
mount --rbind /dev /mnt/gentoo/dev                 # 绑定挂载设备节点
mount --rbind /run /mnt/gentoo/run                 # 绑定挂载运行时信息
mount --make-rslave /mnt/gentoo/sys                # 设置为从属挂载 (防止卸载时影响宿主)
mount --make-rslave /mnt/gentoo/dev
mount --make-rslave /mnt/gentoo/run

chroot /mnt/gentoo /bin/bash    # 切换根目录到新系统
source /etc/profile             # 加载环境变量
export PS1="(chroot) ${PS1}"    # 修改提示符以区分环境

emerge-webrsync   # 获取最新的 Portage 快照 (比 rsync 快)
emerge --sync     # 同步 Portage 树 (获取最新 ebuild)
emerge --ask app-editors/vim # 安装 Vim 编辑器 (推荐)
eselect editor list          # 列出可用编辑器
eselect editor set vi        # 将 Vim 设置为默认编辑器 (vi 通常是指向 vim 的软链接)

emerge --ask --verbose --oneshot app-portage/mirrorselect
mirrorselect -i -o >> /etc/portage/make.conf
# 或手动：
#以 BFSU 镜像站为例
echo 'GENTOO_MIRRORS="https://mirrors.bfsu.edu.cn/gentoo/"' >> /etc/portage/make.conf

vim /etc/portage/make.conf

cat /etc/portage/binrepos.conf/gentoo.conf

ld.so --help

Subdirectories of glibc-hwcaps directories, in priority order:
  x86-64-v4 (supported, searched)
  x86-64-v3 (supported, searched)
  x86-64-v2 (supported, searched)

emerge --ask --getbinpkg sys-kernel/gentoo-kernel

emerge -pv sys-kernel/gentoo-kernel

eselect profile list          # 列出所有可用 Profile
eselect profile set <编号>    # 设置选定的 Profile
emerge -avuDN @world          # 更新系统以匹配新 Profile (a:询问 v:详细 u:升级 D:深层依赖 N:新USE)

echo "Asia/Shanghai" > /etc/timezone
emerge --config sys-libs/timezone-data

echo "en_US.UTF-8 UTF-8" > /etc/locale.gen
echo "zh_CN.UTF-8 UTF-8" >> /etc/locale.gen
locale-gen                      # 生成选定的语言环境
eselect locale set en_US.utf8   # 设置系统默认语言 (建议用英文以免乱码)

# 重新加载环境
env-update && source /etc/profile && export PS1="(chroot) ${PS1}"

echo "gentoo" > /etc/hostname

emerge --ask net-misc/networkmanager
# OpenRC:
rc-update add NetworkManager default
# systemd:
systemctl enable NetworkManager

mkdir -p /etc/portage/package.license
# 同意 Linux 固件的授权条款
echo 'sys-kernel/linux-firmware linux-fw-redistributable no-source-code' > /etc/portage/package.license/linux-firmware
# installkernel USE flag 要与你用的引导器对应。择一：
#   GRUB           → 'sys-kernel/installkernel dracut grub'
#   systemd-boot   → 'sys-kernel/installkernel dracut systemd systemd-boot'
#   Limine / 其他  → 'sys-kernel/installkernel dracut'（引导器手动维护）
echo 'sys-kernel/installkernel dracut grub' > /etc/portage/package.use/installkernel
# systemd-boot 用户还须在首次安装内核前设置内核命令行：
# printf 'root=UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx rw quiet\n' > /etc/kernel/cmdline
emerge --ask sys-kernel/linux-firmware
emerge --ask sys-firmware/intel-microcode  # Intel CPU
emerge --ask sys-kernel/installkernel

emerge --ask sys-kernel/gentoo-kernel-bin
# 若已按旧流程安装内核，执行以下命令重新应用 installkernel 配置：
emerge --ask sys-kernel/installkernel && emerge --ask --config sys-kernel/gentoo-kernel-bin

emerge --ask sys-fs/e2fsprogs  # ext4
emerge --ask sys-fs/xfsprogs   # XFS
emerge --ask sys-fs/dosfstools # FAT/vfat (EFI 分区需要)
emerge --ask sys-fs/btrfs-progs # Btrfs

passwd root # 设置 root 密码
useradd -m -G wheel,video,audio,plugdev <用户名> # 创建用户并加入常用组
passwd <用户名> # 设置用户密码
emerge --ask app-admin/sudo

visudo

%wheel ALL=(ALL:ALL) ALL

emerge --ask sys-boot/grub:2
# 安装到 ESP (注意 --bootloader-id=Gentoo 会自动创建独立目录，避免冲突)
grub-install --target=x86_64-efi --efi-directory=/efi --bootloader-id=Gentoo

emerge --ask sys-boot/os-prober
# 启用 os-prober (默认禁用以保障安全)
echo 'GRUB_DISABLE_OS_PROBER=false' >> /etc/default/grub

grub-mkconfig -o /boot/grub/grub.cfg

timeout 3
console-mode auto

echo 'sys-boot/limine ~amd64' >> /etc/portage/package.accept_keywords/limine
emerge --ask sys-boot/limine

# 先将已安装的内核和 initramfs 复制到 ESP；随后 ESP 会挂载到 /boot。
ls -1 /boot/vmlinuz-* /boot/initramfs-*
cp -v /boot/vmlinuz-* /boot/initramfs-* /efi/
# 将 /etc/fstab 中 ESP 的挂载点从 /efi 改为 /boot。
vim /etc/fstab
umount /efi
mount /boot
mkdir -p /boot/EFI/Gentoo
cp -v /usr/share/limine/BOOTX64.EFI /boot/EFI/Gentoo/limine.efi
cp -v /usr/share/limine/limine-bios.sys /boot/ # （可选）仅 BIOS 需要

timeout: 5

/Gentoo Linux
    protocol: linux
    kernel_path: boot():/<vmlinuz-文件名>
    module_path: boot():/<initramfs-文件名>
    cmdline: root=UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx rw

/Windows 11
    protocol: efi
    path: boot():/EFI/Microsoft/Boot/bootmgfw.efi

emerge --ask sys-boot/efibootmgr
# 创建名为 "Gentoo Limine" 的启动项
# -d: 磁盘设备 (如 /dev/nvme0n1)
# -p: 分区号 (如 1)
# -L: 标签名称
# -l: loader 路径 (Windows 风格斜杠)
efibootmgr --create --disk /dev/nvme0n1 --part 1 --label "Gentoo Limine" --loader '\EFI\Gentoo\limine.efi'

exit
umount -l /mnt/gentoo/dev{/shm,/pts,}
umount -R /mnt/gentoo
swapoff -a
reboot