No description
  • TypeScript 51.5%
  • C# 48.1%
  • Dockerfile 0.1%
  • Shell 0.1%
Find a file
Jarvis c77f0f26a5 Pick a user's home storage from the existing ones, keep it when the user is deleted
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.
2026-11-02 15:18:21 +01:00
docs Pick a user's home storage from the existing ones, keep it when the user is deleted 2026-11-02 15:18:21 +01:00
logo Pick the logo by theme (dark text variant for the light skin) 2026-10-13 16:13:07 +02:00
scripts Unify style: tabs, .ts extensions, naming and outdated comments 2026-10-12 23:00:36 +02:00
server Pick a user's home storage from the existing ones, keep it when the user is deleted 2026-11-02 15:18:21 +01:00
server.Tests Pick a user's home storage from the existing ones, keep it when the user is deleted 2026-11-02 15:18:21 +01:00
web Pick a user's home storage from the existing ones, keep it when the user is deleted 2026-11-02 15:18:21 +01:00
.dockerignore Add Dockerfile (web build, publish, aspnet runtime), .dockerignore and compose.yml 2026-10-12 12:40:06 +02:00
.editorconfig Add global.json, .editorconfig and scripts/check.sh verification entry point 2026-10-12 11:36:17 +02:00
.gitattributes Normalize line endings to LF via .gitattributes 2026-10-12 11:29:50 +02:00
.gitignore Add Phase 4 features, redesigned file cards and viewer, persisted view and theme, review backlog 2026-10-12 20:46:14 +02:00
AGENTS.md Treat the deployed data as production: only additive migrations 2026-11-02 15:00:41 +01:00
compose.yml Unify style: tabs, .ts extensions, naming and outdated comments 2026-10-12 23:00:36 +02:00
Dockerfile Remove duplicated and dead code and rename EnableUpload to AllowUpload 2026-10-12 22:57:30 +02:00
DONE.MD Keep the share dialog heading after creating links and show small sizes once 2026-10-12 23:40:35 +02:00
global.json Add global.json, .editorconfig and scripts/check.sh verification entry point 2026-10-12 11:36:17 +02:00
README.md Move users and storages to an admin-only menu card 2026-11-02 15:00:42 +01:00
selfClouded.sln Add xUnit test project with file-service tests 2026-10-12 11:35:58 +02:00
TODO.MD Keep the share dialog heading after creating links and show small sizes once 2026-10-12 23:40:35 +02:00

selfClouded

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

Soubory v tabulce s hromadným výběrem (světlý skin) Soubory jako náhledy (tmavý skin)
Soubory v tabulce Soubory jako náhledy
Prohlížeč obrázků Dialog sdílení
Prohlížeč obrázků Dialog sdílení
Informace o souboru a jeho odkazech Přehled sdílení
Informace o souboru Přehled sdílení
Veřejná stránka sdílené složky Úložiště a kvóty (správce)
Veřejná stránka sdílení Úložiště

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, F2 přejmenovat, Delete smazat, Ctrl+X / Ctrl+V přesunout, Ctrl+A vybrat vše, Esc zruš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:

  1. Proxy musí předávat X-Forwarded-For, X-Forwarded-Proto a Host.
  2. V SelfClouded__TrustedProxies musí 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řes docker 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: nosniff a Content-Security-Policy: sandbox; do prohlížeče se jako inline posílají jen bezpečné typy (obrázky, PDF, …), ostatní jako attachment. 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__LoginAttemptsPerMinute na IP adresu (platí jen se správně nastavenými TrustedProxies za 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 .env with an absolute SELFCLOUDED_FILES=/path/to/files (plus SELFCLOUDED_UID/SELFCLOUDED_GID from id -u/id -g), run docker 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__TrustedProxies to 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.