

以下清单按管理对象分类整理，所有命令均以 `root` 身份在 PVE 宿主机 Shell 中执行。涉及破坏性操作（删除、强制停止、回滚）的地方已单独标注。


## 一、虚拟机管理：`qm`

`qm` 是 Proxmox VE 中管理 QEMU/KVM 虚拟机的核心工具，覆盖创建、配置、生命周期、快照、克隆与迁移。

### 1. 查看与创建

| 命令 | 说明 | 关键参数/示例 |
|---|---|---|
| `qm list` | 列出当前节点上的所有虚拟机及状态 | `qm list` |
| `qm config <vmid>` | 查看虚拟机完整配置 | `qm config 103`；加 `--current` 只看当前值，加 `--snapshot <名称>` 查看快照配置 |
| `qm create <vmid> [选项]` | 创建新虚拟机 | `qm create 103 --name "DebianVM" --memory 2048 --cores 2 --sockets 1 --net0 virtio,bridge=vmbr0 --ostype l26` |

`qm create` 高频参数：`--memory`（内存 MB）、`--cores`（每插槽核心数）、`--sockets`（插槽数）、`--net0`（网络，格式 `model,bridge=...`）、`--ostype`（`l26` 表示 Linux 2.6+ 内核）、`--scsi0` / `--virtio0`（磁盘）、`--cdrom`（ISO 路径）。

### 2. 生命周期

| 命令 | 说明 | 示例 |
|---|---|---|
| `qm start <vmid>` | 启动虚拟机 | `qm start 103` |
| `qm shutdown <vmid>` | 优雅关机（发送 ACPI 信号，等待 Guest OS 正常退出） | `qm shutdown 101 --timeout 120`（等待最多 120 秒） |
| `qm stop <vmid>` | **强制停止**（相当于物理机拔电，可能导致数据损坏） | `qm stop 103` |
| `qm reboot <vmid>` | 重启虚拟机 | `qm reboot 103` |
| `qm suspend <vmid>` / `qm resume <vmid>` | 挂起到内存 / 从挂起恢复 | `qm suspend 103` |

### 3. 硬件配置修改

`qm set <vmid> [选项]` 用于在线或离线修改虚拟机硬件配置。

```bash
# 挂载 32GB 磁盘到 SCSI 0
qm set 105 --scsi0 local-lvm:32G

# 挂载 ISO 到 IDE 光驱
qm set 105 --ide2 local:iso/debian-10.7.0-amd64-netinst.iso,media=cdrom

# 设置启动顺序（先光驱，后硬盘）
qm set 105 --boot order=ide2;scsi0

# 在线扩容磁盘 +10G
qm resize 103 scsi0 +10G

# 热插拔增加内存
qm set 103 --memory 8192

# 启用 Q35 芯片组（PCIe 直通场景）
qm set 103 --machine q35
```

磁盘参数说明：`local-lvm` 为存储 ID，`scsi0`/`virtio0`/`sata0` 为磁盘接口，`+10G` 表示在现有基础上增加 10GB。

### 4. 快照与克隆

```bash
# 创建快照（建议在执行升级等高风险操作前进行）
qm snapshot 103 "before_upgrade"

# 查看快照列表
qm listsnapshot 103

# 回滚到指定快照（⚠️ 快照之后的变更将被丢弃）
qm rollback 103 "before_upgrade"

# 删除快照
qm delsnapshot 103 "before_upgrade"

# 完整克隆（复制全部磁盘数据）
qm clone 103 104 --name "DebianClone" --full

# 链接克隆（共享基础磁盘，速度快，用于模板场景）
qm clone 103 104 --name "LinkedClone"
```

`qm clone` 关键参数：`--full` 为完整克隆（默认从模板克隆时尝试链接克隆），`--target <节点>` 用于跨节点克隆（要求共享存储），`--storage <存储ID>` 指定目标存储。

### 5. 迁移与销毁

```bash
# 在线迁移到 node2
qm migrate 103 node2 --online

# 离线迁移
qm migrate 103 node2

# ⚠️ 销毁虚拟机（同时删除所有磁盘）
qm destroy 103

# ⚠️ 销毁并清理所有关联任务/配置
qm destroy 103 --purge
```


## 二、LXC 容器管理：`pct`

`pct` 是管理 Linux 容器的工具，命令结构与 `qm` 高度对应。

### 1. 创建与查看

```bash
# 创建容器（模板需事先下载到存储）
pct create 200 local:vztmpl/debian-12-standard_12.2-1_amd64.tar.zst \
  --hostname my-ct --memory 1024 --cores 2 \
  --rootfs local-lvm:8 \
  --net0 name=eth0,bridge=vmbr0,ip=dhcp \
  --password 'secret' --unprivileged 1

# 查看容器配置
pct config 200
```

`pct create` 关键参数：`--rootfs <存储>:<大小>`（根磁盘）、`--net0 name=eth0,bridge=...,ip=...`（网络）、`--unprivileged 1`（非特权容器，推荐）、`--password`（root 密码）、`--nameserver`（DNS）。

### 2. 生命周期与进入容器

| 命令 | 说明 |
|---|---|
| `pct start <ctid>` / `pct shutdown <ctid>` | 启动 / 优雅关机 |
| `pct stop <ctid>` | 强制停止 |
| `pct reboot <ctid>` | 重启 |
| `pct enter <ctid>` | **进入容器内的 root Shell**（最常用） |
| `pct exec <ctid> -- <命令>` | 不进入容器，直接执行命令，如 `pct exec 200 -- systemctl restart nginx` |
| `pct destroy <ctid>` | ⚠️ 销毁容器及其卷 |

### 3. 配置修改

```bash
# 调整内存为 4096MB
pct set 200 --memory 4096

# 修改网络配置（运行中也可执行）
pct set 200 -net0 name=eth0,bridge=vmbr0,ip=192.168.15.147/24,gw=192.168.15.1
```


## 三、存储管理：`pvesm`

`pvesm` 用于管理存储定义、查看存储状态和内容、分配磁盘卷。

| 命令 | 说明 | 示例 |
|---|---|---|
| `pvesm status` | 查看所有存储的状态、类型、可用空间 | `pvesm status` |
| `pvesm list <storage>` | 列出指定存储上的内容（磁盘、ISO、备份、模板等） | `pvesm list local-lvm` |
| `pvesm add <type> <storage_id> [选项]` | 添加新存储 | `pvesm add dir mydir --path /mnt/data`；`pvesm add pbs store2 --server localhost --datastore store2` |
| `pvesm set <storage_id> [选项]` | 修改存储属性 | `pvesm set store2 --disable 1`（禁用）；`pvesm set store2 --shared 1`（标记为共享） |
| `pvesm alloc <storage> <vmid> <filename> <size>` | 手动分配磁盘镜像 | `pvesm alloc local-lvm 103 vm-103-disk-1 32G` |
| `pvesm free <volume>` | ⚠️ 删除卷 | `pvesm free local-lvm:vm-103-disk-1` |


## 四、集群管理：`pvecm`

`pvecm` 用于创建集群、加入节点、查看仲裁状态和节点视图。

| 命令 | 说明 | 示例 |
|---|---|---|
| `pvecm create <clustername>` | 在首节点上创建集群 | `pvecm create my-cluster` |
| `pvecm add <hostname/IP>` | 将当前节点加入已有集群（需输入首节点 root 密码） | `pvecm add 192.168.1.10` |
| `pvecm status` | **查看集群整体状态和 Quorum 仲裁情况** | `pvecm status` |
| `pvecm nodes` | 查看集群节点列表及 Node ID | `pvecm nodes` |
| `pvecm delnode <node>` | ⚠️ 从集群配置中移除节点（建议先关机并清理） | `pvecm delnode pve03` |

`pvecm add` 关键参数：`--link0 address=<IP>` 指定 Corosync 链路地址（最多 8 条链路），`--votes <N>` 设置投票数，`--force` 在节点已存在时不报错。集群节点间需要 UDP 5405–5412 通信，时间必须同步，建议使用独立物理网卡承载 Corosync 流量。


## 五、备份与恢复：`vzdump`

`vzdump` 是内置的虚拟机/容器备份工具，支持 snapshot、suspend、stop 三种模式。

### 常用备份命令

```bash
# 备份单个 VM 到 local 存储，gzip 压缩
vzdump 103 --storage local --compress gzip

# 备份所有 Guest，排除指定 ID，zstd 压缩
vzdump --all --exclude 103,105 --storage backup --compress zstd

# 快照模式（默认，对运行中 VM 影响最小）
vzdump 102 --mode snapshot --storage backup

# suspend 模式（短暂挂起，兼顾一致性）
vzdump 102 --mode suspend --compress lzo --storage backup

# 限制备份带宽为 1024 KiB/s
vzdump 102 --bwlimit 1024 --storage backup

# 保留策略：仅保留最近 5 份
vzdump 102 --prune-backups keep-last=5 --storage backup
```

关键参数说明：

- `--mode snapshot|suspend|stop`：`snapshot` 依赖存储快照，在线备份首选；`suspend` 短暂挂起；`stop` 先关机再备份，一致性最强但停机。
- `--compress 0|gzip|lzo|zstd`：`0` 为不压缩；`zstd` 通常压缩比与速度平衡较好。
- `--storage <ID>`：目标备份存储。
- `--prune-backups keep-last=N`：新版保留策略，替代已弃用的 `--maxfiles`。
- `--all`：备份本节点全部 Guest；可配合 `--exclude` 排除。

### 恢复

```bash
# 从备份文件恢复 VM（在存储中手动选择备份卷）
qmrestore local:backup/vzdump-qemu-103-2026_11_09-03_00_00.vma.zst 103 --storage local-lvm

# 从备份恢复 LXC
pct restore 200 local:backup/vzdump-lxc-200-2026_11_09-03_00_00.tar.zst --storage local-lvm
```


## 六、API 命令行：`pvesh`

`pvesh` 允许你在 Shell 中直接调用 Proxmox VE 的 REST API，适合脚本化、批量查询和获取 JSON 输出。

| 命令 | 说明 | 示例 |
|---|---|---|
| `pvesh get <api_path>` | 调用 API GET | `pvesh get /nodes`（列出集群节点）；`pvesh get /version`（版本） |
| `pvesh create <api_path> [--参数 值]` | 调用 API POST（创建/启动等） | `pvesh create /nodes/pve1/qemu --vmid 106 --name test --memory 2048 --cores 2` |
| `pvesh set <api_path> [--参数 值]` | 调用 API PUT（修改） | `pvesh set cluster/options -console html5` |
| `pvesh delete <api_path>` | 调用 API DELETE | `pvesh delete /nodes/pve1/qemu/106` |

通用选项：`--output-format json-pretty` 美化 JSON 输出；`--noproxy` 禁用自动代理。


## 七、防火墙与网络

### `pve-firewall`

| 命令 | 说明 |
|---|---|
| `pve-firewall status` | 查看防火墙运行状态 |
| `pve-firewall start` / `reload` | 启动 / 重载规则（修改规则后 reload 即可生效） |
| `pve-firewall log` | 查看最近防火墙日志 |

规则文件位于 `/etc/pve/firewall/`：集群级 `cluster.fw`、节点级 `<node>.fw`、VM/CT 级 `<VMID>.fw`。注意：PVE 8 起启用防火墙后，默认仅放行管理网络访问 WebGUI（8006）和 SSH（22）。

### 网络重载

修改 `/etc/network/interfaces` 后，无需重启即可使配置生效：

```bash
ifreload -a
```

网桥、VLAN、Bond 的配置均在 `/etc/network/interfaces` 中定义；VLAN 接口通过设备名加点号表示，如 `eth0.50`、`bond1.30`。


## 八、容器模板管理：`pveam`

```bash
pveam update                          # 刷新可用模板索引
pveam available --section system      # 列出系统类模板
pveam download local debian-12-standard_12.2-1_amd64.tar.zst
pveam list local                      # 查看 local 存储上的模板
pveam remove local:vztmpl/xxx.tar.zst # 删除模板
```


## 九、排障与巡检

| 命令 | 说明 |
|---|---|
| `pveversion -v` | 查看 PVE 及各组件详细版本（求助/排障时首先提供） |
| `pvesh get /nodes/$(hostname)/tasks --limit 10` | 查看最近 10 个任务（备份、迁移、启动等） |
| `journalctl -u pvedaemon --since "1 hour ago"` | 查看核心 PVE 守护进程日志 |
| `journalctl -u pveproxy --since "30 min ago"` | 查看 Web UI / API 代理日志 |
| `journalctl -u corosync --since "1 hour ago"` | 集群通信诊断 |
| `journalctl -xe` | 查看系统级错误日志 |
| `dmesg -T \| grep -i "error\|warn\|fail"` | 查看内核硬件/驱动错误（带时间戳） |
| `qm status <vmid>` / `pct status <ctid>` | 快速查看 Guest 运行状态 |


## 附：高频操作速查

| 场景 | 命令 |
|---|---|
| 查看本节点所有 VM | `qm list` |
| 查看本节点所有 CT | `pct list` |
| 优雅关机 VM | `qm shutdown <vmid>` |
| 强制停止 VM | `qm stop <vmid>` ⚠️ |
| 进入容器 Shell | `pct enter <ctid>` |
| 查看集群仲裁 | `pvecm status` |
| 查看存储空间 | `pvesm status` |
| 备份单个 VM | `vzdump <vmid> --storage <存储> --compress zstd` |
| 在线迁移 VM | `qm migrate <vmid> <目标节点> --online` |
| 查看版本（排障第一步） | `pveversion -v` |


**使用提醒**：`qm destroy`、`pct destroy`、`pvecm delnode`、`qm stop`、`pvesm free` 以及快照回滚均具有不可逆性或可能导致数据丢失，执行前请确认目标 ID 并确保有可用备份。跨节点迁移和克隆的前提是目标节点可达，且存储为共享存储或目标存储已配置。

以下清单按管理对象分类整理，所有命令均以 root 身份在 PVE 宿主机 Shell 中执行。涉及破坏性操作（删除、强制停止、回滚）的地方已单独标注。

Proxmox VE 常用命令清单

高级技术架构师、产品售前专家

编程语言

以下内容按管理对象分类，覆盖Proxmox VE的虚拟机与容器管理、存储、集群、备份、网络及排障命令，包含qmqm、pct、pvesm、pvecm、vzdump、pvesh等核心工具。重点解析高频操作如创建、生命周期管理、快照、克隆、迁移及恢复，并标注破坏性操作风险。助力SEO优化，快速掌握PVE运维要点，提升搜索可见度。

数据丢失

代码解释

存储管理

虚拟机

防火墙

容器

Debian

Linux

DHCP

JSON

QEMU

腾讯云双十一大促

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

以下内容按管理对象分类，覆盖Proxmox VE的虚拟机与容器管理、存储、集群、备份、网络及排障命令，包含qmqm、pct、pvesm、pvecm、vzdump、pvesh等核心工具。重点解析高频操作如创建、生命周期管理、快照、克隆、迁移及恢复，并标注破坏性操作风险。助力SEO优化，快速掌握PVE运维要点，提升搜索可见...

Proxmox VE 常用命令清单-腾讯云开发者社区-腾讯云

Proxmox VE 常用命令清单

Proxmox VE 常用命令清单

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐