dockurr/proxmox

镜像概述

本Docker镜像允许用户在容器内快速部署完整的Proxmox VE节点，无需在物理机上直接安装，降低了Proxmox VE的使用门槛，适用于开发测试、学习实践或小型虚拟化场景。

核心功能

• 容器内运行完整Proxmox VE节点
• 提供原生Proxmox Web管理界面
• 支持KVM硬件加速虚拟机
• 开箱即用的LXC容器功能
• 预配置NAT桥接网络与DHCP服务
• 支持ARM64架构（通过PXVIRT技术）

使用场景

1. 开发测试：快速搭建Proxmox环境，验证虚拟化配置或应用兼容性
2. 学习实践：在不影响物理机的前提下，学习Proxmox VE的操作与管理
3. 小型部署：资源受限场景下，快速构建轻量级虚拟化平台

配置说明

环境变量

• PASSWORD：设置Proxmox root用户的登录密码（必填）

卷挂载

• ./data:/var/lib/vz：存储虚拟机镜像、ISO文件等大对象
• ./config:/var/lib/pve-cluster：存储Proxmox配置数据

端口映射

• 8006:8006：Proxmox Web界面访问端口

部署示例

Docker Compose

yaml
services:
  proxmox:
    hostname: pve
    image: docker.xuanyuan.run/dockurr/proxmox
    container_name: proxmox
    environment:
      PASSWORD: "root"
    ports:
      - 8006:8006
    volumes:
      - ./data:/var/lib/vz
      - ./config:/var/lib/pve-cluster
    restart: always
    privileged: true
    stop_grace_period: 2m

Docker CLI

bash
docker run -it --rm --name proxmox --hostname pve --privileged -e "PASSWORD=root" -p 8006:8006 -v "${PWD:-.}/data:/var/lib/vz" -v "${PWD:-.}/config:/var/lib/pve-cluster" --stop-timeout 120 docker.xuanyuan.run/dockurr/proxmox