mcp/proxmox
管理Proxmox VE基础设施，包括虚拟机、容器、存储、网络、防火墙规则、高可用性等。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Proxmox VE MCP Server
镜像概述和主要用途
Proxmox VE MCP Server是一个用于管理Proxmox VE基础设施的Docker镜像，提供全面的集群管理功能，包括虚拟机（VM）、容器、存储、网络、防火墙规则、高可用性（HA）等核心组件的配置与运维。
https://www.anthropic.com/news/model-context-protocol
MCP信息
| 属性 | 详情 |
|---|---|
| Docker镜像 | https://hub.docker.com/repository/docker/mcp/proxmox |
| 作者 | https://github.com/GethosTheWalrus |
| 代码仓库 | https://github.com/GethosTheWalrus/proxmox-mcp |
镜像构建信息
| 属性 | 详情 |
|---|---|
| Dockerfile | https://github.com/GethosTheWalrus/proxmox-mcp/blob/2741ad3a5e13e9a54e286b0d91a9e3ac58c3a5ab/Dockerfile |
| 提交哈希 | 2741ad3a5e13e9a54e286b0d91a9e3ac58c3a5ab |
| 构建者 | Docker Inc. |
| Docker Scout健康评分 | !https://api.scout.docker.com/v1/policy/insights/org-image-score/badge/mcp/proxmox |
| 验证签名 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/proxmox --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| 许可证 | Other |
核心功能和特性
该镜像提供286种工具，覆盖Proxmox VE管理的各个方面，主要功能类别包括：
- 虚拟机/容器管理：创建、克隆、删除、启动、停止、迁移、快照等操作
- 存储管理：创建存储池（LVM、ZFS、Ceph等）、分配卷、备份、复制等
- 网络管理：配置网络接口、SDN（软件定义网络）、防火墙规则等
- 高可用性：创建HA组、管理HA资源、集群状态监控
- 用户与权限：用户/组管理、角色配置、ACL权限控制
- 监控与诊断：资源统计、日志查看、系统报告生成
可用工具（部分展示）
| 工具 | 简短描述 |
|---|---|
add_firewall_ipset_entry | 向IP集添加IP/CIDR。 |
allocate_storage_volume | 在存储中分配新磁盘卷。 |
apply_sdn_changes | 将待处理的SDN配置更改应用到所有节点。 |
bulk_migrate_guests | 批量将客户机迁移到目标节点。 |
bulk_shutdown_guests | 跨集群批量关闭客户机。 |
bulk_start_guests | 跨集群批量启动客户机。 |
change_password | 修改用户密码。 |
clone_container | 克隆容器。 |
clone_vm | 克隆VM以创建新VM。 |
convert_container_to_template | 将容器转换为模板（不可逆）。 |
convert_vm_to_template | 将VM转换为模板（不可逆）。 |
create_backup_job | 创建计划备份任务。 |
create_ceph_osd | 在设备上创建新的Ceph OSD。 |
create_ceph_pool | 创建新的Ceph存储池。 |
create_cluster_firewall_rule | 创建集群级防火墙规则。 |
create_container | 创建新的LXC容器。 |
create_vm | 创建新的QEMU虚拟机。 |
工具详情（部分示例）
工具：add_firewall_ipset_entry
向IP集添加IP/CIDR。
| 参数 | 类型 | 描述 |
|---|---|---|
cidr | string | IP地址或CIDR。 |
name | string | IP集名称。 |
comment | string 可选 | 描述。 |
nomatch | boolean 可选 | 排除此条目（nomatch）。 |
工具：allocate_storage_volume
在存储中分配新磁盘卷。
| 参数 | 类型 | 描述 |
|---|---|---|
filename | string | 卷名称。 |
node | string | 节点名称。 |
size | string | 卷大小（例如'10G'）。 |
storage | string | 存储ID。 |
vmid | integer | 关联的VM ID。 |
format | string 可选 | 磁盘格式（raw、qcow2、vmdk），为空则自动检测。 |
工具：clone_vm
克隆VM以创建新VM，支持完整克隆或链接克隆。
| 参数 | 类型 | 描述 |
|---|---|---|
newid | integer | 新克隆的VMID。 |
node | string | 源节点名称。 |
vmid | integer | 源VM ID。 |
description | string 可选 | 克隆的描述。 |
full | boolean 可选 | 完整克隆（True）或链接克隆（False）。 |
name | string 可选 | 克隆的名称。 |
pool | string 可选 | 资源池。 |
snapname | string 可选 | 从中克隆的快照名称。 |
storage | string 可选 | 完整克隆的目标存储。 |
target | string 可选 | 克隆的目标节点（默认：同一节点）。 |
使用场景和适用范围
- Proxmox VE集群的集中化管理
- 自动化运维任务（如批量部署、备份、迁移）
- 多节点环境下的资源监控与调度
- 网络与安全策略的统一配置
- 开发/测试环境中虚拟机/容器的快速创建与管理
使用方法和配置说明
Docker运行示例
bashdocker run -d \ --name proxmox-mcp \ -e PROXMOX_API_URL="https://your-proxmox-node:8006/api2/json" \ -e PROXMOX_USER="root@pam" \ -e PROXMOX_PASSWORD="your-password" \ mcp/proxmox
配置参数说明
| 环境变量 | 描述 | 示例 |
|---|---|---|
PROXMOX_API_URL | Proxmox VE API地址 | https://node1:8006/api2/json |
PROXMOX_USER | 认证用户ID | admin@proxmox |
PROXMOX_PASSWORD | 用户密码 | secure-password |
PROXMOX_TOKEN_ID | API令牌ID（可选，替代密码） | token123 |
PROXMOX_TOKEN_SECRET | API令牌密钥（可选） | secret456 |
基本操作示例
- 创建LXC容器
bashdocker exec proxmox-mcp create_container \ --vmid 100 \ --node node1 \ --storage local-lvm \ --ostemplate "local:vztmpl/ubuntu-22.04-standard_22.04-1_amd64.tar.zst" \ --hostname "container1" \ --memory 2048 \ --cores 2
- 创建VM快照
bashdocker exec proxmox-mcp create_vm_snapshot \ --vmid 200 \ --node node1 \ --snapname "pre-upgrade" \ --description "Snapshot before system upgrade"
- 批量迁移虚拟机
bashdocker exec proxmox-mcp bulk_migrate_guests \ --target node2 \ --vms "200,201,202"
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull mcp/proxmox:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"