绿联NAS部署Cloudreve Pro私有云存储全指南

1. 项目概述与背景

Cloudreve Pro是一款功能强大的私有云存储解决方案，特别适合在NAS设备上部署使用。绿联NAS作为国产NAS中的佼佼者，其Docker支持能力使得部署Cloudreve Pro变得非常便捷。本文将详细介绍在绿联NAS上部署Cloudreve Pro的全过程，包括网络配置、Redis集成、Compose文件编写等关键环节。

在实际部署过程中，我发现很多用户在Redis网络配置和数据持久化方面容易出现问题。本文将重点解决这些痛点，确保部署后的Cloudreve Pro能够稳定运行，即使容器重建也不会丢失数据。整个部署过程大约需要30分钟，适合有一定Docker基础的用户参考。

2. 环境准备与网络配置

2.1 创建专用Docker网络

首先我们需要为Cloudreve创建一个专用的Docker网络，这样可以确保容器间的通信隔离和安全。在绿联NAS的Docker管理界面中：

1. 进入"网络"选项卡
2. 点击"创建"按钮
3. 输入网络名称"cloudreve-net"
4. 选择桥接模式（默认）
5. 点击"应用"完成创建

这个网络将用于Cloudreve容器与Redis容器之间的通信。使用专用网络的好处是：

• 避免端口冲突
• 提高通信安全性
• 便于管理容器间的连接关系

提示：网络名称可以自定义，但后续在Compose文件中需要使用相同的名称。

2.2 将Redis容器加入网络

如果你的系统已经运行了Redis容器，需要将其加入新创建的cloudreve-net网络：

1. 找到现有的Redis容器
2. 进入容器详情页的"网络"设置
3. 添加网络选择"cloudreve-net"
4. 确保保留原有网络配置
5. 点击"应用"保存更改

这样Redis容器就同时属于默认网络和新创建的cloudreve-net网络，既保持了原有服务的可用性，又为Cloudreve提供了专用通信通道。

3. Docker Compose配置详解

3.1 基础服务定义

以下是Cloudreve Pro的核心Compose配置，我们逐项解析关键参数：

version: '3.8' services: pro: image: cloudreve.azurecr.io/cloudreve/pro:latest container_name: cloudreve-pro-backend restart: always ports: - 7724:5212

• version: '3.8'：使用较新的Compose文件格式，支持更多特性
• image：指定Cloudreve Pro的官方镜像地址
• container_name：为容器设置明确的名称，便于管理
• restart: always：确保容器意外退出后自动重启
• ports：将容器内部的5212端口映射到主机的7724端口

3.2 数据库连接配置

environment: - CR_CONF_Database.Type=mysql - CR_CONF_Database.Host=数据库地址 - CR_CONF_Database.User=用户名 - CR_CONF_Database.Name=数据库名称 - CR_CONF_Database.Password=数据库密码 - CR_CONF_Database.Port=3306

这些环境变量配置了Cloudreve连接MySQL数据库的参数。需要注意：

• 数据库需要提前创建好
• 确保NAS能够访问数据库服务器
• 生产环境建议使用云数据库而非容器内数据库

3.3 Redis缓存配置

- CR_CONF_Redis.Server=redis-pwd-12637:6379 - CR_CONF_Redis.Password=Redis密码

这里有几个关键点：

1. redis-pwd-12637需要替换为你实际的Redis容器名
2. 端口使用Redis默认的6379
3. 如果Redis设置了密码，必须在此配置
4. 因为容器在同一网络，可以直接使用容器名访问

3.4 数据持久化配置

volumes: - /volume1/docker/Cloudreve:/cloudreve/data

这个映射将容器内的/cloudreve/data目录挂载到NAS本地的/volume1/docker/Cloudreve路径。这样做的好处是：

• 容器重建后数据不会丢失
• 可以直接在NAS上管理文件
• 方便进行备份操作

重要：确保挂载目录有正确的读写权限，否则会导致Cloudreve无法正常运行。

4. 网络与存储高级配置

4.1 外部网络声明

networks: cloudreve-net: external: true

这表示使用已存在的cloudreve-net网络，而不是新建网络。必须设置external: true，否则Compose会尝试创建同名网络导致冲突。

4.2 多容器网络通信原理

当多个容器加入同一网络时：

• 它们可以通过容器名直接互相访问
• 通信流量被限制在该网络内
• 不需要暴露不必要的端口到主机
• 网络隔离提高了安全性

在我们的配置中，Cloudreve容器通过容器名redis-pwd-12637访问Redis服务，而不需要Redis暴露端口到主机。

4.3 数据卷的最佳实践

对于生产环境，建议：

1. 使用NAS上的固定路径挂载，如/volume1/docker/Cloudreve
2. 定期备份该目录
3. 设置适当的权限（建议UID/GID为1000）
4. 考虑使用ZFS或Btrfs文件系统以获得更好的数据完整性

5. 部署与验证

5.1 启动Cloudreve服务

将完整的Compose配置保存为docker-compose.yml文件后，在绿联NAS上：

1. 进入Docker管理界面
2. 选择"项目"选项卡
3. 点击"新建项目"
4. 上传或粘贴Compose文件内容
5. 点击"应用"启动服务

5.2 验证服务运行状态

检查服务是否正常运行：

1. 查看容器日志，确认无报错
2. 访问http://NAS_IP:7724应能看到Cloudreve登录界面
3. 检查Redis连接是否正常
4. 确认挂载目录中有文件生成

5.3 初始化管理员账户

首次访问时需要设置管理员账户：

1. 按照页面提示输入初始信息
2. 记录好管理员凭证
3. 登录后检查各功能是否正常

6. 常见问题与解决方案

6.1 Redis连接失败

症状：日志中出现Redis连接错误

排查步骤：

1. 确认Redis容器已加入cloudreve-net网络
2. 检查Redis密码是否正确
3. 验证Redis容器名是否与配置一致
4. 尝试在Cloudreve容器内使用telnet redis容器名 6379测试连接

6.2 数据库连接问题

症状：启动时数据库连接失败

解决方法：

1. 确认数据库服务可访问
2. 检查用户名密码是否正确
3. 验证数据库是否存在且字符集为utf8mb4
4. 确保NAS与数据库服务器之间的网络通畅

6.3 文件权限错误

症状：无法上传或读取文件

处理方案：

1. 检查挂载目录的权限设置
2. 确认容器用户有读写权限
3. 尝试执行chmod -R 775 /volume1/docker/Cloudreve
4. 检查SELinux或AppArmor是否限制了访问

7. 维护与升级指南

7.1 日常维护建议

1. 定期检查容器运行状态
2. 监控存储空间使用情况
3. 设置日志轮转，避免日志文件过大
4. 定期备份数据库和文件存储目录

7.2 版本升级步骤

1. 停止当前运行的容器
2. 修改Compose文件中的镜像版本
3. 重新部署项目
4. 检查新版本是否兼容现有数据

7.3 数据迁移方案

如果需要迁移到其他NAS：

1. 备份数据库和文件存储目录
2. 在新NAS上部署相同版本的Cloudreve
3. 恢复数据库和文件
4. 验证数据完整性

在实际部署过程中，我发现保持Redis和数据库的稳定连接是确保Cloudreve可靠运行的关键。建议为生产环境配置数据库主从复制和Redis持久化，以进一步提高数据安全性。