# Proxmox VE 管理 ## 概述 Proxmox VE 是一个基于 Debian 构建的服务器虚拟化平台。它通过 Web UI 或 CLI 工具管理 KVM 虚拟机和 LXC 容器。此技能涵盖使用“qm”（虚拟机）、“pct”（容器）和支持实用程序进行基于 CLI 的管理。 ## 何时使用 * 创建、配置或管理 KVM 虚拟机 * 生成和管理 LXC 容器 * 管理 Proxmox 存储、网络或集群 * 通过脚本自动化虚拟机/容器配置 * 解决 Proxmox 主机或来宾问题 **不适用于：** 仅 Web UI 工作流程（使用下面的 CLI 等效项）。 ## 快速参考工具|目的 ---|--- `qm` |管理KVM虚拟机 `pct` |管理 LXC 容器 `pvesm` |管理存储 `pvecm` |管理集群 `pveam` |管理设备/模板下载 `pvesh` |从 shell 访问 Proxmox API `pveperf` |主机性能基准测试 ## 使用 `qm` 进行虚拟机管理 ### 创建虚拟机 # 创建一个ID为100的虚拟机 qm 创建 100 --名称 my-vm --内存 2048 --核心 2 --套接字 1 \ --net0 virtio,bridge=vmbr0 --ostype l26 # 在 local-lvm 存储 (32GB) 上使用 SCSI 磁盘创建 qm 创建 100 --名称 my-vm --内存 4096 --核心 4 \ --scsi0 本地-lvm:32 --scsihw virtio-scsi-pci \ --net0 virtio,bridge=vmbr0 --ostype l26 # 附上 ISO 进行安装 qm set 100 --cdrom local:iso/ubuntu-22.04-server.iso --boot order=ide2 ### 虚拟机生命周期命令 |目的 ---|--- `qm start ` |启动虚拟机 `qm shutdown ` | ACPI 正常关闭 `qm stop ` |强制停止（如拉力） `qm 重新启动 ` |重新启动虚拟机 `qm 重置 ` |硬重置 `qm 暂停 ` |挂起至 RAM `qm 简历 ` |从暂停状态恢复 `qm 销毁 ` |删除虚拟机及其磁盘 `qm destroy --purge` |删除虚拟机、磁盘和所有相关作业 ### 虚拟机配置 # 显示当前配置质量配置 100 # 修改硬件 qm 设置 100 --内存 8192 qm 设置 100 --核心 4 qm set 100 --balloon 2048 # 动态内存（分钟） qm set 100 --cpu cputype=host # 传递主机CPU特性 qm set 100 --machine q35 # 使用 Q35 芯片组（用于 PCIe 直通） # 添加/调整磁盘大小 qm set 100 --scsi1 local-lvm:50 # 添加50GB磁盘 qm disk resize 100 scsi0 +20G # 将现有磁盘增加 20GB # 网络 qm set 100 --net0 virtio,bridge=vmbr0,tag=10 # VLAN 标记 qm set 100 --net1 virtio,bridge=vmbr1 # 第二个网卡 # Cloud-init（用于自动配置） qm 设置 100 --ide2 local-lvm:cloudinit qm 设置 100 --ciuser 管理 --cipassword '秘密' qm 设置 100 --ipconfig0 ip=10.0.0.50/24,gw=10.0.0.1 qm 设置 100 --sshkeys ~/.ssh/authorized_keys qm 设置 100 --启动顺序=scsi0 #EFI/UEFI启动 qm 设置 100 --bios ovmf --efidisk0 本地 lvm:1,efitype=4m,预注册密钥=1 # 串行控制台（无头） qm 设置 100 --serial0 套接字 --vga serial0 # PCI 直通（GPU、NIC 等） qm 设置 100 --hostpci0 0000:01:00.0,pcie=1 ### 快照和克隆 # 创建快照 qm snapshot 100 before-upgrade --description “内核升级之前” # 列出快照 qm 列出快照 100 # 回滚到快照升级前 qm 回滚 100 # 删除快照升级前的 qm delsnapshot 100 # 克隆虚拟机（完整副本） qm 克隆 100 101 --name 克隆虚拟机 --full # 克隆为链接克隆（共享基础磁盘，速度更快） qm 克隆 100 101 --name linked-vm ### 模板 # 将VM转换为模板（不可逆）质量管理模板 100 # 从模板创建虚拟机（链接克隆） qm 克隆 100 200 --来自模板的名称 # 从模板创建虚拟机（完整克隆） qm 克隆 100 200 --name from-template --full ### 迁移 # 在线迁移到另一个节点 qm migrate 100 node2 --在线 # 离线迁移 qm 迁移 100 个节点2 ### 监控 # 虚拟机状态质量状况 100 # 列出所有虚拟机质量管理清单 # 显示正在运行的进程/代理信息质量管理代理 100 ping qm 代理 100 获取 osinfo # 监控接口（QEMU监控）质量监控100 ## 使用 `pct` 进行容器管理 ### 创建容器 # 先下载一个模板 pveam更新 pveam 可用 --section 系统 pveam 下载本地 debian-12-standard_12.2-1_amd64.tar.zst # 创建ID为200的容器 pct 创建 200 local:vztmpl/debian-12-standard_12.2-1_amd64.tar.zst \ --主机名 my-ct --内存 1024 --核心 2 \ --rootfs 本地lvm:8 \ --net0 名称 = eth0，网桥 = vmbr0，ip = dhcp \ --密码“秘密”--非特权 1 # 使用静态IP创建 pct 创建 201 local:vztmpl/debian-12-standard_12.2-1_amd64.tar.zst \ --主机名 web-ct --内存 2048 --核心 2 \ --rootfs 本地lvm:16 \ --net0 名称=eth0,bridge=vmbr0,ip=10.0.0.51/24,gw=10.0.0.1 \ --名称服务器 1.1.1.1 --非特权 1 ### 容器生命周期命令 |目的 ---|--- `pct start ` |启动容器 `pct shutdown ` |优雅关机 `pct stop ` |强制停止 `pct 重新启动 ` |重启容器 `pct 销毁 ` |删除容器及其卷 `pct 输入 ` |打开容器内的外壳 `pct exec -- ` |在容器内运行命令 `pct 控制台 ` |连接到容器控制台 ### 容器配置 # 显示配置百分比配置 200 # 修改资源 pct 设置 200 --内存 4096 pct 设置 200 --核心 4 pct 集 200 --交换 1024 # 添加挂载点（从主机绑定挂载） pct 设置 200 --mp0 /mnt/data,mp=/data # 添加额外的存储卷 pct 设置 200 --mp1 local-lvm:50,mp=/var/lib/data # 网络 pct 设置 200 --net0 名称 = eth0，桥 = vmbr0，ip = 10.0.0.60/24，gw = 10.0.0.1 pct 设置 200 --net1 名称 = eth1，网桥 = vmbr1，ip = dhcp # 功能（嵌套、FUSE、NFS） pct 设置 200 --features 嵌套=1 pct 设置 200 --features 嵌套 = 1，保险丝 = 1，安装 = nfs # DNS pct set 200 --nameserver "1.1.1.1 8.8.8.8" --searchdomain example.com # 开机启动 pct set 200 --onboot 1 --startup order=1,up=30 ### 容器快照和克隆 # 快照 pct snapshot 200 全新安装 # 回滚 pct 回滚 200 全新安装 # 克隆 pct 克隆 200 201 --主机名克隆-ct --full ## 存储管理 # 列出存储池脓毒症状态 # 列出存储的内容 Pvesm 本地列表 pvesm 列表本地 lvm # 添加存储（示例） pvesm add dir my-backup --path /mnt/backup --content backup pvesm 添加 nfs nfs-share --server 10.0.0.5 --export /exports/pve --content 图像，vztmpl pvesm 添加 lvm my-lvm --vgname my-vg --content rootdir,images pvesm 添加 zfspool my-zfs --pool rpool/data --content rootdir，图像 # 删除存储 pvesm 删除我的备份 # 下载 ISO wget -P /var/lib/vz/template/iso/ https://example.com/image.iso ## 网络 # 列出网络接口猫 /etc/网络/接口 # 通用网桥配置（在/etc/network/interfaces中） # 自动 vmbr0 # iface vmbr0 inet 静态 # 地址 10.0.0.1/24 # 桥接端口 eno1 # 桥接 stp 关闭 # 桥FD 0 # 应用网络更改 ifreload -a ## 集群管理 # 创建一个新集群 pvecm 创建我的集群 # 加入现有集群 pvecm添加10.0.0.1 # 显示集群状态 pvecm状态 # 列出集群节点 pvecm节点 # 删除一个节点（从剩余节点运行） pvecm delnode 节点名 # 检查法定人数 pvecm Expected 1 # 强制仲裁（危险，仅限单节点恢复） ## 防火墙 # 在数据中心级别启用/禁用防火墙 pve-防火墙启动 pve-防火墙停止 pve-防火墙状态 # 通过配置文件管理规则 # 数据中心：/etc/pve/firewall/cluster.fw # 节点：/etc/pve/nodes//host.fw # VM/CT：/etc/pve/firewall/.fw ## 备份与恢复 # 备份虚拟机 vzdump 100 --存储本地 --模式快照 --压缩 zstd # 备份一个容器 vzdump 200 --存储本地 --模式停止 --压缩 zstd # 备份所有客人 vzdump --all --storage local --mode snapshot --compress zstd --mailto admin@example.com # 恢复虚拟机 qmrestore /var/lib/vz/dump/vzdump-qemu-100-*.vma.zst 100 # 恢复一个容器 pct 恢复 200 /var/lib/vz/dump/vzdump-lxc-200-*.tar.zst # 恢复到不同的存储 qmrestore /var/lib/vz/dump/vzdump-qemu-100-*.vma.zst 100 --storage local-lvm ## 常见的配置模式 ### 从模板进行 Cloud-Init VM # 1.创建基础VM并安装操作系统，然后转换为模板质量管理模板 9000 # 2. 使用 cloud-init 进行克隆和自定义 qm 克隆 9000 110 --name web-server --full qm 设置 110 --ciuser 部署 --sshkeys ~/.ssh/authorized_keys qm 设置 110 --ipconfig0 ip=10.0.0.110/24,gw=10.0.0.1 qm 设置 110 --名称服务器 1.1.1.1 质量开始 110 ### 批量创建容器对于 $(seq 1 5) 中的 i；做 CTID=$((300 + i)) pct 创建 $CTID local:vztmpl/debian-12-standard_12.2-1_amd64.tar.zst \ --主机名“worker-${i}”--内存1024--核心2\ --rootfs 本地lvm:8 \ --net0 name=eth0,bridge=vmbr0,ip=10.0.0.$((60 + i))/24,gw=10.0.0.1 \ --非特权1 --启动1 完成 ### 导入磁盘镜像（例如云镜像） # 下载云镜像 wget https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img # 导入到虚拟机 qm importdisk 100 jammy-server-cloudimg-amd64.img 本地-lvm # 附加导入的磁盘 qm 设置 100 --scsi0 本地 lvm:vm-100-disk-0 qm 设置 100 --启动顺序=scsi0 ## 故障排除问题 |解决方案 ---|--- VM 无法启动 |检查“qm config ”，使用“pvesm status”验证存储是否存在 “任务错误：无法锁定文件”| `rm /run/lock/qemu-server/lock-.conf` （首先验证虚拟机是否未运行）容器无网络|检查桥是否存在：`brctl show`；验证防火墙规则磁盘存储已满 | `pvesm status` 检查使用情况； LVM 精简池的“lvs” 集群仲裁丢失 |幸存节点上的“pvecm预期为1”（仅限单节点恢复）迁移失败 |确保相同的 CPU 类型或使用 `--online` 进行实时迁移；检查节点之间的网络备份因锁定错误而失败 | `qm 解锁 ` 或 `pct 解锁 ` 虚拟机中磁盘 I/O 缓慢 |使用带有“iothread=1”和“discard=on”的“virtio-scsi-pci”控制器访客代理没有响应 |在虚拟机中安装“qemu-guest-agent”并启用：“qm set --agent 1” ## 有用的路径路径|内容 ---|--- `/etc/pve/` |集群范围的配置 (pmxcfs) `/etc/pve/qemu-server/.conf` |虚拟机配置文件 `/etc/pve/lxc/.conf` |容器配置文件 `/etc/pve/storage.cfg` |存储定义 `/etc/pve/nodes/` |每个节点的配置 `/var/lib/vz/` |默认本地存储根目录 `/var/lib/vz/template/iso/` | ISO 映像 `/var/lib/vz/template/cache/` |容器模板 `/var/lib/vz/dump/` |备份文件 `/var/log/pve/tasks/` |任务日志

Proxmox 管理员

包含技能