Docker 部署 Cloudreve 个人网盘 🗂️

📋 目录导航

🎯 项目简介
🛠️ 核心特性
🐳 一、Docker 部署 Cloudreve
- 1. 创建部署目录和 docker-compose.yml 文件 📁
- 2. 拉取镜像并启动容器 🚀
🚀 二、使用指南
- 1. 访问 Web 界面 💻
- 2. 首次使用步骤 🎯
🌐 三、Nginx 反向代理配置
- 1. 创建 Nginx 配置文件 🔧
- 2. 测试并重载 Nginx 🔄
🔧 四、容器维护命令
🌟 启航个人云存储，探索无限可能

🎯 项目简介

🌐 Cloudreve 官网地址： https://cloudreve.org
🐱 GitHub 项目地址： https://github.com/cloudreve/cloudreve
🐋 Docker 镜像地址： https://hub.docker.com/r/cloudreve/cloudreve

Cloudreve 是一款开源的个人网盘系统，支持多种存储后端（本地存储、对象存储等），提供文件管理、分享、在线预览等功能。通过与 Aria2 集成，还可以实现离线下载功能，是一款功能全面且易于部署的个人网盘解决方案。

🛠️ 核心特性

特性类别	功能描述	优势
🌐 多存储支持	支持本地存储、对象存储（S3、OSS、COS等）	灵活的存储方案选择
📁 文件管理	完整的文件上传、下载、删除、重命名等功能	完善的文件操作体验
🔗 文件分享	生成分享链接，设置密码和有效期	方便的文件共享方式
👥 用户管理	支持多用户和权限控制	适合个人或团队使用
⬇️ 离线下载	集成 Aria2 支持 HTTP、BT、磁力链下载	强大的下载功能
📱 响应式设计	完美适配桌面和移动设备	跨设备一致的使用体验
🎨 主题定制	支持自定义界面主题	个性化界面设置
🔒 安全可靠	提供文件加密、防盗链等安全功能	保障数据安全

🐳 一、Docker 部署 Cloudreve

1. 创建部署目录和 `docker-compose.yml` 文件 📁

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31


mkdir -p /mnt/mydisk/home/cloudreve && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  cloudreve:
    container_name: cloudreve
    image: cloudreve/cloudreve:latest
    restart: unless-stopped
    ports:
      - "5212:5212"
    volumes:
      - ./uploads:/cloudreve/uploads
      - ./conf.ini:/cloudreve/conf.ini
      - ./cloudreve.db:/cloudreve/cloudreve.db
      - ./avatar:/cloudreve/avatar
    environment:
      - TZ=Asia/Shanghai

  aria2:
    container_name: aria2
    image: p3terx/aria2-pro:latest
    restart: unless-stopped
    ports:
      - "6800:6800"
    volumes:
      - ./aria2/config:/config
      - ./downloads:/downloads
    environment:
      - RPC_SECRET=KEJILION
      - RPC_PORT=6800
      - TZ=Asia/Shanghai
EOF

🔐 安全提示：首次使用后请立即修改默认密码！

2. 拉取镜像并启动容器 🚀

1

docker-compose up -d

🚀 二、使用指南

1. 访问 Web 界面 💻

本地访问: http://localhost:5212
IP访问: http://服务器IP:5212
域名访问: 配置反向代理后可使用域名访问

2. 首次使用步骤 🎯

打开浏览器访问上述地址
使用默认管理员账户登录：
- 用户名：admin
- 密码：admin
立即修改默认密码
进入管理面板配置基本设置
配置 Aria2 离线下载集成

🌐 三、Nginx 反向代理配置

访问地址示例： https://cloud.example.com

1. 创建 Nginx 配置文件 🔧

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47


mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/cloudreve.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name cloud.example.com;

    # SSL 证书
    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers off;
    ssl_ciphers ECDHE+AESGCM:ECDHE+CHACHA20:!aNULL:!MD5;

    # 安全头部
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";

    # 文件大小限制（网盘需要较大限制）
    client_max_body_size 20G;

    location / {
        proxy_pass http://127.0.0.1:5212;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_buffering off;

        # WebSocket 支持
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        
        # 超时设置（大文件上传需要较长超时）
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
    }

    # 错误页
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1

sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


# 进入项目目录
cd /mnt/mydisk/home/cloudreve

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28


# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器
docker stop cloudreve aria2
docker start cloudreve aria2
docker restart cloudreve aria2

# 删除容器
docker rm cloudreve aria2
docker rm -f cloudreve aria2

# 进入容器Shell
docker exec -it cloudreve sh
docker exec -it aria2 sh

# 查看容器详情和资源使用
docker inspect cloudreve
docker stats cloudreve

# 容器日志管理
docker logs cloudreve
docker logs -f cloudreve
docker logs --tail 100 cloudreve
docker logs -t cloudreve

3. Docker 镜像管理 📀

1
2
3
4


docker images
docker rmi cloudreve/cloudreve:latest p3terx/aria2-pro:latest
docker image prune -f
docker image prune -a -f

🌟 启航个人云存储，探索无限可能

通过本文档，你已经成功使用 Docker 部署了 Cloudreve 个人网盘系统，并借助 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

🗂️ 随时随地 访问个人文件库，无论是文档、照片还是视频，都能安全存储和随时取用
🔐 完全自主 掌控数据存储，告别第三方云服务的限制和隐私担忧，真正拥有自己的数字资产
🌐 多端同步 在电脑、手机、平板等各种设备上无缝访问文件，保持数据一致性和可用性
⚡ 高效分享 轻松生成分享链接，设置密码和有效期，安全便捷地与他人共享文件

数据是数字时代的重要资产，存储是价值保障的基础。愿 Cloudreve 成为你个人数据管理的得力助手，帮助你构建安全、可靠、便捷的个人云存储解决方案。

从现在开始，整理文件，守护数据——构建你专属的数字资产库吧！🚀

📌 持续关注：建议留意 Cloudreve 项目更新，获取最新功能与安全补丁。
🐛 反馈与支持：使用中遇到问题或有建议，可前往 GitHub Issues 提出。

祝你使用愉快，数据安全！🎉