85 lines
3.3 KiB
Markdown
85 lines
3.3 KiB
Markdown
# File Drop
|
|
|
|
Un hébergeur de fichiers privé, auto-hébergé et minimal. On dépose un fichier,
|
|
on reçoit un lien secret et intraçable. Les images, vidéos et sons s'affichent
|
|
directement dans le navigateur ; les autres fichiers se téléchargent.
|
|
|
|
- **Backend** — Rust (Axum + Tokio)
|
|
- **Frontend** — Svelte (Vite + Tailwind)
|
|
- **Stockage** — système de fichiers local, sans base de données
|
|
|
|
## Démarrage rapide
|
|
|
|
```bash
|
|
# 1. Construire le frontend (produit frontend/dist)
|
|
cd frontend
|
|
npm install
|
|
npm run build
|
|
cd ..
|
|
|
|
# 2. Lancer le serveur (depuis la racine du projet)
|
|
cargo run --release --manifest-path backend/Cargo.toml
|
|
```
|
|
|
|
Ouvrir ensuite http://localhost:3000.
|
|
|
|
> Les chemins `STORAGE_DIR` et `STATIC_DIR` sont relatifs au dossier de
|
|
> lancement. Lance donc le serveur depuis la racine du projet (ou règle ces
|
|
> variables en absolu dans `.env`).
|
|
|
|
## Configuration
|
|
|
|
Copier `backend/.env.example` vers `.env` puis l'adapter.
|
|
|
|
| Variable | Défaut | Rôle |
|
|
| ---------------------- | ----------------- | ----------------------------------------- |
|
|
| `HOST` / `PORT` | `0.0.0.0` / `3000`| Adresse d'écoute. |
|
|
| `STORAGE_DIR` | `./storage` | Dossier des fichiers et métadonnées. |
|
|
| `STATIC_DIR` | `./frontend/dist` | Dossier du frontend construit. |
|
|
| `MAX_FILE_SIZE` | `10GB` | Taille maximale d'envoi. |
|
|
| `FILE_TTL_MS` | `172800000` | Durée de vie d'un fichier (48 h max). |
|
|
| `KEY_LENGTH` | `8` | Longueur de la clé de partage (`a-z0-9`). |
|
|
| `PUBLIC_BASE_URL` | — | URL publique pour les liens absolus. |
|
|
| `RATE_LIMIT_ENABLED` | `1` | Limite de requêtes par IP. |
|
|
| `RATE_LIMIT_MAX` | `300` | Requêtes max par fenêtre. |
|
|
| `RATE_LIMIT_WINDOW_MS` | `60000` | Fenêtre en millisecondes. |
|
|
| `TRUST_PROXY` | `0` | Activer derrière un proxy (`X-Forwarded-For`). |
|
|
|
|
## API
|
|
|
|
| Méthode | Route | Rôle |
|
|
| --------- | -------------------- | ------------------------------------------- |
|
|
| `POST` | `/api/upload` | Envoi d'un fichier (`multipart/form-data`). |
|
|
| `GET` | `/:key` | Téléchargement (inline pour les médias). |
|
|
| `POST` | `/api/auth/:key` | Mot de passe d'un fichier protégé. |
|
|
| `DELETE` | `/api/files/:id` | Suppression (en-tête `X-Delete-Key`). |
|
|
| `GET` | `/api/health` | État du service. |
|
|
|
|
Exemple :
|
|
|
|
```bash
|
|
curl -F "[email protected]" http://localhost:3000/api/upload
|
|
```
|
|
|
|
Le lien renvoyé est de la forme `http://localhost:3000/<clé>.png`. Ajouter
|
|
`?dl=1` force le téléchargement au lieu de l'affichage.
|
|
|
|
## Structure
|
|
|
|
```
|
|
backend/ serveur Rust (Axum)
|
|
frontend/ interface Svelte (Vite + Tailwind)
|
|
scripts/ tests
|
|
storage/ données (généré au premier lancement)
|
|
```
|
|
|
|
## Tests
|
|
|
|
```bash
|
|
cargo build # dans backend/
|
|
bash scripts/e2e-test.sh
|
|
```
|
|
|
|
Le test couvre l'envoi, le téléchargement, l'authentification par mot de passe,
|
|
les clés invalides, la sanitisation des noms et la suppression.
|