进阶 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」页面完成后续流程。

评论 (0)