Skip to content

Cloudreve 简介

Cloudreve封面

Cloudreve 是一款广受欢迎的开源私有云盘系统,能帮助你快速搭建一个属于自己的云存储服务。它支持多种主流云存储作为后端,让你的文件管理既灵活又安全。

官网网站:cloudreve.org

官方 GitHub 地址:https://github.com/cloudreve/Cloudreve

主要特点

  • 多存储后端:支持本地、阿里云 OSS、腾讯云 COS、又拍云、OneDrive 等多种存储方式。
  • 多用户系统:支持多用户注册和管理,可为不同用户组分配不同权限。
  • 在线预览与编辑:支持图片、视频、音频、Office 文档等多种格式在线预览。
  • WebDAV 支持:支持 WebDAV 协议,可将云盘挂载到本地电脑,像操作本地硬盘一样方便。
  • 离线下载:支持离线下载功能,可将 HTTP/FTP/Magnet 链接的文件下载到云盘中。
  • 响应式设计:界面美观,完美适配桌面和移动设备。

准备工作

在开始部署之前,请确保您已经具备以下条件:

  1. 已安装 Docker 和 Docker Compose(参考本站 Linux Docker 安装教程
  2. 服务器建议配置:1核 CPU, 1GB 内存, 5GB 可用存储空间以上。
  3. 准备域名,用于HTTPS访问(可选)

使用 Docker Compose 部署 Cloudreve

1. 创建项目目录和文件

首先,创建用于存放 Cloudreve 配置和数据的目录。

bash
mkdir -p ~/cloudreve
cd ~/cloudreve

2. 创建 docker-compose.yml 文件

bash
cat > docker-compose.yml << 'EOF'
version: '3.8'
services:
  cloudreve:
    image: cloudreve/cloudreve:latest
    container_name: cloudreve
    restart: always
    ports:
      - '5212:5212'
    depends_on:
      - db
      - redis
    volumes:
      # 上传文件
      - ./uploads:/cloudreve/uploads
      # 用户头像
      - ./avatar:/cloudreve/avatar
      # 自定义配置、数据库等
      - ./data:/cloudreve/data
    environment:
      - TZ=Asia/Shanghai
      # 使用 PostgreSQL 作为数据库
      - DATABASE_URL=postgres://cloudreve:cloudreve@db:5432/cloudreve?sslmode=disable
      # 使用 Redis 作为缓存
      - REDIS_URL=redis://redis:6379/0

  db:
    image: postgres:15-alpine
    container_name: cloudreve-db
    restart: always
    volumes:
      - ./db:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=cloudreve
      - POSTGRES_PASSWORD=cloudreve
      - POSTGRES_DB=cloudreve

  redis:
    image: redis:7-alpine
    container_name: cloudreve-redis
    restart: always
EOF

参数说明

  • cloudreve: Cloudreve 主程序服务。
    • ports: 映射 5212 端口用于访问。
    • depends_on: 依赖 dbredis 服务,确保它们先于主程序启动。
    • volumes: 分别挂载了上传目录、头像目录和核心数据目录。
    • environment: 设置了时区,并指定了连接 PostgreSQL 和 Redis 所需的 URL。
  • db: PostgreSQL 数据库服务,用于存储所有元数据。
  • redis: Redis 缓存服务,用于提升系统性能。

3. 启动 Cloudreve 服务

执行以下命令,以后台模式启动 Cloudreve 容器。

bash
docker compose up -d

基本配置

1.访问 Cloudreve

在浏览器中访问:

bash
http://你的服务器IP:5212

2. 初始化管理员账号

Cloudreve 的最新版本采用了更现代、更安全的初始化方式:第一个注册的用户将自动成为管理员。

页面加载后,直接点击“注册”按钮,创建您的第一个用户账号。这个账号创建成功后,将自动拥有管理员权限。

使用您刚刚注册的账号登录后,就可以开始配置您的云盘了。

域名与HTTPS访问(可选)

如需通过自定义域名和HTTPS访问,推荐搭配 Nginx Proxy Manager 进行反向代理与SSL证书配置。

详细教程请参考:使用Docker快速部署Nginx Proxy Manager实现多域名反向代理

后续步骤(可选)

成功部署后,您可以进一步探索 Cloudreve 的强大功能:

  • 在“管理面板” -> “存储策略”中,添加您自己的对象存储(如阿里云 OSS)。
  • 在“用户组”中,为不同用户设置不同的容量和权限。
  • 开启 WebDAV 功能,方便多设备同步。

享受你的专属私有云盘吧!如果在部署过程中遇到任何问题,欢迎在评论区留言。