Proxmox VE（以主流 PVE 8.x / Debian 12 Bookworm 为例）全新安装后的初始化配置与换源完整指
【摘要】 第一步：换源（替换为国内镜像） 新建安装后，默认使用的是官方企业源（需付费订阅），国内更新速度慢且会报错。以下命令均在 PVE Shell 界面 或 SSH 终端 中执行： 1. 替换 Debian 系统底层基础源（清华源）Bash# 备份原来的 sources.listcp /etc/apt/sources.list /etc/apt/sources.list.bak# 写入清华镜像源（适...
第一步：换源（替换为国内镜像）
新建安装后，默认使用的是官方企业源（需付费订阅），国内更新速度慢且会报错。以下命令均在 PVE Shell 界面 或 SSH 终端 中执行：
1. 替换 Debian 系统底层基础源（清华源）
Bash
# 备份原来的 sources.list
cp /etc/apt/sources.list /etc/apt/sources.list.bak
# 写入清华镜像源（适用于 PVE 8 / Debian 12 Bookworm）
cat <<EOF > /etc/apt/sources.list
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware
EOF
2. 屏蔽官方企业付费源 & 替换为非订阅源（No-Subscription）
Bash
# 禁用/注释官方企业源
rm -f /etc/apt/sources.list.d/pve-enterprise.list
rm -f /etc/apt/sources.list.d/ceph.list
# 添加清华 PVE 非订阅软件源
echo "deb https://mirrors.tuna.tsinghua.edu.cn/proxmox/debian bookworm pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list
# 添加清华 Ceph 镜像源（如无需 Ceph 集群亦可配置）
echo "deb https://mirrors.tuna.tsinghua.edu.cn/proxmox/ceph/quincy debian bookworm main" > /etc/apt/sources.list.d/ceph.list
3. 替换 LXC / CT 容器模板源（加速下载容器镜像）
Bash
# 替换默认下载域名
cp /usr/share/perl5/PVE/APLInfo.pm /usr/share/perl5/PVE/APLInfo.pm.bak
sed -i 's|http://download.proxmox.com|https://mirrors.tuna.tsinghua.edu.cn/proxmox|g' /usr/share/perl5/PVE/APLInfo.pm
# 重启 API 守护进程生效
systemctl restart pvedaemon.service
4. 更新系统软件包
Bash
apt update && apt dist-upgrade -y
⚙️ 第二步：常用初始化设置
1. 去除无有效订阅提示（弹窗警告）
每次登录 Web 界面都会弹窗“无有效订阅”，执行以下脚本可一键去除：
Bash
# 执行自动化修改脚本
sed -Ezi.bak "s/(Ext.Msg.show\(\{\s+title: gettext\('No valid sub)/void\(\{ \/\/\1/g" /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js && systemctl restart pveproxy.service
(清除浏览器缓存并刷新页面即可生效)
2. 合并默认的分区 local 与 local-lvm（可选）
默认安装会将硬盘拆分为 local（仅存镜像文件/备份）和 local-lvm（存虚拟机磁盘）。对于单块小容量 SSD，建议合并为一个空间方便统一管理：
-
打开网页端：Datacenter（数据中心） -> Storage（存储）。
-
选中 local-lvm，点击 Remove（删除）。
-
在 Shell 中释放并扩展逻辑卷：
Bashlvremove /dev/pve/data -y lvresize -l +100%FREE /dev/pve/root resize2fs /dev/pve/root -
回到网页端 Storage（存储） -> 双击编辑 local -> 在 Content（内容） 下拉菜单中勾选全部类型（包含 Disk image、Container 等），保存即可。
3. 开启 CPU 直通（IOMMU / PCIe Passthrough）
若需要直通网卡、显卡、硬盘等硬件给虚拟机：
-
Intel CPU：
Bashsed -i 's/GRUB_CMDLINE_LINUX_DEFAULT="quiet"/GRUB_CMDLINE_LINUX_DEFAULT="quiet intel_iommu=on iommu=pt"/' /etc/default/grub update-grub -
AMD CPU：
Bashsed -i 's/GRUB_CMDLINE_LINUX_DEFAULT="quiet"/GRUB_CMDLINE_LINUX_DEFAULT="quiet amd_iommu=on iommu=pt"/' /etc/default/grub update-grub -
加载硬件直通模块：
Bashcat <<EOF >> /etc/modules vfio vfio_iommu_type1 vfio_pci vfio_virqfd EOF -
重启系统生效：
reboot
4. 调整 Web 界面显示 Hardware 温度/CPU 频率（可选扩展）
默认 Web 界面不显示 CPU 温度和频率，建议安装工具并使用开源小助手脚本（如 pve-tools）开启可视化增强面板。
📌 总结配置 Checklist
| 配置项 | 是否必须 | 说明 |
| Debian / PVE 换源 | 必须 | 避免 apt update 失败，大幅提升软件下载速度 |
| 移除企业订阅源 | 必须 | 解决更新过程报 401/403 错误 |
| CT 模板换源 | 推荐 | 加载/下载 LXC 容器（如 OpenWrt/Ubuntu 容器）更顺畅 |
| 屏蔽订阅弹窗 | 推荐 | 提升登录使用体验 |
| 合并存储分区 | 视情况 | 单盘小容量存储建议合并 |
| 开启 IOMMU | 视情况 | 如需网卡/显卡/硬盘直通必设 |
【声明】本内容来自华为云开发者社区博主，不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源（华为云社区）、文章链接、文章作者等基本信息，否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱：
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论（0）