xavierniu/cloudreve

Cloudreve Docker

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

镜像概述

本镜像基于最新的https://github.com/cloudreve/Cloudreve%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E4%B8%80%E7%A7%8D%E7%AE%80%E5%8D%95%E3%80%81%E9%AB%98%E6%95%88%E7%9A%84%E6%96%B9%E5%BC%8F%E9%83%A8%E7%BD%B2Cloudreve%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E7%B3%BB%E7%BB%9F%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%E3%80%81%E5%85%B7%E5%A4%87%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E3%80%81%E7%94%A8%E6%88%B7%E7%AE%A1%E7%90%86%E3%80%81%E6%9D%83%E9%99%90%E6%8E%A7%E5%88%B6%E7%AD%89%E5%8A%9F%E8%83%BD%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%E6%9C%AC%E9%95%9C%E5%83%8F%E9%80%9A%E8%BF%87Docker%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%EF%BC%8C%E7%AE%80%E5%8C%96%E4%BA%86%E5%AE%89%E8%A3%85%E6%B5%81%E7%A8%8B%EF%BC%8C%E5%90%8C%E6%97%B6%E4%BF%9D%E8%AF%81%E4%BA%86%E7%8E%AF%E5%A2%83%E4%B8%80%E8%87%B4%E6%80%A7%E5%92%8C%E8%B7%A8%E5%B9%B3%E5%8F%B0%E5%85%BC%E5%AE%B9%E6%80%A7%E3%80%82

核心功能与特性

• 基于最新版本：集成最新的Cloudreve V3版本，确保功能完整性和安全性
• 长期维护：提供持续的更新和维护支持
• 体积优化：镜像体积小，资源占用低
• 纯净安装：无多余组件，仅包含Cloudreve运行所需核心依赖
• 多架构支持：兼容amd64、arm64、arm32/v7等多种硬件架构
• 简易部署：通过Docker命令或docker-compose快速启动
• 配套教程：内含Cloudreve+Nginx+Aria2完整部署教程

使用场景

• 个人或家庭私有云存储系统搭建
• 团队内部文件共享与协作平台
• 小型企业文件管理与分发系统
• 需要跨平台部署的文件服务场景

使用方法

获取PUID和PGID

使用PUID（用户ID）和PGID（用户组ID）可以确保容器内进程对挂载目录拥有正确的权限。获取方法：假设当前登录用户为root，执行以下命令：

bash
id root

输出示例：

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

其中uid值（如1000）为PUID，gid值（如1001）为PGID。详细说明参见Understanding PUID and PGID。

目录准备

需提前创建以下目录（请替换<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
   

启动容器

使用以下命令启动Cloudreve容器：

bash
docker run -d \
  --name cloudreve \
  -e PUID=1000 \  # 可选，替换为实际PUID
  -e PGID=1000 \  # 可选，替换为实际PGID
  -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 \
  xavierniu/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%B3%A8%E6%84%8F%EF%BC%9A%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 xavierniu/cloudreve
   

3. 按照「启动容器」步骤重新启动即可完成升级。