中文

应用程序

在专用服务器上安装和配置 Proxmox VE

通过 KVM IP 在专用服务器上安装 Proxmox VE 9:ISO、软件仓库、防火墙、双重身份验证、存储、第一台 Linux 虚拟机、更新与备份。

阅读约 16 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南将带您完成从在专用服务器上安装 Proxmox VE 到创建第一台 Linux 虚拟机的全过程,内容包括:挂载 ISO、配置软件包仓库、保护管理界面、双重身份验证、存储、更新与备份。

Proxmox VE 是基于 Debian 的开源虚拟化管理程序,集成了 KVM 虚拟机、LXC 容器和 Web 管理界面。截至撰写本文时(2026 年 11 月),当前版本为 9.2,基于 Debian 13 “Trixie”。

订购服务器

HostMyServers 网站将 Proxmox VE 列为可在经济型专用服务器上使用的虚拟化方案之一。这些套餐包含 KVM IP 访问和从客户区挂载 ISO 的功能,这两项工具都是本次安装必不可少的。

本指南面向专用服务器。Proxmox VE 需要处理器提供硬件虚拟化扩展:如果您使用其他类型的套餐,请先通过客户区向技术支持确认是否可用。

前提条件

  • 一台可使用 KVM IP 并能从客户区挂载 ISO 的专用服务器
  • 服务器的公网 IP 地址、子网掩码、网关和 DNS
  • 您的本地电脑上装有较新的浏览器和 SSH 客户端
  • 您本地电脑的公网 IP 地址,用于限制对管理界面的访问
  • 一款用于双重身份验证的 TOTP 应用(FreeOTP 或同类应用)

系统要求

组件 最低配置(评估用) 推荐配置
处理器 64 位,支持 Intel VT 或 AMD-V 64 位 Intel 或 AMD,支持 VT 或 AMD-V
内存 1 GB,另加虚拟机所需内存 系统和服务 2 GB,另加虚拟机所需内存
存储 一块磁盘 带掉电保护的 SSD、带受保护缓存的硬件 RAID,或用于 ZFS 的无 RAID 磁盘
网络 一块网卡 根据需要配置多块多千兆网卡

使用 ZFS 时请预留更多内存:Proxmox 文档建议 4 GB,另加每 TB 原始磁盘容量 1 GB。

使用的端口

端口 协议 用途 建议开放范围
8006 TCP Web 界面和 API(HTTPS) 仅限您的管理 IP
22 TCP SSH,包括集群节点之间的连接 您的管理 IP 和各节点
5900-5999 TCP VNC 控制台 仅限您的管理 IP
3128 TCP SPICE 代理 仅限您的管理 IP
111 UDP rpcbind 不要对外开放
5405-5412 UDP Corosync(集群) 仅限节点之间
60000-60050 TCP 热迁移 仅限节点之间
25 TCP(出站) 通过 sendmail 发送通知 仅限出站

步骤 1:记录当前配置

如果服务器上仍在运行某个系统,请通过 SSH 连接并记下以下信息。安装程序中会用到它们。

终端
ip -br addr
ip route show default
cat /etc/resolv.conf
ip -br link
lsblk -o NAME,SIZE,TYPE,MODEL,ROTA
grep -c -E 'vmx|svm' /proc/cpuinfo
需记录的内容 查看位置
IP 地址和前缀(例如 /24) ip -br addr
网关 ip route show default,via 之后的值
活动网络接口及其 MAC 地址 ip -br addr 和 ip -br link
DNS 服务器 /etc/resolv.conf
可用磁盘 lsblk

最后一条命令应返回大于 0 的数字。如果返回 0,说明虚拟化功能不存在或已在 BIOS 中禁用。

步骤 2:获取并挂载 ISO

  1. 从官方页面下载最新的 Proxmox VE ISO Installer 镜像。该页面同时公布了 SHA256 校验和。

  2. 如果您将镜像下载到本地电脑,请进行校验:

    终端
    sha256sum proxmox-ve_9.2-1.iso
  3. 在客户区将 ISO 挂载到服务器,然后打开 KVM IP。

  4. 重启服务器并从虚拟光驱启动。如果服务器没有从虚拟光驱启动,请在 KVM 控制台中打开启动菜单或 BIOS。

步骤 3:安装 Proxmox VE

在启动菜单中选择 Install Proxmox VE (Graphical)。如果 KVM 控制台一直黑屏或画面卡住,请重启并选择 Install Proxmox VE (Terminal UI),它提供相同的选项。

然后按照向导操作:

  1. 许可协议:接受协议(EULA)。

  2. 目标磁盘:选择磁盘。可通过 Options 按钮选择文件系统。

    选项 适用场景 创建的虚拟机存储
    ext4(默认)或 xfs 一般情况、单块磁盘或硬件 RAID local-lvm
    ZFS(RAID1、RAIDZ 等) 多块磁盘且无硬件 RAID,内存充足 local-zfs
  3. 位置:国家、时区和键盘布局。

  4. 密码:为 root 设置一个足够长且唯一的密码(至少 12 个字符),并填写用于接收通知的电子邮箱地址。

  5. 网络:对照步骤 1 记录的值逐项检查。安装程序显示的是通过 DHCP 获取的值,可能与实际值不同。

    字段 值
    Management Interface 步骤 1 记录的活动接口
    Hostname (FQDN) 完整名称,例如 pve1.您的域名.com
    IP Address (CIDR) 服务器IP/前缀
    Gateway 记录的网关
    DNS Server 记录的 DNS
  6. 摘要:仔细核对所有内容。取消勾选 Automatically reboot after successful installation,以便在重启前卸载 ISO。

  7. 点击 Install,等待复制完成。

  8. 在客户区卸载 ISO,然后重启。

步骤 4:首次连接

通过 KVM 控制台或 SSH 检查网络和 Web 服务:

终端
ip -br addr
ip route show default
hostname --ip-address
systemctl status pveproxy --no-pager

hostname --ip-address 应返回服务器的 IP,而不是 127.0.0.1 或 127.0.1.1。

然后打开 https://服务器IP:8006 并登录:

  • User name:root
  • Realm:Linux PAM standard authentication
  • Password:安装时设置的密码

浏览器会提示证书不受信任:这是安装时生成的自签名证书。No valid subscription 消息仅为提示信息,不影响 Proxmox VE 的使用。

步骤 5:限制对管理界面的访问

安装完成后,8006 端口会在公网地址上响应。请在创建第一批虚拟机之前对其进行保护。内置防火墙默认处于禁用状态。

首先设置在 10 分钟后自动停用防火墙,以防您失去访问权限:

终端
systemd-run --on-active=10min --unit=fw-rollback /usr/sbin/pve-firewall stop

然后编辑配置文件:

终端
nano /etc/pve/firewall/cluster.fw
配置
[OPTIONS]
enable: 1

[ALIASES]
local_network 服务器IP

[IPSET management]
您的IP
配置项 作用
enable: 1 启用防火墙:此后发往主机的入站流量默认被阻止
local_network 将“本地网络”限定为服务器的 IP。否则,检测到的整个公网子网都会被视为本地网络并获得放行
management 允许访问 Web 界面、SSH、VNC 和 SPICE 的 IP 列表

检查配置,然后在您的本地电脑上打开一个新的 SSH 会话并刷新 Web 界面:

终端
pve-firewall status
pve-firewall localnet

如果一切正常,请取消已设置的自动停用:

终端
systemctl stop fw-rollback.timer

如果您的公网 IP 经常变化,请将相应的地址段添加到 management,或通过具有固定地址的 VPN 进行连接。如果 IP 发生变化而未及时登记,就只能通过 KVM IP 来修改该列表。

请勿在主机上安装 ufw:它会与 Proxmox 防火墙冲突。

加固 SSH

在您的本地电脑上复制公钥:

终端
ssh-copy-id root@服务器IP

确认密钥登录正常后,禁止 root 使用密码登录:

终端
sed -i 's/^#\?PermitRootLogin.*/PermitRootLogin prohibit-password/' /etc/ssh/sshd_config
sshd -t && systemctl reload ssh

步骤 6:配置软件仓库

全新安装会启用 Enterprise 仓库,该仓库仅供拥有订阅的服务器使用。没有密钥时,apt update 会失败并报 401 Unauthorized 错误。

仓库 用途
pve-enterprise 推荐用于生产环境,需要 Proxmox 订阅
pve-no-subscription 无需密钥即可访问。Proxmox 将其定位于测试和非生产用途,其软件包经过的验证较少
pve-test 仅用于测试新功能,此处应避免使用

如果您有订阅,请在 节点 → Subscription 中输入密钥,无需更改仓库。

如果没有订阅,请进入 节点 → Updates → Repositories:禁用 enterprise 条目,然后通过 Add 添加 No-Subscription。对应的命令行操作如下:

终端
for f in /etc/apt/sources.list.d/pve-enterprise.sources /etc/apt/sources.list.d/ceph.sources; do
  [ -f "$f" ] && sed -i '/^Types:/i Enabled: no' "$f"
done

cat > /etc/apt/sources.list.d/proxmox.sources <<'EOF'
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

然后更新系统:

终端
apt update
apt full-upgrade

如果安装了新内核,请重启,然后检查版本:

终端
pveversion
uname -r

步骤 7:启用双重身份验证

  1. 打开 Datacenter → Permissions → Two Factor,然后选择 Add → TOTP。
  2. 选择 root@pam,点击 Randomize,并用您的应用扫描二维码。
  3. 在 Verification Code 中输入应用显示的验证码,然后点击 Apply 确认。
  4. 接着通过 Add → Recovery Keys 添加恢复密钥,并将这些一次性密钥保存在服务器之外,例如密码管理器中。
  5. 在关闭当前会话之前,请在浏览器的无痕窗口中测试登录。

连续输错 8 次 TOTP 验证码后,该用户的 TOTP 因素将被停用。使用恢复密钥可以解除锁定。您也可以通过 KVM 控制台或 SSH 解除锁定:

终端
pveum user tfa unlock root@pam

创建个人管理账户

为避免日常使用 root,请创建一个专用账户,并同样为其启用双重身份验证:

终端
pveum user add admin@pve --comment "管理员"
pveum passwd admin@pve
pveum acl modify / --users admin@pve --roles Administrator

此账户登录时使用 Proxmox VE authentication server 域。

步骤 8(可选):Let's Encrypt 证书

受信任的证书可以消除浏览器警告,并便于使用 WebAuthn。您需要一个 A 记录指向该服务器的域名。

http-01 验证使用 80 端口上的内置 Web 服务器,因此该端口必须能从互联网访问。请将以下配置段添加到 /etc/pve/firewall/cluster.fw:

配置
[RULES]
IN ACCEPT -p tcp -dport 80

注册账户,然后申请证书:

终端
pvenode acme account register default admin@您的域名.com
pvenode config set --acme domains=pve1.您的域名.com
pvenode acme cert order

第一条命令会要求您选择服务。请先选择 Let's Encrypt V2 Staging 来验证流程,以免触及 Let's Encrypt 的限制。测试成功后,替换账户并选择 Let's Encrypt V2 申请正式证书:

终端
pvenode acme account deactivate default
pvenode acme account register default admin@您的域名.com
pvenode acme cert order --force

此后由 pve-daily-update.service 负责续期。

如果您不想开放 80 端口,可以在 Datacenter → ACME 中使用 dns-01 验证,并配合您的 DNS 服务商插件。

步骤 9:了解并扩展存储

查看可用存储:

终端
pvesm status
存储 位置 内容
local /var/lib/vz ISO、容器模板、备份
local-lvm LVM-Thin 卷 pve/data(ext4 或 xfs 安装) 虚拟机和容器的磁盘
local-zfs rpool/data(ZFS 安装) 虚拟机和容器的磁盘

要使用一块额外的空磁盘:

  1. 在 节点 → Disks 中找到它。
  2. 如果磁盘上有不再需要的旧数据,请选中它并点击 Wipe Disk。此操作不可撤销:请仔细核对型号和容量。
  3. 打开 节点 → Disks → LVM-Thin → Create: Thinpool,选择磁盘并命名,保持 Add Storage 处于勾选状态。

步骤 10:创建第一台 Linux 虚拟机

准备虚拟机网络

获取 ISO

在 local → ISO Images → Download from URL 中,粘贴 Debian 页面上提供的 netinst 镜像链接,点击 Query URL,然后点击 Download。

创建虚拟机

点击 Create VM 并填写向导:

选项卡 建议设置
General VM ID 100,名称 debian-test
OS Debian ISO,类型 Linux,版本 6.x - 2.6 Kernel
System SCSI Controller:VirtIO SCSI single,勾选 Qemu Agent
Disks 总线 SCSI,存储 local-lvm,32 GB,勾选 Discard 和 IO thread
CPU 1 个插槽,2 个核心,类型 x86-64-v2-AES
Memory 2048 MB
Network Bridge:vmbr1,Model:VirtIO (paravirtualized)

也可以通过命令行创建同样的虚拟机。请将 ISO 名称替换为您下载的文件名:

终端
qm create 100 --name debian-test --ostype l26 \
  --cpu x86-64-v2-AES --sockets 1 --cores 2 --memory 2048 \
  --scsihw virtio-scsi-single \
  --scsi0 local-lvm:32,iothread=1,discard=on \
  --ide2 local:iso/debian-netinst.iso,media=cdrom \
  --net0 virtio,bridge=vmbr1 \
  --agent enabled=1 \
  --boot 'order=scsi0;ide2'

启动虚拟机,打开其 Console 并安装 Debian。私有网络默认没有 DHCP:请手动配置地址,例如 10.10.10.10/24,网关为 10.10.10.1。

完成虚拟机配置

在虚拟机中安装客户机代理:

终端
apt update
apt install -y qemu-guest-agent
systemctl start qemu-guest-agent

在主机上移除 ISO,启用开机自启,并检查代理:

终端
qm set 100 --ide2 none,media=cdrom
qm set 100 --onboot 1
qm status 100
qm guest cmd 100 ping
qm guest cmd 100 network-get-interfaces

最后,请参考保护您的服务器指南,加固虚拟机的系统。

验证安装

检查项 预期结果
pveversion 显示版本 9.x
pve-firewall status Status: enabled/running
从未授权的 IP 访问 https://服务器IP:8006 被阻止,服务器无响应
使用 root 登录 要求输入 TOTP 验证码
apt update 没有 401 错误
pvesm status 存储状态为 active
qm guest cmd 100 ping 没有错误

更新

请定期通过 节点 → Updates 或 SSH 应用更新:

终端
apt update
apt full-upgrade

内核更新后,请正常关闭虚拟机或交由主机自动处理,然后在预定的时间窗口内重启。请将 uname -r 与 pveversion -v 列出的版本进行比较。

进行大版本升级时,请勿只执行普通更新:请按照 Proxmox 发布的升级指南及其检查脚本操作,例如从版本 8 升级到版本 9 的指南。请先进行完整备份。

备份

执行一次性备份:

终端
vzdump 100 --storage local --mode snapshot --compress zstd

如需定期备份,请在 Datacenter → Backup → Add 中创建任务,选择存储、计划、虚拟机和保留策略。

HostMyServers 提供托管的 Proxmox Backup Server 服务,详见以下指南:

同时请备份主机配置,并将归档文件复制到服务器之外。其中包含敏感信息:请妥善保管。

终端
tar czf /root/pve-config-$(date +%F).tar.gz /etc/pve /etc/network/interfaces /etc/hosts /etc/apt/sources.list.d

要确认备份可用,请不时将其恢复到一个新的 ID 下:

终端
qmrestore /var/lib/vz/dump/备份文件名.vma.zst 900

在现有 Debian 13 上安装

ISO 方式仍然是最简单的。Proxmox 建议仅由高级用户在 Debian 上安装。此方式仅适用于 Debian 13:基于 Debian 12 的 Proxmox VE 8 自 2026 年 8 月起已不再维护,Ubuntu 也不是受支持的基础系统。如果您使用 Debian 12,请先迁移到 Debian 13,或使用 ISO 重新安装。

主机名必须指向环回地址以外的地址。请修改 /etc/hosts,如果存在 127.0.1.1 这一行,请从中移除主机名:

文本
127.0.0.1       localhost
服务器IP   pve1.您的域名.com pve1
终端
hostname --ip-address

添加仓库及其密钥:

终端
cat > /etc/apt/sources.list.d/pve-install-repo.sources <<'EOF'
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

wget https://enterprise.proxmox.com/debian/proxmox-archive-keyring-trixie.gpg -O /usr/share/keyrings/proxmox-archive-keyring.gpg
sha256sum /usr/share/keyrings/proxmox-archive-keyring.gpg

预期的校验值为 136673be77aba35dcce385b28737689ad64fd785a797e57897589aed08db6e45。仅在校验值一致时才可继续。

安装 Proxmox 内核,然后重启:

终端
apt update && apt full-upgrade
apt install proxmox-default-kernel
systemctl reboot

然后安装 Proxmox VE。对于 Postfix,如果您没有邮件中继,请选择 local only:

终端
apt install proxmox-ve postfix open-iscsi chrony
apt install ifupdown2
apt remove linux-image-amd64 'linux-image-6.12*'
update-grub
apt remove os-prober

确认服务器仍可访问,然后保持公网接口不变,只创建私有网桥,具体请参阅网络指南。之后从步骤 4 起继续按本指南操作。在步骤 6 中,仓库已在 pve-install-repo.sources 中声明:请勿再创建 proxmox.sources。如果您有订阅,请在注册密钥后删除该文件。

故障排除

执行 apt update 时出现 401 Unauthorized

Enterprise 仓库仍处于启用状态,但没有有效密钥。请按步骤 6 的说明将其禁用,或注册您的订阅。

Web 界面在 8006 端口上不再响应

通过 KVM IP 或 SSH 执行:

终端
systemctl status pveproxy --no-pager
ss -tlnp | grep 8006
pve-firewall status

如果您的 IP 已不在 management 中,请停止防火墙,修改 /etc/pve/firewall/cluster.fw,然后重新启动防火墙:

终端
pve-firewall stop
nano /etc/pve/firewall/cluster.fw
pve-firewall start

安装后完全无法访问网络

打开 KVM IP 并检查 /etc/network/interfaces:地址、前缀、网关以及 bridge-ports 中的接口名称。修改后使用 ifreload -a 应用。如果您不清楚正确的参数,请通过客户区联系技术支持。

ipcc_send_rec[1] failed: Connection refused

主机名可能没有解析到服务器的 IP。请检查 /etc/hosts 和 hostname --ip-address,然后重启相关服务或服务器。

KVM virtualisation configured, but not available

虚拟化扩展已被禁用或不存在。请通过 KVM IP 在 BIOS 中启用 Intel VT-x 或 AMD-V (SVM)。如果无法访问该选项,请联系技术支持。

安装程序卡住或显示黑屏

使用 Install Proxmox VE (Terminal UI) 重新启动安装程序。如果问题仍然存在,请选中该条目,按 e,在以 linux 开头的行末尾添加 nomodeset,然后按 Ctrl-X 启动。安装过程中,按 Ctrl+Alt+F2 可查看详细错误信息。

服务器重启后又进入安装程序

ISO 仍处于挂载状态,或启动顺序排在磁盘之前。请在客户区卸载 ISO,并在 BIOS 中检查启动顺序。

TOTP 验证码被拒绝

请检查手机时间,并使用 timedatectl 检查服务器时间。您可以使用恢复密钥,或通过 pveum user tfa unlock root@pam 解锁账户。万不得已时,可在控制台执行 pveum user tfa delete root@pam 删除该账户的验证因素。

storage 'local-lvm' does not exist

您的安装可能使用了 ZFS。请将 local-lvm 替换为 local-zfs,或替换为 pvesm status 中显示的名称。

参考

进一步了解:创建 Windows 虚拟机和搭建集群。