Proxmox 9¶

在这篇文章中

• 部署功能
• Proxmox 9 安装
• 首次登录与基础检查
• 网络：Bridge vmbr0
• 磁盘与存储
• 加载 ISO 镜像
• 创建第一个 VM (Ubuntu 25.10)
• Windows 安装（适用于更强大的节点）
• LXC 容器：快速入门
• 典型的 VM 配置方案
• 在同一个网络中连接 VM 和 LXC
• 备份与模板
• 常见问题及解决方案
• 诊断：速查表
• 迷你 FAQ
• 系统就绪检查清单
• 使用 API 订购带有 Proxmox 9 的服务器

部署功能¶

Proxmox 9 安装¶

在安装服务器后，Proxmox VE 服务的安装将在 15-20 分钟内完成。系统会向与账户关联的邮箱发送一封电子邮件，通知您已安装的服务器信息，并提供格式为 https://proxmox<ID_server>.hostkey.in 的链接，您必须访问该链接才能进入 Proxmox VE 的 Web 管理界面：

• Login - root;
• Password - 系统密码。

首次登录与基础检查¶

1. 打开浏览器 > https://proxmox{Server_ID}.hostkey.in 并输入凭据：

   

2. 导航至：Datacenter > Node > Summary - 检查 CPU、RAM、磁盘和运行时间 (uptime)。

   

3. 如果没有订阅，请禁用企业版仓库：

Node > Repositories > pve-enterprise > Disable。保留 pve-no-subscription：

终端命令：

sed -i 's/^deb/#deb/g' /etc/apt/sources.list.d/pve-enterprise.list || true

apt update

网络：Bridge vmbr0¶

桥接器 vmbr0 是连接虚拟机的虚拟“交换机”。它绑定到一个物理接口（例如 ens18/eno1）。

通过 Web 界面¶

1. Node > System > Network。

   

2. 确认 vmbr0 是否存在。如果不存在或未配置 - Create > Linux Bridge：

   • Name: vmbr0
   • IPv4/CIDR: 指定您的静态 IP，格式为 X.X.X.X/YY（如果使用 DHCP 则留空）；
   • Gateway (IPv4): 默认网关（通常是 X.X.X.1）（如果使用 DHCP 则无需输入）；
   • Bridge ports: 您的物理接口，例如 ens1；
   • Save > Apply configuration：

   

通过 CLI（如果 Web 访问丢失）¶

/etc/network/interfaces (ifupdown2) 示例：

auto lo
iface lo inet loopback
auto ens18
iface ens18 inet manual
auto vmbr0
iface vmbr0 inet static
    address 192.0.2.10/24
    gateway 192.0.2.1
    bridge-ports ens18
    bridge-stp off
    bridge-fd 0

ifreload -a

常见错误：

• 错误的 bridge-ports（错误的物理接口） > 网络“消失”。请修正接口并执行 ifreload -a。
• 输入了错误的网关或子网掩码 > 本地连接存在但无法访问互联网。

磁盘与存储¶

为 VM 存储添加第二块磁盘¶

1. Node > Disks：确保新磁盘可见（例如 sdb）。

   

2. 方案 A - LVM-Thin（便于快照）：

   • Disks > LVM-Thin > Create：选择磁盘 > 指定 VG 名称（例如 pve2）和 thin-pool（例如 data2）。

   

   • 存储将出现在 Datacenter > Storage 中。

   

3. 方案 B - Directory：

   • 创建文件系统（Disks > ZFS 或手动执行 mkfs.ext4），挂载到 /mnt/...

   

   • Datacenter > Storage > Add > Directory > 路径 /mnt/... > 启用 Disk image, ISO image（根据需要）。

加载 ISO 镜像¶

ISO 镜像可以通过两种方式加载。

A. 通过 Web 界面¶

1. Datacenter > Storage > (选择类型为 ISO 的 storage，例如 local) > Content。
2. Upload > 选择本地的 ubuntu-25.10-live-server-amd64.iso > 等待上传完成。

B. 通过 Node (CLI)¶

将 Ubuntu 25.10 ISO 下载到 local 存储的示例：

cd /var/lib/vz/template/iso

wget https://releases.ubuntu.com/25.10/ubuntu-25.10-live-server-amd64.iso

创建第一个 VM (Ubuntu 25.10)¶

示例：Ubuntu Server 25.10 (2 vCPU 的 VPS)

点击 Create VM（右上角）：

General: 将 ID 保持为默认，Name - ubuntu2510（或您自定义的名称）：

OS: 选择 ISO ubuntu-25.10-live-server-amd64.iso，Type: Linux:

System:

• Graphics card: Default;
• BIOS: OVMF (UEFI);
• Machine: q35;
• SCSI Controller: VirtIO SCSI single;
• （可选）在 VM 创建后，在 Options 中启用 Qemu Agent（见下文）：

Disks:

• Bus/Device: SCSI;
• SCSI Controller: VirtIO SCSI single;
• Storage: 您的 LVM-Thin/Directory；
• Size: 20–40 GB（测试建议至少 10-15 GB）；
• Discard (TRIM): 在 thin-pool 上启用：

CPU:

• Sockets: 1;
• Cores: 2（根据您的 VPS 配置）；
• Type: host（性能最佳）：

Memory:

• 2048–4096 MB。您可以启用 Ballooning（例如 Min 1024, Max 4096）：

Network:

• Model: VirtIO (半虚拟化);
• Bridge: vmbr0;
• 如果需要 VLAN：设置 VLAN Tag：

Confirm: 检查设置，勾选 Start after created 并点击 Finish：

OS 安装：¶

1. 启动 VM > Console (noVNC) > Try or Install Ubuntu：

   

2. 安装程序：

   • 根据需要设置 DHCP/静态 IP；
   • Disk: Use entire disk；
   • Profile: 用户名/密码；
   • OpenSSH server: 启用。

3. 重启并通过 console/SSH 登录。

安装后操作：¶

sudo apt update && sudo apt -y full-upgrade

sudo apt -y install qemu-guest-agent

sudo systemctl enable --now qemu-guest-agent

Boot Order: 如果从 ISO 启动 - Options > Boot Order > 将 scsi0 移至 cdrom 之上。

Windows 安装（适用于更强大的节点）¶

适用于配置 \(\ge\) 4 vCPU/8 GB RAM 的节点。在配置较低的 VPS 上，Windows 可能运行不稳定。

1. ISO: 在 Storage > Content 中下载 Windows Server (2019/2022/2025) 和 virtio-win.iso (驱动程序) 的 ISO：

   

2. Create VM > OS: Microsoft Windows，选择安装用的 ISO 镜像。Add additional drive for VirtIO drivers 选项允许您添加第二个包含驱动程序的 CD：

   

3. System: BIOS OVMF (UEFI);

   • Machine: q35;
   • 如有必要，启用 Add EFI Disk 和 Add TPM（针对较新版本的 Windows）。如果无法启动 - 请尝试使用 SeaBIOS 并禁用 EFI/TPM：

   

4. Disks:

   • Bus: SCSI;
   • Controller: VirtIO SCSI;
   • Size: 40–80 GB;
   • 启用 IO Threads：

   

5. CPU: 2–4 vCPUs；

   • Type: host：

   

6. Memory: 4–8 GB：

   

7. Network: Model VirtIO (半虚拟化), Bridge vmbr0：

   

8. Confirm: 点击 Create 完成 VM 创建，然后在 Hardware > CD/DVD Drive 中挂载第二个 ISO - virtio-win.iso：

   

9. Windows 安装程序：在磁盘选择步骤中，点击 Load Driver > 指定包含 VirtIO 的 CD (vioscsi/viostor)。安装完成后 - 在设备管理器中设置网络驱动程序 (NetKVM)：

   

10. Guest Agent (可选)：使用 virtio-win ISO 为 Windows 安装 Qemu Guest Agent：

    

Windows 故障排除：¶

• 黑屏/无法启动：将 OVMF 更改为 SeaBIOS，并禁用 EFI/TPM。
• 无网络：确保网卡 (NIC) 为 VirtIO 且已安装 NetKVM 驱动程序。
• 磁盘变慢：确保磁盘类型为 SCSI + virtio 驱动程序。

LXC 容器：快速入门¶

在模板存储中提供了包含最小化软件的预制模板。

1. Datacenter > Storage > (选择类型为 Templates 的 storage) > Content > Templates。 下载，例如：ubuntu-25.04-standard_*.tar.zst 或其他需要的模板：

   

2. 点击 Create CT：

   • General: 指定 ID/Name，Unprivileged container = Enabled（默认更安全）。设置密码 root 或 SSH 密钥。

   

   • Template: 选择已下载的模板。

   

   • Disks: 存储/大小（例如 8–20 GB）。

   

   • CPU/RAM: 根据任务需求（例如 1 vCPU, 1–2 GB RAM）。

   

   • Network: Bridge vmbr0，IPv4 = DHCP（如果需要则设为 Static）。根据需要设置 VLAN Tag。

   

网络提示：如果您在 vmbr1 上使用 NAT，请进行相应设置并指定静态 IP。

- **DNS**: 使用来自主机的默认 DNS 或您自己的 DNS。

- **Features**: 可选启用 `nesting`, `fuse`, `keyctl`（取决于容器内的应用程序）。

• Start at boot/Start after created: 根据需求设置。
• 启动后：通过 SSH 登录并从模板或软件包安装软件：

  apt update && apt -y upgrade
  

  

在 LXC 中，不需要 Qemu Guest Agent。挂载主机目录是通过 MP (Mount points) 完成的。

典型的 VM 配置方案¶

• Ubuntu/Debian (Web/DB/Utility): SCSI + VirtIO, UEFI (OVMF), 1–2 vCPUs, 2–4 GB RAM, 磁盘 20–60 GB；启用 Qemu Guest Agent。
• 轻量级服务 (DNS/DHCP/Proxy): 1 vCPU, 1–2 GB RAM, 磁盘 8–20 GB。
• 容器宿主机 (Docker/Podman): 2–4 vCPUs, 4–8 GB RAM；为数据准备独立的磁盘/存储池。

ISO 的替代方案：您可以使用 Ubuntu 25.10 Cloud-Init 镜像进行快速克隆，并自动配置网络/SSH。如果您计划拥有许多类似的 VM，这非常适用。

在同一个网络中连接 VM 和 LXC¶

基本变体 (单一子网)：¶

1. 确保所有 VM/容器的 Bridge = vmbr0（或 vmbr1）。
2. 如果使用 DHCP 网络 - 地址会自动分配；如果是静态 IP - 请在同一个子网内指定 IP（例如 10.10.0.2/24, 10.10.0.3/24）和共同的网关 10.10.0.1。
3. 可选：VLAN：在 VM/CT 的网络适配器设置中指定 VLAN Tag，并确保交换机上行链路允许该 VLAN。
4. 在操作系统内部，检查本地防火墙是否拦截了 ICMP/SSH/HTTP。
5. 测试：从 Ubuntu VM 执行 ping <LXC的IP> 及其反向操作；ip route 和 traceroute 将有助于排查问题。

当存在不同子网时：¶

• Proxmox 本身不会在桥接器之间进行路由。需要一个路由器（带有 Linux/pfSense 的独立 VM）或在主机上配置 NAT。
• 主机上的简单 NAT（示例）：

启用转发：

sysctl -w net.ipv4.ip_forward=1

iptables -t nat -A POSTROUTING -o vmbr0 -j MASQUERADE

EXT_IF=vmbr0

iptables -t nat -C POSTROUTING -s 10.10.0.0/24 -o $EXT_IF -j MASQUERADE 2>/dev/null || \
iptables -t nat -A POSTROUTING -s 10.10.0.0/24 -o $EXT_IF -j MASQUERADE

iptables -C FORWARD -i vmbr1 -o $EXT_IF -j ACCEPT 2>/dev/null || \
iptables -A FORWARD -i vmbr1 -o $EXT_IF -j ACCEPT

iptables -C FORWARD -i $EXT_IF -o vmbr1 -m state --state RELATED,ESTABLISHED -j ACCEPT 2>/dev/null || \
iptables -A FORWARD -i $EXT_IF -o vmbr1 -m state --state RELATED,ESTABLISHED -j ACCEPT

备份与模板¶

• Backup: Datacenter > Backup 或 Node > Backup - 设置 vzdump 计划（存储、时间、快照/停止模式）：

  

• VM Template: 在完成基础 VM 设置后 > Convert to Template。通过 Clone 创建新 VM 可以节省时间并减少错误：

常见问题及解决方案¶

"Web Interface Disappeared" (GUI 未打开)¶

检查是否可以通过 SSH 访问该节点。在节点上执行：

systemctl status pveproxy pvedaemon pve-cluster

journalctl -u pveproxy --no-pager -n 100

systemctl restart pveproxy pvedaemon

修改 Bridge 后网络丢失¶

通过控制台连接（通过供应商/VNC/IPMI）。检查 /etc/network/interfaces 并应用：

ifreload -a

ip a

ip r

VM 无法连接互联网¶

• 确保 VM 内部指定了正确的 IP/掩码/网关/DNS。
• 检查 VM 网络适配器的 Bridge 是否为 - vmbr0（或 nat/vmbr1）。
• 如果使用了 VLAN - 在 VM 网卡设置中 (Hardware > Network Device > VLAN Tag) 指定 VLAN Tag，并确保交换机上行链路允许该 VLAN。

ISO 无法启动 / 看不到安装程序¶

• 检查启动顺序 (Options > Boot Order) 以及是否连接了正确的 ISO。
• 对于 UEFI，如果 ISO 不支持 Secure Boot，请检查客户操作系统中是否禁用了它。

高负载/磁盘“堵塞”¶

• 使用 VirtIO SCSI 并为密集的磁盘使用 IO Threads。
• 不要将备份存储在与运行中的磁盘相同的 thin-pool 上 - 最好拥有独立的存储。

VM 中的摄像头/USB 设备“断开连接”¶

• 对于 USB 透传，请使用 Hardware > USB Device。如果设备停止响应 - 请 Stop/Start VM 或在主机上重新连接 USB。有时禁用 Use USB3 有助于提高兼容性。

更新与重启¶

apt update && apt full-upgrade -y

reboot

诊断：速查表¶

节点网络：

ip a; ip r; ping -c3 1.1.1.1; ping -c3 google.com

systemctl status pveproxy pvedaemon pvestatd pve-cluster

journalctl -u pveproxy -n 200 --no-pager

df -h | sort -k5 -h
lvs; vgs; pvs

cat /etc/pve/storage.cfg

qm list; qm config <VMID>; qm status <VMID>

qm stop <VMID> --skiplock; sleep 2; qm start <VMID>

迷你 FAQ¶

问：可以重命名 vmbr0 吗？ 答：可以，但不建议在生产节点上这样做 - 保留 vmbr0 并根据需要添加额外的桥接器 (vmbr1) 会更容易。

问：ISO 默认存放在哪里？ 答：在本地存储中：/var/lib/vz/template/iso。

问：local 和 local-lvm 有什么区别？ 答：local - 用于存放 ISO、容器模板等的常规目录；local-lvm - 用于带有快照功能的 VM/容器磁盘的 LVM-Thin 存储。

问：如何快速克隆一个 VM？ 答：将一个示例 VM 转换为 Template（模板），然后使用 Clone > Full/Linked。

问：如何安全地调整 VM 的 CPU/RAM？ 答：关闭 VM 并更改资源；对于 Linux，部分参数可以“即时”更改，但最好提前规划好。

系统就绪检查清单¶

• 已能访问 https://<server_IP>:8006；
• vmbr0 已设置且节点可上网；
• ISO 已加载到存储中；
• 第一个 VM 已创建并安装完成；
• Qemu Guest Agent 已启用；
• 备份已配置 (vzdump schedule)；
• 已检查更新。

使用 API 订购带有 Proxmox 9 的服务器¶

要使用 API 安装此软件，请参考这些说明。