安装 {pve}

{pve}基于Debian系统。这就是为什么Proxmox提供的安装磁盘镜像（ISO文件）包含了完整的Debian系统以及所有必需的{pve}包。

Tip	请参阅FAQ中的支持表格[xref:faq-support-table]，了解{pve}版本与Debian版本之间的关系。

安装程序将指导您完成设置，让您能够对本地磁盘进行分区，应用基本的系统配置（例如，时区、语言、网络）以及安装所有必需的包。这个过程不应该超过几分钟。使用提供的ISO进行安装是新用户和现有用户推荐的方法。

或者，{pve}可以安装在现有的Debian系统之上。这个选项只推荐给高级用户，因为需要有关{pve}的详细知识。

系统要求

我们建议在生产环境中使用高质量的服务器硬件运行{pve}。为了进一步减少主机故障的影响，您可以在集群中运行{pve}，并配置高可用性（HA）的虚拟机和容器。

{pve}可以使用本地存储（DAS）、SAN、NAS以及像Ceph RBD这样的分布式存储。详情请参阅存储章节。

最低评估要求

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

CPU: 64位（英特尔EMT64或AMD64）
支持KVM全虚拟化的Intel VT/AMD-V兼容CPU/主板
RAM：1 GB RAM，加上客户端所需的额外RAM
硬盘驱动器
一块网络卡（NIC）

简单性能概览

要获取已安装的 {pve} 系统上CPU和硬盘性能的概览，请运行内置的 pveperf 工具。

Note	这只是一个非常快速和一般性的基准测试。建议进行更详细的测试，特别是关于您系统的I/O性能。

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

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

Firefox，当前年份的发布版本，或最新的长期支持版本。
Chrome，一款来自今年的新版本。
微软目前支持的Edge版本
Safari，今年的一次发布

当从移动设备访问时，{pve} 将展示一个轻量级的、基于触控的界面。

准备安装介质

从以下网址下载安装器ISO镜像：{website}en/downloads/proxmox-virtual-environment/iso

The {pve} 安装介质是一个混合ISO映像。它有两种工作方式：

一个准备好烧录到CD或DVD的ISO镜像文件。
一份准备好直接复制到USB闪存盘（U盘）的原始扇区（IMG）镜像文件。

使用USB闪存盘来安装 {pve} 是推荐的方式，因为这是更快的选项。

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

U盘至少需要有1GB的可用存储空间。

Note	不要使用UNetbootin。它不能与{pve}安装镜像一起工作。

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`的转换选项将`.iso`文件转换成`.dmg`格式，例如：

# hdiutil convert proxmox-ve_*.iso -format UDRW -o proxmox-ve_*.dmg

Tip	macOS往往会自动在输出文件名后添加'.dmg'。

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

# diskutil list

现在插入USB闪存驱动器，然后再次运行此命令以确定已分配给它的设备节点（例如，/dev/diskX）。

# diskutil list
# diskutil unmountDisk /dev/diskX

Note	把X替换为上一条命令中的磁盘编号。

# sudo dd if=proxmox-ve_*.dmg bs=1M of=/dev/rdiskX

Note	在最后一个命令中使用’rdiskX’而不是’diskX’是有意为之的。这将提高写入速度。

Windows操作说明

使用Etcher

Etcher开箱即用。从https://etcher.io下载Etcher。它将引导你完成选择ISO文件和USB闪存盘的过程。

使用Rufus

Rufus是一个更轻量级的替代品，但你需要使用*DD模式*来使它工作。从https://rufus.ie/ 下载Rufus。你可以安装它或者使用便携版本。选择目标驱动器和{pve} ISO文件。

Important

一旦你点击“开始”，你必须在询问是否下载GRUB的不同版本的对话框中点击“否”。在下一个对话框中选择“DD”模式。

使用 {pve} 安装程序

安装程序 ISO 映像包括以下内容：

完整操作系统（Debian Linux，64位）
{pve} 安装程序可以对本地磁盘进行分区，支持ext4、XFS、BTRFS（技术预览版）或ZFS文件系统，并安装操作系统。
支持KVM和LXC的{pve} Linux内核
用于管理虚拟机、容器、主机系统、集群及所有必要资源的完整工具集
基于Web的管理界面

Note	在安装过程中，选定驱动器上的所有现有数据将被清除。安装程序不会为其他操作系统添加引导菜单项。

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

Tip	确保在服务器的固件设置中启用了从安装介质（例如，USB）启动。在 {pve} 版本 8.1 之前启动安装程序时，需要禁用安全启动。

在选择了正确的条目（例如，“从USB启动”）后，{pve}菜单将会显示，并且可以选择以下选项之一：

安装 {pve} (图形界面): 开始正常安装。

Tip	可以仅使用键盘来使用安装向导。可以通过按下`ALT`键以及相应按钮上下划线下的字符来点击按钮。例如，按`ALT + N`来点击`Next`按钮。

安装 {pve}（终端用户界面）: 启动终端模式安装向导。它提供了与图形安装程序相同的整体安装体验，但与非常旧和非常新的硬件通常具有更好的兼容性。
安装 {pve} (终端用户界面, 串行控制台): 启动终端模式安装向导，并额外设置Linux内核使用机器的第一个串行端口进行输入和输出。如果机器完全没有显示设备，只有一个串行控制台可用，这可以被使用。

这两种模式使用相同的代码库来进行实际的安装过程，以便从十多年的错误修复中受益并确保特性一致。

Tip	如果图形安装程序不能正确工作，比如因为驱动问题，可以使用’终端用户界面’选项。另见添加`nomodeset`内核参数。

高级选项：安装 {pve}（图形界面，调试模式）: 以调试模式开始安装。在几个安装步骤中会打开一个控制台。如果出现问题，这有助于调试情况。要退出调试控制台，请按`CTRL-D`。这个选项可以用来以所有基本工具可用的方式启动一个实时系统。例如，你可以使用它来修复一个降级的ZFS 'rpool’或为现有的{pve}设置修复引导加载程序。
高级选项：安装 {pve}（终端用户界面，调试模式）: 与图形化调试模式相同，但是准备系统运行基于终端的安装程序。
高级选项：安装 {pve}（串行控制台调试模式）: 启用基于终端的调试模式，并且额外设置Linux内核使用机器的第一个串行端口进行输入和输出。
高级选项：救援启动: 使用这个选项，您可以启动现有的安装。它会搜索所有连接的硬盘。如果找到现有的安装，它会直接使用ISO中的Linux内核引导到那个硬盘。如果有与引导加载程序（GRUB/systemd-boot）相关的问题，或者BIOS/UEFI无法从磁盘读取启动块，这个功能会很有用。
高级选项：内存测试 (memtest86+): 运行 memtest86+。这对于检查内存是否正常工作且没有错误非常有用。在UEFI固件设置实用程序中必须关闭Secure Boot才能运行此选项。

你通常会选择 Install {pve} (Graphical) 来开始安装。

第一步是阅读我们的EULA（最终用户许可协议）。之后，您可以选择用于安装的目标硬盘。

Caution

默认情况下，将使用整个服务器，并且将删除所有现有数据。在继续安装之前，请确保服务器上没有重要数据。

“Options`按钮允许你选择目标文件系统，默认为`ext4。如果你选择`ext4`或`xfs`作为文件系统，安装程序将使用LVM，并提供额外的选项来限制LVM空间（参见下方的xref:advanced_lvm_options）。”

{pve}也可以安装在ZFS上。由于ZFS提供了几种软件RAID级别，对于没有硬件RAID控制器的系统来说，这是一个选项。目标磁盘必须在`Options`对话框中被选中。更多ZFS特定的设置可以在高级选项下更改。

Warning

在任何硬件RAID之上使用ZFS是不被支持的，并且可能会导致数据丢失。

下一页会要求您设置一些基本配置选项，比如您的位置、时区和键盘布局。位置信息用于选择一个临近的下载服务器，以提高更新速度。安装程序通常能自动检测这些设置，因此只有在自动检测失败的罕见情况下，或者当您想使用在您所在国家不常用的键盘布局时，才需要更改这些设置。

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

使用至少12个字符的最小密码长度。
包括小写字母和大写字母、数字及符号。
避免字符重复、键盘模式、常见字典单词、字母或数字序列、用户名、亲属或宠物名字、情感链接（现在的或过去的），以及个人生物信息（例如身份证号、祖先名字或日期）。

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

关于可用的包更新的信息。
周期性“cron”任务的错误信息。

所有这些通知邮件将被发送到指定的邮箱地址。

最后一步是网络配置。在下拉菜单中，状态为’UP’的网络接口前会显示一个填充的圆圈。请注意，在安装过程中，您可以指定IPv4或IPv6地址，但不能同时指定两者。要配置双栈节点，在安装后添加额外的IP地址。

下一步会显示之前选定选项的摘要。请重新检查每个设置，如果需要更改设置，请使用`上一步`按钮。

点击“安装”后，安装程序将开始格式化磁盘并将包复制到目标磁盘。请等待此步骤完成；然后取出安装介质并重新启动您的系统。

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

当复制和设置包完成后，可以重启服务器。默认情况下，这将在几秒钟后自动完成。

安装失败

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

如果安装仍然不起作用，请查看如何获取帮助章节。

安装后访问管理界面

在成功安装并重启系统后，你可以使用 {pve} 网络界面进行进一步配置。

将您的浏览器指向安装过程中给出的IP地址以及端口8006，例如：https://youripaddress:8006
使用`root`（领域 PAM）用户名以及安装过程中设置的密码登录。
上传您的订阅密钥以访问企业存储库。否则，您将需要设置一个公共的、测试较少的包存储库，以获取安全修复、错误修复和新功能的更新。
检查IP配置和主机名。
检查时区。
检查你的防火墙设置。

高级LVM配置选项

安装程序创建一个名为 pve 的卷组（VG），以及其他名为 root、data 和 swap 的逻辑卷（LVs），如果使用的是 ext4 或 xfs 文件系统。要控制这些卷的大小，使用：

hdsize

定义要使用的硬盘总大小。通过这种方式，您可以在硬盘上保留空闲空间以供进一步分区（例如，在同一硬盘上为额外的PV和VG预留空间，这些空间可用于LVM存储）。

swapsize

定义了`swap`交换区的大小。默认值是已安装内存的大小，最小4GB，最大8GB。最终的值不能大于`hdsize/8`。

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

最大根

定义了`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池`rpool`，如果使用了ZFS的话。不会创建交换空间，但您可以在安装磁盘上保留一些未分区的空间用于交换。您也可以在安装后创建一个交换zvol，尽管这可能会导致问题（参见ZFS交换说明）。

ashift: 定义创建池时的`ashift`值。`ashift`值至少需要设置为底层磁盘的扇区大小(2的`ashift`次方是扇区大小)，或者池中可能会放入的任何磁盘的大小（例如替换有缺陷的磁盘）。
压缩: 定义是否为`rpool`启用压缩。
校验和: 定义应该用于`rpool`的校验和算法。
副本: 为`rpool`定义`copies`参数。查看`zfs(8)`手册页以了解其语义，以及为什么这不会替代磁盘级别的冗余。
ARC最大大小: 定义ARC可以增长到的最大尺寸，从而限制ZFS将使用的内存量。有关更多详细信息，请参见关于如何限制ZFS内存使用的部分。
hdsize: 定义要使用的硬盘总大小。这对于在硬盘上节省空闲空间以进行进一步分区很有用（例如，创建交换分区）。hdsize 仅在可引导磁盘上受到尊重，即只有第一块磁盘或RAID0、RAID1或RAID10的镜像，以及RAID-Z[123]中的所有磁盘。

ZFS 性能提示

ZFS最适合使用大量内存。如果你打算使用ZFS，请确保有足够的RAM可以用于它。一个好的计算方法是4GB加上每1TB原始磁盘空间的1GB RAM。

ZFS可以使用专用驱动器作为写入缓存，称为ZFS意向日志（ZIL）。使用快速驱动器（SSD）来做这个。可以在安装后使用以下命令添加它：

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

给内核参数添加`nomodeset`选项 _~_~_~_~_~_~_~_~_~_~_~_~_~~~

Problems may arise on very old or very new hardware due to graphics drivers. If the installation hangs during boot, you can try adding the nomodeset parameter. This prevents the Linux kernel from loading any graphics drivers and forces it to continue using the BIOS/UEFI-provided framebuffer.

On the {pve} bootloader menu, navigate to Install {pve} (Terminal UI) and press e to edit the entry. Using the arrow keys, navigate to the line starting with linux, move the cursor to the end of that line and add the parameter nomodeset, separated by a space from the pre-existing last parameter.

Then press Ctrl-X or F10 to boot the configuration.

Install {pve} on Debian

{pve} ships as a set of Debian packages and can be installed on top of a standard Debian installation. After configuring the repositories you need to run the following commands:

# apt-get update
# apt-get install proxmox-ve

Installing on top of an existing Debian installation looks easy, but it presumes that the base system has been installed correctly and that you know how you want to configure and use the local storage. You also need to configure the network manually.

In general, this is not trivial, especially when LVM or ZFS is used.

A detailed step by step how-to can be found on the {webwiki-url}Install_Proxmox_VE_on_Debian_12_Bookworm[wiki].