claude BotandClaude Opus 5.5 f8801f00f9 Lot 1 : catalogue PostgreSQL partagé pour les métadonnées et les partages
- Nouveau paquet internal/catalog : pool pgx, migrations SQL embarquées
  (sérialisées entre instances par verrou consultatif), transactions
  rejouées après conflit, interblocage ou bascule du primaire (pool vidé
  sur erreur de lecture seule ou de connexion). DSN multi-hôtes accepté
  (target_session_attrs=read-write) pour une future HA.
- Store.UseCatalog : tags, icônes, auteurs (item_meta) et liens de partage
  (shares) lus et écrits en base ; chaque modification se fait sous verrou
  consultatif par racine (« main », « home/<id> »), donc sans perte
  d'écriture entre instances. Sans DATABASE_URL, rien ne change (JSON).
- Reprise unique de .meta.json et .shares.json au premier branchement
  (table imports), fichiers renommés en *.imported.
- Serveur : DATABASE_URL / DATABASE_URL_FILE, DATABASE_WAIT (60 s).
- Compose : service postgres:16 sur un réseau interne dédié ; Traefik
  inchangé. Dockerfile : go.sum et téléchargement des modules.
- Tests : UPANDOWN_TEST_DATABASE_URL fait passer toute la suite storage par
  la base ; tests de partage entre deux instances et de reprise JSON.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LNfwm4pfYR9C914C2EeiuB
2026-11-20 17:20:16 +01:00
2026-11-19 10:30:47 +01:00
2026-11-20 15:04:49 +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, CSV (tableau paginé), Markdown et code colorisé (le HTML s'affiche comme du code, jamais rendu), 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 Papicons) 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%