# 基于Cloudreve和MinIO的个人存储部署方案

**Repository Path**: cnzyx/cloudreve-minio

## Basic Information

- **Project Name**: 基于Cloudreve和MinIO的个人存储部署方案
- **Description**: 一种基于Cloudreve和MinIO的个人存储部署方案，使用docker compose进行一键部署，引入外置mariadb，引入外置redis，支持aria2离线下载
- **Primary Language**: Docker
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-18
- **Last Updated**: 2025-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于MinIO的个人网盘部署方案

注意，本README部分由AI生成，如你所见写这个时已是凌晨两点，时间并不充裕，仓促之作，如有问题请提起Issue

## 概述

本项目提供了一种基于MinIO的S3 API的个人存储部署方案，使用Docker Compose进行快
速部署。方案支持以下功能：

• **MinIO**：高性能对象存储，兼容S3 API。

• **MariaDB**：外置数据库，用于存储元数据。

• **Aria2**：离线下载功能，支持多种协议。

• **Redis**：外置缓存服务，提升系统性能。

• **Cloudreve**：开源网盘系统，支持多存储后端和丰富的文件管理功能。

## 环境要求

• Docker 20.10.0 或更高版本

• Docker Compose 1.29.0 或更高版本

• 至少1GB内存，建议2GB或更高

• 至少20GB磁盘空间

## 部署步骤

### 1. 克隆项目

```bash
git clone https://gitee.com/cnzyx/cloudreve-minio
cd cloudreve-minio
```

### 2. 配置密码

密码配置分散在各个子 `docker-compose.yml` 文件中，请根据需求修改以下文件,注意保持各个文件中相对应的密码的一致性：

• **MariaDB**：`./components/mariadb/docker-compose.yml`

• **Redis**：`./components/redis/docker-compose.yml`

• **MinIO**：`./components/minio/docker-compose.yml`

• **Aria2**：`./components/aria2/docker-compose.yml`

### 3. 启动服务

使用Docker Compose启动所有服务：

```bash
docker-compose up -d
```

### 4. 访问服务

• **MinIO控制台**：访问 `http://<服务器IP>:9001`，使用配置的用户名和密码登录。

• **MariaDB**：通过 `3306` 端口访问。

• **Redis**：通过 `6379` 端口访问。

• **Aria2**：通过 `6800` 端口访问。

• **Cloudreve**：访问 `http://<服务器IP>:5212`，使用初始管理员账号登录。

> 如何获取初始密码？
>
> 在初次运行项目时，Cloudreve会自动初始化，执行如下命令即可看到cloudreve容器的日志
>
> ```bash
> dcker composr logs -f cloudreve
> ```
>

## 服务说明

### MinIO

MinIO是一个高性能的对象存储服务，完全兼容Amazon S3 API。它用于存储用户上传的文件，并提供高可用性和数据冗余支持。

### MariaDB

MariaDB作为外置数据库，用于存储用户信息、文件元数据等。通过 `3306` 端口提供服务，确保数据持久化。

### Aria2

Aria2是一个轻量级的多协议下载工具，支持HTTP、HTTPS、FTP、BitTorrent等协议。它用于实现离线下载功能，提升用户体验。

### Redis

Redis作为外置缓存服务，用于加速数据访问和减少数据库负载。通过 `6379` 端口提供服务。

### Cloudreve

Cloudreve是一款开源的云存储网盘系统，支持多种存储后端（如本地存储、阿里云OSS、腾讯云COS等），并提供丰富的功能，包括文件分享、在线预览、离线下载、WebDAV协议支持等。它适合用于搭建个人网盘、团队文件共享平台或企业级云存储解决方案。

## 网络配置

所有服务通过 `localnet` 网络进行通信，IP地址范围为 `172.18.100.0/24`。具体IP
分配如下：

• MinIO：`172.18.100.101`

• Cloudreve：`172.18.100.102`

• Aria2：`172.18.100.103`

## 持久化存储

所有数据存储在 `/components/xxx/data` 的目录下，确保容器重启后数据不丢失。

## 常见问题

### 1. 如何修改服务配置？

每个服务的配置文件位于 `./components/` 目录下，修改后重新启动服务即可生效。

### 2. 如何备份数据？

定期备份 `/components/xxx/data` 目录下的数据，确保数据安全。

### 3. 如何扩展存储容量？

可以通过挂载新的磁盘卷到 `/components/minio/data` 目录或者将minio集群部署来扩展存储容量。

## 参考文档

• [MinIO官方文档](https://min.io/docs/minio/linux/index.html)

• [MariaDB官方文档](https://mariadb.com/kb/en/documentation/)

• [Aria2官方文档](https://aria2.github.io/manual/en/html/)

• [Redis官方文档](https://redis.io/documentation)

• [Cloudreve官方文档](https://docs.cloudreve.org/)

## 许可证

本项目基于 MIT 许可证开源，详情请参阅 [LICENSE](LICENSE) 文件。