Skip to content

V1.1.0

Choose a tag to compare

@maelmoreau21 maelmoreau21 released this 08 Mar 19:43
· 243 commits to main since this release

JellyGate

Docker Build
GHCR Image

Portail d'invitations, de récupération de mot de passe et de gestion d'utilisateurs pour Jellyfin, avec LDAP/Active Directory natif.

Version 1.1.0.

Vue d'ensemble

JellyGate remplace jfa-go avec une approche plus intégrée côté infra self-hosted:

  • invitations avec quotas, expiration, profils et automatisation
  • création de comptes en mode hybride LDAP + Jellyfin ou LDAP only
  • vérification d'e-mail configurable sur les invitations publiques, activée par défaut, avec création de compte après confirmation
  • récupération de mot de passe unifiée
  • administration web complète
  • modèles e-mail no-code avec variables de template et insertion directe depuis l'admin
  • notifications email et webhooks
  • audit logs exploitables et exportables
  • i18n pilotée par fichiers JSON avec vérification de cohérence en CI

Fonctionnalités principales

  • Invitations: liens uniques, expiration, quotas, groupe cible, preset Jellyfin et provisioning tiers.
  • Comptes: création atomique LDAP + Jellyfin + SQL, avec rollback si une étape échoue.
  • Vérification d'e-mail: flux public différé tant que l'adresse n'est pas confirmée.
  • Utilisateurs: listing, toggle, suppression, synchronisation Jellyfin et profil utilisateur.
  • E-mails: modèles no-code, variables comme {{.Username}}, aperçu et insertion directe dans Paramètres > Modèles e-mail.
  • Sécurité: CSRF, rate limiting, cookies signés et headers HTTP centralisés.
  • Audit: filtres avancés, export CSV/JSON et corrélation par request_id.
  • Base de données: SQLite par défaut, PostgreSQL pris en charge.

Langues

Le changement de langue fonctionne selon cette priorité:

  1. cookie lang
  2. header Accept-Language
  3. paramètre global default_lang

Le sélecteur est disponible dans l'interface admin et reste visible sur les pages publiques. Le moteur de rendu applique ensuite les traductions côté serveur sur chaque requête.

Note: plusieurs locales non fr/en existent déjà, mais leur qualité reste encore hétérogène selon les sections.

Sécurité actuellement en place

  • authentification admin déléguée à Jellyfin
  • session signée HMAC-SHA256
  • token CSRF pour les routes admin d'écriture
  • rate limiting mémoire sur /admin/login, /invite/*, /reset/request, /reset/*
  • headers Content-Security-Policy, Strict-Transport-Security quand HTTPS, X-Frame-Options, X-Content-Type-Options, Referrer-Policy
  • journaux d'audit avec request_id

Reste à durcir côté production:

  • cookies Secure derrière reverse proxy TLS non généralisés partout
  • secrets LDAP/SMTP/Webhooks encore stockés en clair dans settings
  • PostgreSQL TLS à imposer explicitement en prod

Docker et publication GHCR

Le workflow GitHub Actions publie une image multi-arch pour:

  • linux/amd64
  • linux/arm64

Tags publiés:

  • latest sur la branche par défaut
  • vX.Y.Z sur les tags Git semver

Démarrage rapide

1. Prérequis

  • Docker
  • une instance Jellyfin avec clé API admin
  • LDAP/Active Directory si tu utilises le mode annuaire
  • SMTP si tu veux les emails transactionnels

2. Configuration

git clone https://github.com/maelmoreau21/JellyGate.git
cd JellyGate
cp .env.example .env

Variables minimales:

JELLYGATE_SECRET_KEY=...
JELLYFIN_URL=http://jellyfin:8096
JELLYFIN_API_KEY=...

3. Lancement

docker compose up -d

Pour PostgreSQL:

docker compose -f docker-compose.postgres.yml up -d

4. Connexion admin

  1. ouvre /admin/login
  2. connecte-toi avec un compte Jellyfin administrateur
  3. JellyGate crée la session et charge la langue préférée utilisateur si elle existe

Variables d'environnement utiles

Variable Requis Défaut Description
JELLYGATE_SECRET_KEY Oui - Clé de signature de session
JELLYGATE_PORT Non 8097 Port HTTP
JELLYGATE_BASE_URL Non http://localhost:8097 URL publique
JELLYGATE_DATA_DIR Non /data Répertoire de persistance
JELLYGATE_DEFAULT_LANG Non fr Langue par défaut
JELLYFIN_URL Oui - URL Jellyfin
JELLYFIN_API_KEY Oui - Clé API Jellyfin
DB_TYPE Non sqlite sqlite ou postgres
DB_HOST Non postgres Hôte PostgreSQL
DB_PORT Non 5432 Port PostgreSQL
DB_USER Non jellygate Utilisateur PostgreSQL
DB_PASSWORD Non - Mot de passe PostgreSQL
DB_NAME Non jellygate Base PostgreSQL
DB_SSLMODE Non disable Mode SSL PostgreSQL
JELLYSEERR_URL Non - URL Jellyseerr
JELLYSEERR_API_KEY Non - Clé API Jellyseerr
OMBI_URL Non - URL Ombi
OMBI_API_KEY Non - Clé API Ombi
JELLYTULLI_URL Non - URL JellyTulli

LDAP, SMTP, webhooks et modèles e-mail se configurent ensuite depuis l'admin et sont stockés en base SQL.

Structure du projet

cmd/
  i18ncheck/         # Vérification i18n pour CI
  i18ncoverage/      # Couverture de traduction (valeurs identiques à en)
  jellygate/         # Entrée principale
internal/
  backup/
  config/
  database/
  handlers/
  integrations/
  jellyfin/
  ldap/
  mail/
  middleware/
  notify/
  render/
  scheduler/
  session/
web/
  i18n/
  static/
  templates/
.github/workflows/

Vérifications utiles

npm run build:css
go build ./...
go test ./...
go run ./cmd/i18ncheck
go run ./cmd/i18ncoverage

Le workflow .github/workflows/i18n-quality.yml exécute i18ncheck et i18ncoverage.
Le seuil de blocage est piloté par la variable de dépôt I18N_MAX_SAME_AS_BASE.
Par défaut, le workflow utilise le plafond de non-régression actuel (195) et il faut le baisser progressivement jusqu'à 0 à mesure que les locales sont nettoyées.

État actuel

  • Version applicative: 1.1.0
  • Déploiement recommandé: Docker avec volume persistant /data
  • Flux public sécurisé: création de compte après confirmation d'e-mail quand la politique l'exige
  • Modèles e-mail: édition no-code, variables et aperçu directement dans l'admin

Licence

MIT