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/Taipei" > /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