corsinvest/cv4pve-admin

cv4pve-admin Docker镜像文档

镜像概述和主要用途

cv4pve-admin是cv4pve-toolbox的进化版，是Proxmox VE的高级管理系统，支持对多个集群和单节点进行集中管理，提供进阶的Proxmox VE环境管理能力。

核心功能和特性

• 多环境管理：支持同时管理多个Proxmox VE集群及单个节点
• 数据持久化：通过挂载卷实现配置和数据的持久化存储
• 时区同步：支持通过环境变量配置时区，确保系统时间准确性

使用场景和适用范围

适用于需要集中管理多个Proxmox VE集群或独立节点的管理员，可简化Proxmox VE环境的日常运维、监控和管理任务，提升管理效率。

详细使用方法和配置说明

准备持久化目录

需创建持久化目录存储配置数据，假设基础目录为/DockerData/cv4pve-admin，首次使用需在此目录创建空的appsettings.json文件：

sh
$ touch /DockerData/cv4pve-admin/appsettings.json

创建容器

使用以下命令启动容器：

sh
$ docker run -d \
    -p 5000:5000 \
    -e TZ=Europe/Rome \
    -v /DockerData/cv4pve-admin/data:/app/data \
    -v /DockerData/cv4pve-admin/appsettings.json:/app/appsettings.json \
    --name cv4pve-admin \
    corsinvest/cv4pve-admin:xx.xx.x

注意：首次运行前，必须在映射目录中创建appsettings.json文件，否则容器可能无法正常启动。 时区配置：TZ=Europe/Rome用于同步时区，时区列表参考。

容器启动后，通过访问Docker主机的5000端口即可使用管理界面。默认登录凭据：用户admin@local，密码Password123!。

镜像更新

更新时，持久化卷中的配置数据不会丢失（建议更新前手动备份）。系统会通过通知提示可用更新，更新需在维护期内进行，过期维护的系统更新后可能无法正常工作。

更新步骤

1. 停止当前容器：

   sh
   $ docker stop cv4pve-admin
   

2. 删除容器：

   sh
   $ docker rm cv4pve-admin
   

3. 启动新版本容器（替换xx.xx.x为目标版本号）：

   sh
   $ docker run -d \
       -p 5000:5000 \
       -e TZ=Europe/Rome \
       -v /DockerData/cv4pve-admin/data:/app/data \
       -v /DockerData/cv4pve-admin/appsettings.json:/app/appsettings.json \
       --name cv4pve-admin \
       corsinvest/cv4pve-admin:xx.xx.x
   

维护与支持

• 维护者：Corsinvest Srl
• 获取帮助：https://github.com/Corsinvest/cv4pve-admin
• 订阅支持：购买支持
• 支持计划对比：查看支持计划