Gentoo 安装指南

Gentoo Linux 桌面版实战安装指南

包含完整图形界面（KDE Plasma）。默认环境：UEFI + GPT 磁盘格式，OpenRC 初始化系统。

开局建议： 请使用 Arch Linux 或 Ubuntu 的 LiveUSB 引导安装。自带浏览器、网络和舒适的终端环境，方便直接复制粘贴本文档的代码。

阶段一：底层系统构建

1. 磁盘分区与挂载

假设目标磁盘为 /dev/nvme0n1。

# 进入 cgdisk 或 fdisk 分区
cgdisk /dev/nvme0n1

# 建议分区结构：
# 1. EFI System分区 (512MB, Hex code: ef00) -> /dev/nvme0n1p1
# 2. Linux swap分区 (16GB, Hex code: 8200)  -> /dev/nvme0n1p2
# 3. Linux root分区 (剩余全部空间, Hex code: 8300) -> /dev/nvme0n1p3

格式化并挂载：

mkfs.fat -F 32 /dev/nvme0n1p1
mkswap /dev/nvme0n1p2
swapon /dev/nvme0n1p2
mkfs.ext4 /dev/nvme0n1p3

mount /dev/nvme0n1p3 /mnt/gentoo
mkdir -p /mnt/gentoo/boot/efi
mount /dev/nvme0n1p1 /mnt/gentoo/boot/efi

2. 下载并解压 Stage3

cd /mnt/gentoo
# 建议下载 amd64/openrc 版本 (带 desktop profile 更好，但基础版也可)
wget https://mirrors.ustc.edu.cn/gentoo/releases/amd64/autobuilds/current-stage3-amd64-openrc/stage3-amd64-openrc-latest.tar.xz

# 解压（注意保留文件权限）
tar xpvf stage3-*.tar.xz --xattrs-include='*.*' --numeric-owner

3. 配置编译参数 (引入二进制包加速)

核心提速点： Gentoo 官方现已提供海量预编译二进制包（binpkg）。我们在 make.conf 中启用该特性，像 QtWebEngine、Firefox 这种几小时编译起步的包，现在只需几秒钟即可安装完毕。

nano -w /mnt/gentoo/etc/portage/make.conf

# 替换或添加以下核心参数：
COMMON_FLAGS="-O2 -pipe -march=native"
MAKEOPTS="-j$(nproc)"
ACCEPT_LICENSE="*"
GENTOO_MIRRORS="https://mirrors.ustc.edu.cn/gentoo/"

# 启用二进制包支持 (极其重要)
FEATURES="getbinpkg"
EMERGE_DEFAULT_OPTS="--getbinpkg"

# 设置你的显卡驱动 (根据实际情况选择：amdgpu, intel, nvidia)
VIDEO_CARDS="amdgpu radeonsi" 
# 开启网络管理器和声音支持
USE="networkmanager pulseaudio pipewire wayland dbus -gnome -systemd"

4. Chroot 切换与更新系统

cp --dereference /etc/resolv.conf /mnt/gentoo/etc/

mount --types proc /proc /mnt/gentoo/proc
mount --rbind /sys /mnt/gentoo/sys
mount --make-rslave /mnt/gentoo/sys
mount --rbind /dev /mnt/gentoo/dev
mount --make-rslave /mnt/gentoo/dev
mount --bind /run /mnt/gentoo/run
mount --make-slave /mnt/gentoo/run

chroot /mnt/gentoo /bin/bash
source /etc/profile
export PS1="(chroot) ${PS1}"

# 同步软件树 (优先使用 webrsync)
emerge-webrsync
emerge --sync

阶段二：桌面环境准备

5. 选择 Profile (桌面环境的基础)

eselect profile list
# 找到包含 desktop/plasma/wayland 且带 openrc 的编号，例如:
# default/linux/amd64/23.0/desktop/plasma/wayland (稳定版)
eselect profile set 编号

# 更新 @world 集合以适应新的 Profile配置
emerge --update --deep --newuse @world

6. 设置时区与本地化

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

nano -w /etc/locale.gen
# 取消注释: en_US.UTF-8 UTF-8 和 zh_CN.UTF-8 UTF-8
locale-gen
eselect locale set en_US.utf8
env-update && source /etc/profile

7. 内核与 Fstab (拒绝底层黑屏)

稳妥方案：使用预编译内核 gentoo-kernel-bin，包含了所有常见的显卡、声卡驱动，避免新手第一次重启就遇到找不到硬盘或花屏的问题。

emerge sys-kernel/installkernel sys-kernel/gentoo-kernel-bin sys-kernel/linux-firmware

# 编辑 fstab
blkid # 复制你的 UUID
nano -w /etc/fstab

# 示例:
UUID=你的EFI-UUID    /boot/efi   vfat   defaults,noatime   0 2
UUID=你的SWAP-UUID   none        swap   sw                 0 0
UUID=你的ROOT-UUID   /           ext4   noatime            0 1

阶段三：图形界面与用户配置

8. 创建日常用户并配置 Sudo

桌面环境绝对不能使用 root 直接登录。我们需要创建一个具有高权限的日常用户。

# 安装 sudo
emerge app-admin/sudo

# 创建用户 (将 yourname 替换为你的用户名)
useradd -m -G users,wheel,audio,video,usb,cdrom,portage,plugdev -s /bin/bash yourname
passwd yourname

# 设置 root 密码
passwd

# 允许 wheel 组使用 sudo
visudo
# 找到并取消注释这一行: %wheel ALL=(ALL:ALL) ALL

9. 安装 KDE Plasma 与显示管理器

得益于之前在 make.conf 配置了二进制包，这一步原本需要编译 10 小时的庞然大物，现在将以类似 Arch Linux 的速度直接解压安装。

# 安装 KDE Plasma 元数据包及其基础应用
emerge kde-plasma/plasma-meta kde-apps/kdecore-meta

# 安装显示管理器 (SDDM) 和 NetworkManager
emerge x11-misc/sddm net-misc/networkmanager

# 配置显示管理器
nano -w /etc/conf.d/display-manager
# 将 DISPLAYMANAGER 设置为 "sddm"
# DISPLAYMANAGER="sddm"

10. 配置开机自启服务

OpenRC 需要手动将关键服务加入开机启动项。

# 基础系统服务
emerge app-admin/sysklogd sys-process/cronie
rc-update add sysklogd default
rc-update add cronie default

# 硬件和系统总线服务
rc-update add dbus default
rc-update add udev sysinit

# 网络与图形界面服务
rc-update add NetworkManager default
rc-update add display-manager default

11. 安装 Bootloader (GRUB)

emerge sys-boot/grub sys-boot/efibootmgr
grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=Gentoo
grub-mkconfig -o /boot/grub/grub.cfg

退出并享受桌面

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

拔掉 U 盘重启后，你将直接看到 SDDM 登录界面。输入你创建的普通用户密码，进入极其流畅的 Gentoo + KDE Plasma 桌面环境。