进阶 docs.cloudreve.org 2026-10-17 18:46:57 · 20 阅读
第4章 使用 Docker Compose 部署 Cloudreve
使用 Docker Compose 部署
利用 Docker Compose,你可以部署多个容器以支撑 Cloudreve 的运行,包括数据库和 Redis。
前置条件
请参考 Docker Compose 安装文档,安装 Docker 和 Docker Compose。
准备 Compose 文件
将 Docker Compose 仓库克隆到服务器:
bash
git clone https://github.com/cloudreve/docker-compose.git ~/cloudreve
cd ~/cloudreve
复制示例环境变量文件:
bash
cp .env.example .env
该仓库包含以下 Compose 文件:
| 文件 | 说明 |
|---|---|
docker-compose.yml |
基础栈:Cloudreve + PostgreSQL + Redis |
docker-compose.pro.yml |
专业版覆盖配置:切换至 Pro 镜像并添加授权密钥 |
docker-compose.fts.yml |
全文搜索插件:添加 Apache Tika 和 Meilisearch,详见《全文搜索》 |
启动
在 docker-compose.yml 所在目录运行以下命令:
bash
docker compose up -d
后续步骤
Cloudreve 默认监听 5212 端口。你可以在浏览器访问 http://localhost:5212 进入 Cloudreve。请注册一个账号,首个注册的账号将被设为管理员。
此时,Cloudreve 已成功启动并监听 5212 端口。请继续前往「后续步骤」页面完成部署配置。
常见问题
容器持续重启?
首先找到正在重启的容器,然后检查日志:
bash
docker logs -f container_ID
Cloudreve 报错“请指定 license key...”
请在启动前检查是否正确设置了 CR_LICENSE_KEY 环境变量。其值应为从 Pro 许可证管理面板获取的授权密钥。
如何升级 Cloudreve?
bash
# 停止当前运行的容器
docker compose down
# 更新 Cloudreve 镜像
docker compose pull
# 启动新容器
docker compose up -d
你还需要参考「升级 Cloudreve」页面完成后续流程。