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. 重启并通过控制台/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 安装 (适用于配置较高的节点)¶

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

1. ISO: 在 Storage > Content 中下载 Windows Server (2019/2022/2025) 的 ISO 和 virtio-win.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**: 使用来自主机的默认设置或您自己的设置。

- **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 界面消失" (GUI 无法打开)¶

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

systemctl status pveproxy pvedaemon pve-cluster

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

systemctl restart pveproxy pvedaemon

修改桥接器后丢失网络¶

通过控制台 (通过供应商/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，请检查客体操作系统中是否已禁用 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>

bash
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 安装此软件，请遵循 这些说明。