mcpField
P
proxmox

proxmox

github.com/poindexter12云与 DevOps736 次安装40 周前更新
代码仓库

关于 proxmox

proxmox 是面向 Proxmox VE 虚拟化平台的参考技能，供管理虚拟机、容器、集群及家庭实验室基础设施时查阅。它按需提供主题文档、命令参考和部署前检查清单。

主要功能

  1. 01VM 与 LXC 管理参考
  2. 02网络、存储及集群主题文档
  3. 03云初始化与备份参考
  4. 04常用命令行工具指南
  5. 05部署前验证清单

适用场景

  1. 01选择 VM 或 LXC 虚拟化方式
  2. 02配置网络桥接、VLAN 或存储
  3. 03规划集群高可用与备份
  4. 04部署前检查节点和资源状态

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/poindexter12/waypoint --skill proxmox

安装后在 Claude Code 中输入/proxmox确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
automation-tools.md
backup.md
cli-tools.md
cloud-init-templates.md
clustering.md
docker-hosting.md
networking.md
storage.md
troubleshooting.md
vm-lxc.md

详细介绍

Proxmox 技能

Proxmox VE 虚拟化平台参考，涵盖虚拟机管理、容器、集群和家庭实验室基础设施。

快速参考

# VM management (qm)
qm list                           # List all VMs
qm status <vmid>                  # Check VM status
qm start <vmid>                   # Start VM
qm stop <vmid>                    # Stop VM (graceful)
qm shutdown <vmid>                # Shutdown VM (ACPI)
qm unlock <vmid>                  # Remove lock
qm config <vmid>                  # Show VM config

# Container management (pct)
pct list                          # List all containers
pct status <ctid>                 # Check container status
pct start <ctid>                  # Start container
pct stop <ctid>                   # Stop container
pct enter <ctid>                  # Enter container shell

# Cluster management (pvecm)
pvecm status                      # Cluster status and quorum
pvecm nodes                       # List cluster nodes

# API shell (pvesh)
pvesh get /nodes                  # List nodes via API
pvesh get /nodes/<node>/status    # Node resource status

# Backup (vzdump)
vzdump <vmid> --mode snapshot --storage <storage>
vzdump --all --compress zstd

参考文件

根据任务按需加载：

主题文件加载时机
VM 与 LXCvm-lxc.md选择虚拟化类型时
Docker 托管docker-hosting.md在 Proxmox 上运行 Docker 时
网络networking.md网桥、VLAN、SDN、防火墙
存储storage.md存储后端、内容类型
Cloud-initcloud-init-templates.md使用 cloud-init 配置 VM
集群clustering.mdHA、仲裁、隔离
备份backup.mdvzdump 模式、恢复
CLI 工具cli-tools.mdqm、pct、pvecm、pvesh 命令
故障排除troubleshooting.md常见错误、诊断
自动化工具automation-tools.mdTerraform/Ansible 集成

验证清单

部署 VM/容器之前：

  • 集群状态正常（pvecm status）
  • 节点资源充足（CPU、RAM、磁盘）
  • 存储可访问且已挂载
  • 网络网桥配置正确
  • VLAN 标签符合网络设计
  • 资源分配未超出节点限制
  • HA 配置正确（如已启用）
  • 已设置备份计划
  • 遵循命名规范

VM 与 LXC 快速决策

因素使用 VM使用 LXC
OSWindows、BSD、任何系统仅 Linux
隔离完整的内核隔离共享内核
性能良好更好（更轻量）
启动较慢快
密度较低较高
复杂度任何工作负载简单服务

家庭实验室网络 VLAN

VLAN用途Proxmox 网桥
5管理（Web UI、API、SSH）vmbr5
1可信网络vmbr0
11存储（NFS/Ceph，MTU 9000）vmbr11
12高速传输vmbr12

评论

支持 Markdown