4LabCloud ist als moderne, micro-service-orientierte On-Premises-Cloud-Plattform konzipiert. Ziel ist es, höchste Datensicherheit, vollständige Souveränität und maximale Upload-Geschwindigkeit zu vereinen.
graph TD
subgraph Oeffentlichkeit
Browser["Web-Browser (Client)"]
end
subgraph Podman_Netzwerk_Frontend
Nginx["Nginx Reverse Proxy\n(Port 80/443, TLS 1.3)"]
Frontend["Frontend Service\n(SvelteKit + Node.js)"]
end
subgraph Podman_Netzwerk_Backend_Isoliert
AppServer["App-Server\n(Go / Gin REST API)"]
UploadService["Upload-Service\n(Rust / Axum / AES-256-GCM)"]
Postgres[("PostgreSQL 17\n(Row Level Security)")]
Redis[("Redis 7\n(Sessions / Cache)")]
StorageVolume[("Dateisystem-Volume\n(AES-256-GCM Chunks)")]
end
Browser -->|TLS 1.3 HTTPS| Nginx
Nginx -->|Statische Assets & SSR| Frontend
Nginx -->|/api/*| AppServer
Nginx -->|/api/v1/uploads/tus/*| UploadService
AppServer -->|Auth: Bearer SERVICE_TOKEN| UploadService
AppServer -->|SQL mit app.user_id| Postgres
AppServer -->|Session Cache / Locks| Redis
UploadService -->|Verschluesselte Blobs| StorageVolume
UploadService -.->|Metadaten & Thumbnail Status| Postgres
Der Upload läuft direkt vom Browser über Nginx an den Rust-Upload-Service, ohne den Go-App-Server mit Streaming-Daten zu belasten:
sequenceDiagram
autonumber
actor User as Benutzer / Browser
participant Nginx
participant Go as Go App-Server
participant Rust as Rust Upload-Service
participant DB as PostgreSQL
participant Storage as Festplatte (Storage)
User->>Nginx: POST /api/v1/uploads/init (Dateiname, Groesse)
Nginx->>Go: Weiterleitung /api/v1/uploads/init
Go->>Go: Pruefe Benutzer-Authentifizierung & Quota
Go->>Rust: POST /internal/uploads/init (Auth: Bearer SERVICE_TOKEN)
Rust->>Rust: Session anlegen & temporaere Upload-ID generieren
Rust-->>Go: 201 Created (Upload-ID)
Go-->>User: 200 OK (Upload-ID, Presigned Tus URL)
loop Chunk-Upload (Tus Protocol)
User->>Nginx: PATCH /api/v1/uploads/tus/{upload_id} (Chunk Bytes)
Nginx->>Rust: Direkter Stream an Rust
Rust->>Rust: AES-256-GCM verschluesseln
Rust->>Storage: Verschluesselte Chunks schreiben
Rust-->>User: 204 No Content (Upload-Offset)
end
User->>Nginx: POST /api/v1/uploads/complete
Nginx->>Go: Weiterleitung /api/v1/uploads/complete
Go->>Rust: POST /internal/uploads/complete (Upload-ID)
Rust->>Storage: Datei finalisieren (Nonce + Ciphertext)
Rust-->>Go: 200 OK (Dateipfad, Groesse, Checksumme)
Go->>DB: INSERT INTO files (user_id, name, path, ...)
Go->>DB: INSERT INTO audit_log (action = 'upload')
Go-->>User: 201 Created (File-Metadaten)
sequenceDiagram
autonumber
actor User as Benutzer / Browser
participant Nginx
participant Go as Go App-Server
participant Rust as Rust Upload-Service
participant Storage as Festplatte (Storage)
User->>Nginx: GET /api/v1/files/{id}/download
Nginx->>Go: GET /api/v1/files/{id}/download
Go->>Go: Pruefe RLS / Berechtigung & Rate-Limit
Go->>Rust: GET /internal/files/{id}/stream (Bearer Token)
Rust->>Storage: Verschluesselte Blobs einlesen
Rust->>Rust: AES-256-GCM Entschluesselung On-the-Fly
Rust-->>Go: Entschluesselter Byte-Stream
Go-->>User: 200 OK (Content-Disposition: attachment)
Go->>Go: Audit-Log: action = 'download'
sequenceDiagram
autonumber
actor Recipient as Empfaenger (Extern)
participant Nginx
participant Go as Go App-Server
participant Rust as Rust Upload-Service
Recipient->>Nginx: GET /share/{token}
Nginx->>Go: GET /api/v1/shares/{token}
Go->>Go: Pruefe Token-Gueltigkeit & Ablaufdatum
alt Passwortgeschuetzt
Go-->>Recipient: 401 Unauthorized (Passwort erforderlich)
Recipient->>Go: POST /api/v1/shares/{token}/auth (Passwort)
Go->>Go: Verifiziere bcrypt Hash
end
Go-->>Recipient: 200 OK (Datei-Vorschau / Download-URL)
Recipient->>Go: GET /api/v1/shares/{token}/download
Go->>Rust: Stream Anfrage
Rust-->>Recipient: Datei-Stream (Decrypted)
Jede schreibende oder lesende Abfrage in der Datenbank erfolgt unter Mandantenisolierung.
ALTER TABLE files ENABLE ROW LEVEL SECURITY;
CREATE POLICY files_isolation_policy ON files
FOR ALL
TO cloud_app_role
USING (user_id = NULLIF(current_setting('app.user_id', true), '')::uuid);
Der Go-App-Server setzt vor jeder Transaktion SET LOCAL app.user_id = '...'. Ein Zugriff über Benutzergrenzen hinweg ist auf Datenbankebene physikalisch unmöglich.
[12 Bytes Nonce][Verschluesselte Nutzdaten (Ciphertext)][16 Bytes GCM Auth-Tag].Der Rust-Upload-Service weist alle Anfragen ohne gültigen Authorization: Bearer <SERVICE_TOKEN> Header im isolierten Backend-Netzwerk mit 401 Unauthorized ab.
Für Fotodateien (image/*) extrahiert der Rust-Upload-Service Metadaten und reichert Standortinformationen an:
sequenceDiagram
autonumber
participant Client as Browser (Frontend)
participant Go as Go App-Server
participant Rust as Rust Upload-Service
participant DB as PostgreSQL
participant Nom as Self-Hosted Nominatim
Client->>Go: POST /api/v1/uploads/complete
Go->>DB: Pruefe users.store_gps
Go->>Rust: POST /internal/thumbs/{id} (extract_exif: true, store_gps: bool)
Rust->>Rust: Thumbnail generieren & EXIF parsen (kamadak-exif)
alt store_gps == false (Datenschutz Opt-out)
Rust->>Rust: GPS-Tags aus EXIF strippen
else store_gps == true
Rust-->>Rust: GPS extrahieren (DMS -> Dezimal)
Rust-)Nom: tokio::spawn: Async Reverse-Geocoding (5s Timeout, 1 req/s)
Rust-->>DB: UPDATE files SET location_name, location_address
end
Rust-->>Go: Thumbnail & EXIF Response (sofort)
Go->>DB: INSERT INTO files (..., gps_lat, gps_lon, exif_json)
Go-->>Client: 201 Created (Upload-Complete sofort fertig)
tokio::spawn.PATCH /api/v1/users/me/preferences die GPS-Speicherung deaktivieren (store_gps: false). In diesem Fall werden GPS-Metadaten vor der Persistierung vollständig entfernt.mediagis/nominatim:4.5 im isolierten Backend-Netzwerk.geocoding_cache auf 4 Nachkommastellen gerundet gecacht (~11 m Präzision). Nominatim-Anfragen werden auf maximal 1 Request/Sekunde gedrosselt.profiles: ["geocoding"] in podman-compose.yml wird der ressourcenintensive Nominatim-Container in der Entwicklungsumgebung nur bei Bedarf gestartet (--profile geocoding).