2026-11-19 11:09:21 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 11:09:21 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 10:30:47 +01:00
2026-11-19 10:30:47 +01:00

Up And Down

Dépôt et téléchargement de fichiers auto-hébergé, avec un navigateur de fichiers complet. Même modèle qu'Excalicloud (explorateur, espaces personnels, favoris, tags, corbeille, partage, authentification OIDC ou locale), mais pour des fichiers de tout type.

  • Envoi : glisser-déposer de fichiers et de dossiers entiers, envoi en flux (pas de limite de mémoire), plusieurs fichiers en parallèle, progression, annulation, nouvel essai, choix « garder les deux / remplacer / ignorer », date de modification d'origine conservée.
  • Navigation : 4 affichages (liste, tableau triable, vignettes, galerie), recherche (noms, tags, contenu des fichiers texte), tags, favoris (fichiers et dossiers), sélection multiple, glisser-déposer pour déplacer, miniatures d'images (EXIF pris en compte).
  • Aperçu intégré : images, vidéo, audio, PDF, texte et code, avec navigation ←/→ dans le dossier.
  • Téléchargement : fichier (reprise possible, Range) ou dossier / sélection en ZIP généré en flux.
  • Espaces : arborescence commune + espace Personnel privé par utilisateur ; poubelle ; historique des versions (chaque remplacement garde l'ancien contenu, restauration en un clic).
  • Partage par lien (/s/<jeton>) d'un fichier ou d'un dossier : durée au choix, mot de passe facultatif, compteur de téléchargements, révocation, sans compte pour le destinataire.
  • Comptes : comptes locaux avec inscription (fermée, avec validation, ou libre), connexion OIDC (Authentik, Keycloak...), ou les deux. Rôles administrateur / utilisateur, quotas, jetons d'API.
  • Sécurité : conteneur non-root en lecture seule, un seul binaire Go (bibliothèque standard, aucune dépendance), fichiers servis sans jamais exécuter leur contenu dans l'origine de l'application.

Démarrage

cp .env.example .env         # optionnel
docker compose up -d --build
# http://localhost:8080 : le premier compte créé devient l'administrateur

Pour imposer l'administrateur : ADMIN_USER et ADMIN_PASSWORD dans .env. Les fichiers sont de simples fichiers sur le volume ./data (chown -R 65532:65532 ./data pour un bind mount).

Authentification

AUTH_MODE Comportement
local (défaut) Comptes locaux (mot de passe PBKDF2-SHA256), inscription selon REGISTRATION
oidc Connexion uniquement via le fournisseur OIDC
both Formulaire local et bouton OIDC
none Aucune authentification intégrée (reverse proxy qui authentifie) ; un seul utilisateur, tout le monde administre

Inscription (REGISTRATION, modifiable ensuite dans Administration > Général) : closed (l'administrateur crée les comptes), approval (les inscrits attendent la validation d'un administrateur), open. Tant qu'aucun administrateur n'existe, le premier compte créé (inscription ou première connexion OIDC) le devient.

OIDC : OIDC_ISSUER, OIDC_CLIENT_ID, OIDC_CLIENT_SECRET (vide : client public, PKCE seul), URI de redirection https://<hôte>/auth/callback (ou OIDC_REDIRECT_URL). OIDC_ALLOWED_GROUPS restreint l'accès ; OIDC_ADMIN_GROUPS / OIDC_ADMIN_EMAILS désignent les administrateurs (synchronisés à chaque connexion). Les comptes OIDC sont créés à la première connexion ; un e-mail identique d'un autre sujet ne fusionne jamais deux comptes.

Variables

Variable Défaut Rôle
LISTEN_ADDR / DATA_DIR :8080 / /data Écoute et volume
MAX_UPLOAD_MB 0 Taille max d'un fichier (0 : illimité)
USER_QUOTA_MB 0 Quota de l'espace personnel (0 : illimité)
COMMON_READONLY false Commun en lecture seule pour les non-administrateurs
TRASH_DAYS 0 Purge de la poubelle (0 : jamais)
HISTORY_KEEP / HISTORY_INTERVAL / HISTORY_MAX_AGE 10 / 0 / 0 Versions gardées par fichier, écart minimal, âge maximal
SESSION_TTL / SESSION_SECRET 24h / aléatoire Session ; clé de signature (sinon DATA_DIR/.session-secret)
SHARE_SECRET aléatoire Clé de signature des liens de partage
PUBLIC_URL URL publique (cookies Secure)

Les valeurs d'inscription, de quota, de lecture seule et de poubelle sont des défauts : une fois modifiées dans l'interface, c'est le réglage de l'interface qui prime.

API et jetons

Chaque utilisateur peut créer des jetons (Jetons d'API) pour scripter :

curl -T rapport.pdf -H "Authorization: Bearer upd_..." \
  "https://cloud.example.org/api/file?path=.perso/rapport.pdf&conflict=overwrite"
curl -OJ -H "Authorization: Bearer upd_..." "https://cloud.example.org/api/file?path=.perso/rapport.pdf"

Les routes sont décrites en tête de internal/api/api.go. .perso/... est l'espace personnel, .favoris les favoris, .poubelle la poubelle.

Sécurité : ce qui est fait

  • Un fichier déposé ne s'exécute jamais dans l'application : seuls les types sûrs (images, vidéo, audio, PDF, texte) s'affichent en ligne ; HTML, SVG hors <img>, scripts et inconnus sont téléchargés (attachment), le texte est servi en text/plain, et un SVG ouvert directement l'est sous un CSP sandbox.
  • Chemins normalisés sous la racine, noms cachés (.trash, .accounts.json...) refusés, liens symboliques ignorés ou refusés.
  • Sessions invalidées dès qu'un compte est désactivé ou supprimé ; limitation des tentatives de connexion, d'inscription et de déverrouillage de lien ; en-tête Origin contrôlé sur les requêtes modifiantes ; jeton d'un lien absent des journaux.
  • Jetons et mots de passe de liens conservés hachés ; liens non énumérables (id 128 bits signé HMAC).
  • Suppression d'un compte : son espace personnel est mis de côté (.users-removed), jamais hérité par un homonyme.

À faire par l'exploitant : TLS devant le service (Traefik, Caddy, nginx), purge de .trash / .users-removed, sauvegarde du volume.

Développement

go test ./...                         # backend (sans ouvrir de port)
cd frontend && npm install && npm run build   # construit web/dist, embarqué dans le binaire
go run ./cmd/server                   # http://localhost:8080 (DATA_DIR=./data)
cd frontend && npm run dev            # rechargement à chaud, proxy vers :8080

Évolutions possibles

Envoi par morceaux (reprise après coupure, proxys à limite de corps), liens de dépôt (envoi seul), WebDAV, miniatures vidéo/PDF/WebP, recherche dans les PDF et documents Office, 2FA.

Licence

MIT, voir LICENSE. Une partie du code (authentification OIDC, explorateur, icônes Tabler) est reprise d'Excalicloud, voir THIRD_PARTY_NOTICES.md.

S
Description
Up And Down : dépôt et téléchargement de fichiers auto-hébergé (navigateur de fichiers, OIDC ou comptes locaux avec inscription)
Readme MIT
826 KiB
0 Stars 2 Watchers 0 Forks
Languages
Go 53.9%
TypeScript 39%
CSS 6.7%
Dockerfile 0.2%
HTML 0.2%