1. 宿主机 CPU 模式准备（PVE 环境必看）#

XanMod 针对微架构等级进行了特定编译优化，若需使用性能更强的 x64v3（AVX2）内核，需先确保虚拟机暴露了对应指令集：

1. PVE 控制台关闭目标虚拟机。
2. 进入 硬件 (Hardware) -> 双击 处理器 (Processors) -> 将 类别 (Type) 改为 host。
3. 启动虚拟机，在终端验证是否支持 x86-64-v3：

1
/lib64/ld-linux-x86-64.so.2 --help | grep -i x86-64

输出中包含 x86-64-v3 (supported, searched) 即可选择安装 x64v3 版本。

2. 导入 XanMod GPG 签名密钥#

1
sudo mkdir -p /etc/apt/keyrings
2
curl -fsSL https://dl.xanmod.org/archive.key | sudo gpg --dearmor --yes -o /etc/apt/keyrings/xanmod-archive-keyring.gpg

3. 配置清华大学开源镜像源#

Debian 13 的发行版代号为 trixie：

1
echo 'deb [signed-by=/etc/apt/keyrings/xanmod-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/xanmod/ trixie main' | sudo tee /etc/apt/sources.list.d/xanmod.list

4. 更新软件索引并安装元包 (Meta-package)#

XanMod 官方提供了元包（Meta-package），安装元包会自动解析并关联安装当前最新的内核镜像以及配套的 headers 头文件：

• 支持 AVX2 的现代平台（推荐，匹配上述 host 模式）：

1
sudo apt update
2
sudo apt install -y linux-xanmod-x64v3

• 基础兼容平台（若未开启 host 模式，仅支持 v1/v2 时使用）：

1
sudo apt update
2
sudo apt install -y linux-xanmod-x64v2
3
# 或使用全架构通用版：sudo apt install -y linux-xanmod

5. 重启并验证#

1
sudo reboot

虚拟机重启后，执行以下命令确认内核已成功切换至 XanMod：

1
uname -r

输出带有 xanmod（如包含 x64v3-xanmod）即代表安装完成并已正常运行。