Docs: 新建Proxmox账号

Mon, 01 Jan 0001 00:00:00 +0000

Proxmox资源纳管流程

新建 Proxmox 云账号时，平台不同步 Proxmox 侧的网桥作为二层网络/IP 子网，而是根据节点网卡（含网桥）上的 IP 在本地准备网络：
- 若已有本地 IDC（如 KVM）的 IP 子网已覆盖这些宿主机 IP，则直接复用，不再新建；
- 否则自动创建二层网络和 IP 子网（名称形如 {账号名}-proxmox-host-network）；
- 后续同步宿主机网卡时，按网卡 IP 挂到对应的本地二层网络，并记录网桥名称（如 vmbr0）。
云账号添加完成后，如自动添加的二层网络和 IP 子网不符合组网需求（例如仅覆盖宿主机 IP、未覆盖虚拟机网段，或同一二层被拆成多段），请按 Proxmox 实际网络环境进行合并wire和合并IP子网；合并 wire 操作不可逆，如配置错误，请删除云账号后重新添加。
同步已有虚拟机时，网卡按虚拟机 IP 匹配本地 IP 子网，不关联 Proxmox 远端网络 ID。运行中虚拟机的 IP 通过 QEMU Guest Agent 获取。

注意：若环境在升级到 4.0.4 之前已接入 Proxmox 云账号，升级后请先删除该云账号，再按本文重新导入。4.0.4 调整了 Proxmox 网络与资源同步模型，旧账号会残留脏数据，继续使用可能导致网络、宿主机或虚拟机状态异常。删除云账号仅取消平台纳管，不会影响 Proxmox 侧资源。

接入地址只填写 IP 或域名（如 192.168.1.10 或 pve.example.com），不要填写 https://、路径或端口；端口在单独字段中填写，默认为 8006。
若接入地址使用域名，需保证云管控制节点能够解析该域名，否则连接测试和资源同步会失败。
认证方式对应 Proxmox 的 Realm：
- PAM：Linux 系统用户认证（常用 root）。使用本地 Glance 镜像创建虚拟机时，远程挂载系统盘依赖 PAM 用户，必须选择该方式。
- PVE：Proxmox VE 本地用户认证。仅能用于资源同步等 API 操作，不能用于远程挂载系统盘。
账号栏只需填写用户名，平台会按认证方式自动拼接 @pam 或 @pve，请勿在账号中自行填写后缀。
建议使用具备管理员权限的 PAM 账号（如 root）。权限不足时，可能出现连接测试成功但同步不到宿主机、存储或虚拟机，或无法在平台上创建、变更资源。
平台通过 HTTPS 调用 Proxmox API，并跳过证书校验，使用自签名证书的环境也可以接入。

创建虚拟机支持两种镜像方式：

本地 Glance 镜像（推荐）：选择平台系统镜像中的公共镜像或自定义镜像。平台先将镜像缓存到 Proxmox 存储，再通过 esxi-agent 远程挂载系统盘并注入登录等信息，开机即可进入系统。
ISO 镜像：将 ISO 挂载为光驱并创建空磁盘。创建完成后虚拟机处于关机状态，需开机后通过 VNC 安装操作系统。ISO 需提前放在 Proxmox 存储中，或通过平台缓存到对应存储。

使用公共镜像或自定义镜像创建虚拟机时，流程与 VMware 类似，不依赖 cloud-init：

使用该方式时请注意：

认证方式必须为 PAM：远程挂载系统盘使用 Linux 系统用户（如 root@pam）访问 Proxmox 节点。PVE 用户无法登录宿主机，选择 PVE 认证时部署会失败。
esxi-agent：需已部署并运行 esxi-agent（与纳管 VMware 共用同一套服务）。esxi-agent 所在节点必须能访问 Proxmox API 及存储，否则无法远程挂载系统盘，部署会失败。
镜像无需预装 cloud-init：密码、密钥、IP 等由 host-deployer 直接写入磁盘，与本地 KVM、VMware 的部署方式相同。
虚拟机须关机：远程挂载系统盘进行部署时，虚拟机需处于关机状态。
网卡：选择与目标节点二层互通的本地 IP 子网。创建时网卡挂到该子网所在二层网络上、节点已记录的网桥（如 vmbr0）；若未记录网桥，则默认使用 vmbr0。请确认目标节点存在该网桥，且与所选 IP 子网二层互通。

提示：Glance 镜像适合批量交付已封装好的操作系统；ISO 方式适合需要交互式安装或自定义分区的场景。

提示：若导入云账号后没有任何资源，请检查账号权限是否足够，以及 Proxmox 上是否存在 QEMU 虚拟机（LXC 容器不会被同步）。