Proxmox 虚拟机 / 容器创建器

在 Proxmox VE 上创建 Ubuntu 24.04 LXC 容器或完整虚拟机（VM）。返回一个已预装 Docker 并支持 SSH 访问的主机环境。

适用场景

• “create proxmox vm”
• “create proxmox container”
• “spin up lxc”
• “new container on proxmox-host”
• 任何需要在 Proxmox 上快速获取一台全新 Linux 主机的场景

这是一个 基础技能，仅负责构建底层基础设施；其他技能将在其上部署具体应用。

LXC 与 VM 决策指南

默认使用 LXC。 仅当应用程序明确要求内核访问能力时，才应选用 VM。

用户输入参数

前置条件检查

# SSH 连接到 Proxmox
ssh proxmox-host "pveversion" || echo "FAIL: Cannot SSH to Proxmox host"

# 检查模板是否存在（LXC）
ssh proxmox-host "pveam list local | grep ubuntu-24.04" || echo "Template not cached, will download"

# 查找下一个可用 CTID
ssh proxmox-host "pct list" | tail -n +2 | awk '{print $1}' | sort -n | tail -1
# 使用该值加 1 作为新 CTID

LXC 容器执行流程

步骤 1：确保模板已缓存

ssh proxmox-host "pveam list local | grep ubuntu-24.04 || pveam download local ubuntu-24.04-standard_24.04-2_amd64.tar.zst"

步骤 2：查找下一个可用 CTID

NEXT_CTID=$(ssh proxmox-host "cat <(pct list | tail -n +2 | awk '{print $1}') <(qm list | tail -n +2 | awk '{print $1}') 2>/dev/null | sort -n | tail -1")
NEXT_CTID=$((NEXT_CTID + 1))

步骤 3：创建容器

ssh proxmox-host "pct create $CTID local:vztmpl/ubuntu-24.04-standard_24.04-2_amd64.tar.zst 
  --hostname  
  --memory  
  --cores  
  --rootfs local-lvm: 
  --net0 name=eth0,bridge=vmbr0,ip=dhcp 
  --unprivileged 1 
  --features nesting=1 
  --start 1"

关键参数说明：

• --unprivileged 1：安全最佳实践
• --features nesting=1：LXC 内运行 Docker 所必需
• --start 1：创建后立即启动容器

步骤 4：等待启动完成并获取 IP 地址

sleep 10  # LXC 启动耗时约 5 秒

# 从 Proxmox 获取 IP 地址
ssh proxmox-host "pct exec $CTID -- hostname -I"

# 或通过 DHCP 查询
ssh proxmox-host "pct exec $CTID -- ip -4 addr show eth0 | grep inet | awk '{print $2}' | cut -d/ -f1"

步骤 5：启动后 Docker 初始化配置

bash scripts/post-boot-setup.sh proxmox-host $CTID

或手动执行：

ssh proxmox-host "pct exec $CTID -- bash -c '
  apt-get update -qq
  apt-get install -y -qq docker.io curl git htop
  systemctl enable docker && systemctl start docker
  mkdir -p /usr/local/lib/docker/cli-plugins
  curl -SL https://github.com/docker/compose/releases/latest/download/docker-compose-linux-x86_64 -o /usr/local/lib/docker/cli-plugins/docker-compose
  chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
'"

步骤 6：验证安装结果

ssh proxmox-host "pct exec $CTID -- docker --version && pct exec $CTID -- docker compose version"

完整虚拟机（VM）执行流程

当 LXC 不满足需求时，请使用 scripts/create-vm.sh 创建完整虚拟机：

ssh proxmox-host "qm create $VMID --name  --memory  --cores  
  --net0 virtio,bridge=vmbr0 --scsihw virtio-scsi-pci 
  --scsi0 local-lvm:,format=raw --ide2 local-lvm:cloudinit 
  --boot c --bootdisk scsi0 --serial0 socket --vga serial0 
  --ciuser deploy --cipassword  --ipconfig0 ip=dhcp 
  --start 1"

返回值

向调用方报告以下信息：

Container/VM Created: 
CTID/VMID: 
Type: lxc | vm
IP: 
SSH: root@ (LXC) or deploy@ (VM)
Docker: installed
Docker Compose v2: installed

清理操作（Teardown）

# LXC 清理
ssh proxmox-host "pct stop $CTID && pct destroy $CTID --purge"

# VM 清理
ssh proxmox-host "qm stop $VMID && qm destroy $VMID --purge"

关键注意事项（Critical Gotchas）

详见 references/gotchas.md：

1. Docker 在 LXC 中运行需启用 nesting=1：若未指定 --features nesting=1，Docker 将无法创建网络
2. LXC 功能限制：不支持自定义内核模块、不支持原始套接字（AF_PACKET）；Security Onion、Zeek 等工具请使用 VM
3. 模板缓存机制：首次执行 pveam download 较慢；建议先运行 pveam list local 检查本地是否已缓存
4. CTID 冲突风险：分配 CTID 前务必通过 pct list 确认可用性
5. 磁盘为精简配置（thin-provisioned）：尽管存储池显示有 770GB 可用空间，但多个容器可能迅速占满空间
6. Wazuh（CTID 105）示例：仅占用 25GB 即已达 99.3% 使用率；请避免在同一节点上部署高存储消耗型服务