refactor(storage): enforce per-user max_file_bytes limit on upload pipelines
PR — Ouverture automatique / create-pr (push) Successful in 3s
PR — Ouverture automatique / create-pr (push) Successful in 3s
* 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
This commit is contained in:
+27
-3
@@ -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
|
||||
|
||||
|
||||
@@ -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,
|
||||
|
||||
Reference in New Issue
Block a user