- TypeScript 51.5%
- C# 48.1%
- Dockerfile 0.1%
- Shell 0.1%
PUT /api/users/user takes homeMountId: a mount without an owner becomes the user's home (keeps its name, full access), the previous home is released with everything in it. An empty defaultFolder means a folder named like the user (new) or the current one (edit). Deleting a user releases the home mount instead of deleting it, so other users' grants and shares survive. The user dialog offers a dropdown of the free storages instead of a folder field. |
||
|---|---|---|
| docs | ||
| logo | ||
| scripts | ||
| server | ||
| server.Tests | ||
| web | ||
| .dockerignore | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| AGENTS.md | ||
| compose.yml | ||
| Dockerfile | ||
| DONE.MD | ||
| global.json | ||
| README.md | ||
| selfClouded.sln | ||
| TODO.MD | ||
Vlastní úložiště souborů a sdílení odkazem – jako Dropbox, ale na vašem serveru.
Rychlý start · Konfigurace · Reverzní proxy · Zálohy · Vývoj · English
selfClouded je self-hosted aplikace pro ukládání a sdílení souborů: uživatelé procházejí, nahrávají a stahují soubory ve své složce a vybrané soubory nebo složky zveřejní veřejným odkazem (volitelně i s anonymním nahráváním a úpravami). Běží jako jediný Docker kontejner (ASP.NET Core + React SPA, data v SQLite a na disku).
Ukázky
Funkce
- Úložiště (mounty) a oprávnění – každý uživatel má vlastní domovskou složku; správce může vytvářet další úložiště a přidělovat uživatelům práva Číst / Zapisovat / Mazat / Sdílet. Správce má vše implicitně. Mezi úložišti se přepíná nad seznamem souborů, kde je vidět i jejich využití.
- Veřejné odkazy – sdílení souboru, složky nebo více vybraných položek najednou bez přihlášení; název, poznámka, platnost do data. U složky lze návštěvníkům povolit nahrávání, mazání a přejmenování. Odkaz nikdy nedovolí víc, než smí zakladatel sám. Přehled sdílení umí kopírovat odkazy, upravit je i zrušit; správce vidí sdílení všech uživatelů.
- Krátké odkazy
/s/<odkaz>– soubor se rovnou stáhne, složka otevře veřejnou stránku sdílení. - Informace o položce – velikost, obsah složky, data změny a vytvoření, typ obsahu a u sdílených položek jejich odkazy s platností, počtem stažení a posledním stažením.
- Kvóty – volitelný limit velikosti pro každé úložiště; souběžná nahrávání se do limitu vejdou společně.
- Zobrazení jako tabulka nebo mřížka – tabulka s velikostí a datem změny (řazení podle kteréhokoli sloupce), mřížka se složkami jako kartami (počet položek) a miniaturami obrázků (SkiaSharp, cache v
/data); drobečková navigace. Stránka sdíleného souboru ukazuje jeho velikost. - Prohlížeč obrázků, PDF, videa a zvuku: listování mezi soubory složky (na dotykovém displeji přejetím), přiblížení kolečkem myši s posunem tažením, stažení, sdílení, přejmenování a smazání přímo z prohlížeče.
- Nahrávání přetažením do okna, tlačítkem i celých složek, fronta na pozadí s průběhem, dialog při konfliktu názvů (přepsat / ponechat obě / přeskočit).
- Hromadné akce – výběr více položek (i s
Ctrl/Shift): stažení (každá položka zvlášť), sdílení, přesun, smazání; celou složku lze stáhnout jako ZIP. Položky lze přesouvat přetažením na složku nebo do drobečkové navigace. - Klávesové zkratky – šipky,
Home/End,Shift+šipky rozšíření výběru, mezerník označit, Enter otevřít,F2přejmenovat,Deletesmazat,Ctrl+X/Ctrl+Vpřesunout,Ctrl+Avybrat vše,Esczrušit výběr. - Čeština a angličtina, světlý a tmavý skin (přepíná se v Nastavení, pamatuje si je prohlížeč).
- Volitelný obsahový host – veřejná sdílení lze servírovat z jiné domény, aby nahraný obsah neběžel na stejném originu jako přihlášená aplikace.
- Správa uživatelů a úložišť (správce, vlastní karta v menu), změna vlastního hesla v Nastavení (odhlásí ostatní zařízení), nápověda přímo v aplikaci.
Rychlý start (Docker Compose)
Potřebujete Docker s pluginem Compose. Image se sestaví lokálně z tohoto repozitáře.
git clone https://git.modrazebra.net/taurus/selfClouded.git && cd selfClouded
# SELFCLOUDED_FILES = ABSOLUTNÍ cesta ke složce na hostiteli, kde budou soubory uživatelů
mkdir -p "$HOME/selfclouded-files"
printf "SELFCLOUDED_FILES=$HOME/selfclouded-files\nSELFCLOUDED_UID=$(id -u)\nSELFCLOUDED_GID=$(id -g)\n" > .env
docker compose up -d --build
Aplikace poté poslouchá na http://localhost:8080. Při prvním spuštění zobrazí „První spuštění“ – tam vytvoříte účet správce (vytvoření je možné jen dokud neexistuje žádný uživatel). Dál se přihlašujete a další uživatele zakládá správce v sekci Uživatelé. Stav kontejneru hlídá Docker HEALTHCHECK na /api/health (docker compose ps ukáže healthy).
Poznámky k .env:
| Proměnná | Význam |
|---|---|
SELFCLOUDED_FILES |
Povinná, absolutní cesta k adresáři se soubory (bind mount na /files). Nepoužívejte ~ ani $HOME přímo v compose.yml; při sudo docker by šlo o /root. |
SELFCLOUDED_UID, SELFCLOUDED_GID |
Uživatel a skupina, pod kterými kontejner běží (výchozí 1000:1000). Nastavte podle id -u / id -g, aby nové soubory na disku patřily vám. |
Port je ve compose.yml publikovaný jen na 127.0.0.1:8080. Pro přístup z jiných počítačů dejte před aplikaci reverzní proxy s TLS (nebo změňte mapování na "8080:8080" a vědomě počítejte s tím, že provoz je bez šifrování).
Kontejner je zpevněný: cap_drop: [ALL], no-new-privileges, kořenový systém jen pro čtení (zapisuje se do /data, /files a /tmp). Na hostiteli se SELinuxem může být potřeba přidat k bind mountu štítek :Z.
Konfigurace
Nastavuje se proměnnými prostředí (sekce SelfClouded, v prostředí s dvěma podtržítky). Do compose.yml je přidejte do environment:.
| Proměnná | Výchozí | Popis |
|---|---|---|
SelfClouded__DataDir |
./data (v image /data) |
Databáze, klíče cookies, cache miniatur. |
SelfClouded__FilesRoot |
./files (v image /files) |
Kořen souborů uživatelů; domovská složka uživatele je podsložka (výchozí jméno uživatele). |
SelfClouded__TrustedProxies |
nenastaveno | IP adresy nebo CIDR sítě (oddělené čárkou nebo středníkem), jejichž hlavičkám X-Forwarded-For/Proto/Host se věří. Nenastaveno = hlavičky se ignorují. Neplatná hodnota ukončí start. Za proxy je nutné nastavit. |
SelfClouded__ContentHost |
nenastaveno | Hostitel (případně s portem) pro veřejná sdílení, např. files-content.example.com. Hlavní host na něj přesměruje (302) stahování a miniatury veřejných sdílení. Na obsahovém hostu je přihlášení a první nastavení zakázáno (403). |
SelfClouded__LoginAttemptsPerMinute |
10 |
Limit pokusů o přihlášení za minutu z jedné IP. |
SelfClouded__StorageMaintenanceEnabled |
true |
Úklid (staré dočasné soubory, cache miniatur) a pravidelné přepočítání využití kvót (po startu, pak každých 5 min). Vypínejte jen pro testy. |
Příklad:
environment:
SelfClouded__TrustedProxies: "172.18.0.0/16"
SelfClouded__LoginAttemptsPerMinute: "5"
Kvóty, úložiště a oprávnění se nenastavují přes prostředí, ale v aplikaci (sekce Úložiště a Uživatelé, pouze správce).
Za reverzní proxy s TLS
TLS aplikace sama nezajišťuje; ukončuje se na reverzní proxy. Dvě pravidla:
- Proxy musí předávat
X-Forwarded-For,X-Forwarded-ProtoaHost. - V
SelfClouded__TrustedProxiesmusí být adresa (nebo síť) proxy tak, jak ji vidí kontejner (u Dockeru typicky brána nebo síť bridge, např.172.18.0.0/16; zjistíte přesdocker network inspect). Bez toho sdílí všichni klienti jeden limit pokusů o přihlášení (IP proxy) a cookies nejsou označenéSecure.
Caddy (Caddyfile; předává potřebné hlavičky sám, certifikát získá automaticky):
cloud.example.com {
reverse_proxy 127.0.0.1:8080
}
nginx (certifikát řešte např. přes certbot):
server {
listen 443 ssl http2;
server_name cloud.example.com;
# ssl_certificate ...; ssl_certificate_key ...;
client_max_body_size 0; # velikost nahrávaných souborů neomezuje nginx
proxy_request_buffering off; # nahrávání se streamuje, nebuffruje se na disk proxy
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Proxy na hostiteli se k publikovanému portu připojuje přes bránu sítě Dockeru – tu (např. 172.18.0.1) uveďte v TrustedProxies. Pokud používáte ContentHost, nasměrujte druhé doménové jméno na stejnou aplikaci stejnou proxy.
Svazky a zálohy
| Kde | Co obsahuje | Zálohovat? |
|---|---|---|
/data (pojmenovaný svazek selfclouded-data) |
selfclouded.db (SQLite: uživatelé, úložiště, oprávnění, sdílení), keys/ (klíče cookies – bez nich se všichni odhlásí), cache/ (miniatury, lze znovu vygenerovat) |
ano (cache lze vynechat) |
/files (bind mount SELFCLOUDED_FILES) |
soubory uživatelů | ano |
Konzistentní záloha: nejdřív aplikaci zastavte, aby se nic nezapisovalo, a zálohujte oba svazky ze stejného okamžiku.
docker compose stop
docker compose cp selfclouded:/data ./zaloha-data # databáze, klíče, cache
rsync -a "$SELFCLOUDED_FILES"/ ./zaloha-files/ # nebo jiný nástroj pro zálohu adresáře
docker compose start
Obnova je opačně: se zastavenou aplikací vraťte soubory do SELFCLOUDED_FILES a /data (docker compose cp ./zaloha-data/. selfclouded:/data) a spusťte ji. Zálohu jen databáze bez souborů nepoužívejte – sdílení a kvóty se odkazují na cesty v /files. Změny provedené mimo aplikaci (přímo na disku) aplikace pozná, využití kvót se přepočítá do 5 minut.
Aktualizace
git pull
docker compose up -d --build
Databáze se při startu migruje automaticky (jen přidávané migrace, existující data zůstávají). Před aktualizací si pořiďte zálohu.
Bezpečnost
- Izolace obsahu: každý soubor uživatele se servíruje s
X-Content-Type-Options: nosniffaContent-Security-Policy: sandbox; do prohlížeče se jakoinlineposílají jen bezpečné typy (obrázky, PDF, …), ostatní jakoattachment. Nahraný HTML/JS tak neběží s právy aplikace. - Obsahový host (
SelfClouded__ContentHost): veřejná sdílení lze servírovat z jiného originu; na něm nelze vytvořit relaci (přihlášení i první nastavení vrací 403). - Ochrana proti vložení do rámu: všechny odpovědi aplikace mají
Content-Security-Policy: frame-ancestors 'none'. - Omezení přihlašování:
SelfClouded__LoginAttemptsPerMinutena IP adresu (platí jen se správně nastavenýmiTrustedProxiesza proxy). - Izolace souborů: každý přístup k souborům prochází jedním překladačem cest, který odmítá
.., absolutní cesty i symlinky vedoucí mimo úložiště; úložiště se nesmí překrývat. - Citlivé odkazy: tokeny veřejných sdílení se nezapisují do logů; změna hesla nebo role odhlásí uživatele všude.
- Kontejner běží bez privilegií (viz Rychlý start). TLS zajišťuje reverzní proxy.
Vývoj
Požadavky: .NET SDK 10 (global.json), Node 24 + npm.
scripts/check.sh # serverový build + testy, web: typy, lint, build, vitest, Playwright e2e (SKIP_E2E=1 přeskočí e2e)
dotnet test selfClouded.sln # jen backendové testy
cd server && dotnet run # API na http://localhost:5000 (Development, Swagger na /swagger); data v server/data a server/files
cd web && npm run dev # SPA na http://localhost:5173, /api proxy na :5000
cd web && npm test # vitest
cd web && npm run e2e # Playwright (spustí si server i Vite, pokud nebězí)
UPDATE_OPENAPI=1 dotnet test selfClouded.sln --filter OpenApiTests # přegeneruje server/openapi.json po změně API
cd web && npm run gen:api # přegeneruje TypeScript typy z server/openapi.json
První administrátor se v dev režimu vytvoří stejně jako v produkci – přes obrazovku „První spuštění“ nebo POST /api/setup ({"name": "...", "password": "..."}).
Struktura projektu
| Cesta | Obsah |
|---|---|
server/ |
ASP.NET Core (net10) API, EF Core + SQLite |
server.Tests/ |
xUnit testy (včetně integračních na skutečném Kestrelu) |
web/ |
Vite + React + TypeScript + Fluent UI SPA, e2e/ = Playwright |
scripts/check.sh |
jediný ověřovací příkaz |
docs/ |
poznámky k API a přehled kódu (API_CONTRACT_CHANGES.md, CODE_REVIEW.md) |
Podrobné konvence a architektura: AGENTS.md. Plán prací: TODO.MD, hotové: DONE.MD. Kompletní API: server/openapi.json.
Licence
Licence: zatím neurčena.
English summary
selfClouded is a self-hosted, Dropbox-like file storage and sharing app (ASP.NET Core + React, SQLite, one Docker container).
- Per-user home folders plus admin-defined mounts with Read / Write / Delete / Share grants and quotas; list or thumbnail grid view, folder upload by drag & drop, drag & drop move, bulk actions, keyboard shortcuts, Czech/English UI, light/dark skin.
- Viewer for images (zoom, swipe), PDF, video and audio; file info with share links and download counts.
- Public share links (also short
/s/<link>) with optional expiry and anonymous upload / delete / rename; optional separate content host. - Quick start: create
.envwith an absoluteSELFCLOUDED_FILES=/path/to/files(plusSELFCLOUDED_UID/SELFCLOUDED_GIDfromid -u/id -g), rundocker compose up -d --build, open http://localhost:8080 and create the admin on the first-run screen. - Behind a reverse proxy (TLS is not handled by the app): set
SelfClouded__TrustedProxiesto the proxy address/network as the container sees it. - Data:
/data(database, cookie keys, thumbnail cache) and/files(user files) – back up both while the app is stopped. - Configuration, backup, security and development details are in the Czech sections above; see AGENTS.md for architecture and conventions. Licence: not yet specified.







