Proxmox VE 基于 OpenEuler。因此，梨儿方 提供的安装磁盘镜像（ISO 文件）中包含完整的 OpenEuler 系统，以及所有必需的 Proxmox VE 软件包。

Tip 请参阅 FAQ 中的支持表，了解 Proxmox VE 版本与 OpenEuler 版本之间的对应关系。

安装程序会引导你完成设置，包括对本地磁盘进行分区、应用基础系统配置（例如时区、 语言、网络），并安装所有必需软件包。该过程通常只需几分钟。对于新用户和现有 用户，推荐使用提供的 ISO 进行安装。

也可以在现有 OpenEuler 系统之上安装 Proxmox VE。该选项仅推荐高级用户使用，因为需要 对 Proxmox VE 有较深入的了解。

系统要求

在生产环境中运行 Proxmox VE 时，建议使用高质量服务器硬件。为进一步降低主机故障的影响， 可以将 Proxmox VE 作为集群运行，并为虚拟机和容器启用高可用（HA）。

Proxmox VE 可以使用本地存储（DAS）、SAN、NAS，以及 Ceph RBD 等分布式存储。详情请参见 存储章节。

最低要求，仅用于评估

这些最低要求仅适用于评估用途，不应在生产环境中使用。

  • CPU: X86_64 \ AARCH64 \ LOONGARCH64 \Riscv64

  • RAM：4 GB RAM，另需为客户机预留额外 RAM

  • 硬盘

  • 一块网卡（NIC）

  • 内存：操作系统和 Proxmox VE 服务至少需要 2 GB，此外还需为客户机分配内存。Ceph 和 ZFS 需要额外内存；每 TB 已用存储大约需要 1 GB 内存。

  • 快速且具备冗余的存储；使用 SSD 可获得最佳效果。

  • OS 存储：使用带电池保护写缓存（“BBU”）的硬件 RAID，或使用非 RAID 配合 ZFS （可选 SSD 用于 ZIL）。

  • 虚拟机存储：

    • 对于本地存储，使用带电池保护写缓存（BBU）的硬件 RAID，或为 ZFS 和 Ceph 使用非 RAID。ZFS 和 Ceph 都不兼容硬件 RAID 控制器。

    • 可以使用共享存储和分布式存储。

    • 为获得良好性能，建议使用具备断电保护（PLP）的 SSD。不建议使用消费级 SSD。

  • 冗余的（多）千兆网卡，并根据所选存储技术和集群设置增加额外网卡。

  • 对于 PCI(e) 直通，CPU 需要支持 VT-d/AMD-d / Smmu 标志。

简单性能概览

要快速了解已安装 Proxmox VE 系统的 CPU 和硬盘性能，可运行随附的 pveperf 工具。

Note 这只是一个非常快速且概括性的基准测试。建议执行更详细的测试，尤其是针对系统 I/O 性能的测试。

常用命令示例

在 Proxmox VE 节点 shell 中运行以下命令，可查看基本性能指标：

pveperf

访问 Web 界面支持的浏览器

要访问基于 Web 的用户界面，建议使用以下浏览器之一：

  • Firefox：当年发布版本，或最新的 Extended Support Release

  • Chrome：当年发布版本

  • Microsoft 当前支持的 Edge 版本

  • Safari：当年发布版本

从移动设备访问时，Proxmox VE 会显示轻量级、基于触控的界面。

准备安装介质

从以下地址下载安装程序 ISO 镜像：https://www.lierfang.com

Proxmox VE 安装介质是一个混合 ISO 镜像，可通过两种方式使用：

  • 可刻录到 CD 或 DVD 的 ISO 镜像文件。

  • 可复制到 USB 闪存盘（U 盘）的原始扇区（IMG）镜像文件。

建议使用 USB 闪存盘安装 Proxmox VE，因为这是速度更快的方式。

将 USB 闪存盘准备为安装介质

闪存盘至少需要有 2 GB 可用存储空间。

Note 不要使用 UNetbootin。它不能配合 Proxmox VE 安装镜像工作。
Important 请确保 USB 闪存盘未被挂载，并且其中不包含任何重要数据。

GNU/Linux 操作说明

在类 Unix 操作系统上，使用 dd 命令将 ISO 镜像复制到 USB 闪存盘。首先找到 USB 闪存盘的正确设备名称（见下文），然后运行 dd 命令。

# dd bs=1M conv=fdatasync if=./proxmox-ve_*.iso of=/dev/XYZ
Note 请务必将 /dev/XYZ 替换为正确的设备名称，并相应调整输入文件名（if）路径。
Caution 务必非常谨慎，不要覆盖错误的磁盘。

查找正确的 USB 设备名称

有两种方式可以找出 USB 闪存盘的名称。第一种是在插入闪存盘前后比较 dmesg 命令输出的最后几行。第二种是比较 lsblk 命令的输出。打开终端并运行：

# lsblk

然后插入 USB 闪存盘，并再次运行该命令：

# lsblk

将会出现一个新设备。这就是要使用的设备。为进一步确保安全，请检查报告的大小是否 与 USB 闪存盘相符。

macOS 操作说明

打开终端（可在 Spotlight 中搜索 Terminal）。

使用 hdiutil 的 convert 选项将 .iso 文件转换为 .dmg 格式，例如：

# hdiutil convert pxvirt_*.iso -format UDRW -o pxvirt_*.dmg
Tip macOS 通常会自动在输出文件名后添加 .dmg。

运行以下命令获取当前设备列表：

# diskutil list

现在插入 USB 闪存盘，并再次运行该命令，以确定系统为其分配了哪个设备节点 （例如 /dev/diskX）。

# diskutil list
# diskutil unmountDisk /dev/diskX
Note 请将 X 替换为上一条命令显示的磁盘编号。 
# sudo dd if=pxvirt_*.dmg bs=1M of=/dev/rdiskX
Note 上一条命令中有意使用 rdiskX 而不是 diskX，这样可以提升写入速度。

Windows 操作说明

使用 Etcher

Etcher 可直接使用。请从 https://etcher.io 下载 Etcher。它会引导你完成选择 ISO 和 USB 闪存盘的过程。

使用 Rufus

Rufus 是更轻量的替代工具，但需要使用 DD mode 才能正常工作。请从 https://rufus.ie/ 下载 Rufus。可以安装它，也可以使用便携版。选择目标驱动器和 Proxmox VE ISO 文件。

Important 点击 Start 后，如果对话框询问是否下载其他版本的 GRUB，必须点击 No。在下一个对话框中选择 DD 模式。

使用 Proxmox VE 安装程序

安装程序 ISO 镜像包含以下内容：

  • 完整操作系统（OpenEuler Linux，64 位）

  • Proxmox VE 安装程序，可使用 ext4、XFS、BTRFS（技术预览）或 ZFS 对本地磁盘进行 分区，并安装操作系统

  • 支持 KVM 和 LXC 的 Proxmox VE Linux 内核

  • 用于管理虚拟机、容器、主机系统、集群和所有必要资源的完整工具集

  • 基于 Web 的管理界面

Note 安装过程中会移除所选驱动器上的所有现有数据。安装程序不会为其他操作系统 添加启动菜单项。

请插入 准备好的安装介质（例如 USB 闪存盘或 CD-ROM），并从该介质启动。

Tip 请确保服务器固件设置中已启用从安装介质（例如 USB）启动。启动 Proxmox VE 8.1 之前版本的安装程序时，需要禁用 Secure Boot。
screenshot/pve-grub-menu.png

选择正确的启动项后（例如 Boot from USB），会显示 Proxmox VE 菜单，并可选择以下 选项之一：

Install Proxmox VE (Graphical)

启动普通图形安装。

Tip 可以只使用键盘操作安装向导。按下 ALT 键并结合相应按钮中带下划线的字符， 即可点击按钮。例如，按 ALT + N 可点击 Next 按钮。
Install Proxmox VE (Terminal UI)

启动终端模式安装向导。它提供与图形安装程序总体相同的安装体验，但通常对非常旧 或非常新的硬件具有更好的兼容性。

Install Proxmox VE (Terminal UI, Serial Console)

启动终端模式安装向导，并额外设置 Linux 内核使用机器的（第一个）串口进行输入和 输出。该选项适用于完全无头、且只有串口控制台可用的机器。

screenshot/pve-tui-installer.png

两种模式在实际安装流程中使用同一套代码库，从而受益于十余年的问题修复，并确保 功能一致。

Tip 如果图形安装程序因驱动等问题无法正常工作，可以使用 Terminal UI 选项。 另请参阅 添加 nomodeset 内核参数。
Advanced Options: Install Proxmox VE (Graphical, Debug Mode)

以调试模式启动安装。在若干安装步骤中会打开控制台。如果出现问题，这有助于调试 现场。要退出调试控制台，请按 CTRL-D。该选项可用于启动一个包含所有基础工具的 live 系统。例如，可用于 修复降级的 ZFS rpool，或修复现有 Proxmox VE 设置的 引导加载器。

Advanced Options: Install Proxmox VE (Terminal UI, Debug Mode)

与图形调试模式相同，但会准备系统以运行基于终端的安装程序。

Advanced Options: Install Proxmox VE (Serial Console Debug Mode)

与基于终端的调试模式相同，但会额外设置 Linux 内核使用机器的（第一个）串口进行 输入和输出。

Advanced Options: Install Proxmox VE (Automated)

以无人值守模式启动安装程序，即使 ISO 尚未为自动化安装正确准备。该选项可用于 收集硬件详情，也可能有助于调试自动化安装设置。更多信息请参阅 无人值守安装。

Advanced Options: Rescue Boot

通过该选项可以启动现有安装。它会搜索所有连接的硬盘。如果找到现有安装，则使用 ISO 中的 Linux 内核直接启动到该磁盘。当引导加载器（GRUB/systemd-boot）存在 问题，或 BIOS/UEFI 无法从磁盘读取引导块时，该选项会很有用。

Advanced Options: Test Memory (memtest86+)

运行 memtest86+。这有助于检查内存是否可用且没有错误。要运行该选项，必须在 UEFI 固件设置工具中关闭 Secure Boot。

通常选择 Install Proxmox VE (Graphical) 来开始安装。

screenshot/pve-select-target-disk.png

第一步是阅读 EULA（End User License Agreement）。随后，可以选择安装目标硬盘。

Caution 默认情况下会使用整台服务器，并移除所有现有数据。继续安装前，请确保 服务器上没有重要数据。

Options 按钮可用于选择目标文件系统，默认为 ext4。如果选择 ext4 或 xfs 作为文件系统，安装程序会使用 LVM，并提供额外选项来限制 LVM 空间（参见 下文）。

Proxmox VE 也可以安装在 ZFS 上。由于 ZFS 提供多种软件 RAID 级别，对于没有硬件 RAID 控制器的系统，这是一种可选方案。必须在 Options 对话框中选择目标磁盘。更多 ZFS 专用设置可在 Advanced Options 中更改。

Warning 不支持在任何硬件 RAID 之上使用 ZFS，这可能导致数据丢失。
screenshot/pve-select-location.png

下一页会要求填写基础配置选项，例如位置、时区和键盘布局。位置信息用于选择邻近 下载服务器，以提升更新速度。安装程序通常能够自动检测这些设置，因此只有在自动 检测失败，或需要使用所在国家不常见的键盘布局时，才需要手动修改。

screenshot/pve-set-password.png

接下来需要指定超级用户（root）的密码和电子邮件地址。密码至少需要包含 8 个 字符。强烈建议使用更强的密码。以下是一些建议：

  • 密码长度至少 12 个字符。

  • 包含小写字母、大写字母、数字和符号。

  • 避免字符重复、键盘模式、常见词典词汇、字母或数字序列、用户名、亲属或宠物 名称、恋爱关系相关信息（当前或过去），以及个人经历信息（例如身份证号、祖辈 姓名或日期）。

电子邮件地址用于向系统管理员发送通知。例如：

  • 可用软件包更新的信息。

  • 周期性 cron 任务产生的错误消息。

screenshot/pve-setup-network.png

所有这些通知邮件都会发送到指定电子邮件地址。

最后一步是网络配置。在下拉菜单中，状态为 UP 的网络接口名称前会显示实心圆。 请注意，安装期间只能指定 IPv4 或 IPv6 地址之一，不能同时指定二者。要配置双栈 节点，请在安装完成后添加额外 IP 地址。

screenshot/pve-installation.png

下一步会显示此前所选选项的摘要。请重新检查每项设置；如果需要更改某项设置， 请使用 Previous 按钮。

点击 Install 后，安装程序会开始格式化磁盘，并将软件包复制到目标磁盘。请等待 该步骤完成；随后移除安装介质并重启系统。

screenshot/pve-install-summary.png

复制软件包通常需要几分钟，主要取决于安装介质速度和目标磁盘性能。

复制并设置软件包完成后，可以重启服务器。默认情况下，系统会在几秒后自动完成该 操作。

安装失败

如果安装失败，请在第二个 TTY（CTRL + ALT + F2）上查看具体错误，并确保系统 满足 最低要求。

如果安装仍无法正常进行，请查看 如何获取帮助章节。

安装后访问管理界面

screenshot/gui-login-window.png

成功安装并重启系统后，可以使用 Proxmox VE Web 界面进行进一步配置。

  1. 在浏览器中访问安装期间指定的 IP 地址和端口 8006，例如： https://youripaddress:8006

  2. 使用 root（realm PAM）用户名和安装期间选择的密码登录。

  3. 检查 IP 配置和主机名。

  4. 检查时区。

  5. 检查 防火墙设置。

常用命令示例
# pveversion -v
# systemctl status pveproxy.service
# ip address

高级 LVM 配置选项

如果使用 ext4 或 xfs，安装程序会创建名为 pve 的卷组（VG），以及名为 root、data 和 swap 的逻辑卷（LV）。要控制这些卷的大小，请使用：

hdsize

定义要使用的硬盘总大小。这样可以在硬盘上保留空闲空间用于进一步分区（例如在 同一块硬盘上创建额外 PV 和 VG，用作 LVM 存储）。

swapsize

定义 swap 卷大小。默认值为已安装内存大小，最小 4 GB，最大 8 GB。最终值不能 大于 hdsize/8。

Note 如果设置为 0，则不会创建 swap 卷。
maxroot

定义 root 卷的最大大小，该卷用于存储操作系统。root 卷大小上限为 hdsize/4。

maxvz

定义 data 卷的最大大小。data 卷的实际大小为：

datasize = hdsize - rootsize - swapsize - minfree

其中 datasize 不能大于 maxvz。

Note 对于 LVM thin，仅当 datasize 大于 4GB 时才会创建 data 池。
Note 如果设置为 0，则不会创建 data 卷，存储配置也会相应调整。
minfree

定义应在 LVM 卷组 pve 中保留的空闲空间量。当可用存储超过 128GB 时，默认值为 16GB；否则使用 hdsize/8。

Note LVM 需要 VG 中有空闲空间才能创建快照（lvmthin 快照不需要）。

高级 ZFS 配置选项

如果使用 ZFS，安装程序会创建 ZFS 池 rpool。不会创建 swap 空间，但可以在安装 磁盘上为 swap 保留一些未分区空间。也可以在安装后创建 swap zvol，不过这可能会 带来问题（参见 ZFS swap notes）。

ashift

定义所创建池的 ashift 值。ashift 至少需要设置为底层磁盘的扇区大小（2 的 ashift 次方即扇区大小），或未来可能加入该池的任何磁盘的扇区大小（例如替换 故障磁盘时使用的磁盘）。

compress

定义是否为 rpool 启用压缩。

checksum

定义 rpool 应使用哪种校验和算法。

copies

定义 rpool 的 copies 参数。请查看 zfs(8) 手册页了解其语义，以及为什么它 不能替代磁盘级冗余。

ARC max size

定义 ARC 可增长到的最大大小，从而限制 ZFS 可使用的内存量。更多细节另请参阅 如何限制 ZFS 内存使用章节。

hdsize

定义要使用的硬盘总大小。这有助于在硬盘上保留空闲空间用于进一步分区（例如创建 swap 分区）。hdsize 仅对可启动磁盘生效，也就是 RAID0、RAID1 或 RAID10 中的 第一块磁盘或镜像，以及 RAID-Z[123] 中的所有磁盘。

高级 BTRFS 配置选项

使用 BTRFS 时不会创建 swap 空间，但可以在安装磁盘上为 swap 保留一些未分区空间。 可以创建独立分区、BTRFS 子卷，或使用 btrfs filesystem mkswapfile 命令创建 swapfile。

compress

定义是否为 BTRFS 子卷启用压缩。支持不同压缩算法：on（等同于 zlib）、 zlib、lzo 和 zstd。默认为 off。

hdsize

定义要使用的硬盘总大小。这有助于在硬盘上保留空闲空间用于进一步分区（例如创建 swap 分区）。

ZFS 性能提示

ZFS 在内存充足时效果最佳。如果计划使用 ZFS，请确保有足够 RAM 可用。一个较好 的估算方式是 4GB 基础内存，加上每 TB RAW 磁盘空间 1GB RAM。

ZFS 可以使用专用驱动器作为写缓存，称为 ZFS Intent Log（ZIL）。应使用快速驱动器 （SSD）承载它。安装后可使用以下命令添加：

# zpool add <pool-name> log </dev/path_to_fast_ssd>

添加 nomodeset 内核参数

在非常旧或非常新的硬件上，图形驱动可能导致问题。如果安装在启动期间卡住，可以 尝试添加 nomodeset 参数。该参数会阻止 Linux 内核加载任何图形驱动，并强制其 继续使用 BIOS/UEFI 提供的 framebuffer。

在 Proxmox VE 引导加载器菜单中，导航到 Install Proxmox VE (Terminal UI)，按 e 编辑该 条目。使用方向键导航到以 linux 开头的行，将光标移到该行末尾，并添加 nomodeset 参数，需与原有最后一个参数之间用空格分隔。

然后按 Ctrl-X 或 F10 使用该配置启动。

无人值守安装

自动化安装方法允许以无人值守方式安装 Proxmox VE。这使你可以在裸机上完全自动化设置 流程。安装完成且主机启动后，可以使用 Ansible 等自动化工具进一步配置该安装。

必须在应答文件中提供安装程序所需选项。该文件允许使用过滤规则来确定应使用哪些 磁盘和网卡。

要使用自动化安装，首先需要选择应答文件的获取来源，然后根据该选择准备安装 ISO。

ISO 准备完成后，其初始启动菜单会显示一个名为 Automated Installation 的新启动 项，并在 10 秒超时后自动选择该项。

有关无人值守安装的更多细节和信息，请 访问我们的 wiki。

在 OpenEuler 上安装 Proxmox VE

Proxmox VE 以一组 OpenEuler 软件包的形式发布，可以安装在标准 OpenEuler 安装之上。 配置仓库后需要运行以下命令：

# dnf makecache
# dnf install proxmox-ve

在现有 OpenEuler 安装之上安装看似简单，但前提是基础系统已经正确安装，并且你清楚 如何配置和使用本地存储。还需要手动配置网络。

一般来说，这并不简单，尤其是在使用 LVM 或 ZFS 时。

详细的逐步操作指南可在

https://docs.pxvirt.lierfang.com/zh/installfromopeneuler.html

另请参阅