在专用服务器上安装和配置 Proxmox VE
通过 KVM IP 在专用服务器上安装 Proxmox VE 9:ISO、软件仓库、防火墙、双重身份验证、存储、第一台 Linux 虚拟机、更新与备份。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南将带您完成从在专用服务器上安装 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
-
从官方页面下载最新的 Proxmox VE ISO Installer 镜像。该页面同时公布了 SHA256 校验和。
-
如果您将镜像下载到本地电脑,请进行校验:
终端sha256sum proxmox-ve_9.2-1.iso -
在客户区将 ISO 挂载到服务器,然后打开 KVM IP。
-
重启服务器并从虚拟光驱启动。如果服务器没有从虚拟光驱启动,请在 KVM 控制台中打开启动菜单或 BIOS。
步骤 3:安装 Proxmox VE
在启动菜单中选择 Install Proxmox VE (Graphical)。如果 KVM 控制台一直黑屏或画面卡住,请重启并选择 Install Proxmox VE (Terminal UI),它提供相同的选项。
然后按照向导操作:
-
许可协议:接受协议(EULA)。
-
目标磁盘:选择磁盘。可通过 Options 按钮选择文件系统。
选项 适用场景 创建的虚拟机存储 ext4(默认)或 xfs 一般情况、单块磁盘或硬件 RAID local-lvmZFS(RAID1、RAIDZ 等) 多块磁盘且无硬件 RAID,内存充足 local-zfs -
位置:国家、时区和键盘布局。
-
密码:为
root设置一个足够长且唯一的密码(至少 12 个字符),并填写用于接收通知的电子邮箱地址。 -
网络:对照步骤 1 记录的值逐项检查。安装程序显示的是通过 DHCP 获取的值,可能与实际值不同。
字段 值 Management Interface 步骤 1 记录的活动接口 Hostname (FQDN) 完整名称,例如 pve1.您的域名.comIP Address (CIDR) 服务器IP/前缀Gateway 记录的网关 DNS Server 记录的 DNS -
摘要:仔细核对所有内容。取消勾选
Automatically reboot after successful installation,以便在重启前卸载 ISO。 -
点击 Install,等待复制完成。
-
在客户区卸载 ISO,然后重启。
步骤 4:首次连接
通过 KVM 控制台或 SSH 检查网络和 Web 服务:
ip -br addr
ip route show default
hostname --ip-address
systemctl status pveproxy --no-pagerhostname --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:启用双重身份验证
- 打开 Datacenter → Permissions → Two Factor,然后选择 Add → TOTP。
- 选择
root@pam,点击 Randomize,并用您的应用扫描二维码。 - 在 Verification Code 中输入应用显示的验证码,然后点击 Apply 确认。
- 接着通过 Add → Recovery Keys 添加恢复密钥,并将这些一次性密钥保存在服务器之外,例如密码管理器中。
- 在关闭当前会话之前,请在浏览器的无痕窗口中测试登录。
连续输错 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 安装) |
虚拟机和容器的磁盘 |
要使用一块额外的空磁盘:
- 在 节点 → Disks 中找到它。
- 如果磁盘上有不再需要的旧数据,请选中它并点击 Wipe Disk。此操作不可撤销:请仔细核对型号和容量。
- 打开 节点 → 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 pve1hostname --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 虚拟机和搭建集群。