Notificări de securitate Jellyfin — ghid

Instalare

Ai nevoie de Jellyfin Server 12.2 sau mai nou și de un cont MediaLab Works cu o licență care acoperă plugin-ul (abonament activ, licență lifetime în perioada de actualizări, Pachetul Jellyfin sau proba gratuită de 30 de zile).

Din repository-ul tău de plugin-uri (recomandat). Jellyfin instalează și actualizează apoi singur plugin-ul.

În contul MediaLab Works deschide Licențe → Repository de plugin-uri Jellyfin și apasă Creează adresa. Copiaz-o: e privată (conține un token), deci nu o da mai departe; o poți regenera sau revoca oricând.
În Jellyfin deschide Tablou de bord → Plugin-uri → Repository-uri, apasă +, dă-i un nume (de exemplu MediaLab Works), lipește adresa și salvează.
În Tablou de bord → Plugin-uri → Catalog găsește Security Notifications, apasă Instalează, apoi repornește Jellyfin.

Repository-ul arată doar plugin-urile acoperite de licențele tale și doar versiunile permise. Linkurile de descărcare sunt semnate și expiră după câteva ore, așa că Jellyfin citește mereu o listă proaspătă.

Manual, dintr-o arhivă zip.

În Cont → Licențe descarcă jf-securitynotifications_x.y.z.zip (SHA-256 al fișierului apare lângă buton).
Dezarhivează-l într-un dosar nou Security Notifications_x.y.z.0 din dosarul de plugin-uri Jellyfin:
- Linux (pachet): /var/lib/jellyfin/plugins/
- Docker (imaginea oficială): /config/plugins/ din volumul de configurare
- Windows: %ProgramData%\Jellyfin\Server\plugins\
Repornește Jellyfin.

Activarea licenței

Deschide pagina plugin-ului din Tablou de bord → Plugin-uri → Security Notifications și apasă Deschide pagina Licență.
Lipește cheia de licență și apasă Activează cu cheia. Plugin-ul contactează serverul de licențe, leagă cheia de acest server Jellyfin și arată licența Activă.
Nu ai încă o cheie? Pe aceeași pagină scrii adresa de e-mail și pornești proba gratuită de 30 de zile (card necesar, 0 € azi) sau cumperi o licență; plugin-ul se activează singur după plată.

Licența se verifică o dată pe zi și la fiecare pornire a Jellyfin. Fără internet plugin-ul merge încă 7 zile de la ultima verificare reușită. Fără o licență valabilă plugin-ul își oprește activitatea și rămâne funcțională doar pagina Licență (probă, cheie, reînnoire); nu se șterge nimic și totul revine imediat ce licența e din nou valabilă. Mută licența (eliberează serverul) de pe aceeași pagină eliberează cheia pentru alt server.

Actualizare și revenire

Din repository: Jellyfin arată versiunile noi în Tablou de bord → Plugin-uri și poate actualiza plugin-ul automat; repornește Jellyfin ca să încarce versiunea nouă.
Din pagina Licență a plugin-ului: cu o licență valabilă, Instalează actualizarea aduce cea mai nouă versiune permisă de licență, iar Rollback la x.y.z întoarce versiunea anterioară (de exemplu dacă ceva nu mai merge după o actualizare). Repornește Jellyfin după oricare dintre ele. Ambele pachete se verifică după suma de control publicată de serverul de licențe.
O licență lifetime primește versiunile apărute în perioada ei de actualizări; după aceea plugin-ul merge mai departe pe ultima versiune permisă.
După o revenire, dacă repository-ul de plugin-uri e adăugat în Jellyfin, sarcina programată Update Plugins (la pornire și zilnic) instalează din nou cea mai nouă versiune. Ca să rămâi o vreme pe versiunea anterioară, scoate declanșatoarele acestei sarcini din Tablou de bord → Sarcini programate și pune-le la loc mai târziu.

Codul sursă

Sursa GPL-3.0 a fiecărei versiuni e în Cont → Licențe (Cod sursă), lângă descărcare, ca arhivă .tar.gz făcută din commit-ul exact al versiunii.

Configurare

Deschide Notificări de securitate din meniul tabloului de bord Jellyfin. Pagina are cinci file: Prezentare, Istoric, Reguli, Canale și Setări.

Canale: pornește canalele dorite, alege gravitatea minimă pentru fiecare, apoi apasă Trimite un test.
- Telegram: scrie tokenul botului, trimite /start botului (sau adaugă-l într-un grup), apoi apasă Găsește ca să se completeze chat-ul.
- E-mail: destinatarii și serverul tău SMTP. Recomandat e portul 587 cu STARTTLS (portul 465 cu TLS implicit nu e suportat). Dacă ai instalat Înregistrare, poți folosi serverul SMTP al lui.
- Webhook: alegi Discord, Slack, ntfy, Gotify sau JSON și lipești adresa. Adresa conține tokenul și se păstrează separat de setări. Pentru Gotify adaugă ?token=… la adresa /message.
- Jurnalul de activitate Jellyfin: alertele apar și în lista de activitate din tabloul de bord.
Fără spam (în aceeași filă): cât de des se poate repeta aceeași alertă, orele de liniște (pleacă imediat doar alertele critice, restul vin într-un rezumat la sfârșitul intervalului) și rezumatul zilnic opțional pentru alertele medii și informative.
Reguli: fiecare dintre cele 20 de reguli are comutator, gravitate și, unde e cazul, praguri (de exemplu câte parole greșite în câte minute, viteza pentru călătoria imposibilă sau orele obișnuite ale administratorului).
Setări:
- Geolocație: DB-IP Lite (gratuit, fără cont), MaxMind GeoLite2 (ID-ul contului și cheia de licență) sau oprită. Fără geolocație nu funcționează regulile de țară nouă, călătorie imposibilă și rețea nouă.
- Rețea: rețelele de încredere (CIDR) tratate ca rețea locală, de exemplu VPN-ul propriu. Rețelele private și cele din setările de rețea Jellyfin sunt incluse automat. Pornește Serverul stă în spatele unui proxy propriu dacă Jellyfin e în spatele nginx, Caddy, Traefik sau altul asemănător, ca antetele transmise de proxy să fie normale; Cloudflare se recunoaște singur.
- Liste de IP-uri rău famate: ieșirile Tor (la oră) și Spamhaus DROP (zilnic).

Folosire zilnică

Prezentare arată alertele recente și starea plugin-ului.
Istoric listează fiecare alertă cu contul, adresa, locația, dispozitivul și canalele pe care a plecat; filtrezi după gravitate, regulă și perioadă sau exporți în CSV.
Fiecare alertă spune de ce e suspectă și ce e de verificat. Dacă ai fost tu (un telefon nou, o călătorie în străinătate), nu e nimic de făcut.

Depanare

Toate alertele au aceeași adresă (a proxy-ului sau a Cloudflare): adaugă proxy-ul în Known proxies din Jellyfin (Tablou de bord → Rețea), ca Jellyfin să transmită adresa reală a vizitatorului, și pornește în Setări Serverul stă în spatele unui proxy propriu.
Nu vin mesaje pe Telegram: trimite din nou /start botului și apasă Găsește; verifică gravitatea minimă a canalului.
Fără locație: verifică sursa de geolocație din Setări; la MaxMind, ID-ul contului și cheia.