mabutou/cloudreve

Cloudreve 3.1.1 Docker镜像文档

镜像概述

本镜像基于 xavierniu/cloudreve 构建，对应Cloudreve 3.1.1版本，用于快速部署私有文件管理系统。Cloudreve是一款支持多存储后端、具备文件管理、用户权限控制、文件分享等功能的开源云存储解决方案。该版本基于原3.0.0-rc1版本优化，目前xavierniu已发布更新版本，建议用户优先使用官方最新版以获得更好的功能支持和安全性。

核心功能与特性

• 多存储后端支持：兼容本地存储、对象存储（如AWS S3、阿里云OSS等）、WebDAV等多种存储方式
• 文件管理功能：支持文件上传、下载、移动、重命名、删除等基础操作
• 用户与权限管理：支持多用户创建，可配置细粒度的文件访问权限
• 文件分享：生成带密码或时效限制的分享链接，支持文件预览
• WebDAV支持：可通过WebDAV协议挂载为本地磁盘，便捷管理文件
• 简洁Web界面：提供直观的Web管理界面，操作简单易用

使用场景

• 个人私有云盘搭建，管理个人文件
• 团队内部文件协作与共享
• 小型组织的文件存储与分发系统
• 开发环境中临时文件管理服务

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name cloudreve-3.1.1 \
  -p 5212:5212 \
  -v /path/to/data:/cloudreve/data \
  -v /path/to/config:/cloudreve/config \
  -v /path/to/uploads:/cloudreve/uploads \
  xavierniu/cloudreve:3.1.1

参数说明：

• -p 5212:5212：映射容器内Web服务端口（默认5212）到主机
• -v /path/to/data:/cloudreve/data：挂载数据目录，用于持久化数据库等数据
• -v /path/to/config:/cloudreve/config：挂载配置目录，存放配置文件
• -v /path/to/uploads:/cloudreve/uploads：挂载上传文件存储目录

Docker Compose配置

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  cloudreve:
    image: xavierniu/cloudreve:3.1.1
    container_name: cloudreve-3.1.1
    ports:
      - "5212:5212"
    volumes:
      - ./data:/cloudreve/data
      - ./config:/cloudreve/config
      - ./uploads:/cloudreve/uploads
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

访问与初始化

部署完成后，通过 http://主机IP:5212 访问Cloudreve服务。首次启动会生成初始管理员账号和密码，请注意保存。

注意事项

1. 数据持久化：务必通过卷挂载持久化 data、config 和 uploads 目录，避免容器重启后数据丢失
2. 版本更新：xavierniu已发布更新版本，建议通过 docker pull xavierniu/cloudreve 获取最新镜像并更新部署
3. 安全配置：生产环境中建议配置HTTPS，可通过反向代理（如Nginx）实现
4. 存储配置：根据实际需求修改配置文件中的存储后端设置，支持扩展至对象存储等外部存储服务