一. Proxmox VE介绍Proxmox VE简称 PVE是一款基于 Debian Linux 的开源企业级服务器虚拟化管理平台由 Proxmox Server Solutions GmbH 开发维护遵循 GNU AGPLv3 许可证, 它将 KVM 全虚拟化与 LXC 容器技术深度集成通过 Web 界面或 CLI 统一管理虚拟机、容器、软件定义存储SDS及软件定义网络SDN具备集群高可用HA、实时迁移、备份恢复等企业级功能是 VMware ESXi 等商业虚拟化方案的热门开源替代选择1.核心功能特性虚拟化技术支持 QEMU/KVM全虚拟化可运行 Windows、Linux 等操作系统及 LXC 轻量级容器9.1 及以上版本新增 OCI 镜像仓库原生支持可直接拉取 Docker Hub 等镜像仓库中的兼容镜像并转换为 LXC 容器运行无需嵌套虚拟机或 Docker 引擎资源利用率更高集群与高可用采用多主Multi-Master架构无单点故障基于 Corosync 集群引擎实时同步配置内置 HA 管理器支持节点故障自动转移、虚拟机实时迁移Live Migration9.2 版本新增动态负载均衡器可基于实时资源数据自动优化集群负载分布存储管理支持本地磁盘、LVM、ZFS、NFS、SMB/CIFS、iSCSI、FC、NVMe-oF 及 Ceph RBD/CephFS 等多种存储类型ZFS 支持快照、克隆及数据校验9.0 版本新增链式快照卷与动态 ZFS 存储扩展9.x 版本支持 iSCSI 和 FC 存储的精简配置与空间回收UNMAP网络功能支持 Linux 网桥、Open vSwitch 及软件定义网络SDN提供 VLAN、VXLAN、EVPN 等隔离与覆盖网络技术9.2 版本原生集成 WireGuard 和 BGP 协议支持 EVPN IPv6 Underlay 及路由映射管理与安全提供基于 Web 的统一管理门户默认端口 8006支持 RESTful API 和 CLI 操作支持基于角色的权限控制RBAC及 Linux PAM、LDAP、Microsoft AD、OpenID 等多种认证方式内置 nftables 防火墙备份与恢复内置 vzdump 备份工具支持全量/增量备份、定时备份及异地存储可集成 Proxmox Backup Server 实现高效数据压缩、去重与加密Veeam 12.2 版本起也支持 Proxmox VE 的备份恢复2.最新版本与架构支持截至 2026 年 9 月最新稳定版本为Proxmox VE 9.22026 年 5 月发布基于 Debian 13.5 Trixie默认内核 Linux 7.0集成 QEMU 11.0、LXC 7.0、ZFS 2.4, 该版本首次正式支持arm64/aarch64 架构首发支持 NVIDIA Grace Hopper 与 NVIDIA Vera 平台与 x86-64 版本共享代码库及发布周期但 arm64 架构不支持 Intel GVT-g 虚拟 GPU 直通及 AMD SEV 内存加密且虚拟机无法跨 x86-64 与 arm64 架构节点在线迁移二.安装配置操作1.proxmox镜像下载下载ISO镜像, 从官网:proxmox下载ISO安装镜像如下图示:2.制作U盘启动盘2.1 安装ventoy到U盘从Ventoy 下载ventory工具插入一个空的U盘把ventoy安装到U盘如下图示:注意: 这里会格式化整个U盘确保U盘上无需要的文件, 选择是继续安装Ventoy安装成功如下图示:如果上面步骤安装Ventoy失败, 报错:解决办法:和普通使用 Ventoy2Disk 的方法一样只是在最后点击安装按钮之前在 Ventoy2Disk.exe 界面勾选配置选项---创建 VTSI 文件如下图所示生成了.vtsi镜像, 如下:使用Rufus(3.15)把这个 vtsi 文件写入对应的U盘即可完成 Ventoy 的安装,安装时只需要选择对应的U盘设备选择 vtsi 文件即可其余选项保持默认对于 Rufus 弹出的提示点击 OK 或 确认即可安装成功特殊说明(1). Rufus 只支持 USB 接口类型的U盘或者移动硬盘不支持本地硬盘, 而且默认只显示U盘对于USB移动硬盘可以按AltF显示(2).Ventoy生成的 vtsi 文件只能用来写入对应的磁盘不能写入其他盘(3).安装中遇到其他问题,可以查看官方解决方案: https://www.ventoy.net/cn/faq.html2.2 promox的iso镜像复制到U盘打开U盘把promox的iso镜像复制到U盘如下图:一个带promox的U盘启动盘就制作完成了3.从U盘启动安装首先, 插入带promox的U盘到目标服务器(电脑),然后通过下面步骤进行启动安装:本台电脑是在开机启动时狂按F11键, 展示:选择启动项:上面为什么会出现两个分区?这通常是使用 Ventoy 或类似工具制作启动盘时的正常现象Partition 1存放引导文件如EFI、GRUB等用于启动系统Partition 2存放你复制进去的ISO镜像文件如Proxmox VE、Linux Mint)等如何选择正确的启动项?在安装Proxmox VE时建议选择 UEFI: Netac OnlyDisk 2.00, Partition 1 作为启动项因为它是主引导分区, 如果启动失败再尝试 Partition 2启动项选择完成后,会进入到如下界面:选择proxmox-ve_9.2-1.iso后进入下面界面:选择 Boot in normal mode 后,进入下面界面:选择 Install Proxmax VE(Graphical) 以图形(Graphical)界面安装,进入下面安装程序加载过程如下图示:同意用户服务条款如下图示:选择安装到ssd硬盘有4T空间的这个硬盘如下图示:Options选项里可以选择使用哪种文件系统确保是ext4如下图示:注意: 这里选择安装到/dev/nvmeOn1这块硬盘会对整块硬盘进行格式化如果硬盘上还有资料是需要的则需要提前备份或使用一块空的硬盘来安装下一步(Next):选择所在地区(China)、时区(Asia/Shanghai)、键盘布局保留默认值(U.S.English)如下图示:下一步(Next):填管理员密码、管理员邮箱地址, 如果联网系统能发送邮件管理员能收到事件通知, 如下图示:注意: 这里设置的密码就是系统root用户的密码也是后面登录管理所需的密码下一步(Next):配置服务器的IP地址,如下图示:这里主机名(Hostname)建议配置成pve-192.168.xx.xx格式注意替换成现场的IP地址, 下一步(Next), 安装配置信息的汇总如下图示:继续安装(Install), 安装进度如下图示:等待,安装完成会自动重启,如下图示:上面显示的就是promox的访问地址,IP是在部署过程中配置的IP4.访问登录通过另一台在同一局域网的电脑浏览器访问:192.168.xx.xx:8006, 访问失败:但通过ping却能ping通服务器:curl 也是报错:在PVE服务器上查看端口, 也没问题:查看防火墙, 这里把防火墙关闭一下:systemctl stop pve-firewall iptables -F # 清空所有规则还是访问不了在 PVE 终端执行curl -k https://localhost:8006,本机可以访问但外部不行, 检查了防火墙,端口号等,都没发现啥问题,这里使用重新大法, 使用192.168.xx.xx这个ip进行绑定, 然后能够正常访问了:登录:语言可以选择中文, 用户是root密码是部署过程中设置的密码, 如下图示:登录之后有一个订阅无效的提示可以忽略, 如下图示:登录操作系统:或者使用ssh工具登录操作系统如下图示:登录系统之后执行以下命令来替换软件源(1). 切换到配置文件所在目录:cd /etc/apt/sources.list.d/(2). 备份原有的企业版源:mv pve-enterprise.sources pve-enterprise.sources.backup(3). 使用社区源:echo -e Types:deb\nURIs: https://mirrors.tuna.tsinghua.edu.cn/proxmox/debian/pve\nSuites: trixie\nComponents: pve-no-subscription\nSigned-By: /usr/share/keyrings/proxmox-archive-keyring.gpg pve-no-subscription.sources(4). 备份基础软件源:mv debian.sources debian.sources.backup(5). 替换基础软件源:echo -e Types: deb\nURIs: https://mirrors.tuna.tsinghua.edu.cn/debian\nSuites: trixie trixie-updates trixie-backports\nComponents: main contrib non-free non-free-firmware\nSigned-By: /usr/share/keyrings/debian-archive-keyring.gpg debian.sources(6). 备份:mv ceph.sources ceph.sources.backup(7). 替换:echo -e Types: deb\nURIs: https://mirrors.tuna.tsinghua.edu.cn/proxmox/debian/ceph-squid\nSuites: trixie\nComponents: no-subscription\nSigned-By: /usr/share/keyrings/proxmox-archive-keyring.gpg /etc/apt/sources.list.d/ceph.sources如下图示:然后更新软件源的缓存:apt update如下图示:使用reboot重启操作系统5.安装Ubuntu-22.045.1 下载镜像下载地址:这里通过清华源下载5.2 上传镜像到pve服务器这里下载desktop ios镜像, 上传下载的desktop ios镜像到pve服务器:上传完成:5.3 创建PCI显卡映射然后先创建显卡映射一张显卡一个组, 然后创建虚拟机的时候就可以选择到独立显卡了选择设备, 这里要根据pve服务器来选择, 服务器显卡查看:可以看出, 使用的是AMD, 选择ID: 这里选择03:00,这是根据上面得出的结果创建结果:5.4 创建虚拟机下面就可以创建虚拟机啦:创建好的虚拟机如下:5.5 虚拟机绑定PCI设备创建好虚拟机后先不要开机, 需要绑定前面的PCI设备:5.6 安装系统选择启动进入控制台系统安装界面, 安装完系统之后后续启动就默认进入操作系统了好了, 虚拟机安装完成, 下面看看ubuntu里面能不能识别到显卡能不能安装上驱动,如果没问题的话,下面就可以重启一下服务器, 看看能否再次访问: 192.168.xx.xx:8006 以及能否打开虚拟机操作,如果可以,就没问题了重启一下服务器, 看看能否再次访问: 192.168.xx.xx:8006 以及能否打开虚拟机操作,如果可以,就没问题了好了,整个流程完成!6.虚拟机挂了解决办法这里虚拟机启动失败,如下:屏幕中间的文字显示为“Guest not running”中文意思是“虚拟机客户机未在运行”你当前处于 Proxmox VE (PVE) 管理界面的控制台 (Console)页面, 这个页面是虚拟机的“显示器”因为这台虚拟机100 (prox-ubuntu-22.04)当前是关机状态没有开机运行所以控制台自然什么系统画面都显示不出来只能告诉你“没在运行”屏幕上的绿色小方块通常是图形渲染或字体的显示小故障在虚拟机未启动的 VNC 控制台中非常常见可以忽略原因: 控制台依然显示 “Guest not running” 且黑屏通常是因为系统启动过程太快或者显卡驱动渲染出现了延迟/故障解决方法第一步刷新控制台页面由于浏览器 VNC 连接有时会有延迟尝试刷新一下当前的网页或者在控制台窗口里随便按一下键盘比如空格键或回车键画面通常就会弹出来第二步检查 PVE 后台任务日志最重要在左侧菜单中点击你的物理节点即pve-192进入主节点界面。在右侧找到并点击“任务历史 (Tasks)”或“系统日志 (Syslog)”查看列表里 ID 为100的虚拟机VM 100的任务如果状态显示绿色的OK说明虚拟机已经成功开机只是控制台画面卡住了大概率是显卡显示问题见第三步如果状态显示红色的Error (错误)点击这行任务进去看详细的错误日志里面会写明为什么启动失败例如 ISO 文件丢失、磁盘不足等第三步检查虚拟机的“显示”设置确保 VM 100 处于关闭状态点击左侧的“硬件 (Hardware)”菜单找到“显示 (Display)”这一项检查它是什么驱动如果你装的是 Ubuntu 22.04强烈建议将其更改为virtio-gl或std或qxl不要使用VGA或None否则容易导致控制台黑屏无法显示开机画面修改后重新点击右上角的Start Now启动试试第四步通过 Shell 强行查看报错如果上面都不行我们需要用命令行来看真正的报错点击左侧的pve-192节点点击右侧的“Shell”输入命令并回车qm start 100如果系统有报错终端会直接把红色的错误信息弹出来比如volume local:iso/ubuntu.iso does not exist表示镜像丢失分析报错日志如下:日志提示service vm:100 in error state, must be disabled and fixed first虚拟机 100 处于“错误状态”通常是集群高可用 HA 冲突导致的必须先被禁用Disable并修复后才能重新启动这是 PVE 集群环境下常见的问题通常是因为 PVE 认为这个虚拟机在集群的其他节点运行或者之前的任务非正常退出导致它被锁死在了“错误状态”修复步骤:按照以下步骤在物理节点上操作第一步在 PVE 网页界面禁用 HA高可用在左侧菜单中点击你的物理节点例如pve-192在右侧菜单中找到并点击“高可用 (HA)”点击顶部的“资源 (Resources)”标签页在列表中找到VM 100选中它点击顶部的“删除 (Remove)”按钮或者选中它后点击“禁用 (Disable)”,(注意这不会删除你的虚拟机只是把它从自动高可用集群的监控中解除)第二步在 Shell 中清理残留的错误状态如果第一步在界面上做完后仍然无法启动需要用命令行强制清理在左侧点击物理节点然后点击“Shell”进入命令行输入以下命令并回车清除 100 的 HA 状态记录ha-manager remove vm:100确保虚拟机是关闭状态再次尝试输入命令启动它qm start 100执行完以上操作, 再次回到prox-ubuntu-22.04界面点击Start Now应该就可以正常开机了还有报错信息:这通常是显卡直通 (GPU Passthrough) 配置不完整或失败导致的, 系统尝试将物理显卡的 PCI 中断引脚 (PCI_IRQ_PINS) 直通给虚拟机但数量或配置不对导致了断言失败虚拟机因此无法启动解决步骤: 按照以下步骤先尝试禁用显卡直通让虚拟机能够正常开机第一步在 PVE 界面移除显卡直通设置在左侧菜单中点击你的虚拟机100 (prox-ubuntu-22.04)点击右侧的“硬件” (Hardware)选项在硬件列表中找到类型为“PCI设备” (PCI Device)的条目通常就是你直通的那个显卡选中它点击顶部的“移除” (Remove)第二步尝试启动虚拟机移除显卡设备后回到“控制台” (Console)页面点击“Start Now”尝试启动如果成功启动恭喜问题确认就是显卡直通导致的。你可以先用 Ubuntu 系统自带的virtio-gl或std显卡驱动来使用如果依然失败说明可能有其他残留配置请进行下一步第三步强制移除残留的 PCI 设备命令行如果界面上没有 PCI 设备或者移除了仍然报同样的错需要用命令行强制清除再次回到物理节点pve-192的“Shell”中输入以下命令查看虚拟机 100 的配置文件找到 PCI 设备的残留记录cat /etc/pve/qemu-server/100.conf检查输出内容看有没有类似hostpci0: 0000:03:00.0或者hostpci1: 0000:xx:xx.x这样的行。这正是你在报错中看到的0000:03:00.0使用nano编辑器打开并编辑这个配置文件nano /etc/pve/qemu-server/100.conf找到并删除掉所有包含hostpci的行按键盘上的CtrlO保存然后按CtrlX退出编辑器现在再次尝试启动虚拟机qm start 100还有报错, 如下:报错内容依然是error writing 1 to /sys/bus/pci/devices/0000:03:00.0/reset: Inappropriate ioctl for device kvm: .../hw/pci/pci.c:1847: pci_irq_handler: Assertion ... failed.根本原因虚拟机 100 配置了显卡直通 (PCI Passthrough)直通了 PCI ID 为0000:03:00.0的硬件设备, 但是当前的 PVE 系统内核或硬件状态无法正确重置该设备导致虚拟机启动直接崩溃QEMU exited with code 1解决办法:按照以下顺序由简到繁进行排查和修复第一步在 PVE 界面移除直通设备最直接的方法点击左侧菜单的虚拟机100 (prox-ubuntu-22.04)点击右侧的“硬件” (Hardware)在列表中找到类型为“PCI设备” (PCI Device)的条目它对应的应该是0000:03:00.0选中它点击上方的“移除” (Remove)按钮移除后再次尝试点击Start Now启动虚拟机第二步修改配置文件强制移除如果第一步看不到或无效如果在“硬件”选项里找不到 PCI 设备或者移除了依然报错说明配置文件有残留点击左侧的物理节点pve-192点击右侧的“Shell”输入以下命令用nano编辑器打开虚拟机 100 的配置文件nano /etc/pve/qemu-server/100.conf在里面找到包含0000:03:00.0或hostpci字样的那一行例如hostpci0: 0000:03:00.0,pcie1将光标移到该行最前面按键盘上的Ctrl K删除这一行按Ctrl O保存按Enter确认然后按Ctrl X退出编辑器回到虚拟机 100 界面尝试启动第三步如果你必须使用显卡直通进阶修复如果确实需要这块显卡比如用来做 AI 计算或桌面渲染需要检查底层配置确保/etc/modprobe.d/vfio.conf文件中正确绑定了该设备0000:03:00.0以及它对应的声卡设备0000:03:00.1通常都需要绑定确保 GRUB 引导参数/etc/default/grub中已经开启了intel_iommuonIntel平台或amd_iommuonAMD平台以及vfio_iommu_type1.allow_unsafe_interrupts1有些显卡需要修改完 GRUB 后必须在 PVE 物理机的 Shell 中运行update-grub然后重启物理机reboot让内核参数生效 Proxmox VE镜像下载,制作U盘启动盘,安装Ubuntu,配置操作教程详解
一. Proxmox VE介绍Proxmox VE简称 PVE是一款基于 Debian Linux 的开源企业级服务器虚拟化管理平台由 Proxmox Server Solutions GmbH 开发维护遵循 GNU AGPLv3 许可证, 它将 KVM 全虚拟化与 LXC 容器技术深度集成通过 Web 界面或 CLI 统一管理虚拟机、容器、软件定义存储SDS及软件定义网络SDN具备集群高可用HA、实时迁移、备份恢复等企业级功能是 VMware ESXi 等商业虚拟化方案的热门开源替代选择1.核心功能特性虚拟化技术支持 QEMU/KVM全虚拟化可运行 Windows、Linux 等操作系统及 LXC 轻量级容器9.1 及以上版本新增 OCI 镜像仓库原生支持可直接拉取 Docker Hub 等镜像仓库中的兼容镜像并转换为 LXC 容器运行无需嵌套虚拟机或 Docker 引擎资源利用率更高集群与高可用采用多主Multi-Master架构无单点故障基于 Corosync 集群引擎实时同步配置内置 HA 管理器支持节点故障自动转移、虚拟机实时迁移Live Migration9.2 版本新增动态负载均衡器可基于实时资源数据自动优化集群负载分布存储管理支持本地磁盘、LVM、ZFS、NFS、SMB/CIFS、iSCSI、FC、NVMe-oF 及 Ceph RBD/CephFS 等多种存储类型ZFS 支持快照、克隆及数据校验9.0 版本新增链式快照卷与动态 ZFS 存储扩展9.x 版本支持 iSCSI 和 FC 存储的精简配置与空间回收UNMAP网络功能支持 Linux 网桥、Open vSwitch 及软件定义网络SDN提供 VLAN、VXLAN、EVPN 等隔离与覆盖网络技术9.2 版本原生集成 WireGuard 和 BGP 协议支持 EVPN IPv6 Underlay 及路由映射管理与安全提供基于 Web 的统一管理门户默认端口 8006支持 RESTful API 和 CLI 操作支持基于角色的权限控制RBAC及 Linux PAM、LDAP、Microsoft AD、OpenID 等多种认证方式内置 nftables 防火墙备份与恢复内置 vzdump 备份工具支持全量/增量备份、定时备份及异地存储可集成 Proxmox Backup Server 实现高效数据压缩、去重与加密Veeam 12.2 版本起也支持 Proxmox VE 的备份恢复2.最新版本与架构支持截至 2026 年 9 月最新稳定版本为Proxmox VE 9.22026 年 5 月发布基于 Debian 13.5 Trixie默认内核 Linux 7.0集成 QEMU 11.0、LXC 7.0、ZFS 2.4, 该版本首次正式支持arm64/aarch64 架构首发支持 NVIDIA Grace Hopper 与 NVIDIA Vera 平台与 x86-64 版本共享代码库及发布周期但 arm64 架构不支持 Intel GVT-g 虚拟 GPU 直通及 AMD SEV 内存加密且虚拟机无法跨 x86-64 与 arm64 架构节点在线迁移二.安装配置操作1.proxmox镜像下载下载ISO镜像, 从官网:proxmox下载ISO安装镜像如下图示:2.制作U盘启动盘2.1 安装ventoy到U盘从Ventoy 下载ventory工具插入一个空的U盘把ventoy安装到U盘如下图示:注意: 这里会格式化整个U盘确保U盘上无需要的文件, 选择是继续安装Ventoy安装成功如下图示:如果上面步骤安装Ventoy失败, 报错:解决办法:和普通使用 Ventoy2Disk 的方法一样只是在最后点击安装按钮之前在 Ventoy2Disk.exe 界面勾选配置选项---创建 VTSI 文件如下图所示生成了.vtsi镜像, 如下:使用Rufus(3.15)把这个 vtsi 文件写入对应的U盘即可完成 Ventoy 的安装,安装时只需要选择对应的U盘设备选择 vtsi 文件即可其余选项保持默认对于 Rufus 弹出的提示点击 OK 或 确认即可安装成功特殊说明(1). Rufus 只支持 USB 接口类型的U盘或者移动硬盘不支持本地硬盘, 而且默认只显示U盘对于USB移动硬盘可以按AltF显示(2).Ventoy生成的 vtsi 文件只能用来写入对应的磁盘不能写入其他盘(3).安装中遇到其他问题,可以查看官方解决方案: https://www.ventoy.net/cn/faq.html2.2 promox的iso镜像复制到U盘打开U盘把promox的iso镜像复制到U盘如下图:一个带promox的U盘启动盘就制作完成了3.从U盘启动安装首先, 插入带promox的U盘到目标服务器(电脑),然后通过下面步骤进行启动安装:本台电脑是在开机启动时狂按F11键, 展示:选择启动项:上面为什么会出现两个分区?这通常是使用 Ventoy 或类似工具制作启动盘时的正常现象Partition 1存放引导文件如EFI、GRUB等用于启动系统Partition 2存放你复制进去的ISO镜像文件如Proxmox VE、Linux Mint)等如何选择正确的启动项?在安装Proxmox VE时建议选择 UEFI: Netac OnlyDisk 2.00, Partition 1 作为启动项因为它是主引导分区, 如果启动失败再尝试 Partition 2启动项选择完成后,会进入到如下界面:选择proxmox-ve_9.2-1.iso后进入下面界面:选择 Boot in normal mode 后,进入下面界面:选择 Install Proxmax VE(Graphical) 以图形(Graphical)界面安装,进入下面安装程序加载过程如下图示:同意用户服务条款如下图示:选择安装到ssd硬盘有4T空间的这个硬盘如下图示:Options选项里可以选择使用哪种文件系统确保是ext4如下图示:注意: 这里选择安装到/dev/nvmeOn1这块硬盘会对整块硬盘进行格式化如果硬盘上还有资料是需要的则需要提前备份或使用一块空的硬盘来安装下一步(Next):选择所在地区(China)、时区(Asia/Shanghai)、键盘布局保留默认值(U.S.English)如下图示:下一步(Next):填管理员密码、管理员邮箱地址, 如果联网系统能发送邮件管理员能收到事件通知, 如下图示:注意: 这里设置的密码就是系统root用户的密码也是后面登录管理所需的密码下一步(Next):配置服务器的IP地址,如下图示:这里主机名(Hostname)建议配置成pve-192.168.xx.xx格式注意替换成现场的IP地址, 下一步(Next), 安装配置信息的汇总如下图示:继续安装(Install), 安装进度如下图示:等待,安装完成会自动重启,如下图示:上面显示的就是promox的访问地址,IP是在部署过程中配置的IP4.访问登录通过另一台在同一局域网的电脑浏览器访问:192.168.xx.xx:8006, 访问失败:但通过ping却能ping通服务器:curl 也是报错:在PVE服务器上查看端口, 也没问题:查看防火墙, 这里把防火墙关闭一下:systemctl stop pve-firewall iptables -F # 清空所有规则还是访问不了在 PVE 终端执行curl -k https://localhost:8006,本机可以访问但外部不行, 检查了防火墙,端口号等,都没发现啥问题,这里使用重新大法, 使用192.168.xx.xx这个ip进行绑定, 然后能够正常访问了:登录:语言可以选择中文, 用户是root密码是部署过程中设置的密码, 如下图示:登录之后有一个订阅无效的提示可以忽略, 如下图示:登录操作系统:或者使用ssh工具登录操作系统如下图示:登录系统之后执行以下命令来替换软件源(1). 切换到配置文件所在目录:cd /etc/apt/sources.list.d/(2). 备份原有的企业版源:mv pve-enterprise.sources pve-enterprise.sources.backup(3). 使用社区源:echo -e Types:deb\nURIs: https://mirrors.tuna.tsinghua.edu.cn/proxmox/debian/pve\nSuites: trixie\nComponents: pve-no-subscription\nSigned-By: /usr/share/keyrings/proxmox-archive-keyring.gpg pve-no-subscription.sources(4). 备份基础软件源:mv debian.sources debian.sources.backup(5). 替换基础软件源:echo -e Types: deb\nURIs: https://mirrors.tuna.tsinghua.edu.cn/debian\nSuites: trixie trixie-updates trixie-backports\nComponents: main contrib non-free non-free-firmware\nSigned-By: /usr/share/keyrings/debian-archive-keyring.gpg debian.sources(6). 备份:mv ceph.sources ceph.sources.backup(7). 替换:echo -e Types: deb\nURIs: https://mirrors.tuna.tsinghua.edu.cn/proxmox/debian/ceph-squid\nSuites: trixie\nComponents: no-subscription\nSigned-By: /usr/share/keyrings/proxmox-archive-keyring.gpg /etc/apt/sources.list.d/ceph.sources如下图示:然后更新软件源的缓存:apt update如下图示:使用reboot重启操作系统5.安装Ubuntu-22.045.1 下载镜像下载地址:这里通过清华源下载5.2 上传镜像到pve服务器这里下载desktop ios镜像, 上传下载的desktop ios镜像到pve服务器:上传完成:5.3 创建PCI显卡映射然后先创建显卡映射一张显卡一个组, 然后创建虚拟机的时候就可以选择到独立显卡了选择设备, 这里要根据pve服务器来选择, 服务器显卡查看:可以看出, 使用的是AMD, 选择ID: 这里选择03:00,这是根据上面得出的结果创建结果:5.4 创建虚拟机下面就可以创建虚拟机啦:创建好的虚拟机如下:5.5 虚拟机绑定PCI设备创建好虚拟机后先不要开机, 需要绑定前面的PCI设备:5.6 安装系统选择启动进入控制台系统安装界面, 安装完系统之后后续启动就默认进入操作系统了好了, 虚拟机安装完成, 下面看看ubuntu里面能不能识别到显卡能不能安装上驱动,如果没问题的话,下面就可以重启一下服务器, 看看能否再次访问: 192.168.xx.xx:8006 以及能否打开虚拟机操作,如果可以,就没问题了重启一下服务器, 看看能否再次访问: 192.168.xx.xx:8006 以及能否打开虚拟机操作,如果可以,就没问题了好了,整个流程完成!6.虚拟机挂了解决办法这里虚拟机启动失败,如下:屏幕中间的文字显示为“Guest not running”中文意思是“虚拟机客户机未在运行”你当前处于 Proxmox VE (PVE) 管理界面的控制台 (Console)页面, 这个页面是虚拟机的“显示器”因为这台虚拟机100 (prox-ubuntu-22.04)当前是关机状态没有开机运行所以控制台自然什么系统画面都显示不出来只能告诉你“没在运行”屏幕上的绿色小方块通常是图形渲染或字体的显示小故障在虚拟机未启动的 VNC 控制台中非常常见可以忽略原因: 控制台依然显示 “Guest not running” 且黑屏通常是因为系统启动过程太快或者显卡驱动渲染出现了延迟/故障解决方法第一步刷新控制台页面由于浏览器 VNC 连接有时会有延迟尝试刷新一下当前的网页或者在控制台窗口里随便按一下键盘比如空格键或回车键画面通常就会弹出来第二步检查 PVE 后台任务日志最重要在左侧菜单中点击你的物理节点即pve-192进入主节点界面。在右侧找到并点击“任务历史 (Tasks)”或“系统日志 (Syslog)”查看列表里 ID 为100的虚拟机VM 100的任务如果状态显示绿色的OK说明虚拟机已经成功开机只是控制台画面卡住了大概率是显卡显示问题见第三步如果状态显示红色的Error (错误)点击这行任务进去看详细的错误日志里面会写明为什么启动失败例如 ISO 文件丢失、磁盘不足等第三步检查虚拟机的“显示”设置确保 VM 100 处于关闭状态点击左侧的“硬件 (Hardware)”菜单找到“显示 (Display)”这一项检查它是什么驱动如果你装的是 Ubuntu 22.04强烈建议将其更改为virtio-gl或std或qxl不要使用VGA或None否则容易导致控制台黑屏无法显示开机画面修改后重新点击右上角的Start Now启动试试第四步通过 Shell 强行查看报错如果上面都不行我们需要用命令行来看真正的报错点击左侧的pve-192节点点击右侧的“Shell”输入命令并回车qm start 100如果系统有报错终端会直接把红色的错误信息弹出来比如volume local:iso/ubuntu.iso does not exist表示镜像丢失分析报错日志如下:日志提示service vm:100 in error state, must be disabled and fixed first虚拟机 100 处于“错误状态”通常是集群高可用 HA 冲突导致的必须先被禁用Disable并修复后才能重新启动这是 PVE 集群环境下常见的问题通常是因为 PVE 认为这个虚拟机在集群的其他节点运行或者之前的任务非正常退出导致它被锁死在了“错误状态”修复步骤:按照以下步骤在物理节点上操作第一步在 PVE 网页界面禁用 HA高可用在左侧菜单中点击你的物理节点例如pve-192在右侧菜单中找到并点击“高可用 (HA)”点击顶部的“资源 (Resources)”标签页在列表中找到VM 100选中它点击顶部的“删除 (Remove)”按钮或者选中它后点击“禁用 (Disable)”,(注意这不会删除你的虚拟机只是把它从自动高可用集群的监控中解除)第二步在 Shell 中清理残留的错误状态如果第一步在界面上做完后仍然无法启动需要用命令行强制清理在左侧点击物理节点然后点击“Shell”进入命令行输入以下命令并回车清除 100 的 HA 状态记录ha-manager remove vm:100确保虚拟机是关闭状态再次尝试输入命令启动它qm start 100执行完以上操作, 再次回到prox-ubuntu-22.04界面点击Start Now应该就可以正常开机了还有报错信息:这通常是显卡直通 (GPU Passthrough) 配置不完整或失败导致的, 系统尝试将物理显卡的 PCI 中断引脚 (PCI_IRQ_PINS) 直通给虚拟机但数量或配置不对导致了断言失败虚拟机因此无法启动解决步骤: 按照以下步骤先尝试禁用显卡直通让虚拟机能够正常开机第一步在 PVE 界面移除显卡直通设置在左侧菜单中点击你的虚拟机100 (prox-ubuntu-22.04)点击右侧的“硬件” (Hardware)选项在硬件列表中找到类型为“PCI设备” (PCI Device)的条目通常就是你直通的那个显卡选中它点击顶部的“移除” (Remove)第二步尝试启动虚拟机移除显卡设备后回到“控制台” (Console)页面点击“Start Now”尝试启动如果成功启动恭喜问题确认就是显卡直通导致的。你可以先用 Ubuntu 系统自带的virtio-gl或std显卡驱动来使用如果依然失败说明可能有其他残留配置请进行下一步第三步强制移除残留的 PCI 设备命令行如果界面上没有 PCI 设备或者移除了仍然报同样的错需要用命令行强制清除再次回到物理节点pve-192的“Shell”中输入以下命令查看虚拟机 100 的配置文件找到 PCI 设备的残留记录cat /etc/pve/qemu-server/100.conf检查输出内容看有没有类似hostpci0: 0000:03:00.0或者hostpci1: 0000:xx:xx.x这样的行。这正是你在报错中看到的0000:03:00.0使用nano编辑器打开并编辑这个配置文件nano /etc/pve/qemu-server/100.conf找到并删除掉所有包含hostpci的行按键盘上的CtrlO保存然后按CtrlX退出编辑器现在再次尝试启动虚拟机qm start 100还有报错, 如下:报错内容依然是error writing 1 to /sys/bus/pci/devices/0000:03:00.0/reset: Inappropriate ioctl for device kvm: .../hw/pci/pci.c:1847: pci_irq_handler: Assertion ... failed.根本原因虚拟机 100 配置了显卡直通 (PCI Passthrough)直通了 PCI ID 为0000:03:00.0的硬件设备, 但是当前的 PVE 系统内核或硬件状态无法正确重置该设备导致虚拟机启动直接崩溃QEMU exited with code 1解决办法:按照以下顺序由简到繁进行排查和修复第一步在 PVE 界面移除直通设备最直接的方法点击左侧菜单的虚拟机100 (prox-ubuntu-22.04)点击右侧的“硬件” (Hardware)在列表中找到类型为“PCI设备” (PCI Device)的条目它对应的应该是0000:03:00.0选中它点击上方的“移除” (Remove)按钮移除后再次尝试点击Start Now启动虚拟机第二步修改配置文件强制移除如果第一步看不到或无效如果在“硬件”选项里找不到 PCI 设备或者移除了依然报错说明配置文件有残留点击左侧的物理节点pve-192点击右侧的“Shell”输入以下命令用nano编辑器打开虚拟机 100 的配置文件nano /etc/pve/qemu-server/100.conf在里面找到包含0000:03:00.0或hostpci字样的那一行例如hostpci0: 0000:03:00.0,pcie1将光标移到该行最前面按键盘上的Ctrl K删除这一行按Ctrl O保存按Enter确认然后按Ctrl X退出编辑器回到虚拟机 100 界面尝试启动第三步如果你必须使用显卡直通进阶修复如果确实需要这块显卡比如用来做 AI 计算或桌面渲染需要检查底层配置确保/etc/modprobe.d/vfio.conf文件中正确绑定了该设备0000:03:00.0以及它对应的声卡设备0000:03:00.1通常都需要绑定确保 GRUB 引导参数/etc/default/grub中已经开启了intel_iommuonIntel平台或amd_iommuonAMD平台以及vfio_iommu_type1.allow_unsafe_interrupts1有些显卡需要修改完 GRUB 后必须在 PVE 物理机的 Shell 中运行update-grub然后重启物理机reboot让内核参数生效