henryyao/cloudreve

Cloudreve Docker

![]([] ![]([] ![]([] ![]([]

项目地址：https://github.com/chunfengyao/cloudreve-docker

镜像概述和主要用途

该Docker镜像基于最新的https://github.com/cloudreve/Cloudreve%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E6%96%87%E4%BB%B6%E5%AD%98%E5%82%A8%E4%B8%8E%E5%88%86%E4%BA%AB%E6%9C%8D%E5%8A%A1%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%E3%80%82Cloudreve%E6%98%AF%E4%B8%80%E6%AC%BE%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E5%AD%98%E5%82%A8%E6%96%B9%E5%BC%8F%EF%BC%88%E6%9C%AC%E5%9C%B0%E5%AD%98%E5%82%A8%E3%80%81%E5%AF%B9%E8%B1%A1%E5%AD%98%E5%82%A8%E7%AD%89%EF%BC%89%E7%9A%84%E5%BC%80%E6%BA%90%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E7%B3%BB%E7%BB%9F%EF%BC%8C%E5%8F%AF%E7%94%A8%E4%BA%8E%E6%90%AD%E5%BB%BA%E4%B8%AA%E4%BA%BA%E6%88%96%E5%9B%A2%E9%98%9F%E7%9A%84%E7%A7%81%E6%9C%89%E4%BA%91%E5%AD%98%E5%82%A8%E5%B9%B3%E5%8F%B0%E3%80%82

核心功能和特性

• 基于最新版本：同步官方最新Cloudreve V3版本
• 长期维护：持续跟进官方更新并维护镜像
• 体积优化：解决依赖问题后大幅缩小镜像体积，可能是目前最小的Cloudreve Docker镜像
• 纯净安装：无多余组件，仅包含运行Cloudreve所需核心文件
• 多架构支持：兼容amd64、arm64、arm32/v7架构
• 简易部署：提供简洁的启动命令和配置说明
• 配套教程：内含Cloudreve+Nginx+Aria2完整部署教程

使用场景和适用范围

• 个人文件存储与管理
• 团队内部文件协作与分享
• 搭建私有云存储服务
• 需要跨架构部署文件服务的场景

使用方法和配置说明

获取PUID和PGID

使用PUID和PGID可确保容器内进程对挂载目录拥有正确权限，详情参见Understanding PUID and PGID。
假设当前登录用户为root，执行id root获取类似输出：

uid=1000(root) gid=1001(root)

则PUID为1000，PGID为1001。

目录准备

需提前创建以下目录（替换<PATH TO ...>为实际路径）：

• <PATH TO uploads>：文件上传目录，如/sharedfolders
• <PATH TO config>：配置文件目录，如/dockercnf/cloudreve/config
• <PATH TO db>：数据库文件目录，如/dockercnf/cloudreve/db
• <PATH TO avatar>：用户头像存储目录，如/dockercnf/cloudreve/avatar

创建配置文件

1. 创建配置文件夹：

bash
mkdir -p <PATH TO config>

2. 创建配置文件conf.ini（以下为SQLite数据库配置，使用MySQL等其他数据库请参考Cloudreve官方文档）：

ini
# conf.ini
[Database]
DBFile = /cloudreve/db/cloudreve.db

启动容器

bash
docker run -d \
  --name cloudreve \
  -e PUID=1000 \ # 可选，容器内用户ID
  -e PGID=1000 \ # 可选，容器内用户组ID
  -e TZ="Asia/Shanghai" \ # 可选，时区设置，默认Asia/Shanghai
  -p 5212:5212 \
  --restart=unless-stopped \
  -v <PATH TO uploads>:/cloudreve/uploads \
  -v <PATH TO config>:/cloudreve/config \
  -v <PATH TO db>:/cloudreve/db \
  -v <PATH TO avatar>:/cloudreve/avatar \
  henryyao/cloudreve

说明：

• 首次启动后，执行docker logs -f cloudreve获取初始管理员密码
• PUID和PGID获取方法详见“获取PUID和PGID”部分
• TZ环境变量用于设置时区，默认值为Asia/Shanghai

其他部署方式

• Nginx反向代理+Aria2离线下载：参见https://github.com/xavier-niu/cloudreve-docker/blob/master/README-NAC.md
• Docker Compose部署：参见https://github.com/xavier-niu/cloudreve-docker/blob/master/README-DOCKER-COMPOSE.md
• 云端远程部署：参见https://github.com/xavier-niu/cloudreve-docker/blob/master/README-TEAMCODE.md%EF%BC%88%E6%AF%8F%E6%9C%88%E5%85%8D%E8%B4%B9%E4%BD%BF%E7%94%A8%E6%97%B6%E9%97%B4%E6%9C%89%E9%99%90%E5%88%B6%EF%BC%8C%E8%B6%85%E5%87%BA%E9%9C%80%E4%BB%98%E8%B4%B9%EF%BC%89

镜像升级

1. 停止并移除当前容器：

bash
docker stop cloudreve && docker rm cloudreve

2. 拉取最新镜像：

bash
docker pull henryyao/cloudreve

3. 按照上述“启动容器”步骤重新创建容器即可完成升级。

Cloudreve版本升级

Cloudreve官方版本更新后，维护者会收到邮件通知并及时创建新的Release触发镜像编译（仅需创建新Tag，无需修改源代码）。欢迎社区贡献和参与维护。