===== 第二章：安装 ======
**原文链接：** https://pve.proxmox.com/pve-docs/pve-admin-guide.html#chapter_installation
**最后更新时间：** 2026-02-25
===== 2.1 系统要求 =====
我们建议在生产环境中使用高质量的服务器硬件。为了进一步降低主机故障的影响，您可以在具有高可用（HA）虚拟机和容器的集群中运行Proxmox VE。
Proxmox VE可以使用本地存储（DAS）、SAN、NAS以及分布式存储如Ceph RBD。
==== 2.1.1 最低要求（仅用于评估） =====
这些最低要求仅用于评估目的，不应在生产环境中使用。
* CPU：64位（Intel 64或AMD64）
* 支持KVM完全虚拟化的Intel VT/AMD-V capable CPU/主板
* RAM：1 GB RAM，加上客户机所需的额外RAM
* 硬盘
* 一块网卡（NIC）
==== 2.1.2 推荐系统要求 =====
* Intel 64或AMD64，支持Intel VT/AMD-V CPU标志。
* 内存：操作系统和Proxmox VE服务最少2 GB，加上为客户机指定的内存。对于Ceph和ZFS，需要额外内存；每使用1TB存储大约需要1GB内存。
* 快速且冗余的存储，使用SSD可获得最佳效果。
* 操作系统存储：使用带有电池保护写缓存（BBU）的硬件RAID或非RAID配合ZFS（可选SSD用于ZIL）。
* 虚拟机存储：
对于本地存储，使用带有电池备份写缓存（BBU）的硬件RAID或非RAID用于ZFS和Ceph。ZFS和Ceph与硬件RAID控制器不兼容。
* 共享和分布式存储是可能的。
* 建议使用具有Power-Loss-Protection（PLP）的SSD以获得良好性能。不建议使用消费级SSD。
* 冗余（多）千兆网卡，根据首选存储技术和集群设置可能需要额外的网卡。
* 对于PCI(e)直通，CPU需要支持VT-d/AMD-d标志。
==== 2.1.3 简单的性能 overview =====
要获取已安装Proxmox VE系统上CPU和硬盘性能的概述，请运行随附的pveperf工具。
这只是一个非常快速和一般的基准测试。建议进行更详细的测试，特别是关于系统I/O性能的测试。
==== 2.1.4 支持的Web浏览器 =====
要访问基于Web的用户界面，我们建议使用以下浏览器之一：
* Firefox，当前年度版本或最新的Extended Support Release
* Chrome，当前年度版本
* Microsoft当前支持的Edge版本
* Safari，当前年度版本
从移动设备访问时，Proxmox VE将显示一个轻量级、基于触摸的界面。
===== 2.2 准备安装介质 =====
从以下地址下载安装程序ISO镜像：https://www.proxmox.com/en/downloads/proxmox-virtual-environment/iso
Proxmox VE安装介质是一个混合ISO镜像。它有两种工作方式：
* 可直接烧录到CD或DVD的ISO镜像文件。
* 可直接复制到USB闪存驱动器的原始扇区（IMG）镜像文件。
使用USB闪存驱动器安装Proxmox VE是推荐的方式，因为它速度更快。
==== 2.2.1 准备USB闪存驱动器作为安装介质 ====
闪存驱动器需要至少1 GB的可用存储空间。
请勿使用UNetbootin。它无法与Proxmox VE安装镜像配合使用。
确保USB闪存驱动器未挂载且不包含任何重要数据。
==== 2.2.2 GNU/Linux说明 ====
在类Unix操作系统上，使用dd命令将ISO镜像复制到USB闪存驱动器。首先找到USB闪存驱动器的正确设备名称（见下文）。然后运行dd命令。
# dd bs=1M conv=fdatasync if=./proxmox-ve_*.iso of=/dev/XYZ
请务必将/dev/XYZ替换为正确的设备名称，并调整输入文件名（if）路径。
请非常小心，不要覆盖错误的磁盘！
===== 查找正确的USB设备名称 =====
有两种方法可以找出USB闪存驱动器的名称。第一种是比较插入闪存驱动器前后dmesg命令输出的最后几行。第二种是比较lsblk命令的输出。打开终端并运行：
# lsblk
然后插入您的USB闪存驱动器并再次运行命令：
# lsblk
将出现一个新设备。这就是您要使用的设备。为了更加安全，请检查报告的容量是否与您的USB闪存驱动器匹配。
==== 2.2.3 macOS说明 ====
打开终端（Spotlight中查询Terminal）。
使用hdiutil的convert选项将.iso文件转换为.dmg格式，例如：
# hdiutil convert proxmox-ve_*.iso -format UDRW -o proxmox-ve_*.dmg
macOS倾向于自动为输出文件名添加.dmg。
要获取当前设备列表，请运行命令：
# diskutil list
现在插入USB闪存驱动器并再次运行此命令，以确定分配给它的设备节点。（例如，/dev/diskX）
# diskutil list
# diskutil unmountDisk /dev/diskX
将X替换为上一个命令中的磁盘编号。
# sudo dd if=proxmox-ve_*.dmg bs=1M of=/dev/rdiskX
在最后一个命令中使用rdiskX而不是diskX。它将提高写入速度。
==== 2.2.4 Windows说明 ====
===== 使用Etcher =====
Etcher开箱即用。从https://etcher.io下载Etcher。它将引导您完成选择ISO和USB闪存驱动器的过程。
===== 使用Rufus =====
Rufus是一个更轻量的替代方案，但您需要使用DD模式才能使其工作。从https://rufus.ie/下载Rufus。安装它或使用便携版本。选择目标驱动器和Proxmox VE ISO文件。
一旦您开始，必须点击否，以回答询问下载不同版本GRUB的对话框。在下一个对话框中选择DD模式。
===== 2.3 使用Proxmox VE安装程序 =====
安装程序ISO镜像包括：
* 完整的操作系统（Debian Linux，64位）
* Proxmox VE安装程序，使用ext4、XFS、BTRFS（技术预览）或ZFS对本地磁盘进行分区并安装操作系统
* 支持KVM和LXC的Proxmox VE Linux内核
* 用于管理虚拟机、容器、主机系统、集群以及所有必要资源的完整工具集
* 基于Web的管理界面
所选驱动器上的所有现有数据将在安装过程中被删除。安装程序不会为其他操作系统添加启动菜单条目。
请插入准备好的安装介质（例如，USB闪存驱动器或CD-ROM）并从中启动。
确保在服务器的固件设置中启用了从安装介质启动（例如USB）。在8.1之前的版本启动安装程序时需要禁用安全启动。
选择正确的启动项后（例如，从USB启动），将显示Proxmox VE菜单，可以选择以下选项之一：
* **Install Proxmox VE（Graphical）**：启动正常安装。可以仅使用键盘来使用安装向导。可以通过按下ALT键与相应按钮的下划线字符组合来点击按钮。例如，ALT + N点击下一步按钮。
* **Install Proxmox VE（Terminal UI）**：启动终端模式安装向导。它提供了与图形安装程序相同的整体安装体验，但对非常旧和非常新的硬件具有更好的兼容性。
* **Install Proxmox VE（Terminal UI, Serial Console）**：启动终端模式安装向导，还设置Linux内核以使用机器的第一个串行端口进行输入和输出。如果机器完全是无头的且只有一个串行控制台可用，则可以使用此选项。
两种模式使用相同的安装过程代码库，以受益于十余年的bug修复并确保功能 parity。
如果图形安装程序由于驱动程序问题等无法正确工作，可以使用Terminal UI选项。另见添加nomodeset内核参数。
* **Advanced Options: Install Proxmox VE（Graphical, Debug Mode）**：以调试模式启动安装。将在多个安装步骤打开一个控制台。如果出现问题，这有助于调试情况。要退出调试控制台，请按CTRL-D。此选项可用于启动具有所有基本工具的实时系统。例如，可用于修复降级的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固件设置实用程序中关闭安全启动才能运行此选项。
您通常选择Install Proxmox VE（Graphical）开始安装。
第一步是阅读我们的EULA（最终用户许可协议）。之后，您可以选择安装的目标硬盘。
默认情况下，将使用整个服务器并删除所有现有数据。在继续安装之前，请确保服务器上没有重要数据。
Options按钮允许您选择目标文件系统，默认为ext4。如果选择ext4或xfs作为文件系统，安装程序将使用LVM，并提供其他选项来限制LVM空间。
Proxmox VE也可以安装在ZFS上。由于ZFS提供多种软件RAID级别，这对于没有硬件RAID控制器的系统是一种选择。必须在Options对话框中选择目标磁盘。更多ZFS特定设置可以在Advanced Options下更改。
不支持在任何硬件RAID之上运行ZFS，可能导致数据丢失。
下一页询问基本配置选项，如您的位置、时区和键盘布局。位置用于选择附近的下载服务器，以加快更新速度。安装程序通常能够自动检测这些设置，因此只有在自动检测失败或您想使用不在您国家常用的键盘布局时才需要更改它们。
接下来需要指定超级用户（root）的密码和电子邮件地址。密码必须至少由8个字符组成。强烈建议使用更强的密码。一些指南：
* 使用至少12个字符的最小密码长度。
* 包括小写和大写字母、数字和符号。
* 避免字符重复、键盘模式、常见字典单词、字母或数字序列、用户名、亲属或宠物名称、浪漫链接（当前或过去的）以及传记信息（例如ID号码、祖先姓名或日期）。
电子邮件地址用于向系统管理员发送通知。例如：
* 关于可用包更新的信息。
* 定期cron作业的错误消息。
最后一步是网络配置。在下拉菜单中，UP的网络接口名称前会显示一个实心圆。请注意，在安装期间您可以指定IPv4或IPv6地址，但不能同时指定两者。要配置双栈节点，请在安装后添加额外的IP地址。
下一步显示先前选择选项的摘要。请重新检查每个设置，如果需要更改设置，请使用上一步按钮。
点击安装后，安装程序将开始格式化磁盘并将包复制到目标磁盘。请等待此步骤完成；然后移除安装介质并重启系统。
复制包通常需要几分钟，主要取决于安装介质和目标磁盘的性能。
复制和设置包完成后，您可以重启服务器。默认情况下，几秒钟后会自动完成。
**安装失败**
如果安装失败，请在第二个TTY（CTRL + ALT + F2）上查看具体错误，并确保系统满足最低要求。
如果安装仍然无法工作，请查看如何获取帮助章节。
==== 2.3.1 安装后访问管理界面 ====
成功安装并重启系统后，您可以使用Proxmox VE Web界面进行进一步配置。
* 将浏览器指向安装期间给出的IP地址和端口8006，例如：https://youripaddress:8006
* 使用安装期间选择的root（PAM realm）用户名和密码登录。
* 上传订阅密钥以获取企业存储库的访问权限。否则，您需要设置一个公共的、测试较少的包存储库，以获取安全修复、bug修复和新功能的更新。
* 检查IP配置和主机名。
* 检查时区。
* 检查您的防火墙设置。
==== 2.3.2 高级LVM配置选项 ====
如果使用ext4或xfs，安装程序会创建一个名为pve的卷组（VG），以及名为root、data和swap的额外逻辑卷（LV）。要控制这些卷的大小，请使用：
* **hdsize**：定义要使用的总硬盘大小。这样，您可以保留硬盘上的空闲空间以进行进一步分区（例如，在同一硬盘上创建可用于LVM存储的额外PV和VG）。
* **swapsize**：定义交换卷的大小。默认值是已安装内存的大小，最小4 GB，最大8 GB。结果值不能大于硬盘大小的八分之一（hdsize / 8）。如果设置为0，将不创建交换卷。
* **maxroot**：定义根卷的最大大小，存储操作系统。48 GiB以上存储可用时，默认值为硬盘大小的四分之一（hdsize / 4），最大96 GiB。48 GiB以下存储可用时，根卷大小至少为硬盘大小的一半（hdsize / 2）。
* **maxvz**：定义数据卷的最大大小。实际数据卷大小为：datasize = hdsize - rootsize - swapsize - minfree。其中datasize不能大于maxvz。对于LVM thin，仅当datasize大于4GB时才会创建数据池。如果设置为0，将不创建数据卷，存储配置将相应调整。
* **minfree**：定义应在LVM卷组pve中保留的空闲空间量。128GB以上存储可用时，默认值为16GB，否则使用hdsize/8。LVM需要在VG中留出空闲空间以创建快照（lvmthin快照不需要）。
==== 2.3.3 高级ZFS配置选项 ====
如果使用ZFS，安装程序会创建ZFS池rpool。不会创建交换空间，但您可以在安装磁盘上保留一些未分区的空间用于交换。您也可以在安装后创建交换zvol，尽管这可能导致问题。
* **ashift**：为创建的池定义ashift值。ashift需要至少设置为底层磁盘的扇区大小（2的ashift次方是扇区大小），或可能放入池中的任何磁盘（例如缺陷磁盘的更换）。
* **compress**：定义是否为rpool启用压缩。
* **checksum**：定义应为rpool使用哪种校验算法。
* **copies**：定义rpool的copies参数。请查看zfs(8)手册页以了解语义，以及为什么它不能替代磁盘级别的冗余。
* **ARC max size**：定义ARC可以增长到的最大大小，从而限制ZFS将使用的内存量。另请参阅关于如何限制ZFS内存使用的部分以了解更多详情。
* **hdsize**：定义要使用的总硬盘大小。这对于在硬盘上保留空闲空间以进行进一步分区很有用（例如创建交换分区）。hdsize仅适用于可启动磁盘，即RAID0、RAID1或RAID10的第一个磁盘或镜像，以及RAID-Z[123]的所有磁盘。
==== 2.3.4 高级BTRFS配置选项 ====
使用BTRFS时不会创建交换空间，但您可以在安装磁盘上保留一些未分区的空间用于交换。您可以创建单独分区、BTRFS子卷或使用btrfs filesystem mkswapfile命令创建交换文件。
* **compress**：定义是否为BTRFS子卷启用压缩。支持不同的压缩算法：on（等同于zlib）、zlib、lzo和zstd。默认为off。
* **hdsize**：定义要使用的总硬盘大小。这对于在硬盘上保留空闲空间以进行进一步分区很有用（例如创建交换分区）。
==== 2.3.5 ZFS性能提示 ====
ZFS在大量内存下工作效果最佳。如果您打算使用ZFS，请确保有足够的RAM。一个好的计算方法是4GB加上每TB RAW磁盘空间1GB RAM。
ZFS可以使用专用驱动器作为写缓存，称为ZFS Intent Log（ZIL）。为此使用快速驱动器（SSD）。可以使用以下命令在安装后添加：
# zpool add log
==== 2.3.6 添加nomodeset内核参数 ====
由于图形驱动程序的问题，在非常旧或非常新的硬件上可能会出现问题。如果安装启动时挂起，您可以尝试添加nomodeset参数。这可以防止Linux内核加载任何图形驱动程序，并强制其继续使用BIOS/UEFI提供的帧缓冲区。
在Proxmox VE引导加载程序菜单中，导航到Install Proxmox VE（Terminal UI）并按e编辑条目。使用箭头键，导航到以linux开头的行，将光标移动到该行的末尾，并添加参数nomodeset，与最后一个现有参数用空格分隔。
然后按Ctrl-X或F10启动配置。
===== 2.4 无人值守安装 =====
自动化安装方法允许以无人值守的方式安装Proxmox VE。这使您能够完全自动化裸机上的设置过程。安装完成并启动主机后，可以使用Ansible等自动化工具进一步配置安装。
安装程序的必要选项必须在答案文件中提供。该文件允许使用过滤规则来确定应使用哪些磁盘和网络卡。
要使用自动化安装，首先需要选择从中获取答案文件的来源，然后准备包含该选择的安装ISO。
准备好ISO后，其初始启动菜单将显示一个新的启动项名为Automated Installation，10秒超时后自动选择。
===== 2.5 在Debian上安装Proxmox VE =====
Proxmox VE作为一组Debian包发布，可以安装在标准Debian安装之上。配置存储库后，您需要运行以下命令：
# apt-get update
# apt-get install proxmox-ve
在现有Debian安装上安装看起来很容易，但它假定基础系统已正确安装，并且您知道如何配置和使用本地存储。您还需要手动配置网络。
一般来说，这并不简单，特别是使用LVM或ZFS时。
详细的分步操作指南可在wiki上找到。