Repository navigation
V1.1.0
JellyGate
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 dansParamè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é:
- cookie
lang - header
Accept-Language - 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-Securityquand HTTPS,X-Frame-Options,X-Content-Type-Options,Referrer-Policy - journaux d'audit avec
request_id
Reste à durcir côté production:
- cookies
Securederriè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/amd64linux/arm64
Tags publiés:
latestsur la branche par défautvX.Y.Zsur 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 .envVariables minimales:
JELLYGATE_SECRET_KEY=...
JELLYFIN_URL=http://jellyfin:8096
JELLYFIN_API_KEY=...3. Lancement
docker compose up -dPour PostgreSQL:
docker compose -f docker-compose.postgres.yml up -d4. Connexion admin
- ouvre
/admin/login - connecte-toi avec un compte Jellyfin administrateur
- 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/i18ncoverageLe 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