refactor(storage): enforce per-user max_file_bytes limit on upload pipelines (#20)
CD — Deployment / deploy (push) Successful in 22s

* Validate Content-Length on single-part upload route against user limit
* Check total expected size on chunked upload session creation
* Re-evaluate user limit at finalization to reject dynamic quota reductions
* Clean up temporary files on payload size rejection (413)
* Add 60-second polling interval for periodic fetching of messages and images

---------

Co-authored-by: xEsiah <[email protected]>
Reviewed-on: #20
Reviewed-by: Esiah <[email protected]>
Co-authored-by: Gitea Actions <-[email protected]>
This commit was merged in pull request #20.
This commit is contained in:
Gitea Actions
2026-10-31 10:16:28 +00:00
committed by Esiah
co-authored by Esiah
parent b52417053f
commit 3542b33c89
12 changed files with 907 additions and 34 deletions
+27 -3
View File
@@ -54,6 +54,27 @@ d'adresse).
| PUT | `/api/cloud/files/:id/star` | `requireAuth` |
| DELETE | `/api/cloud/files/:id` | `requireAuth` + écriture (corbeille) |
### Envoi resumable (gros fichiers)
Au-delà de la limite de corps de requête de Cloudflare (100 MB en Free/Pro), le
client découpe le fichier en morceaux de 50 MiB. Une session est créée en base,
le temporaire est préalloué sous `MEDIA_DIR/.uploads`, puis les morceaux sont
écrits à l'offset courant. La finalisation vérifie le nom et les droits une
dernière fois, calcule le SHA-256, publie le fichier et met à jour les quotas.
| Méthode | Chemin | Garde |
| --- | --- | --- |
| POST | `/api/cloud/uploads` | `requireAuth` (nom, `folderId`, `size`, `mimeType`) |
| GET | `/api/cloud/uploads/:id` | `requireAuth` (propriétaire de la session, donne l'offset de reprise) |
| PUT | `/api/cloud/uploads/:id/chunks` | `requireAuth` (corps brut, `Content-Length` obligatoire) |
| POST | `/api/cloud/uploads/:id/complete` | `requireAuth` (vérifie taille, nom, droits, quotas) |
| DELETE | `/api/cloud/uploads/:id` | `requireAuth` (annule et supprime le temporaire) |
Les sessions expirent après 24 h ; une purge au démarrage puis toutes les
heures supprime les temporaires orphelins. Un morceau interrompu ne fait pas
avancer le curseur : le client interroge `GET /uploads/:id` puis reprend à
l'offset exact.
### Corbeille, recherche, galerie
| Méthode | Chemin | Garde |
@@ -157,6 +178,8 @@ par tous les membres authentifiés, en écriture pour son propriétaire.
| Contrôle | Détail |
| --- | --- |
| Corps | `PUT /files` en flux brut (pas de multipart), `?name=` et `?folderId=` |
| Gros fichiers | au-delà de 90 MiB, le front bascule sur `/uploads` (morceaux de 50 MiB) pour rester sous la limite Cloudflare |
| Reprise | l'ID de session est conservé localement ; un envoi interrompu repart de `uploadedBytes` |
| Taille | plafond `users.max_file_bytes`, vérifié en flux (coupure si dépassement) |
| Quota | `users.used_bytes` + quota `storage_locations`, revérifiés avant écriture |
| Disque | `diskUsage()` (`statfs`) avant écriture ; `507` `INSUFFICIENT_STORAGE` si le support est plein |
@@ -197,11 +220,12 @@ par fichier, dérive refusée au démarrage.
| `007_chat.sql` | `chat_messages` (salon global, auteur `ON DELETE SET NULL`) |
| `008_user_preferences.sql` | préférences d'affichage, `user_file_stars`, `chat_reads` |
| `009_chat_edits_and_pins.sql` | `chat_messages.edited_at`, `chat_messages.is_pinned`, index `idx_chat_messages_pinned`, `idx_chat_messages_edited` |
| `010_upload_sessions.sql` | `upload_sessions` (envoi resumable, temporaire préalloué, expiration) |
Tables actives : `users, user_sessions, folders, folder_permissions, files,
media_metadata, file_variants, user_avatars, chat_messages, storage_locations,
settings, password_reset_tokens, email_change_requests, audit_logs,
user_file_stars, chat_reads`.
media_metadata, file_variants, user_avatars, chat_messages, upload_sessions,
storage_locations, settings, password_reset_tokens, email_change_requests,
audit_logs, user_file_stars, chat_reads`.
## Erreurs métier
+5
View File
@@ -177,6 +177,11 @@ adresse ni aucun domaine n'est codé en dur.
de connexion globale, audit inutile).
- Certificat et HSTS sont assurés en amont par Cloudflare — ne pas exposer
directement le port 8083 sur Internet.
- **Corps de requête** : Cloudflare plafonne le corps à 100 MB (Free/Pro). Les
fichiers plus gros passent par l'envoi resumable (`/api/cloud/uploads`) en
morceaux de 50 MiB, sans relever la limite de corps de nginx ni exposer
l'origine. La valeur `client_max_body_size 5g` de nginx ne concerne que le
chemin direct local.
**Tunnel Docker sur un réseau partagé (recommandé).** On joint nginx au réseau
du tunnel plutôt que de publier un port : `cloudflared` résout `nginx` par nom,