Gentoo 中文社群 – Gentoo 中文社群

Gentoo Linux with ZFS（轉載）

Thu, 18 Jun 2026 00:00:00 +0000

背景

在學生時代我就非常喜歡 Gentoo Linux，在使用 Gentoo Linux 的過程中學習到了非常多有用寶貴的 Linux 基礎知識，這些知識在我的職業生涯早期發揮了相當重要的作用。但是由於工作後的忙碌，以及工作需要使用公司的裝置，逐漸沒有空維護我的 Gentoo 作業系統。同時也由於筆記本效能後來確實無法跟上，後來將我的 XPS 13 多裝了一個 Arch Linux 使用至今。

所幸隨著我的遊戲機純 Windows 系統的效能逐漸下滑，無法維持正常的遊戲品質，我決定新購裝置，同時滿足我的遊戲以及回歸 Gentoo 的需求。

本文主要記錄這次安裝 Gentoo 的過程，有些東西可能不會詳細展開。

編者注：如作者所說，本文是一份安裝實錄、並不逐步展開，預設你對 Gentoo 已有基礎（分割區、chroot、emerge、核心與引導等）。想認真學、把系統弄明白，推薦照 Gentoo 官方手冊（中文）一步步裝——自己動手、搞懂每一步，本來就是本社群的初衷。如果只是想先體驗一下，社群客製的 Live ISO 帶圖形安裝器（Calamares），能快速裝上（同樣支援 ZFS）；但那只是一條省事的捷徑，認真用 Gentoo 還是建議自己走一遍手冊。

裝置配置

CPU: AMD Ryzen 9 9950X3D 16-Core Processor
MainBoard: MPG X870E CARBON WIFI
Memroy Size: DDR5 96G
Disk: 2 * 2T (ZFS mirror)

準備

檔案

adminCD，支援 zfs 的 liveCD 安裝環境
Gentoo Stage3 ISO 檔案

我們使用 Gentoo 的 adminCD 來進行安裝，我使用的是 ventoy 進行 USB 啟動鏡像製作。

Gentoo 相關的檔案，可以在 Downloads 中找到，也可以選擇一個鏡像站進行加速下載。

編者建議：想給下載 Gentoo 檔案提速，可以用中文社群下載頁彙總的官方鏡像站，見下載頁 → 鏡像源；下載頁的社群 Live ISO 同樣支援 ZFS 安裝（含原生加密）。

BIOS setup

關閉 secure boot

安裝

ZFS

由於我安裝 Windows 時未手動分割區，萬惡的 Windows 這次只給我分了 100M 的 EFI 分割區，所以我在此處需要進行額外的處理。

我要將 2根 SSD 前 16G 切出來做 ESP 分割區，都切是為了做對齊，總體的分割區佈局如下：

Part. # Size Partition Type Partition Name
----------------------------------------------------------------
1007.0 KiB free space
1 16.0 GiB EFI system partition EFI System Partition
2 1.8 TiB Linux filesystem ZFS0
327.5 KiB free space

Part. # Size Partition Type Partition Name
----------------------------------------------------------------
1007.0 KiB free space
1 16.0 GiB Linux filesystem
2 1.8 TiB Linux filesystem ZFS1
327.5 KiB free space

編者注（補充操作）：原文只給了分割區佈局、沒說具體怎麼分。建分割區、設型別、格式化的標準操作，照官方手冊「準備磁碟」做即可（cfdisk / gdisk 都行）。本文是 ZFS 鏡像佈局，照官方做的同時注意這幾點：

認盤別認錯：先 lsblk -f + ls -al /dev/disk/by-id/，用型號 + 序列號（…2406GT / …240A4C）對上是哪根，別只認 nvme0 / nvme1。
每根盤第一個 16G：盤 A 設 EFI System、mkfs.vfat -F 32 做 ESP；盤 B 設 Linux swap（別當 SLOG——下面建池指令本站已去掉 SLOG，見那裡的編者注）。
兩根盤剩餘的第二個分割區不用格式化——直接留給下面的 zpool create ... mirror，由 ZFS 接管（建池後才會顯示 zfs_member）。

使用如下的指令建立 ZFS Pool，我們在 2 根 SSD 都劃分了 16G，但是其中只需要一個 16G 做 ESP 分割區，由於我的記憶體已經相對夠大，所以我將另一根未設為 ESP 型別的，用作 ZFS 的 SLOG。根據需求，你也可以作為 SWAP 分割區。

其中的 id 可以透過 ls -al /dev/disk/by-id/ 得到。

zpool create -o feature@allocation_classes=enabled \
 -o feature@async_destroy=enabled \
 -o feature@bookmarks=enabled \
 -o feature@bookmark_v2=enabled \
 -o feature@device_rebuild=enabled \
 -o feature@device_removal=enabled \
 -o feature@draid=enabled \
 -o feature@embedded_data=enabled \
 -o feature@empty_bpobj=enabled \
 -o feature@enabled_txg=enabled \
 -o feature@encryption=enabled \
 -o feature@extensible_dataset=enabled \
 -o feature@filesystem_limits=enabled \
 -o feature@hole_birth=enabled \
 -o feature@large_blocks=enabled \
 -o feature@large_dnode=enabled \
 -o feature@livelist=enabled \
 -o feature@log_spacemap=enabled \
 -o feature@obsolete_counts=enabled \
 -o feature@project_quota=enabled \
 -o feature@resilver_defer=enabled \
 -o feature@spacemap_histogram=enabled \
 -o feature@spacemap_v2=enabled \
 -o feature@userobj_accounting=enabled \
 -o feature@zpool_checkpoint=enabled \
 -o feature@zstd_compress=enabled \
 -o ashift=12 \
 -o autoexpand=on \
 -o autoreplace=on \
 -o autotrim=on \
 -O acltype=posixacl \
 -O canmount=off \
 -O devices=off \
 -O normalization=formC \
 -O relatime=on \
 -O xattr=sa \
 -O compression=zstd \
 -O dnodesize=auto \
 -O overlay=off \
 zroot \
 mirror \
 nvme-ZHITAI_TiPlus7100_2TB_ZTA72T0AB2452406GT-part2 \
 nvme-ZHITAI_TiPlus7100_2TB_ZTA72T0AB245240A4C-part2

編者注　指令裡各參數（-o 池屬性、-O 資料集屬性、feature@* 池特性）的權威含義，見 OpenZFS 官方文件：zpoolprops · zpool-features · zfsprops。

另：原文這裡把另一根盤的 16G 當 ZFS 的 SLOG（即 log 一項）。消費級盤沒有掉電保護（PLP）、又和鏡像擠在同一顆盤上，對桌面 / 遊戲機只會拖慢——本站已從上面的 zpool create 裡去掉該 SLOG（那 16G 按原文自己提的退路當 swap 或空著即可）。

建立 rootfs 卷，注意此處我使用了 zfs 加密，如果不需要可以去掉。

zfs create -o mountpoint=legacy \
 -o canmount=noauto \
 -o encryption=aes-256-gcm \
 -o keylocation=prompt \
 -o keyformat=passphrase \
 zroot/root

建立 home 卷，此處將加密設定成與父卷一樣的方式，但是不新增密碼，我們就可以在開機時輸入密碼後共享同一個密碼，無需二次解密。

zfs create -o mountpoint=legacy \
 -o canmount=noauto \ 
 -o encryption=aes-256-gcm \
 zroot/root/home

掛載對應的卷和分割區，注意此處掛載的是 ESP 分割區

mount -t zfs zroot/root /mnt/gentoo
mount -t zfs zroot/root/home /mnt/gentoo/home
mount /dev/nvme0n1p1 /mnt/gentoo/boot

安裝 Gentoo

下載解壓 stage 3，我這裡 example 選擇 systemd 和 desktop 的，根據需求選擇你要的。

官方手冊：安裝 stage3 檔案、配置編譯選項（make.conf）

cd /mnt/gentoo
wget https://distfiles.gentoo.org/releases/amd64/autobuilds/20250406T165023Z/stage3-amd64-desktop-systemd-20250406T165023Z.tar.xz
tar xpvf stage3-*.tar.xz --xattrs-include='*.*' --numeric-owner

配置 /etc/portage/make.conf：

USE="cjk dist-kernel dracut egl -handbook -kwallet networkmanager sddm systemd-boot wayland wacom"
MAKEOPTS="--jobs 16 --load-average 25"
INPUT_DEVICES="wacom"
CFLAGS="-march=native -O3 -pipe"
CXXFLAGS="${CFLAGS}"
CPU_FLAGS="aes avx avx2 avx512_bf16 avx512_bitalg avx512_vbmi2 avx512_vnni avx512_vp2intersect avx512_vpopcntdq avx512bw avx512cd avx512dq avx512f avx512ifma avx512vbmi avx512vl f16c fma3 mmx mmxext pclmul popcnt rdrand sha sse sse2 sse3 sse4_1 sse4_2 sse4a ssse3 vpclmulqdq"
CPU_FLAGS_X86="${CPU_FLAGS}"
GENTOO_MIRRORS="https://mirrors.ustc.edu.cn/gentoo https://mirrors.tuna.tsinghua.edu.cn/gentoo https://distfiles.gentoo.org"

其中的 CPU_FLAGS 可以透過 cpuid2cpuflags 得到。

配置必要的 package USE /etc/portage/package.use/custom：

# required by Locez
*/* CPU_FLAGS_X86: aes avx avx2 avx512_bf16 avx512_bitalg avx512_vbmi2 avx512_vnni avx512_vp2intersect avx512_vpopcntdq avx512bw avx512cd avx512dq avx512f avx51
2ifma avx512vbmi avx512vl f16c fma3 mmx mmxext pclmul popcnt rdrand sha sse sse2 sse3 sse4_1 sse4_2 sse4a ssse3 vpclmulqdq
*/* VIDEO_CARDS: -* amdgpu radeonsi nvidia

遵循新的標準，在這裡繼續配置 CPU_FLAGS 和 VIDEO_CARDS，其中顯示卡的需要根據硬體具體進行配置，我這裡含有 AMD 的集顯和 nvidia 的顯示卡

準備 chroot

官方手冊：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}"

配置時區與區域

ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

cat /etc/locale.gen | grep -v ^#
en_US.UTF-8 UTF-8
zh_CN.UTF-8 UTF-8

locale-gen

配置核心與 ZFS 核心模組

官方手冊：配置核心

emerge-webrsync
emerge -av sys-kernel/linux-firmware
emerge -av sys-kernel/gentoo-kernel-bin
emerge -av sys-fs/zfs sys-fs/zfs-kmod

配置 dracut 生成 initramfs，新增 ZFS 支援，以便開機的時候能正確使用載入 ZFS，其中 systemd-ask-password 是因為上述建立 ZFS Pool 的步驟中，我們在建立子卷的時候填寫了密碼，用這個來提示我們輸入密碼。

注意：配置前後的空格是必須的

/etc/dracut.conf.d/zol.conf

fsck="yes"
add_dracutmodules+=" zfs systemd-ask-password "

生成 initramfs

emerge --config sys-kernel/gentoo-kernel-bin

安裝更新系統

emerge --ask --verbose --update --deep --newuse @world app-shells/fish
systemctl enable networkmanager

安裝 KDE 與 SDDM

官方手冊：桌面環境（KDE 只是作者的選擇，GNOME / Xfce / Sway 等都行）

emerge -auDv kde-plasma/plasma-meta sddm
systemctl enable sddm

修改 sddm 配置，文章有實效性，最新的配置可以參考： plasma-wayland.conf

[General]
DisplayServer=wayland
GreeterEnvironment=QT_WAYLAND_SHELL_INTEGRATION=layer-shell
InputMethod=
[Theme]
Current=breeze
[Wayland]
CompositorCommand=kwin_wayland --no-global-shortcuts --no-lockscreen --inputmethod maliit-keyboard --locale1

建立普通使用者，並且配置對應權限分組，其中 sddm 踩坑在登入後需要 daemon group 才能正常執行（截至 20250413 仍然是這樣，請注意時間有效性）。

官方手冊：收尾工作（使用者管理）

useradd -m -G daemon,adm,wheel,audio,video,users -s /usr/bin/fish locez
passwd locez

生成 fstab

官方手冊：配置系統（fstab）

emerge -a genfstab
genfstab -U / > /etc/fstab

配置啟動項，透過 bootctl 安裝，並且檢查 /boot 下的配置是否正確

官方手冊：配置引導器

bootctl install
ls /boot

❯ cat /boot/loader/entries/gentoo-6.12.21-gentoo-dist.conf
# Boot Loader Specification type#1 entry
# File created by /usr/lib/kernel/install.d/90-loaderentry.install (systemd 256.10)
title Gentoo Linux
version 6.12.21-gentoo-dist
sort-key gentoo
options dokeymap root=ZFS=zroot/root ro
linux /gentoo/6.12.21-gentoo-dist/linux
initrd /gentoo/6.12.21-gentoo-dist/initrd

編者注：文中用 systemd-boot 直接引導 ZFS 根（root=ZFS=zroot/root）。如果想用專為 ZFS 設計的引導方案，也可以瞭解 ZFSBootMenu——社群 Live ISO 的 ZFS 安裝用的就是它；這也只是一種選擇。

重啟進入系統

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

到此為止， Gentoo 的整個安裝過程已經結束，順利的話能直接進入系統，不順利的話只能 liveCD 繼續 chroot 修問題啦。

如果需要 chroot 修問題，這個時候需要在 liveCD 中解密，首次建立的時候輸入密碼沒這個步驟

zpool import zroot
zfs load-key zroot/root

登入進去普通使用者以後如果聲音不正常還需要啟動 pipewire 和 wireplumber

systemctl --user enable --now pipewire-pulse pipewire wireplumber

雙系統啟動配置

由於使用了 2 個 ESP 分割區，雙系統啟動有兩種方式，一種是開機的時候選擇啟動項，另一種則使用 systemd-boot 管理。

雖然 systemd-boot 無法直接管理另一個 ESP 分割區中的啟動，但是我們可以透過 UEFI SHELL 進行跳轉。

首先安裝 edk2，將其複製到我們的 /boot 中，這樣啟動選擇後可以得到一個 UEFI SHELL，我們可以透過這個 SHELL 得到 Windows 的 FS alias

emerge -1 -a edk2-bin
cp /usr/share/edk2-ovmf/Shell.efi /boot/shellx64.efi

重啟然後登入到 UEFI SHELL 中，使用 map 指令得到 Windows 的 UEFI 的 FS alias

然後手動建立以下啟動項 /boot/loader/entries/windows.conf，其中 HD0b 就是 FS alias

title Windows 11
efi /shellx64.efi
options -nointerrupt -nomap -noversion HD0b:EFI\Microsoft\Boot\Bootmgfw.efi

引用

轉載聲明　本文為轉載，已獲原作者授權。原作者 Locez（個人站 locez.com），原文《Gentoo Linux with ZFS》（發布於 2025-04-13，更新於 2026-02-11）。原文以 Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International（CC BY-NC-SA 4.0）協議發布，本文經作者授權、並同樣以該協議轉載。

本站對原文做了少量修改並標註（均為本站觀點，非原作者意見）：zpool create 指令裡的 SLOG（log）已去掉（理由見正文該指令下的編者注）；另補充了新手閱讀提示、分割區要點、下載鏡像建議、ZFSBootMenu 說明，以及各步驟對應的 Gentoo 官方手冊（中文）章節連結，方便照官方最新文件操作。

中文社群近期更新：Live ISO、官網、下載站與測速

Tue, 09 Jun 2026 00:00:00 +0000

把社群最近這段時間的改動整理一下，分專案說。各項都附了倉庫連結，想看完整改動可以翻提交記錄。

Live ISO

中文社群客製的 KDE Plasma 6 桌面 Live ISO（Gentoo-zh/Live-ISO）：

三語言開箱即用：引導選單分簡體 / 繁體 / 英文三檔，整套 live 環境跟著所選語言走；裝好的系統也沿用你在安裝器裡選的語言。
預置中文輸入法：fcitx5 + rime，開箱即可輸入，內建朙月拼音、注音、五筆86、倉頡、粵拼。
閉源 NVIDIA 可選：引導選單選 NVIDIA 項會常規載入閉源驅動（需先關 Secure Boot）；不選則用開源 nouveau。
順手的 live 桌面開關：桌面放了幾個僅 live 用的一鍵圖示，需要時點一下即可——臨時關閉自動休眠 / 鎖屏（折騰或裝機時不被打斷）、開啟免密 sudo、一鍵開啟 SSH（方便遠端裝機或除錯）。
裝好的系統是乾淨的：上面這些 live 便利（連同預設的 SDDM 免密自動登入）都只在 live 裡，安裝器裝機時會復位 / 清掉，裝好的系統回到 KDE 正常預設：登入要密碼、sudo 要授權、休眠鎖屏照常。
開箱即用的細節：PipeWire 音訊、網路開機自動連、MAKEOPTS 與 CPU 指令集按你的機器自適應。

裝系統推薦照 Gentoo 官方手冊一步步來更穩妥；live 裡也帶了圖形安裝器（Calamares），想快速裝也可以用。

安裝器（Calamares）

安裝器配置 Gentoo-zh/calamares-settings-gig：裝機後會清掉 live 專用的殘留設定，並按你在 live 裡選的顯示卡方案配置 NVIDIA。分割區時根檔案系統預設 btrfs，也可選 xfs / ext4 / ZFS——選 ZFS 並勾選加密就是 ZFS 原生加密（aes-256-gcm）、由 ZFSBootMenu 引導（GRUB 讀不了帶原生加密的 ZFS 池，所以 ZFS 根改用 ZBM）。這套裝機流程（含 ZFS 加密安裝）在虛擬機器上做過實機安裝測試。

Live ISO 用的 overlay

Live ISO 建置所需的包來自 Gentoo-zh/gig——它是 Gig OS overlay 的 fork、專給 Live ISO 用，跟社群主 overlay gentoo-zh 不是一個。這次把其中的 Calamares 更新到支援 Python 3.14 的 3.3.14-r8，修復了 emerge --sync 的報錯，並清理了一批冗餘 / 失效的包。

自動建置與釋出

建置流水線 Zakkaus/gentoozh-liveiso-infra：Live ISO 每週一自動編譯，編好後上傳到 Cloudflare R2。流水線會逐位元組核對「R2 上的 = 這次編出來的」、並確認下載頁已反映新鏡像，一致才算上線；也加了對滾動樹過渡期 USE / 關鍵字變化的自適應處理（見 Python 3.14 成為預設版本）。

官網

官網 www.gentoo.org.cn（原始碼 gentoo-zh.github.io）從 Blowfish 遷移到了 Hextra——更輕、更快、對文件和文字瀏覽器更友好（細節見遷移那篇）。表現層抽成了獨立的 Hextra 修補包 gentoozh-theme，補全了 SEO、頁尾與無障礙。下載頁也接入了下載站、補了 Live ISO 的功能說明和硬體要求，並新增了 FAQ 頁。這次還給公共頁面加了英文國際化，簡 / 繁 / 英可切。

下載站

下載站 mirror.gentoozh.org（原始碼 Zakkaus/gentoozh-mirror）遷到了 Cloudflare，不再用自建伺服器：ISO 存 Cloudflare R2（r2.gentoozh.org，零出口流量、全球邊緣、可快取），落地頁改成 Cloudflare Worker——在邊緣即時讀 R2，列出最新鏡像和全部歷史版本，永遠反映當前內容。頁面保留簡 / 繁 / 英三語與淺 / 深色。

測速站

測速改用 Cloudflare 官方測速——下載本來就走 Cloudflare 邊緣，用它測更貼近實際下載速度；原先自建的 speed.gentoozh.org 隨下載站上雲一併下線。

想試 Live ISO 就到下載頁。有問題歡迎到 Telegram 群或各專案的 GitHub 反饋。

Python 3.14 成為預設版本（2026-06-01）

Mon, 01 Jun 2026 00:00:00 +0000

2026-06-01 起，Gentoo 把系統預設的 Python 從 3.13 換成了 3.14。

如果你從沒自己設過 PYTHON_TARGETS 或 PYTHON_SINGLE_TARGET（大多數人都沒設過），那基本不用管——下次 emerge 升級時，系統會自動開始往 3.14 切。

官方公告原文：Python 3.14 to become the default on 2026-06-01（2026-04-16 釋出；本機也能用 eselect news read 看）。

大多數人：等它自己升就行

很多包還在往 3.14 適配，所以不用著急——跟著平時的 @world 升級，讓它慢慢切過去就好。

升級的過程是這樣的：每個包在重新編譯時，順帶就切到新的 Python。所以一串互相依賴的包，得都支援 3.14 了，升級才推得動；中途可能有個別指令暫時找不到依賴（已經開著的程式一般不受影響）。這些都是過渡期的正常現象，全部升完就好了。

如果你在 make.conf 裡設過 Python 版本，先刪掉

如果你在 make.conf 裡寫過 PYTHON_TARGETS 或 PYTHON_SINGLE_TARGET，先把它們刪掉——官方不建議在 make.conf 裡設 Python 版本，它會蓋掉各個包自己該用的預設值。

下面要寫的配置，統一放到 /etc/portage/package.use/python 這個檔案裡（package.use 是個目錄，檔名隨便取，這裡就叫 python）。

想自己控制升級時機

下面幾種做法，挑一種就行。

① 跟著預設走，自動升

什麼都不設，系統會自己處理。萬一中途卡住，手動跑一遍後面的「升級指令」。

② 先不升，暫時留在 3.13

往 /etc/portage/package.use/python 寫：

*/* PYTHON_TARGETS: -* python3_13
*/* PYTHON_SINGLE_TARGET: -* python3_13

這只是拖一拖，早晚還是要升的。

③ 現在就升到 3.14

往 /etc/portage/package.use/python 寫：

*/* PYTHON_TARGETS: -* python3_14
*/* PYTHON_SINGLE_TARGET: -* python3_14

然後跑後面的「升級指令」。等預設正式切過去之後，記得把這兩行刪掉——不然將來會擋住自動升到 3.15。

④ 更穩妥的分步升級

先讓 3.13、3.14 兩個版本並存，再慢慢撤掉 3.13。相關的包要編兩遍，更慢，但中途出問題的機率更低。

第一步，往 /etc/portage/package.use/python 寫（兩版並存），跑一遍「升級指令」：

*/* PYTHON_TARGETS: -* python3_13 python3_14
*/* PYTHON_SINGLE_TARGET: -* python3_13

第二步，改成下面這樣，再跑一遍：

*/* PYTHON_TARGETS: -* python3_13 python3_14
*/* PYTHON_SINGLE_TARGET: -* python3_14

第三步，只留 3.14，最後再升一遍：

*/* PYTHON_TARGETS: -* python3_14
*/* PYTHON_SINGLE_TARGET: -* python3_14

升級指令

切換版本時，舊的 3.13 要從整個依賴樹裡一起清掉；要是有掉隊的舊包沒收拾乾淨，就會報依賴衝突。所以升級要走 --deep --changed-use @world，並且升級前先把沒用的孤兒包清了：

emerge --depclean
emerge -1vUD @world
emerge --depclean

Python 3.11 和 PyPy 3.11 這次也會移除

這輪還會移除對 python3_11 和 PyPy 3.11（pypy3_11）的支援。PyPy 目前沒有相容 Python 3.12 的版本，因此 Gentoo 會暫時移除 PyPy 支援，待新版本釋出後再恢復。

升級時報 USE 衝突怎麼辦

過渡期裡，如果某個包還沒適配 3.14，@world 升級時可能會報 The following USE changes are necessary to proceed。這通常是暫時的：按上面 ② 的寫法，給對應的包指定 Python 版本繞過去，或者等幾天讓包跟上，就能繼續。

有問題可以到 Telegram 群或 GitHub 反饋。

網站主題從 Blowfish 遷移到 Hextra

Fri, 29 May 2026 00:00:00 +0000

繼上次將網站從 Jekyll 遷移到 Hugo 之後，本站再次更換主題：從 Blowfish 遷移到 Hextra。

為什麼換 Hextra

Blowfish 功能全面，但對一個以文件和教學為主的社群站來說偏重：首屏載入的指令碼與樣式較多，頁面效能開銷偏高；預設排版用於長文閱讀時也不夠清爽。

Hextra 基於 Tailwind CSS，為文件與部落格而生：

更輕、更快：零第三方請求（無外部字型 / CDN / 追蹤），首屏文字資源約 50 KB（gzip）；貢獻者頭像按顯示尺寸自動縮放，頁面效能開銷明顯降低；
閱讀更清晰：規整的標題層級、行距與程式碼塊排版，長文更好讀；
自帶全文搜尋（FlexSearch）、暗色模式與響應式佈局；
透過 Hugo Modules 引入，無需 Node 工具鏈。

主要變化

首頁重做：hero + 快捷入口 + 最新文章 + 社群貢獻者；
貢獻者列表：自動抓取 gentoo-zh Overlay 中提交 5 次以上者，顯示提交次數並按提交量排序，每月自動更新；
文章頁署名顯示作者頭像；
文章改用 tags 分類，文章頁與列表顯示 #標籤，可點進 /tags/ 聚合頁；
首頁「最新文章」提供 RSS 訂閱；分享到 Telegram / 社交平臺時顯示網站品牌預覽卡片；
下載頁突出「中文社群客製 KDE 桌面 Live ISO」，新手可開箱即用；
全站簡繁雙語（zh-CN / zh-TW）並存；
站內全文搜尋、暗色模式。

對終端瀏覽器友好（TUI）

應 @talk_something 群裡 lzamora70（因為lzamora70菊苣過於抽象，多次銷號，所以名字不一定更新的上）的提議，本站特意針對終端 / 文字瀏覽器做了一輪最佳化——畢竟是 Gentoo：

語義化的 HTML 結構與標題層級，在 lynx / w3m / links 等純文字瀏覽器中排版清晰、連結可達；
每頁頂部都有「跳到正文」連結，可一鍵跳過導覽直接閱讀；
圖片均有恰當的替代文字（alt）；裝飾性的重複圖片（頭像牆的迴圈副本、明暗兩份 logo）使用空 alt，避免在文字瀏覽器與讀屏軟體中被重複朗讀；
貢獻者頭像牆與文章作者署名在文字模式下每人只列一次；
配合 Hextra 的「以 Markdown 檢視 / 複製為 Markdown」頁面選單，方便用指令碼或 LLM 直接取用頁面原文。

歡迎用 lynx https://www.gentoo.org.cn/ 試試。

補充：公共頁面加了英文

遷移之後，又給公共頁面（關於、下載、鏡像列表、貢獻指南這些）補了英文國際化，方便用 gentoo-zh overlay 的海外使用者——現在簡 / 繁 / 英都能切。要說明的是：技術文章不一定都有英文，目前只做了公共頁面；英文是借翻譯軟體協助生成、由至今能找到的最好最貴的模型 Claude Fable 5（ultracode）負責 review 和最佳化的，難免有錯漏，歡迎在 GitHub 指正。

反饋

Telegram 頻道：@gentoocn · 群組：@gentoo_zh
提交 Issue / PR：GitHub

感謝 Blowfish 與 Hextra 主題的開發者。

網站從 Jekyll 遷移至 Hugo

Tue, 18 Nov 2025 00:00:00 +0000

經創始人 @biergaizi 授權，@Zakkaus 於 2025 年接手本站日常維護，並將網站從 Jekyll 遷移到 Hugo。

為什麼換 Hugo

Jekyll 依賴 Ruby 環境，建置較慢，主題生態也不如以往活躍。Hugo 是單一 Go 二進位制，建置速度快、部署簡單，原生支援多語言。主題選用 Blowfish。

遷移內容

_posts 目錄改用 Hugo 的 Page Bundles 組織（content/posts/<slug>/index.zh-cn.md）
Front matter 從 YAML 改為 TOML
簡繁雙語並存（zh-CN / zh-TW）
作者資料集中到 data/authors/
部署改走 GitHub Actions，定期自動更新貢獻者列表

注：以上是當年 Jekyll → Hugo 遷移時的結構。2026 年本站遷移到 Hextra 後已調整：front matter 統一為 YAML，內容按語言分目錄（content/zh-cn/、content/zh-tw/，檔名均為 index.md），作者署名改用 front matter 的 map-form（不再使用 data/authors/）。

反饋

Telegram 群：@gentoo_zh
Telegram 頻道：@gentoocn
提交 Issue / PR：GitHub

感謝 @biergaizi 與 @zhcj 創立並長期維護 Gentoo 中文社群，也感謝 Blowfish 主題的開發者。

Gentoo 停止為第三方倉庫提供快取鏡像（gentoo-zh 使用者請更新同步源）

Tue, 07 Oct 2025 00:00:00 +0000

根據 Gentoo 官方公告，Gentoo 已停止為第三方倉庫提供快取鏡像支援。從 2025-10-30 起，所有第三方倉庫（包括 gentoo-zh）的鏡像配置都會從官方倉庫列表裡移除。

這意味著什麼

eselect repository、layman 等工具照常能用
官方不再為第三方倉庫提供快取鏡像，改為直接從上游源（GitHub）同步
官方倉庫（::gentoo、::guru、::kde、::science）不受影響，仍走鏡像

已經新增過 gentoo-zh 的話

更新一下同步 URI 即可——移除再重新啟用，會自動用上正確的上游源：

# 檢視已安裝的倉庫
eselect repository list -i

# 移除舊配置
eselect repository remove gentoo-zh

# 重新啟用（自動使用正確的上游源）
eselect repository enable gentoo-zh

之後照常 emerge --sync gentoo-zh。

新增 gentoo-zh 的使用者不受影響，按 Overlay 頁面正常啟用就行。中國內陸直連 GitHub 慢的話，可以走中國內陸 git 鏡像。

在 Apple Silicon Mac 上安裝 Gentoo Linux（M1/M2 MacBook 安裝教學）

Thu, 02 Oct 2025 00:00:00 +0000

本文記錄在 Apple Silicon Mac（M1/M2 系列）上安裝原生 ARM64 Gentoo Linux 的完整流程。

得益於 Asahi Linux 專案團隊（尤其是 chadmed）的工作，Gentoo 現已有官方 Asahi 安裝指南，本文基於該指南並補充實測細節。

硬體支援（按 Asahi Feature Support 現況）：

M1、M2 全系列：可作日常桌面使用
M3：GPU 進行中，Wi-Fi / 音訊等仍 TBA，不建議作桌面
M4：核心驅動多為 TBA，暫不可用
M5：官方支援表尚未列出

本文流程以 M1/M2 為準。最後核對日期：2026 年 5 月 29 日。

流程概覽

必選步驟：

下載官方 Gentoo Asahi Live USB 鏡像
透過 Asahi 安裝程式設定 U-Boot
從 Live USB 啟動
分割區並掛載檔案系統
解壓 Stage3 並 chroot
安裝 Asahi 支援套件
重啟完成安裝

可選步驟：LUKS 加密、自定義核心、PipeWire 音訊、桌面環境。

整個流程會在 Mac 上建立 macOS + Gentoo Linux ARM64 雙啟動環境。

事前準備

硬體需求

Apple Silicon Mac（僅 M1/M2 可作桌面使用；M3/M4 驅動不完整，M5 尚未列入官方支援表）
至少 80 GB 可用磁碟空間，建議 120 GB 以上
穩定的 Wi-Fi 或乙太網
備份所有重要資料

已知工作情況

可用：CPU、記憶體、儲存、Wi-Fi、鍵盤、觸控板、電池管理、內建與外接顯示、USB-C / Thunderbolt。

部分支援：GPU 加速（OpenGL 部分支援）。

不可用：Touch ID、macOS 虛擬化。

1. 準備 Gentoo Asahi Live USB

1.1 下載鏡像

直接使用 Gentoo 提供的 ARM64 Live USB，無需 Fedora 中轉：

https://chadmed.au/pub/gentoo/

推薦 install-arm64-asahi-latest.iso（chadmed 維護的穩定符號連結），或選擇有具體日期的版本以便後續復現。若遇到啟動問題，可以嘗試上一個穩定日期版本。

1.2 製作啟動 USB

在 macOS 中：

diskutil list
diskutil unmountDisk /dev/disk4
sudo dd if=install-arm64-asahi-*.iso of=/dev/rdisk4 bs=4m status=progress
diskutil eject /dev/disk4

2. 設定 Asahi U-Boot 環境

2.1 執行 Asahi 安裝程式

在 macOS Terminal 中：

curl https://alx.sh | sh

建議先訪問 https://alx.sh 檢視指令碼內容再執行。

2.2 跟隨安裝程式

選擇 r（Resize an existing partition to make space for a new OS）
分配給 Linux 的空間（建議至少 80 GB，可填百分比或絕對大小）
選擇 UEFI environment only (m1n1 + U-Boot + ESP)
OS 名稱輸入 Gentoo
按指示關機

2.3 完成 Recovery 設定

等待 25 秒確保完全關機
按住電源鍵直到出現 “Loading startup options…”
釋放電源鍵
在卷列表中選擇 Gentoo
進入 macOS Recovery，輸入使用者密碼（FileVault）
按指示完成設定

如遇啟動迴圈或要求重灌 macOS，請按住電源鍵關機後從頭開始；或開機進入 macOS 重新執行 curl https://alx.sh | sh 選 p 重試。

3. 從 Live USB 啟動

插入 USB 並開機，U-Boot 會自動從 USB 啟動 GRUB。若需手動指定：

setenv boot_targets "usb"
setenv bootmeths "efi"
boot

設定網路（Gentoo Live USB 現在用 NetworkManager，nmtui 是最快方式）：

nmtui # 選 Wi-Fi 網路或編輯有線連線
ping -c 3 1.1.1.1 # 先用 IP 驗證連通性（避開 DNS 問題）
ping -c 3 www.gentoo.org # 再測 DNS

Apple Silicon 的 Wi-Fi 驅動已包含在核心中。若不穩定，嘗試 2.4 GHz 網路。

可選啟用 SSH 遠端操作（Live USB 用 OpenRC）：

passwd # 設 root 密碼
rc-service sshd start # 啟動 SSH（OpenRC 指令）
ip a | grep inet # 檢視 IP 地址

4. 分割區與檔案系統

不要修改現有的 APFS 容器、EFI 分割區或 Recovery 分割區，只在 Asahi 安裝程式預留的空間中操作。

檢視分割區：

lsblk
blkid --label "EFI - GENTO"

典型佈局：

nvme0n1p1 500M Apple Silicon boot
nvme0n1p2 307.3G Apple APFS (macOS)
nvme0n1p3 2.3G Apple APFS
nvme0n1p4 477M EFI System (不要動)
(free) ~150G Linux 可用空間
nvme0n1p5 5G Apple Silicon recovery

4.1 建立根分割區

使用 cfdisk /dev/nvme0n1 在空閒空間建立 Linux filesystem 型別分割區。

不加密：

mkfs.btrfs /dev/nvme0n1p6 # 或 mkfs.ext4
mount /dev/nvme0n1p6 /mnt/gentoo

加密（推薦）：

cryptsetup luksFormat --type luks2 --pbkdf argon2id --hash sha512 --key-size 512 /dev/nvme0n1p6
cryptsetup luksOpen /dev/nvme0n1p6 gentoo-root
mkfs.btrfs --label root /dev/mapper/gentoo-root
mount /dev/mapper/gentoo-root /mnt/gentoo

引數說明：argon2id 抗 ASIC/GPU 暴力破解；luks2 支援更好的安全工具；M1 自帶 AES 指令集，可硬體加速 aes-xts。

4.2 掛載 EFI 分割區

mkdir -p /mnt/gentoo/boot
mount /dev/nvme0n1p4 /mnt/gentoo/boot

5. Stage3 與 chroot

從此處開始可參考 AMD64 Handbook，直到核心安裝章節。

5.1 下載並解壓 Stage3

wget 在 HTTPS 上不支援萬用字元，需要先從 latest-stage3-*.txt 索引檔案取得當前實際的 Stage3 檔名，再下載並用 Gentoo Release Engineering 的 GPG 公鑰驗證：

cd /mnt/gentoo
BASE=https://distfiles.gentoo.org/releases/arm64/autobuilds

# 1. 從官方索引取得最新 Stage3 路徑
STAGE3=$(wget -qO- ${BASE}/latest-stage3-arm64-desktop-systemd.txt | grep -v '^#' | cut -d' ' -f1)

# 2. 下載 tarball + 簽名
wget "${BASE}/${STAGE3}"
wget "${BASE}/${STAGE3}.asc"

# 3. 取得 Gentoo Release Engineering 簽名公鑰（首次需要）
gpg --keyserver hkps://keys.gentoo.org --recv-keys 13EBBDBEDE7A12775DFDB1BABB572E0E2D182910 D99EAC7379A850BCE47DA5F29E6438C817072058

# 4. 驗證簽名（必須看到 "Good signature from ..."）
gpg --verify "$(basename ${STAGE3}).asc" "$(basename ${STAGE3})"

# 5. 解壓（保持屬性）
tar xpvf "$(basename ${STAGE3})" --xattrs-include='*.*' --numeric-owner

或用 links 文字瀏覽器手動選取：

links https://distfiles.gentoo.org/releases/arm64/autobuilds/current-stage3-arm64-desktop-systemd/

5.2 配置 Portage 倉庫

mkdir --parents /mnt/gentoo/etc/portage/repos.conf
cp /mnt/gentoo/usr/share/portage/config/repos.conf /mnt/gentoo/etc/portage/repos.conf/gentoo.conf

5.3 同步系統時間

chronyd -q
date

時間錯誤會導致 SSL 證書驗證失敗和 emerge 報錯。

5.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}"

5.5 編輯 make.conf

nano -w /etc/portage/make.conf

CHOST="aarch64-unknown-linux-gnu"
COMMON_FLAGS="-march=armv8.5-a+fp16+simd+crypto+i8mm -mtune=native -O2 -pipe"
CFLAGS="${COMMON_FLAGS}"
CXXFLAGS="${COMMON_FLAGS}"
FCFLAGS="${COMMON_FLAGS}"
FFLAGS="${COMMON_FLAGS}"
RUSTFLAGS="-C target-cpu=native"
LC_MESSAGES=C
MAKEOPTS="-j4"
# Asahi 社群主推的 R2 鏡像；中國大陸使用者可換成 BFSU / USTC / 清華，詳見 /mirrorlist/
GENTOO_MIRRORS="https://gentoo.rgst.io/gentoo"
EMERGE_DEFAULT_OPTS="--jobs 3"
VIDEO_CARDS="asahi"
L10N="zh-CN zh-TW zh en"

MAKEOPTS 根據核心數調整。檔案末尾保留換行。

emerge-webrsync
# 時區按所在地選擇：大陸 Asia/Shanghai，臺灣 Asia/Taipei，香港 Asia/Hong_Kong
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

編輯 /etc/locale.gen 取消註釋需要的語系，然後：

locale-gen
eselect locale set en_US.utf8
env-update && source /etc/profile && export PS1="(chroot) ${PS1}"

建立使用者：

useradd -m -G wheel,audio,video,usb,input <使用者名稱>
passwd <使用者名稱>
passwd root

6. 安裝 Asahi 支援套件

本節取代官方 Handbook 的「安裝核心」章節。

6.1 方法 A：自動化指令碼（推薦）

emerge --sync
emerge --ask dev-vcs/git

cd /tmp
git clone https://github.com/chadmed/asahi-gentoosupport
cd asahi-gentoosupport
./install.sh

指令碼會啟用 Asahi overlay、安裝 GRUB、設定 VIDEO_CARDS="asahi"、安裝 asahi-meta（含核心、韌體、m1n1、U-Boot）、執行 asahi-fwupdate 和 update-m1n1、最後更新系統。

如遇 USE flag 衝突：

# Ctrl+C 中斷指令碼
emerge --autounmask-write <衝突包>
etc-update # 通常選 -3 自動合併
cd /tmp/asahi-gentoosupport && ./install.sh

指令碼完成後跳到 6.3 配置 fstab。

6.2 方法 B：手動安裝

設定 Portage 與 Asahi overlay（使用 git 同步）：

emerge --sync
emerge --ask dev-vcs/git
rm -rf /var/db/repos/gentoo

sudo tee /etc/portage/repos.conf/gentoo.conf << 'EOF'
[DEFAULT]
main-repo = gentoo
[gentoo]
location = /var/db/repos/gentoo
sync-type = git
sync-uri = https://github.com/gentoo-mirror/gentoo.git
auto-sync = yes
sync-depth = 1
EOF

sudo tee /etc/portage/repos.conf/asahi.conf << 'EOF'
[asahi]
location = /var/db/repos/asahi
sync-type = git
sync-uri = https://github.com/chadmed/asahi-overlay.git
auto-sync = yes
EOF

emerge --sync

簡體中文使用者可以使用北外源 https://mirrors.bfsu.edu.cn/git/gentoo-portage.git。其他鏡像見鏡像列表。

防止官方 dist-kernel 覆蓋 Asahi 版本：

mkdir -p /etc/portage/package.mask
cat > /etc/portage/package.mask/asahi << 'EOF'
virtual/dist-kernel::gentoo
EOF

配置 USE flags 與 VIDEO_CARDS：

mkdir -p /etc/portage/package.use
cat > /etc/portage/package.use/asahi << 'EOF'
dev-lang/rust-bin rustfmt rust-src
dev-lang/rust rustfmt rust-src
EOF
echo 'VIDEO_CARDS="asahi"' >> /etc/portage/make.conf
echo 'GRUB_PLATFORMS="efi-64"' >> /etc/portage/make.conf

韌體許可證：

mkdir -p /etc/portage/package.license
echo 'sys-kernel/linux-firmware linux-fw-redistributable no-source-code' \
 > /etc/portage/package.license/firmware

安裝：

emerge -q1 dev-lang/rust-bin
emerge -q sys-apps/asahi-meta virtual/dist-kernel:asahi sys-kernel/linux-firmware

更新韌體與載入程式：

asahi-fwupdate
update-m1n1

每次更新核心、U-Boot 或 m1n1 後都必須執行 update-m1n1。

安裝 GRUB：

emerge -q grub:2
grub-install --boot-directory=/boot/ --efi-directory=/boot/ --removable
grub-mkconfig -o /boot/grub/grub.cfg

--removable 必須，確保系統能從 ESP 啟動；--boot-directory 與 --efi-directory 都指向 /boot/；make.conf 中必須有 GRUB_PLATFORMS="efi-64"。

最後可選 emerge --ask --update --deep --changed-use @world 更新系統。

6.3 配置 fstab

獲取分割區 UUID（按你實際的裝置路徑調整）：

# 根分割區（非加密直接用裝置；加密用解密後的 mapper 裝置）
blkid /dev/nvme0n1p6 # 非加密
blkid /dev/mapper/gentoo-root # 加密

# EFI 分割區（Asahi 安裝時設的卷標 "EFI - GENTO"）
blkid --label "EFI - GENTO"

nano -w /etc/fstab

UUID=<root-uuid> / btrfs defaults 0 1
# 若用 ext4，第三欄改為 ext4
UUID=<boot-uuid> /boot vfat defaults 0 2

6.4 配置 LUKS（僅加密使用者）

啟用 systemd 的 cryptsetup 支援：

mkdir -p /etc/portage/package.use
echo "sys-apps/systemd cryptsetup" >> /etc/portage/package.use/fde
emerge --ask --oneshot sys-apps/systemd

獲取 LUKS UUID（注意是加密容器的 UUID，不是其中檔案系統的）：

blkid /dev/nvme0n1p6

編輯 /etc/default/grub：

GRUB_CMDLINE_LINUX="rd.luks.name=<LUKS-UUID>=gentoo-root root=/dev/mapper/gentoo-root rootfstype=btrfs rd.luks.allow-discards"

rd.luks.name=<LUKS-UUID>=gentoo-root：用 LUKS 容器 UUID（blkid /dev/nvme0n1p6）解鎖並明確命名 mapper 為 gentoo-root，與 crypttab / luksClose 一致
root=/dev/mapper/gentoo-root：解密後的 btrfs root（避免再查一次檔案系統 UUID）
rd.luks.allow-discards：允許 SSD TRIM 穿透加密層（要權衡安全性）

dracut 配置：

emerge --ask sys-kernel/dracut

# 讓 dist-kernel 更新時自動呼叫 dracut 重建 initramfs（推薦）
echo 'sys-kernel/installkernel dracut' > /etc/portage/package.use/installkernel
emerge --ask --oneshot sys-kernel/installkernel

nano -w /etc/dracut.conf.d/luks.conf

# kernel_cmdline 留空，GRUB 的 GRUB_CMDLINE_LINUX 會覆蓋
kernel_cmdline=""
# crypt 模組自動包含 cryptsetup，無需手動 install_items
add_dracutmodules+=" btrfs systemd crypt dm "
filesystems+=" btrfs "

可選寫入 /etc/crypttab，系統會自動提示解鎖：

gentoo-root UUID=<LUKS-UUID> none luks,discard

生成 initramfs：

# 重新生成所有已安裝核心的 initramfs（dist-kernel:asahi 推薦）
dracut --force --regenerate-all

# 或只針對當前已選核心：
# KVER=$(uname -r) # chroot 內無效，需要在已裝系統上執行
# dracut --force --kver "${KVER}"

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

每次更新核心後都要重新執行此步驟。安裝 sys-apps/asahi-scripts 會提供 installkernel hook 自動處理。

7. 完成與重啟

echo "macbook" > /etc/hostname
systemctl enable NetworkManager
passwd root

退出 chroot 並重啟：

exit
umount -R /mnt/gentoo
cryptsetup luksClose gentoo-root # 若使用加密
reboot

首次啟動順序：U-Boot → GRUB（選 Gentoo）→（若加密）輸入 LUKS 密碼 → 登入提示。

8. 安裝後配置

8.1 網路

nmcli device wifi connect <SSID> password <密碼>
# 或圖形介面
nmtui

8.2 桌面環境

先切換合適的 profile（編號會因系統而異，按 profile 名稱選）：

eselect profile list
# 輸出類似：
# default/linux/arm64/23.0/systemd
# default/linux/arm64/23.0/desktop/gnome/systemd
# default/linux/arm64/23.0/desktop/plasma/systemd
# default/linux/arm64/23.0/desktop（通用，Xfce 等）

按需選擇對應編號。本文範例（實際請用 eselect profile list 看到的編號）：

# 選 desktop/plasma/systemd 那一行的編號，例如：
eselect profile set default/linux/arm64/23.0/desktop/plasma/systemd
emerge -avuDN @world

KDE Plasma：

emerge --ask kde-plasma/plasma-meta kde-apps/kate kde-apps/dolphin
systemctl enable sddm

GNOME：

eselect profile set default/linux/arm64/23.0/desktop/gnome/systemd
emerge -avuDN @world
emerge --ask gnome-base/gnome gnome-extra/gnome-tweaks
systemctl enable gdm

Xfce：

eselect profile set default/linux/arm64/23.0/desktop
emerge -avuDN @world
emerge --ask xfce-base/xfce4-meta x11-misc/lightdm
systemctl enable lightdm

首次建置桌面環境約需 2–4 小時，建議 --jobs 3 或更少避免 OOM。

8.3 字型與中文輸入

emerge --ask media-fonts/liberation-fonts media-fonts/noto media-fonts/noto-cjk media-fonts/dejavu
eselect fontconfig enable 10-sub-pixel-rgb.conf
eselect fontconfig enable 11-lcdfilter-default.conf

emerge --ask app-i18n/fcitx-chinese-addons

app-i18n/fcitx-rime 實測在當前版本無法正常使用，建議使用 fcitx-chinese-addons。

8.4 音訊

emerge --ask media-libs/asahi-audio

# 如果已裝 PulseAudio，先停掉避免衝突
systemctl --user disable --now pulseaudio.socket pulseaudio.service 2>/dev/null

# 啟用 PipeWire（socket-activation，pipewire 守護程序會按需啟動）
systemctl --user enable --now pipewire-pulse.socket
systemctl --user enable --now wireplumber.service

9. 系統維護

定期更新：

emerge --sync # 包含 Asahi overlay
# 或只同步 overlay
emaint sync -r asahi
emerge --ask --update --deep --newuse @world
emerge --ask --depclean # 先確認要刪除的包再執行
dispatch-conf # 處理 .__cfg 配置變更

每次核心更新後必做：

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

m1n1 Stage 2 包含 devicetree blobs，核心依賴它識別硬體。sys-apps/asahi-scripts 提供 installkernel hook 可以自動化。

macOS 更新會附帶韌體更新，建議保留 macOS 分割區以便獲取最新韌體。

10. 常見問題

無法從 USB 啟動：U-Boot 的 USB 驅動較挑剔，嘗試不同 USB、使用 USB 2.0 裝置、或經過 USB Hub。

啟動卡住或黑屏：m1n1 / U-Boot / 核心版本不匹配。從 macOS 重跑 curl https://alx.sh | sh 選 p，並確認 chroot 中已執行 update-m1n1。

加密分割區無法解鎖：檢查 /etc/default/grub 的 GRUB_CMDLINE_LINUX、確認 LUKS UUID（blkid /dev/nvme0n1p6）、重新 grub-mkconfig -o /boot/grub/grub.cfg。

Wi-Fi 不穩定：WPA3 或 6 GHz 頻段問題。改用 WPA2、2.4 GHz 或 5 GHz。

觸控板失靈：

dmesg | grep -i firmware
emerge --ask sys-apps/asahi-meta

11. 進階選項

劉海（Notch）：在 GRUB 核心引數加入

appledrm.show_notch=1

（Asahi 核心 6.18 之前的名稱是 apple_dcp.show_notch=1，從 6.18 起 apple_dcp 模組被改名為 appledrm。）

KDE Plasma 可在頂部加全寬面板，高度對齊劉海底部。

自定義核心：

emerge --ask sys-kernel/asahi-sources
cd /usr/src/linux
make menuconfig
make -j$(nproc)
make modules_install
make install
update-m1n1
grub-mkconfig -o /boot/grub/grub.cfg

記得保留可用核心作為備援。

多核心切換：

eselect kernel list
eselect kernel set <number>
update-m1n1

參考

社群支援：

Telegram 群：@gentoo_zh
Telegram 頻道：@gentoocn
GitHub
Gentoo Forums
IRC #gentoo / #asahi @ Libera.Chat
Asahi Linux Discord

建設中的 Gentoo 中文社群

Sun, 24 Aug 2014 00:00:00 +0000

Gentoo 是一個基於 Linux 或 FreeBSD 的自由作業系統，它幾乎能為任何應用程式或需求自動地作出最佳化和客製。對極限的配置、效能的追求，以及頂尖的使用者和開發者社群，都是 Gentoo 的顯著特點。

Gentoo 曾經先後有過兩次活躍的中文社群，但在 2010 年左右已經完全消失，僅剩 IRC 頻道與郵件列表有零散討論。此次 Gentoo 中文專案的發起，算是第三次了。目標在於對各種中國內陸 Gentoo 相關資源進行有效整合，把 Gentoo 使用者引導到一起交流，給新手解決問題，讓高手交流技術，提高中國內陸 Gentoo 發行版的普及率，最終達到提高中國內陸 Linux 技術水平、回饋 Gentoo 官方的中長期目標。

這次 Gentoo 中文社群依然在建設中，此網站僅有的功能是 ~~刷刷存在感~~ 顯示文字，表明這個專案的存在。

第一階段需要完成的工作：

Jekyll 模板
成立翻譯團隊
- 新聞翻譯
- 文件翻譯
Gentoo 中文社群 Logo 的向量化重製
補完 Gentoo 和 gentoo-zh 的介紹性文字

第二階段需要完成的工作：

gentoo-zh 源的鏡像
Portage 樹的 SquashFS 歸檔

Gentoo 中文社群成立

Tue, 05 Feb 2013 00:00:00 +0000

Gentoo中文社群的源起

Gentoo 中文專案，是中國內陸愛好者進行 Gentoo Linux 交流、討論的一個技術社群。此次 Gentoo 中文社群的建設算是第三次組建。

第一次，2004 年前後，由 LinuxSir 上面的 Gentoo 愛好者發起並維護，為 Gentoo 在中國內陸的推廣做出了貢獻，但最終專案因故中止（詳見 [1]）。

第二次，2007 年開始，由張樂所發起的第二次 Gentoo 中文文件的翻譯專案。取得的最大成果是將 Gentoo 手冊全部翻譯為中文，並將其提交到官方，也就是目前我們看到的官方 Gentoo 中文手冊，目前翻譯專案還正常執行（詳見 [2]）。

此次 Gentoo 中文專案的發起，算是第三次了。主要由清風來負責籌建各項事務，最終確定平臺名稱為 “Gentoo 中文社群”。期間得到許多 Gentooers 的大力支援。

Gentoo中文社群發展目標

對各種中國內陸 Gentoo 相關資源進行有效整合，把 Gentoo 使用者引導到一起交流，給新手解決問題，讓高手交流技術，提高中國內陸 Gentoo 發行版的普及率，最終達到提高中國內陸 Linux 技術水平、回饋 Gentoo 官方的中長期目標。

Gentoo中文社群專案管理

主站伺服器架設及管理：清風、比爾蓋子
文件翻譯：繼續使用張樂的翻譯平臺，在這裡也非常感謝他為 Gentoo 中文做出的貢獻！
論壇管理：清風（暫時），招聘中。。。

Gentoo 中國（鏡像）站開始執行

Sun, 03 Feb 2013 00:00:00 +0000

目前的 Gentoo 網站僅僅是官方站的鏡像，但相信以後會成為 Gentoo 中國社群的主要網站！