Cloudreve Twoja prywatna chmura

Cloudreve to otwartoźródłowy, samodzielnie hostowany system do zarządzania plikami i chmurowej pamięci (self-hosted cloud storage). Pozwala z łatwością stworzyć własny „dysk w chmurze” — zarówno na potrzeby prywatne, jak i dla małych lub średnich organizacji. Obsługuje różne backendy pamięciowe, oferuje panel użytkownika i webowy interfejs do zarządzania plikami, tworzenia linków do udostępniania czy pracy w multi-użytkownikowym środowisku.

W odróżnieniu od klientów chmurowych (np. Google Drive), Cloudreve nie jest menedżerem innych chmur — to pełnoprawny system zarządzania plikami z własnym API i możliwością integracji z backendami pamięci publicznej lub prywatnej.

 

 

---

Główne cechy Cloudreve

Cloudreve zapewnia zestaw funkcji typowych dla nowoczesnych systemów „cloud-drive”:

Obsługa wielu backendów — lokalny dysk, OneDrive, S3 compatible (np. MinIO, Backblaze B2), chińskie OSS, Tencent COS i więcej.
Możliwość bezpośredniej transmisji plików klient → storage (pomijając serwer jako pośrednika), co zmniejsza obciążenie serwera i przyspiesza transfery.
WebDAV — obsługa protokołu WebDAV do mapowania zasobów.
Integracje z Aria2/qBittorrent — pobieranie offline, przyspieszenie transferów.
Podgląd plików online — zdjęcia, audio, video, ePub, dokumenty tekstowe.
Wielu użytkowników i grupy z zarządzaniem storage.
Udostępniane linki z opcjami wygaszenia i hasłem.

---

Wymagania sprzętowe i środowiskowe

Cloudreve jest bardzo elastyczny i lekki, co wynika m.in. z technologii:

Napisany głównie w Go — co sprawia, że jest wydajny i ma małe narzuty pamięci i CPU.

Wymagania minimalne (szacunkowo realne dla małych instalacji):

Element	Minimalne wymagania
CPU	1 vCPU lub więcej
RAM	~512 MB–1 GB RAM (małe instalacje i testy)
Storage	zależne od ilości danych, min. kilka GB dla systemu
System	Linux (najczęściej), również ARM i inne architektury
Baza danych	SQLite, PostgreSQL lub MySQL (produkcyjnie – PostgreSQL/MySQL)
Redis	opcjonalnie (cache)

UWAGA: oficjalne dokumenty nie podają sztywnych „twardych” wymagań systemowych, ponieważ Cloudreve może działać nawet na urządzeniach o ograniczonych zasobach — np. na VPS z 1 GB RAM lub Raspberry Pi, choć zalecane jest więcej RAM przy większym obciążeniu i wielu użytkownikach.

W teście społeczności użytkownik wskazał, że Cloudreve działa z powodzeniem na kontenerze z 1 vCPU i 1 GB RAM — z bardzo niskim zużyciem pamięci (<200 MB w spoczynku).

---

Zalety Cloudreve nad podobnymi rozwiązaniami

W porównaniu z innymi popularnymi, samodzielnie hostowanymi chmurami (np. Nextcloud, Seafile), Cloudreve ma kilka charakterystycznych przewag i cech:

---

1. Lekkość i wydajność

Cloudreve jest bardzo wydajny — działa sprawnie nawet na niewielkich serwerach, dzięki temu że:

• Kod jest kompilowany w Go — niskie użycie CPU i RAM.
• Posiada pojedynczy binarny serwer (bez ciężkich frameworków), co przyspiesza start i zmniejsza narzut.

Użytkownicy zgłaszali, że Cloudreve działa szybciej i bardziej responsywnie niż cięższe rozwiązania takie jak Nextcloud, zwłaszcza jeśli nie potrzebujesz zaawansowanych funkcji grupowych.

---

2. Bezpośrednia integracja wielu backendów

Cloudreve obsługuje natywnie wiele backendów pamięci, w tym lokalne dyski, OneDrive oraz zgodne z S3 — co czyni go elastycznym wyborem do przechowywania danych w różnych środowiskach.

---

3. Prostsza struktura i konfiguracja

Cloudreve jako aplikacja jest często łatwiejszy do wdrożenia i aktualizacji — szczególnie w kontenerach — niż kompleksowe systemy z wieloma komponentami (bazy, Redis, WebDAV, kalendarze, współpraca).

---

4. Interfejs i UI

Interfejs Cloudreve jest nowoczesny i intuicyjny, bardziej przypominający rozwiązania komercyjne typu Google Drive/Dropbox niż np. Nextcloud — co bywa cenione przy prostych wdrożeniach.

---

5. Skala i zasoby

Cloudreve działa dobrze na małych VPS, NAS lub kontenerach — idealny do domowego użytku lub małych zespołów — bez konieczności dużych zasobów serwerowych.

---

Ograniczenia lub punkty krytyczne

Brak bardziej zaawansowanych funkcji współpracy wbudowanych jak w Nextcloud (kalendarze, kontakty, talk, dokumenty) — Cloudreve skupia się przede wszystkim na przechowywaniu i udostępnianiu plików, a nie pełnej platformie współpracy.

Mobilne aplikacje są mniej rozwinięte — istnieją aplikacje iOS, ale ich stabilność bywa różna.

Dokumentacja i społeczność są jeszcze mniejsze niż w przypadku Nextcloud lub Seafile, co może utrudniać bardziej zaawansowane konfiguracje.

Instalacja cloudreve docker compose

Zainstaluj serwer linux na swoim serwerze fizycznym lub w Proxmox. Użyj Debian lub Ubuntu (ja wybrałem Ubuntu, na Proxmox). Przejdź do wyszukiwarki Google, wpisz frazę docker engine. Wybierz i kliknij na wybraną przez Ciebie dystgrybucję:

Skopiuj i zainstaluj repozytoria:

# Add Docker's official GPG key:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Następnie skopiuj i zainstaluj wszystkie niezbędne paczki Docker’a:

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Sprawdź czy docker jest uruchomiony:

sudo systemctl status docker

Jeśli widzisz enabled oraz active (running), możesz przejść do dalszego kroku instalacji Cloudreve

Jeśli nie wystartuj usługę docker, podaną komendą i ponownie sprawdź status usługi:

sudo systemctl start docker

sudo systemctl status docker

Instalacja i konfiguracja Cloudreve

Jeśli nie masz zainstalowanego git, zainstaluj go a następnie Cloudreve

sudo apt install git -y

git clone https://github.com/cloudreve/docker-compose.git ~/cloudreve
cd ~/cloudreve

docker compose up -d

Instalacja zostanie ukończona gdy wszystkie operacje będą zaznaczone na zielono (czas trwania instalacji zależy od zasobów serwera i prędkości łącza internetowego)

Sprawdź adres IP Swojego serwer komendą:

ip a

W moim przypadku jest to 192.168.1.74:

Przejdź do przeglądarki internetowej, wpisz Swój adres IP i dodaj po nium port :5212. Zostaniesz przekierowany na stronę logowania/rejestracji:

W sekcji E-mail i kliknij Dalej (ja specjalnie wpisałem e-mail testowy):

Po zalogowaniu ukazuje się panel sterowania Cloudreve

Instalacja i uruchomienie Cloudreve banalne, prawda ?? 🙂

Teraz zajmijmy się tym do czego jest stworzony Cloudreve, czyli wysyłanie na swój serwer plików. Sposobem „przenieś i upuść” dodaj kilka typów plików. Proponuje na początek kilka obrazków w formacie .png .jpg

Kliknij na obrazek dwa razy, wyskoczy lista wyboru programów które obsługują obrazki, wybierz Przeglądarka obrazów, następnie wybierz opcję Tylko raz

Obrazek nie został wyświetlony, zaraz to naprawimy 🙂

Wybierz z listy Panel sterowania

Wyświetli się komunikat Potwierdź adres URL witryny, kliknij na Ustaw jako główny adres URL witryny

Następnie z listy, kliknij Powrót do strony głównej

Gdy ponownie będziesz chciał otworzyć obrazek, zostanie on już wyświetlony, przykład:

Jak widzisz nie wyświetlają się też miniaturki. Aby to naprawić przejdź ponownie do Panel sterowania / Ustawienia /przetwarzanie mediów, zmień wartości Maks. szerokość / Maks. wysokość, np. na 1200 oraz kliknij Zapisz

Gdy wrócisz do strony głównej, miniaturki powinny się pojawić, jeśli nie po prostu odśwież stronę:

Wystawienie Cloudreve na świat dzięki Clouflare

Domena (wybierz i wykup domenę u dowolnego dostawcy) dodana do Cloudflare (darmowe konto wystarczy).

https://www.cloudflare.com/pl-pl

Musisz mieć:

• własną domenę (np. twojadomena.pl)
• dodaną do Cloudflare DNS

Po wykupieniu domeny i dodaniu jej do swojego konta Cloudflare, przejdź do Zero Trust

Następnie Networks / Connectors

Kliknij w Create a tunnel

Wybierz i kliknij Select Cloudflared

W sekcji Tunnel name, nadaj nazwę tunela np. Cloudreve i kliknij Save tunnel

Wybierz Debian / 64-bit i skopiuj komendy:

Przejdź do serwera Cloudreve, wklej oraz wykonaj te komendy.

Następnie wróć do Claudflare, skopiuj i wykonaj tą komendę:

Wróć do Claudflare, po chwili zestawi się połączenie, kliknij Next

W sekcji Subdomain, wpisz nazwę strony i w Domain, wybierz swoją domenę. W sekcji Type, wybierz HTTP a w sekcji URL, wpisz adres IP serwera Cloudreve wraz z portem :5212 i finalnie kliknij Complete setup

Przejdź do przeglądarki internetowej wpisz adres który przed chwilą utworzyłeś cloudreve.Twoja_domena.xx

Po zalogowaniu przejdź do Panel sterowania, wyskoczy powiadomienie Potwierdź adres URL witryny, kliknij Ustaw jako główny adres URL witryny

Gotowe! Twoja chmura będzie dostępna z każdego miejsca na ziemi (tak długo jak serwer działa). Możesz teraz przesyłać pliki skąd chcesz, po zalogowaniu się do swojej chmury Cloudreve. Nie zapomnij o dodatkowych zabezpieczeniach logowania.

Kliknij na „zębatki„, a następnie Hasło i bezpieczeństwo. Tutaj możesz zmienić hasło, dodać Uwierzytnienie 2FA oraz Passkey (masz tutaj pełną dowolność:

Podsumowanie

Przedstawiono Cloudreve jako otwartoźródłowy system do samodzielnego hostowania chmury plików (self-hosted storage). Umożliwia utworzenie własnego dysku w chmurze z interfejsem webowym, obsługą wielu użytkowników oraz funkcjami udostępniania plików poprzez linki. W przeciwieństwie do usług takich jak Google Drive, system działa jako niezależna platforma zarządzania plikami, a nie tylko klient innych usług chmurowych.

Opisano najważniejsze funkcje, m.in. obsługę wielu backendów pamięci (lokalny dysk, OneDrive, systemy zgodne z S3), protokół WebDAV, podgląd plików w przeglądarce, integracje z narzędziami do pobierania offline oraz możliwość bezpośredniego przesyłania plików do storage bez obciążania serwera. System wspiera także środowiska wieloużytkownikowe z zarządzaniem przestrzenią dyskową i linkami udostępniania.

Podkreślono niewielkie wymagania sprzętowe aplikacji wynikające z implementacji w języku Go. Do małych instalacji wystarczy serwer z ok. 1 vCPU i 512 MB–1 GB RAM. Cloudreve może korzystać z baz danych takich jak SQLite, PostgreSQL lub MySQL, a opcjonalnie z Redis do cache.

Wskazano zalety rozwiązania w porównaniu z platformami takimi jak Nextcloud czy Seafile: większą lekkość, prostszą konfigurację, szybkie działanie oraz nowoczesny interfejs użytkownika. Dzięki temu dobrze sprawdza się na małych serwerach VPS, NAS lub w kontenerach.

Zwrócono również uwagę na ograniczenia, m.in. brak rozbudowanych funkcji współpracy (kalendarz, dokumenty, komunikacja) obecnych w bardziej kompleksowych platformach oraz mniejszą społeczność i dokumentację.

Artykuł przedstawia także przykładowy proces instalacji systemu przy użyciu Docker i docker-compose na serwerze Linux (np. Ubuntu lub Debian), a następnie konfigurację dostępu przez tunel w Cloudflare. Dzięki temu możliwe jest bezpieczne udostępnienie własnej chmury plików w internecie bez konieczności otwierania portów na routerze.