网盘程序：Cloudreve Docker镜像，基于Cloudreve V3版

此Docker镜像由Xavier Niu维护。

优势

• 基于最新的Cloudreve V3
• 长期维护
• 镜像体积小
• 支持多种架构
• 安装简单
• 内含详细的Cloudreve+Caddy+Aria2部署教程

支持架构

• linux/amd64: xaiverniu/cloudreve:latest
• linux/arm64: xaiverniu/cloudreve:arm64v8
• linux/arm/v7: xaiverniu/cloudreve:arm32v7

基于

• cloudreve: 3.0.0-rc1
• base image
  • latest: golang:1.14.1-alpine3.11(builder), lsiobase/alpine:3.11(runtime)
  • arm64v8: arm64v8/golang:1.14.1-alpine3.11(builder), lsiobase/alpine:arm64v8-3.11(runtime)
  • arm32v7: arm32v7/golang:1.14.1-alpine3.11(builder), lsiobase/alpine:arm32v7-3.11(runtime)

关于Cloudreve

Cloudreve 是个公有网盘程序，你可以用它快速搭建起自己的网盘服务，公有云/私有云都可。Cloudreve 底层支持 本机存储、从机存储、阿里云OSS、又拍云、腾讯云COS、七牛云存储、OneDrive（国际版/世纪互联版），每种存储方式的上传下载都是客户端直传。你可以为不同用户组绑定不同存储策略，捐助获得Pro版后，可以为一个用户组分配多个存储方式，用户可以在前台自由切换。

GitHub：https://github.com/Cloudreve/Cloudreve

开始

运行模式

• Docker Run方式运行
  • OC: 仅Cloudreve
  • CAC: Caddy反代+Aria2离线下载服务+Cloudreve
• Docker Compose方式运行
  • CAC: Caddy反代+Aria2离线下载服务+Cloudreve

获取PUID和PGID

假设当前登陆用户为root，则执行

id root

就会得到类似于下面的一段代码

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

则PUID填入1000，PGID填入1001

Docker Run方式运行

OC

docker run -d \
  --name cloudreve \
  -e PUID=1000 \ # optional
  -e PGID=1000 \ # optional
  -e TZ="Asia/Shanghai" \ # optional
  -p 5212:5212 \ 
  --restart=unless-stopped \
  -v <PATH TO UPLOADS>:/cloudreve/uploads \
  -v <PATH TO conf.ini>:/cloudreve/conf.ini \
  -v <PATH TO cloudreve.db>:/cloudreve/cloudreve.db \
  xavierniu/cloudreve

说明

• 首次启动后请执行docker logs -f cloudreve获取初始密码
• PUID以及PGID的获取方式详见获取PUID和PGID
• TZ设置时区，默认值为Asia/Shanghai
• <PATH TO UPLOADS>:上传目录
• <PATH TO conf.ini>: 配置文件
• <PATH TO cloudreve.db>: 数据库文件

CAC

⚠️注意：此教程仅在linux/amd64架构测试，如果您正在使用arm架构，部分参数请根据实际情况调整。

前提

• 已安装docker，如果没有请执行wget -qO- https://get.docker.com/ | bash安装docker。
• 一个域名并解析到运行Cloudreve的服务器，这里以cloudreve.example.com为例。

Step1. 创建Network

docker network create my-network

Step2. 创建Caddy配置文件

mkdir -p /dockercnf/caddy \
    && vim /dockercnf/caddy/Caddyfile

填入以下信息

cloudreve.example.com {
  tls [email protected]
  proxy / cloudreve:5212 {
    transparent
  }
}

Step3. 启动Caddy服务

docker run -d \
  --name caddy \
  -e "ACME_AGREE=true" \
  -e "CADDYPATH=/etc/caddycerts" \
  -v /dockercnf/caddy/certs:/etc/caddycerts \
  -v /dockercnf/caddy/Caddyfile:/etc/Caddyfile \
  --network my-network \
  -p 80:80 -p 443:443 \
  --restart unless-stopped \
  abiosoft/caddy

Step4. 启动Aria2服务（如不需要离线下载功能该步骤略过）

docker run -d \
    --name aria2 \
    --restart unless-stopped \
    --log-opt max-size=1m \
    -e PUID=1000 \
    -e PGID=1000 \
    -e RPC_SECRET=<SECRET> \
    -p 6800:6800 \ #1
    -p 6888:6888 -p 6888:6888/udp \
    --network my-network \
    -v <PATH TO CONFIG>:/config \
    -v <PATH TO TEMP>:/downloads \
    p3terx/aria2-pro

说明

• PUID以及PGID的获取方式详见获取PUID和PGID。
• <SECRET>: Aria2 RPC密码（你可以去这里生成随机字符串）。请记下该密码！在后续Cloudreve设置Aria2中会使用。
• <PATH TO CONFIG>: Aria2的配置文件夹，例如/dockercnf/aria2/conf。
• <PATH TO TEMP>: 临时下载文件夹，需要与Cloudreve的/downloads对应，例如/dockercnf/aria2/temp。
• 如果不需要外网访问Aria2可以将#1所在行删除。

Step5. 预创建Cloudreve的数据库和配置文件，这里以/dockercnf/cloudreve为cloudreve配置目录

mkdir -p /dockercnf/cloudreve \
    && touch /dockercnf/cloudreve/conf.ini \
    && touch /dockercnf/cloudreve/cloudreve.db

Step6. 启动Cloudreve

docker run -d \
  --name cloudreve \
  -e PUID=1000 \ # optional
  -e PGID=1000 \ # optional
  -e TZ="Asia/Shanghai" \ # optional
  --network my-network \
  --restart=unless-stopped \
  -v <PATH TO UPLOADS>:/cloudreve/uploads \
  -v <PATH TO TEMP>:/downloads \ #1
  -v <PATH TO conf.ini>:/cloudreve/conf.ini \
  -v <PATH TO cloudreve.db>:/cloudreve/cloudreve.db \
  xavierniu/cloudreve

说明

• 首次启动后请执行docker logs -f cloudreve获取初始密码
• PUID以及PGID的获取方式详见获取PUID和PGID
• <PATH TO UPLOADS>:上传目录, 例如/sharedfolders
• <PATH TO TEMP>: 临时下载文件夹，需要与Aria的/downloads对应，例如/dockercnf/aria2/temp（如不需要离线下载功能#1可以删除）
• <PATH TO conf.ini>: 配置文件，如/dockercnf/cloudreve/conf.ini
• <PATH TO cloudreve.db>: 数据库文件，如/dockercnf/cloudreve/cloudreve.db

Step7. 配置Cloudreve连接Aria2服务器

• 以管理员身份登陆
• 点击”头像（右上角） > 管理面板”
• 点击”参数设置 > 离线下载”
  • RPC服务器地址: http://aria2:6800/
  • RPC Secret: 参见启动Aria2服务中的<SECRET>
  • 临时下载地址: /downloads
  • 其他选项按照默认值即可
• 测试连接并保存

Docker Compose方式运行

⚠️注意：该docker-compose文件仅适用于linux/amd64架构，如果您正在使用arm请尝试修改部分参数。

前提

• 已安装docker，如果没有请执行wget -qO- https://get.docker.com/ | bash安装docker。
• 已安装docker compose，如果没有请参考Install Docker Compose。
• 一个域名并解析到运行Cloudreve的服务器，这里以cloudreve.example.com为例。
• 确保80和443端口没有被占用，如果您已经有服务器软件（如Nginx或Caddy），请考虑为原有服务器软件增加配置文件并删除docker compose配置文件中的caddy容器。

Step1. 预创建文件

Caddy配置文件

mkdir -p /dockercnf/caddy \
    && vim /dockercnf/caddy/Caddyfile

填入以下信息

cloudreve.example.com {
  tls [email protected]
  proxy / cloudreve:5212 {
    transparent
  }
}

Cloudreve配置文件及数据库文件

mkdir -p /dockercnf/cloudreve \
    && touch /dockercnf/cloudreve/conf.ini \
    && touch /dockercnf/cloudreve/cloudreve.db

Step2. 下载环境文件以及Docker Compose文件

下载环境文件

wget -qO- https://raw.githubusercontent.com/xavier-niu/cloudreve-docker/master/docker-compose-env-example > .env

根据需要对环境变量进行修改

• 必填项
  • CLOUDREVE_PUID: PUID的获取方式详见获取PUID和PGID
  • CLOUDREVE_PGID: PGID的获取方式详见获取PUID和PGID
  • ARIA2_RPC_SECRET: Aria2 RPC密码（你可以去这里生成随机字符串）。请记下该密码！在后续Cloudreve设置Aria2中会使用。
• 选填项（如无特殊需要不建议修改）
  • CADDY_CERTS_PATH: Caddy自动获取证书文件夹路径
  • CADDY_CADDYFILE_PATH: Caddyfile配置文件路径
  • TEMP_FOLDER_PATH: 离线下载临时文件夹路径
  • ARIA2_CONFIG_PATH: Aria2的配置文件夹路径
  • CLOUDREVE_UPLOAD_PATH: Cloudreve上传文件夹路径
  • CLOUDREVE_CONF_INI_PATH: Cloudreve配置文件路径
  • CLOUDREVE_DB_PATH: Cloudreve数据库文件路径

下载Docker Compose文件

wget -qO- https://raw.githubusercontent.com/xavier-niu/cloudreve-docker/master/docker-compose-amd64.yml > docker-compose.yml

Step3. 启动Docker Compose

docker-compose up -d

说明

• Aria2-RPC会暴露于外网，访问端口6800，Secret为你对ARIA2_RPC_SECRET设置的随机字符串。

Step4. 配置Cloudreve连接Aria2服务器

• 以管理员身份登陆
• 点击”头像（右上角） > 管理面板”
• 点击”参数设置 > 离线下载”
  • RPC服务器地址: http://aria2:6800/
  • RPC Secret: 你对ARIA2_RPC_SECRET设置的随机字符串
  • 临时下载地址: /downloads
  • 其他选项按照默认值即可
• 测试连接并保存