使用Docker Compose部署Cloudreve云存储系统的完整指南

前言

Cloudreve是一款优秀的自托管云存储系统，支持多种存储后端，提供丰富的文件管理功能。本文将详细解析如何使用Docker Compose部署Cloudreve及其相关组件，包括Redis缓存服务和Aria2下载工具，构建一个完整的个人云存储解决方案。

系统架构概述

该Docker Compose配置定义了一个包含三个服务的微服务架构：

1. Redis服务：作为Cloudreve的缓存层，提升系统性能
2. Cloudreve主服务：提供核心的文件管理和Web界面
3. Aria2服务：集成下载功能，增强Cloudreve的文件下载能力

详细配置解析

1. Redis服务配置

redis:
  container_name: redis
  image: bitnami/redis:latest
  restart: unless-stopped
  environment:
    - ALLOW_EMPTY_PASSWORD=yes
  volumes:
    - redis_data:/bitnami/redis/data

• 使用官方维护的Bitnami Redis镜像，保证稳定性和安全性
• restart: unless-stopped确保服务异常退出后自动重启
• 允许空密码访问（生产环境建议设置密码）
• 数据卷挂载确保Redis数据持久化

2. Cloudreve主服务配置

cloudreve:
  container_name: cloudreve
  image: cloudreve/cloudreve:latest
  restart: unless-stopped
  ports:
    - "5212:5212"
  volumes:
    - temp_data:/data
    - ./cloudreve/uploads:/cloudreve/uploads
    - ./cloudreve/conf.ini:/cloudreve/conf.ini
    - ./cloudreve/cloudreve.db:/cloudreve/cloudreve.db
    - ./cloudreve/avatar:/cloudreve/avatar
  depends_on:
    - aria2

关键点说明：

• 暴露5212端口供外部访问
• 多数据卷挂载确保配置和数据持久化：
  • 上传文件目录
  • 配置文件
  • SQLite数据库文件
  • 用户头像目录
• 依赖Aria2服务，确保下载功能可用

3. Aria2下载服务配置

aria2:
  container_name: aria2
  image: p3terx/aria2-pro
  restart: unless-stopped
  environment:
    - RPC_SECRET=your_aria_rpc_token
    - RPC_PORT=6800
  volumes:
    - ./aria2/config:/config
    - temp_data:/data

注意事项：

• 必须设置RPC_SECRET作为安全令牌
• 配置目录挂载方便自定义Aria2配置
• 与Cloudreve共享temp_data卷，实现下载文件直接可用

4. 数据卷配置

volumes:
  redis_data:
    driver: local
  temp_data:
    driver: local
    driver_opts:
      type: none
      device: $PWD/data
      o: bind

• redis_data：Redis专用数据卷
• temp_data：绑定挂载到宿主机当前目录下的data文件夹，便于直接管理下载文件

部署步骤指南

1. 准备环境：

   • 安装Docker和Docker Compose
   • 创建项目目录结构

2. 配置文件准备：

   • 在项目目录下创建cloudreve和aria2子目录
   • 将Cloudreve配置文件conf.ini放入cloudreve目录

3. 修改配置：

   • 替换RPC_SECRET为自定义的安全令牌
   • 检查端口5212是否被占用

4. 启动服务：

   docker-compose up -d
   

5. 访问系统：

   • 浏览器访问http://服务器IP:5212
   • 初始管理员账号信息可在Cloudreve日志中查看

生产环境建议

1. 安全性增强：

   • 为Redis设置访问密码
   • 使用Nginx反向代理并配置HTTPS
   • 定期备份数据库和重要文件

2. 性能优化：

   • 根据需求调整Cloudreve和Redis的资源限制
   • 考虑使用外部MySQL数据库替代SQLite

3. 监控维护：

   • 设置日志轮转策略
   • 监控服务健康状态

常见问题解答

Q: 如何更新Cloudreve到最新版本？ A: 停止服务后执行docker-compose pull cloudreve，然后重新启动

Q: 下载的文件存储在哪里？ A: 存储在宿主机的./data目录下（由temp_data卷指定）

Q: 如何备份系统数据？ A: 需要备份cloudreve目录下的数据库文件和配置文件，以及Redis数据卷

通过本文介绍的Docker Compose部署方式，您可以快速搭建一个功能完善的个人云存储系统，享受Cloudreve带来的便捷文件管理体验。