Chevereto V4.0（付费版）最推荐的安装方式是通过 Chevereto 官方 Docker 仓库。
该方案支持：
- 自动生成 .env 配置文件
- 一键构建镜像
- 多版本镜像
- 标准化的部署流程
- 轻松升级到最新版本
本文提供完整安装与更新流程。
一、安装基础环境（依赖工具）
适用于 Debian / Ubuntu
apt update
apt install -y make unzip curl git
克隆官方 Docker 仓库：
git clone https://github.com/chevereto/docker.git
克隆后目录结构包含 Makefile，可自动构建 Chevereto 镜像。
二、构建 Chevereto Docker 镜像
进入目录：
cd docker
2.1 生成 .env 配置文件
make env
脚本会自动询问：
- 你的主机名（example.com）
- Chevereto License Key（付费版必须填写）
- 数据库信息
- 邮箱等信息
配置完成后会生成 .env 文件。
2.2 构建镜像
make image
构建完成后会生成四个版本镜像，例如：
chevereto:latest
chevereto:4
chevereto:4.0
chevereto:4.2.5
提示：
latest指向最新版本，4.2.5是当前最新稳定版本。
三、部署 Chevereto（推荐两种方式）
你可以使用 make deploy（全自动），也可以手写 Docker Compose。
3.1 使用 Makefile 一键部署（推荐）
make deploy NAMESPACE=mywebsite ADMIN_EMAIL=admin@example.com
参数说明：
| 参数 | 说明 |
|---|---|
NAMESPACE | 站点命名空间（类似子目录名或站点标识） |
ADMIN_EMAIL | Chevereto 后台管理员邮箱 |
执行后自动生成：
- docker-compose.yml
- 配置文件
- 数据目录
- 启动容器
3.2 使用 docker-compose.yml 自行部署（手动模式）
创建 docker-compose.yml：
services:
chevereto:
image: chevereto:4.2.5
container_name: chevereto
restart: always
ports:
- "8080:80"
environment:
- CHEVERETO_LICENSE_KEY=${CHEVERETO_LICENSE_KEY}
- DOMAIN=${DOMAIN}
- CHEVERETO_DB_HOST=127.0.0.1
- CHEVERETO_DB_NAME=chevereto
- CHEVERETO_DB_USER=chevereto
- CHEVERETO_DB_PREFIX=chv_
- CHEVERETO_DB_PASS=chv123456
volumes:
- /data/web/html/chevereto/images:/var/www/html/images:rw
启动：
docker-compose up -d
images目录必须挂载，这样更新镜像不会丢失图片。
四、更新 Chevereto（升级到新版本）
进入 docker 仓库目录：
cd docker
4.1 同步仓库（获取最新版本）
make sync
或手动：
git pull
4.2 切换目标版本（如 4.2）
git switch 4.2
4.3 重新构建镜像
make image
4.4 更新正在运行的 Chevereto 容器
make update
更新内容包括：
- 拉取最新配置
- 重建容器
- 自动重启服务
五、常见问题 + 小提示
1. 数据库使用宝塔的 MySQL？
可以，只需要：
CHEVERETO_DB_HOST=127.0.0.1
并确保容器能访问宿主机 MySQL（常用：--network host 或映射 3306）。
2. 图片目录必须挂载吗？
是的！
/var/www/html/images
如果不挂载，更新镜像会丢失所有图片内容。
3. License Key（付费版）必须填？
是的，否则安装完成后无法激活。
4. 推荐部署方案？
最佳方案是：
- 镜像构建使用 Makefile
- 部署使用 docker-compose（可控）
- images 与 storage 持久化挂载
