ad80a1/pvekube repository overview

⁠PveKube · 维立方 PVE 管理面板

轻量级、自托管的 Proxmox VE 中文管理面板。一个二进制 + 一个配置文件，不装 Agent、无数据库，开箱即用。

PVE 官方面板功能完整，但偏向工程师思维，普通用户上手门槛高。PveKube 只调用 PVE 官方 API，所有操作仍由 Proxmox VE 自己执行。

⁠功能

⁠快速开始

docker run -d --name pvekube --restart unless-stopped \
  --network host \
  -v /opt/pvekube/data:/app/data \
  -v /usr/share/novnc:/app/web/static/novnc:ro \
  -e PVE_URL=https://192.168.1.10:8006 \
  -e PVE_PASSWORD='PVE 的 root 密码' \
  ad80a1/pvekube:latest

打开 http://<服务器IP>:8080，账号 admin / 密码 admin888，登录后请先改密码。

⁠环境变量

⁠两个要点

• --network host 是必须的：docker bridge 网络访问 PVE 的 8006 常常 no route to host，用宿主机网络最省事。
• 网页控制台需要 noVNC：宿主机先 apt install -y novnc，上面命令里那行 -v /usr/share/novnc:... 就是给它用的；不装、不挂只影响控制台，其余功能正常。

也可以直接用仓库里的 docker-compose.yml（把两个必填值改掉即可）：

git clone https://gitee.com/cncsrf/PveKube.git && cd PveKube
docker compose up -d

⁠界面预览

首页概览

节点概览

虚拟机详情

⁠镜像信息

• 基于 alpine:3.20，多阶段构建，运行镜像只含一个二进制 + 静态页（17.9MB）。
• 后端 Go 1.22，只用标准库、零第三方依赖；前端原生 HTML/CSS/JS，无构建步骤。
• 数据目录 /app/data（已声明为 volume）：config.json（连接信息）、ui.json（站点文案）、audit.jsonl（审计流水）。
• 改完配置重启容器即可生效：docker restart pvekube。

⁠源码与文档

• 源码仓库：https://gitee.com/cncsrf/PveKube⁠
• 安装说明（脚本 / Docker / 升级 / 排错）：https://gitee.com/cncsrf/PveKube/raw/master/INSTALL.md⁠
• 开发文档（架构 / 接口 / 安全 / 二次开发）：https://gitee.com/cncsrf/PveKube/raw/master/PVE管理平台开发文档.md⁠

也可以不用 Docker，一键脚本安装（机器上没有 Go 会自动装好再编译）：

git clone https://gitee.com/cncsrf/PveKube.git && cd PveKube
sudo bash deploy.sh

⁠说明

• 面板不提供 TLS：公网访问请前置 Nginx / Caddy 终止 TLS。

• 虚拟机 IP 依赖 QEMU Guest Agent 上报，没装的机器显示 — 属正常：

  apt install -y qemu-guest-agent
  systemctl enable --now qemu-guest-agent
  

  Copy

• 默认密码 admin888 仅供首次登录，请登录后在「系统设置」里改掉。

⁠License

MIT