wiki/Catalogue-Self-Hosted/apps/app-cloudreve.md

---
title: Cloudreve
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, cloud-storage, go, file-sharing, multi-backend, s3]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Self-hosted+Cloud, https://github.com/cloudreve/Cloudreve]
---

# ☁️ Cloudreve

> **Plateforme de cloud storage moderne écrite en Go** qui prend en charge simultanément le stockage local, S3, OneDrive, Google Drive et de nombreux backends, avec une interface soignée, un système de partage avancé et la prise en charge multi-utilisateurs payants.

## 📋 Informations Générales

| Métadonnée | Valeur |
| :--- | :--- |
| **Site web** | [cloudreve.org](https://cloudreve.org/) |
| **GitHub** | [cloudreve/Cloudreve](https://github.com/cloudreve/Cloudreve) |
| **License** | AGPL-3.0 |
| **Langage** | Go (backend), React (frontend) |
| **Étoiles** | 22 600 ⭐ |
| **Dernière MAJ** | 2026-05-22 |
| **Catégorie** | [[cat-cloud-storage]] |

## 📝 Description

**Cloudreve** est né en Chine en 2018 et a rapidement conquis une communauté internationale grâce à son interface élégante et sa grande polyvalence. Contrairement à [[app-nextcloud]] qui se positionne comme une suite collaborative complète, Cloudreve se concentre sur le **stockage pur** : gestion fine des fichiers, partage public/privé, tâches d'upload massives (avec déduplication côté client), aperçu de documents en ligne et intégration native avec une multitude de backends distants (S3, OSS Aliyun, COS Tencent, Google Drive, OneDrive, WebDAV, SFTP, etc.).

Le projet est écrit en Go, ce qui lui confère un binaire statique unique très léger (≈ 25 Mo) consommant peu de mémoire au repos. La base de données par défaut est SQLite pour les petites installations, commutable en MySQL/PostgreSQL pour des usages intensifs. Un système de « storage policy » permet d'attribuer à chaque groupe d'utilisateurs son propre backend et ses propres quotas — utile pour des offres de type « drive public payant » vendues directement depuis l'UI.

La version 4 a marqué un tournant : refonte complète du frontend en React avec TypeScript, ajout d'un mode hors-ligne, gestionnaire d'archives en ligne, lecteur vidéo/musique intégré, et une architecture de plugins. La communauté est très active sur Telegram et GitHub ; la documentation officielle (en partie en anglais, majoritairement en chinois) est néanmoins abondante.

## 🚀 Installation

### Option 1 : Docker Compose (recommandé)

```yaml
# docker-compose.yml
version: '3.8'

services:
  cloudreve:
    image: cloudreve/cloudreve:latest
    container_name: cloudreve
    restart: unless-stopped
    ports:
      - "5212:5212"
    volumes:
      - cloudreve_data:/data
      - ./conf.ini:/cloudreve/conf.ini:ro
      - ./uploads:/cloudreve/uploads
      - ./avatars:/cloudreve/avatars
    depends_on:
      - db

  db:
    image: mariadb:11
    container_name: cloudreve-db
    restart: unless-stopped
    environment:
      MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASS}
      MARIADB_DATABASE: cloudreve
      MARIADB_USER: cloudreve
      MARIADB_PASSWORD: ${DB_PASS}
    volumes:
      - db_data:/var/lib/mysql

volumes:
  cloudreve_data:
  db_data:
```

### Option 2 : Binaire natif (1 ligne)

```bash
# Téléchargement direct depuis GitHub releases
wget https://github.com/cloudreve/Cloudreve/releases/latest/download/cloudreve_amd64.tar.gz
tar -xzf cloudreve_amd64.tar.gz
chmod +x ./cloudreve
./cloudreve         # premier lancement, génère conf.ini et le mot de passe admin
```

## ⚙️ Configuration

- **`conf.ini`** : fichier centralisé (mode, DB, Redis, chemin storage, listener).
- **Storage policies** : ajoutez une stratégie par backend via l'UI admin (chemin local, S3, OneDrive avec OAuth2).
- **Redis cache** : fortement recommandé pour les sessions en production.
- **HTTPS** : obligatoire en prod — Cloudreve ne fait pas office de reverse-proxy, laissez [[app-traefik]] ou [[app-caddy]] s'en charger.
- **Cron** : pour l'analyse antivirale et l'indexation ; la documentation explique comment brancher ClamAV.

## 🔄 Alternatives

### Open Source
- [[app-nextcloud]] — La référence absolue, plus complète mais plus lourde
- [[app-owncloud]] — Ancien standard en PHP
- [[app-seafile]] — Très performant pour la synchro d'équipes
- [[app-opencloud]] — Fork Go d'OCIS
- [[app-oxicloud]] — Récent en Rust
- [[app-sync-in]] — Node.js léger
- [[app-mydrive]] — Another Node.js alternative
- **ZPan** — Cloud storage chinois en Go (rejoint par Cloudreve)

### Propriétaires (ce que cette app remplace)
- **Dropbox** — partage et sync
- **pCloud** — cloud avec client natif riche
- **iCloud Drive** — écosystème Apple
- **MEGA** — cloud chiffré (50 Go gratuits)

## 🔐 Sécurité

- **Authentification 2FA** : TOTP intégré, compatible [[app-2fauth]].
- **OAuth2 et WebAuthn** : providers tiers pour la connexion (GitHub, Google, etc.).
- **Storage policies chiffrées** : la clé d'API S3 est stockée en clair dans la conf, veillez à sécuriser l'accès au fichier `conf.ini`.
- **Anti-hotlinking** : URL signées avec expiration pour le partage public.
- **Mises à jour** : surveiller les releases GitHub (canal `latest` parfois instable ; préférez `stable`).
- **Isolation réseau** : exposez Cloudreve uniquement derrière un reverse-proxy avec rate-limiting.

## 📚 Ressources

- [Site officiel](https://cloudreve.org/)
- [Documentation](https://docs.cloudreve.org/)
- [GitHub cloudreve/Cloudreve](https://github.com/cloudreve/Cloudreve)
- [Wiki communauté](https://github.com/cloudreve/Cloudreve/wiki)
- [Demo officielle](https://demo.cloudreve.org/)

## Pages Liées

- [[cat-cloud-storage]] — Catégorie Cloud Storage
- [[recettes-docker-compose]] — Templates Docker
- [[app-nextcloud]] — Référence (plus complète)
- [[securisation-home-lab]] — Sécurité
- [[Catalogue-Self-Hosted]] — Hub