第二章 安装Proxmox VE

第二章 安装Proxmox VE

Proxmox VE 基于 Debian 系统构建。因此，Proxmox 提供的安装磁盘映像（ISO 文件）包含了一个完整的 Debian 系统以及所有必要的 Proxmox VE 软件包。

安装程序将引导用户完成系统设置，包括对本地磁盘进行分区、应用基本系统配置（如时区、语言、网络设置）以及安装所有必需的软件包。整个过程通常不会超过几分钟。对于新用户和现有用户，使用提供的 ISO 文件进行安装是推荐的方法。 

此外，Proxmox VE 也可以安装在现有的 Debian 系统之上。此选项仅适用于高级用户，因为需要具备 Proxmox VE 的深入知识。

1.1 系统要求

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

Proxmox VE 支持多种存储类型，包括本地存储（直接附加存储）、存储区域网络（SAN）、网络附加存储（NAS）以及分布式存储（如 Ceph RBD）。详细信息请参阅“存储”章节。

1.1.1 评估最低要求

以下最低要求仅适用于评估目的，不建议在生产环境中使用

- 中央处理器（CPU）：64 位（英特尔 64 或 AMD64） 

- 支持 KVM 全虚拟化的具备 Intel VT/AMD-V 功能的 CPU/主板 

- 内存：1GB 内存，外加运行虚拟机所需的额外内存 

- 硬盘驱动器 

- 一张网络接口卡（NIC）

1.1.2 推荐系统要求

- 中央处理器（CPU）：64 位架构（英特尔 64 或 AMD64），且支持 KVM 全虚拟化的 CPU/主板（需具备 Intel VT 或 AMD-V 功能）。 

- 内存：操作系统和 Proxmox VE 服务至少需要 2GB 内存；此外，还需为虚拟机分配额外的内存。对于 Ceph 和 ZFS，每使用 1TB 存储空间，大约需要额外 1GB 内存。 

- 硬盘驱动器：快速且冗余的存储设备，使用固态硬盘（SSD）可获得最佳性能。 

- 操作系统存储：建议使用带有电池保护写缓存（BBU）的硬件 RAID 或结合 ZFS 的非 RAID 配置（可选 SSD 用于 ZIL）。 

- 虚拟机存储：对于本地存储，建议使用带有电池缓存（BBU）的硬件 RAID 或针对 ZFS 和 Ceph 的非 RAID 配置。注意，ZFS 和 Ceph 不兼容硬件 RAID 控制器。 

- 网络接口卡（NIC）：冗余的千兆位或更高速度的网络接口卡（NIC），根据所选存储技术和集群设置可配备额外 NIC。 

- PCI(e) 透传支持：CPU 需要支持 VT-d 或 AMD-Vi 标志。

1.1.3 简单性能概览

要概览已安装的 Proxmox VE 系统中 CPU 和硬盘的性能，请运行随附的 pveperf 工具。  

1.1.4 支持访问网络界面的网络浏览器

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

- 当前年份发布的 Firefox 浏览器版本，或最新的延长支持版（ESR）Firefox。  

- 当前年度发布的 Chrome 浏览器版本。  

- 微软当前受支持的 Edge 浏览器版本。  

- 当前年度发布的 Safari 浏览器版本。

从移动设备访问时，Proxmox VE 将显示一个轻量级的触摸式界面。

1.2 准备安装介质

请从以下网址下载 Proxmox VE 的安装程序 ISO 镜像文件：https://www.proxmox.com/en/downloads/proxmox-virtual-environment/-iso 

Proxmox VE 的安装介质采用混合 ISO 映像格式，具备两种使用方式： 

• 可将其作为标准 ISO 镜像文件刻录至 CD 或 DVD，用于基于光盘的安装。 

• 也可将其直接复制到 U 盘（USB 闪存盘），作为原始扇区（IMG）镜像文件使用，适用于基于 U 盘的安装。 

推荐使用 U 盘进行安装，因为这种方式具有更快的读写速度和更高的安装效率。

1.2.1 准备USB闪存驱动器作为安装介质 

闪存驱动器需要至少有 1GB 的可用存储空间

笔记：请勿使用 UNetbootin。它无法与 Proxmox VE 安装映像配合使用。

重要：请确保 U 盘未被挂载且不包含任何重要数据。 

  

1.2.2 GNU/Linux 使用说明 

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

笔记：请务必用正确的设备名称替换 /dev/XYZ，并根据需要调整输入文件名（如果有的话）的路径。

小心：一定要非常小心，切勿误写入错误的磁盘！

1.2.3 MacOS使用说明 

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

说明：macOS 倾向于自动将 .dmg 添加到输出文件名中。

笔记：请务必用正确的设备名称替换 /dev/diskX，并根据需要调整输入文件名（如果有的话）的路径。rdiskX，而不是 diskX，在最后一个命令中。它将提高写入速度。

1.2.4 Windows 使用说明 

Etcher 工具无需额外配置即可直接使用。请从以下网址下载 Etcher：https://etcher.io。该工具将引导您完成选择 ISO 文件和 USB 闪存驱动器的整个过程。

Rufus 是一种更为轻量级的替代方案，但要正确写入混合 ISO 映像，您需要选择 DD 模式进行操作。请从以下网址下载 Rufus：https://rufus.ie/。您可以选择安装该工具或直接使用其便携式版本。在操作过程中，请指定目标驱动器以及 Proxmox VE 的 ISO 文件。

1.3 使用 Proxmox VE 安装程序

Proxmox VE 的安装程序 ISO 映像包含以下内容： 

- 完整的操作系统（基于 Debian Linux，64 位架构） 

- Proxmox VE 安装程序，支持对本地磁盘进行分区并安装操作系统（文件系统选项包括 ext4、XFS、BTRFS（技术预览）或 ZFS） 

- 针对 KVM 和 LXC 进行优化的 Proxmox VE Linux 内核 

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

- 基于 Web 的管理界面

请插入已准备好的安装介质（例如 USB 闪存驱动器或 CD-ROM），并从该介质引导系统。 

选择正确的引导条目（例如，从 USB 启动）后，Proxmox VE 菜单将显示，并提供以下选项：

1. 安装 Proxmox VE（图形模式）启动标准图形化安装向导。

2. 安装 Proxmox VE（终端 UI 模式）

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

3. 安装 Proxmox VE（终端 UI、串行控制台模式）

启动基于终端的安装向导，并将 Linux 内核配置为通过机器的第一个串行端口进行输入和输出。此选项适用于完全无头的计算机环境，且仅依赖串行控制台。

两种安装模式在实际安装过程中共享相同的代码库，从而受益于十多年的错误修复，并确保功能一致性。

4. 高级选项：安装 Proxmox VE（图形、调试模式）

以调试模式启动安装程序。调试控制台将在多个安装步骤中打开，便于在出现问题时进行调试。要退出调试控制台，请按 `Ctrl-D`。此选项可用于启动 live 系统，例如修复降级的 ZFS rpool 或现有 Proxmox VE 设置的引导加载程序问题。 

5. 高级选项：安装 Proxmox VE（终端 UI、调试模式）

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

6. 高级选项：安装 Proxmox VE（串行控制台调试模式）

与基于终端的调试模式类似，但额外将 Linux 内核配置为通过机器的第一个串行端口进行输入和输出。

7. 高级选项：安装 Proxmox VE（自动模式）

以无人参与模式启动安装程序，尽管当前 ISO 文件可能尚未完全准备好支持自动安装。此选项可用于收集硬件详细信息或调试自动安装设置。有关更多信息，请参阅“无人值守安装”章节。

8. 高级选项：Rescue Boot

使用此选项可以从现有安装引导系统。它会搜索所有连接的硬盘，并尝试使用 ISO 中的 Linux 内核直接引导至目标磁盘。此功能在引导加载程序（如 GRUB 或 systemd-boot）出现问题或 BIOS/UEFI 无法从磁盘读取引导块时特别有用。 

9. 高级选项：测试内存（memtest86+）

运行 memtest86+ 工具以检查内存是否正常工作且无错误。请注意，在 UEFI 固件设置实用程序中必须关闭安全启动功能才能运行此选项。

通常情况下，用户会选择“安装 Proxmox VE（图形模式）”以开始安装过程。

第一步：阅读 EULA

首先需要阅读并接受最终用户许可协议（EULA）。随后，选择用于安装的目标硬盘。

文件系统选项

通过点击“Options”按钮，可以选择目标文件系统，默认为 ext4。如果选择 ext4 或 xfs 作为文件系统，安装程序将启用逻辑卷管理（LVM），并提供限制 LVM 空间的附加选项（详见下文）。 

Proxmox VE 也可以安装在 ZFS 上。由于 ZFS 提供了多种软件 RAID 级别，因此对于没有硬件 RAID 控制器的系统，这是一个可行的选择。必须在“Options”对话框中指定目标磁盘，并可在“Advanced Options”下调整更多 ZFS 相关设置。 

基本配置选项

接下来，需要提供一些基本配置选项，包括位置、时区和键盘布局。这些设置用于选择附近的下载服务器以提高更新速度。安装程序通常能够自动检测这些设置，但在极少数情况下可能需要手动更改，例如当自动检测失败或需要使用不常见的键盘布局时。 

超级用户配置

需要指定超级用户（root）的密码和电子邮件地址。密码长度必须至少为 8 个字符，强烈建议使用更强的密码。以下是一些密码准则： 

1. 密码长度至少为 12 个字符。 

2. 包括小写和大写字母、数字及符号。 

3. 避免重复字符、键盘模式、常用词典单词、字母或数字序列、用户名、亲戚或宠物姓名、浪漫关系（当前或过去）以及传记信息（如 ID 号、祖先姓名或日期）。 

提供的电子邮件地址将用于向系统管理员发送通知，例如： 

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

- 来自定期 cron 作业的错误消息。 

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

网络配置

最后一步是网络配置。在下拉菜单中，处于 UP 状态的网络接口将在其名称前显示一个实心圆圈。请注意，在安装过程中只能指定 IPv4 或 IPv6 地址，但不能同时指定两者。若需配置双栈节点，请在安装完成后添加其他 IP 地址。 

完成上述步骤后，将显示先前选择的所有选项的摘要。请仔细检查每个设置，如有必要，可通过“Previous”按钮返回修改。 

点击“Install”后，安装程序将开始格式化磁盘并将软件包复制到目标磁盘。请等待此步骤完成，然后移除安装介质并重新启动系统。复制软件包的时间主要取决于安装介质的速度和目标磁盘的性能，通常需要几分钟。 

安装失败

如果安装失败，请检查第二个 TTY（`Ctrl + Alt + F2`）上的特定错误信息，并确保系统满足最低要求。如果问题仍然存在，请参考“如何获取帮助”章节。

1.3.1 安装后访问管理界面

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

请在浏览器中输入安装过程中提供的 IP 地址及端口 8006（例如：`https://youripaddress:8006`），以访问 Proxmox VE 的管理界面。使用安装过程中设置的 `root@pam` 用户名及其对应的密码登录系统。  

为获取对 Enterprise 存储库的访问权限，请上传您的订阅密钥。若未提供订阅密钥，则需要手动配置一个公共但测试较少的软件包存储库，以确保能够接收安全修复、错误修复和新功能更新。  

接下来，请执行以下检查步骤以确保系统的正确配置：  

- 检查 IP 配置和主机名是否正确设置。  

- 确认时区设置符合预期。  

- 审核防火墙规则，确保其允许必要的网络流量。  

1.3.2 高级 LVM 配置选项

在安装过程中，Proxmox VE 默认会创建一个名为 `pve` 的卷组（Volume Group, VG）。如果选择 ext4 或 xfs 文件系统，则会进一步创建三个逻辑卷（Logical Volume, LV），分别为 `root`、`data` 和 `swap`。用户可以通过以下参数控制这些卷的大小：  

1. 硬盘大小（hdsize） 

定义总硬盘空间的使用量。此设置允许您在硬盘上保留部分未分配的空间，以便后续用于创建额外的物理卷（Physical Volume, PV）或卷组（VG），从而扩展 LVM 存储能力。  

2. 交换大小（swapsize）  

   定义 `swap` 卷的大小。默认值为已安装内存的大小，范围限制在最小 4GB 和最大 8GB 之间。最终值不得超过 `hdsize/8`。  

   

3. 最大根卷大小（maxroot）

   定义存储操作系统的根卷的最大大小。其限制为 `hdsize/4`。  

4. 数据卷最大大小（maxvz） 

   定义 `data` 卷的最大大小。实际分配的大小计算公式如下：  

   ```

   数据大小 = hdsize - rootSize - swapSize - minfree

   ```  

   其中，`datasize` 不得超过 `maxvz`。  

5. 最小可用空间（minfree）  

   定义卷组 `pve` 中应保留的可用空间量。如果总可用存储空间超过 128GB，默认保留 16GB；否则，保留空间将设置为 `hdsize/8`。  

1.3.3 高级 ZFS 配置选项*

如果选择使用 ZFS，安装程序将创建名为 `rpool` 的 ZFS 池。默认情况下不会创建交换空间，但您可以在安装磁盘上保留部分未分区的空间以供后续配置交换空间使用。此外，您也可以在安装完成后创建一个 ZFS 卷（zvol）作为交换空间，尽管此操作可能会引发某些问题（请参阅 ZFS 交换说明）。  

1. **ASHIFT**  

定义所创建池的 ashift 值。ashift 至少需要设置为底层磁盘扇区大小的对数值（即扇区大小为 \(2^n\) 时，ashift 应设置为 \(n\)），或可能放入池中的任何磁盘（例如，用于替换有缺陷的磁盘）的对应值。  

2. **压缩compress**  

定义是否为 `rpool` 启用数据压缩功能。  

3. **校验checksum**  

定义 `rpool` 应使用的校验和算法类型。  

4. **副本copies**  

定义 `rpool` 的 copies 参数值。请查阅 `zfs(8)` 手册页以了解其语义，并注意该参数不能替代磁盘级别的冗余机制。  

5. **ARC 最大大小**  

定义 ZFS 自适应替换缓存（ARC）可增长到的最大内存限制，从而控制 ZFS 使用的系统内存量。更多详细信息，请参见如何限制 ZFS 内存使用的相关文档。  

6. **hdsize**  

定义总硬盘空间的使用量。此参数允许您在硬盘上保留可用空间以供进一步分区使用（例如，创建交换分区）。`hdsize` 仅适用于启动磁盘，包括 RAID0、RAID1 或 RAID10 的第一个磁盘或镜像，以及 RAID-Z 中的所有磁盘 [123]。  

1.3.4 高级 BTRFS 配置选项 

如果选择使用 BTRFS，安装程序不会创建交换空间，但您可以在安装磁盘上保留部分未分区的空间以供后续配置交换空间使用。您可以使用以下方法之一创建交换空间：单独分区、BTRFS 子卷或通过 `btrfs filesystem mkswapfile` 命令创建交换文件。  

1. **compress**  

定义是否为 BTRFS 子卷启用数据压缩功能。支持的压缩算法包括：`on`（等同于 `zlib`）、`zlib`、`lzo` 和 `zstd`。默认值为 `off`。  

2. **hdsize**  

定义总硬盘空间的使用量。此参数允许您在硬盘上保留可用空间以供进一步分区使用（例如，创建交换分区）。  

1.3.5 ZFS 性能提示

ZFS 在具有大量内存的情况下表现最佳。如果您计划使用 ZFS，请确保系统中配备足够的 RAM。一个合理的计算方法是：4GB 基础内存加上每 TB 原始磁盘空间额外分配 1GB 内存。  

ZFS 可以使用专用驱动器作为写入高速缓存（称为 ZFS Intent Log, ZIL）。建议为此目的使用快速驱动器（如 SSD）。安装完成后，可以通过以下命令添加 ZIL：  

1.3.6 添加 nomodeset 内核参数  

由于图形驱动程序的原因，非常旧或非常新的硬件可能会导致引导过程出现问题。如果安装过程中系统挂起，可以尝试添加 `nomodeset` 参数。此参数会阻止 Linux 内核加载任何图形驱动程序，并强制其继续使用 BIOS/UEFI 提供的帧缓冲区。  

在 Proxmox VE 引导加载程序菜单中，导航至“安装 Proxmox VE（终端 UI）”，然后按 `e` 编辑条目。使用箭头键导航至以 `linux` 开头的行，将光标移动到该行末尾，并添加参数 `nomodeset`（与现有参数之间用空格分隔）。完成编辑后，按 `Ctrl-X` 或 `F10` 引导配置。  

1.4 无人值守安装  

自动安装方法允许以无人值守的方式安装 Proxmox VE，从而实现裸机环境下的完全自动化设置过程。安装完成后，可以使用 Ansible 等自动化工具进一步配置系统。  

安装程序所需的必要选项必须通过应答文件提供。此文件允许使用筛选规则确定应使用哪些磁盘和网卡。要启用自动安装，首先需要选择从中获取答案文件的源，并使用相应选项准备安装 ISO。准备好 ISO 后，其初始引导菜单将显示一个名为“Automated Installation”的新引导条目，该条目将在 10 秒超时后自动选中。  

有关无人值守安装的更多详细信息，请访问我们的 Wiki 页面。  

1.5 在 Debian 上安装 Proxmox VE 

Proxmox VE 作为一组 Debian 软件包提供，可以安装在标准 Debian 系统之上。在配置存储库后，您需要运行以下命令进行安装：  

虽然在现有的 Debian 安装之上安装 Proxmox VE 看起来较为简单，但此过程假定基本系统已经正确安装，并且您熟悉本地存储和网络的配置方法。特别是在使用 LVM 或 ZFS 时，这并非易事。详细的分步指南可在我们的 Wiki 页面上找到。