Lazy loaded image
运维管理
Proxmox VE 安装配置与问题解决
Words 2241Read Time≈ 6 min
2025-9-29
2025-11-10
date
related_level
slug
type
relate_date
summary
status
tags
category
last_updated
Nov 10, 2025 10:02 PM
是否已更新
orginal_page
是否推荐
Proxmox VE 系统硬件配置需求Proxmox VE 问题解决
参考资料
Proxmox VE 镜像官方下载
默认账号 root 及登录地址
  • 密码为安装过程中输入的密码
  • 登录地址
    • https://<ipAddress>:8006
 

Proxmox VE 系统硬件配置需求

硬件特性需求
主板 需要支持 IOMMU (Input–output memory management unit) 用于 PCI 直通
CPU 需要支持硬件虚拟化（用于 KVM）以及 IOMMU
  • Intel：支持 VT-d（Virtualization Technology for Directed I/O，非 VT-x，与 AMD-Vi 对应）
GPU ROM 不一定需要支持 UEFI 用于 PCI 直通，但现代主流 GPU 大多都支持
存储需求
硬盘如果用于 NAS 应避开 SMR
SSD Cache（固态硬盘高速缓存）
 

Proxmox VE 问题解决

GUI 安装时遇到 FrameBuffer Mode Fails 错误，无法输出 GUI 安装页面
参考资料
  • 问题产生于 12 代及后续 Intel CPU 的架构变更导致 PVE 安装脚本无法识别 iu 的核显 GPU，需要手动配置 BusID
      • 可以通过 Ctrl+Alt+F# 来更换输出终端 tty#（#为对应编号）
      • Ctrl+Alt+F1 对应 tty1 为 PVE 安装脚本 console，也是目前的输出终端
      • Ctrl+Alt+F2 对应 tty2 为 X server console
      • Ctrl+Alt+F3 对应 tty3 为 shell 终端
    • 此时切换到 tty2 就能看到含 FrameBuffer Mode Fails 错误的报错信息
  • 修正步骤
    • 进入安装页面，选择 Advance 模式（debug）
    • 在脚本加载可以通过 Ctrl +D 组合键暂停到启动 GUI 之前（个人大概10多秒左右），通过 Ctrl +D 组合键暂停脚本手动进入 shell
      • 输入 lspci | grep -i vga 查看对应核显的 vga BusID
      • 我的是 00:02.0，后续对应 BusID 填写 pci0:0:2:0
        • 注意大小写
      • 如果与参考资料一致为 01:00.0 则应填写 pci0:01:0:0
      进一步编辑 X11 设备配置文件
      • vi /usr/share/X11/xorg.conf.d/10-fbdev.conf
        • 10-fbdev.conf 可以取别的名字，会自动读取，前面的数字用于配置读取顺序
      • 输入对应配置内容
        • BusID 填入此前的对应值
        • 需要注意大小写
    • 通过 Ctrl+D 组合键重新执行安装脚本即可
    • （可选）重启 x11 服务 xinit -- -dpi 96 >/dev/tty2 2>&1
更改 PVE 节点名称
  • 修改对应文件内的节点名称
    • /etc/hostname
    • /etc/hosts
    • /etc/postfix/mail.cf
  • 重启 reboot
  • 迁移 /etc/pve/nodes/<old-node-name> 到 /etc/pve/nodes/<new-node-name>
    • cp -r /etc/pve/nodes/<old-node-name> /etc/pve/nodes/<new-node-name>
    • 如果报错则需要手动下载并上传配置文件
      • 主要涉及 /etc/pve/nodes/<old-node-name>/qemu-server/ 下的 .conf 文件
更换 PVE 国内源并禁用企业源
参考资料
  • 备份原有源
    • mv /etc/apt/sources.list /etc/apt/sources.list.bak
禁用企业源和 ceph
  • mv /etc/apt/sources.list.d/pve-enterprise.list /etc/apt/sources.list.d/pve-enterprise.list.bak
  • mv /etc/apt/sources.list.d/ceph.list /etc/apt/sources.list.d/ceph.list.bak
添加 aliyun 或 清华 的源
nano /etc/apt/sources.list
  • 记得确认版本是否对应
可选，如果需要使用 ceph
参考资料
ceph 版本参考
  • 添加 aliyun 的源
  • 下载并信任 aliyun ceph 公钥文件
    • wget -q -O- 'https://mirrors.aliyun.com/ceph/keys/release.asc' | sudo apt-key add -
  • nano /etc/apt/sources.list.d/ceph.list
    • 这里以 ceph quincy 版本和 debian 11为 例
可选，如果需要使用 CT 模板
  • cp /usr/share/perl5/PVE/APLInfo.pm /usr/share/perl5/PVE/APLInfo.pm_back
  • sed -i 's|http://download.proxmox.com|https://mirrors.tuna.tsinghua.edu.cn/proxmox|g' /usr/share/perl5/PVE/APLInfo.pm
GUI 新增温控和 CPU 频率检测（更新 GUI 版本后需要重新执行）
安装所需软件
  • apt update
  • apt-get install lm-sensors nvme-cli hddtemp
创建温控检测GUI脚本
  • cd /home/
  • 粘贴以下代码至 sh 脚本
    • 自测 PVE 7.2 版本可正常执行
      • vim pve-gui-temp.sh
执行温控检测GUI脚本
  • chmod +x pve-gui-temp.sh
  • /home/pve-gui-temp.sh
  • 清理浏览器缓存后 F5 即可
PVE 控制 CPU 频率
查看 CPU 实际频率
  • watch grep \"cpu MHz\" /proc/cpuinfo
禁用 intel pstate 管理驱动
  • 添加 intel_pstate=disable 至 GRUB_CMDLINE_LINUX_DEFAULT
    • vim /etc/default/grub
      • GRUB_CMDLINE_LINUX_DEFAULT="quiet intel_pstate=disable"
      • 如有其他配置项用空格分隔
  • update-grub
安装 cpufrequtils 管理 CPU
  • apt-get install cpufrequtils
配置 cpufrequtils
  • vim /etc/init.d/cpufrequtils
按需修改
参考配置
重启服务
  • systemctl daemon-reload
  • /etc/init.d/cpufrequtils restart
PVE 控制风扇频率
安装所需软件
  • apt update
  • apt-get install lm-sensors
  • apt-get install fancontrol
配置使用
  • sensors-detect
    • 检测传感器
    • 最后有一项添加至 /etc/modules 默认是NO，需要注意
  • service kmod start
    • 加载模块
  • pwmconfig
    • 生成 pwm 配置
    • 如果没有配置，尝试重启，仍未生效说明 sensors-detect 未能找到对应传感器配置
  • service fancontrol start
去除 PVE 未订阅提示
  • 每次更新 PVE 版本后需要重新执行一遍
修改 /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js
  • sed -i_orig "s/res.data.status.toLowerCase() !== 'active'/false/g" /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js
  • 重启服务 systemctl restart pveproxy
GUI 页面登录短时间内反复过期
  • 是由于密钥的时间不同步导致的
  • 检查日志中与 authkey 相关的日志
    • journalctl -b -u pvestatd -u pvedaemon
  • 查看两个指令的时间是否一致
    • hwclock
    • date
      • 会与 hwclock 同步
  • 执行以下指令
    • touch /etc/pve/authkey.pub
    • touch /etc/pve/authkey.pub.old
  • 查看密钥文件时间
    • ls -lha /etc/pve/authkey*
GUI 无法登录，证书异常
  • 查看日志发现是 pveproxy-ssl.key 丢失
    • journalctl -r -p3
    • journalctl -b
    • systemctl --failed
  • 移除原有证书并重新制作证书
    • rm /etc/pve/local/pveproxy-ssl.* /etc/pve/local/pve-ssl.*
    • pvecm updatecerts -f
  • systemctl restart pveproxy
remote-fs 读取顺序循环导致崩溃
  • 禁用 ceph 服务后恢复正常
    • systemctl list-units --all ceph*
    • systemctl mask ceph-mon@localhost
      • 非 disable 而是 mask，mask 将符号链接指向 /dev/null
      • unmask 取消
  • 删除 ceph 配置
    • pveceph purge
hdaudio hdaudioCOD2:unable to configure disabling
PVE 安装 nvidia 官方驱动时无法自动识别内核路径
  • 安装器日志路径
    • /var/log/nvidia-installer.log
  • 先安装对应内核 header
    • apt update && apt install pve-headers
    • find /usr/src -name "linux-headers*"
      • 查看当前内核源路径
      • 假设为 /usr/src/linux-headers-6.8.12-8-pve
  • 传递至 --kernel-source-path
    • bash NVIDIA-Linux-x86_64-<ver>.run --kernel-source-path /usr/src/linux-headers-6.8.12-8-pve
PVE 版本升级临时迁移 VM
  • 停止对应节点上的所有 VM
  • 迁移 VM 描述符到任意路径
    • /etc/pve/nodes/<node-name>/qemu-server
  • 加入集群后, 重新迁移回原有路径即可
PVE 通过命令行创建 vm/lxc 备份
  • 参考资料
    • Backup and Restore - Proxmox VE
      Backup and Restore - Proxmox VE

      Backup and Restore - Proxmox VE

      Backups are a requirement for any sensible IT deployment, and Proxmox VE provides a fully integrated solution, using the capabilities of each storage and each guest system type. This allows the system administrator to fine tune via the mode option between consistency of the backups and downtime of the guest system.

  • 创建备份 vzdump
    • vzdump <vmid_lxcid> --storage <STORAGE_ID> --pbs-change-detection-mode metadata
可用选项参考 /etc/vzdump.conf
备份任务无法通过命令行创建
  • 已创建的备份任务可见 /etc/pve/jobs.cfg
  • 命令行查看备份任务
    • pvesh list /cluster/backup/
    • pvesh get /cluster/backup/backup-<id>
PVE 调整 local 磁盘大小
(必须) 启动到 SystemRescueCD 再进行操作
  • 使用 rufus 等工具刻录 iso 到 u 盘并插入对应主机, 启动时选择 SystemRescueCD
    • 如果有 secure boot 需要关闭
  • 假设使用的 ext4 系统, 存在对系统产生不可逆错误的风险, 请备份后再处理
    • e2fsck -f /dev/pve/root
      • 检查系统格式
查看当前 local 占用
  • lvdisplay | grep -a15 /dev/pve/root
  • lvscan
激活 lvm
  • vgchange -ay
可用选项
调整 local 和 local-lvm 大小
  • lvreduce --resizefs --size 30G /dev/pve/root
    • local 减少到30g
  • lvresize --resizefs --extents +100%FREE /dev/pve/data
    • 扩容 100% 剩余空间
  • 检查
    • e2fsck -f /dev/pve/root
    • e2fsck -f /dev/pve/data
  • 移除 SystemRescueCD 并重启
 
上一篇
Linux 邮件管理
下一篇
Node.js node 版本管理
Comments
Loading...
Catalog