Fiecare admin Jellyfin cunoaște ritualul: un prieten cere un cont, îl creați manual, ghiciți ce biblioteci ar trebui să vadă, îi trimiteți o parolă pe vreo aplicație de chat, iar o săptămână mai târziu descoperiți că jumătate dintre ei pot descărca întreaga bibliotecă. Partajarea contului de admin e și mai rău, dar nici să faceți totul manual nu e o soluție care să țină la scară.
Plugin-ul Înregistrare pentru Jellyfin înlocuiește acest ritual cu o pagină publică pe adresa propriului server. Vizitatorii completează un formular, dumneavoastră decideți cine intră, iar fiecare cont este creat dezactivat, ascuns de pe ecranul de autentificare și cu drepturile minime pe care le definiți o singură dată. Acest tutorial parcurge o configurare în care codurile de invitație controlează cine poate cere un cont, modul cu aprobare vă ține la curent, iar setările de acces implicit se asigură că utilizatorii noi nu pornesc niciodată cu mai mult decât au nevoie.
Cerințe preliminare
- Jellyfin Server 12.2 sau mai nou, pe Linux, Windows sau Docker.
- Serverul dumneavoastră accesibil prin HTTPS de către persoanele care se vor înregistra, direct sau printr-un reverse proxy.
- Un cont MediaLab Works cu o licență care acoperă plugin-ul: un abonament activ, o licență pe viață în fereastra sa de actualizare, pachetul Jellyfin sau perioada de probă gratuită de 30 de zile.
- Opțional, dar recomandat: un server SMTP configurat în plugin dacă doriți confirmări pe e-mail și mesaje cu decizia, și un bot Telegram dacă doriți notificări acolo.
Pasul 1 — Instalați plugin-ul
Calea simplă este depozitul privat de plugin-uri, pentru că Jellyfin instalează și actualizează atunci plugin-ul singur.
- În contul MediaLab Works deschideți Licenses → Jellyfin plugin repository și faceți clic pe Create address. Adresa conține un token, așa că tratați-o ca pe un secret.
- În Jellyfin mergeți la Dashboard → Plugins → Repositories, faceți clic pe +, dați-i un nume (de exemplu MediaLab Works), lipiți adresa și salvați.
- Deschideți Dashboard → Plugins → Catalog, găsiți Registration by MediaLab, faceți clic pe Install și reporniți Jellyfin.
Dacă preferați instalarea manuală, descărcați arhiva zip din Account → Licenses, extrageți-o într-un folder nou Registration by MediaLab_x.y.z.0 în interiorul folderului de plugin-uri (/var/lib/jellyfin/plugins/ la o instalare din pachete Linux, /config/plugins/ în imaginea Docker oficială, %ProgramData%\Jellyfin\Server\plugins\ pe Windows) și reporniți Jellyfin.
Pasul 2 — Activați licența
Deschideți pagina plugin-ului în Dashboard → Plugins → Registration by MediaLab și faceți clic pe Open License page. Lipiți cheia și faceți clic pe Activate with key; licența este legată de acest server și apare ca Active. Fără cheie puteți porni perioada de probă gratuită de 30 de zile din aceeași pagină. Licența este verificată o dată pe zi și la fiecare pornire a Jellyfin, iar fără internet plugin-ul funcționează încă 7 zile după ultima verificare reușită.
Pasul 3 — Deschideți pagina de înregistrare
Mergeți la Dashboard → Registration. După instalare înregistrarea este închisă, așa că nimic nu se deschide de la sine. În fila General:
- Alegeți modul: aprobare manuală (implicit), doar cu cod de invitație sau automat.
- Activați Registration open.
- Opțional, setați o dată de deschidere și de închidere, astfel încât pagina să se închidă singură după runda de invitații.
- Introduceți adresa publică a serverului; este folosită pentru link-urile din e-mailuri.
Pagina publică se află la https://<your server>/Registration/Page și este disponibilă în engleză și română, gândită întâi pentru telefoane: numele de utilizator este verificat pe măsură ce tastați, apoi numele, e-mailul, numărul de telefon în format internațional și o parolă cu indicator de putere. Fila Send access vă oferă link-ul și un cod QR gata de trimis.
Cât timp sunteți autentificat în Jellyfin ca administrator în același browser, deschiderea paginii vă afișează direct formularul, fără cod, iar cererea este marcată ca test. Folosiți asta ca să verificați fluxul înainte de a trimite link-ul cuiva.
Pasul 4 — Lucrați cu coduri de invitație
În fila Invitations găsiți codul de invitație curent și un cod de familie opțional.
- Codul de invitație este de unică folosință și se reînnoiește după utilizare: fiecare persoană nouă primește un cod proaspăt, așa că un cod scurs nu deschide ușa tuturor.
- Codul de familie este destinat persoanelor care locuiesc în aceeași casă, astfel încât o gospodărie se poate înregistra fără să emiteți un cod pentru fiecare persoană.
Setați modul pe doar cu cod de invitație dacă vreți ca nimic să nu se întâmple fără cod, sau păstrați modul cu aprobare și folosiți codurile ca filtru suplimentar. În ambele cazuri, trimiteți link-ul paginii împreună cu codul; fila Send access le are pe amândouă gata de copiat.
Pasul 5 — Alegeți modul cu aprobare
Cu aprobare manuală (implicit), fiecare cerere vă așteaptă la Dashboard → Registration → Requests. Vedeți cererile în așteptare și pe cele procesate, le puteți căuta, aproba sau respinge una câte una sau în bloc și exporta lista ca CSV.
Acesta este implicitul sigur: chiar dacă un bot trece de verificările anti-bot, nimic nu devine cont fără dumneavoastră. Contul în sine este creat dezactivat în momentul cererii, așa că aprobarea doar îl activează. Confirmarea pe e-mail poate fi activată separat în aceeași zonă dacă vreți ca solicitanții să-și dovedească adresa.
Pasul 6 — Setați accesul implicit pentru conturile noi
Aceasta este partea care vă economisește cel mai mult timp mai târziu. În fila Default access definiți ce primește fiecare cont aprobat:
- Biblioteci: toate sau doar cele pe care le alegeți. Pentru un server mixt, distribuiți doar bibliotecile pe care o persoană nouă ar trebui să le vadă.
- Limite de fluxuri simultane și de bitrate la distanță, dacă le doriți.
- Dezactivare automată după un număr de zile, utilă pentru acces de probă.
Conturile noi sunt create cu drepturi minime: fără administrare, fără descărcări, fără sincronizare, fără ștergere și nu apar pe ecranul de autentificare. Gândiți-l ca pe un utilizator șablon pe care îl configurați o dată și îl refolosiți pentru toți, doar că nu mai trebuie să copiați niciodată permisiunile manual.
În fila Form puteți seta și țara implicită, țările permise, regulile pentru numele de utilizator și parolă, precum și textul de confidențialitate afișat pe pagină.
Pasul 7 — Țineți boții afară
Fila Anti-bot este locul unde strângeți șurubul paginii publice:
- Proof-of-work rulează în browser, iar formularul folosește token-uri semnate de unică folosință și un câmp-capcană ascuns.
- Cloudflare Turnstile este opțional și dezactivat implicit; se activează doar dacă introduceți propriile chei.
- Limitele de rată se aplică per IP și per rețea.
- Adresele din centre de date, VPN-uri comerciale și Tor sunt refuzate, iar domeniile de e-mail de unică folosință sunt respinse.
- Regulile pentru conturi duplicate impun un cont per persoană: același dispozitiv, număr de telefon sau browser și rețea sunt blocate sau semnalate, regulă cu regulă.
Aici puteți restricționa și țările vizitatorilor. Informația despre țară vine din antetul CF-IPCountry când sunteți în spatele Cloudflare, iar tipul de rețea dintr-o bază de date ASN locală, fără interogări online.
Pasul 8 — Notificări și link-ul de autentificare
În fila Notifications, activați jurnalul de activitate Jellyfin, e-mailul (prin serverul dumneavoastră SMTP) și Telegram, după preferință. Notificările pe e-mail pentru admin sunt dezactivate implicit; e-mailul către solicitant poate conține confirmarea, decizia și mesajul de acces pe care îl compuneți, care poate include o parolă generată.
Cât timp înregistrarea este deschisă, plugin-ul poate adăuga un link Create an account și un cod QR pe ecranul de autentificare Jellyfin. Acest lucru se face prin textul de disclaimer al autentificării (Branding → Login disclaimer), fără modificarea fișierelor.
Sfaturi și depanare
- „Registration is closed”: activați Registration open în fila General și verificați datele de deschidere și de închidere.
- „Not available from this network”: vizitatorul se află pe o adresă de centru de date, VPN sau Tor. Dezactivați acea regulă în Anti-bot doar dacă chiar aveți nevoie.
- În spatele Cloudflare sau al unui reverse proxy: asigurați-vă că adresa reală a vizitatorului ajunge la Jellyfin (setarea Known proxies din Jellyfin). Altfel toți vizitatorii împart o singură adresă și lovesc limitele de rată.
- Televizoare: formularul suportă Quick Connect nativ din Jellyfin, așa că un cod de televizor poate fi introdus în formular, iar televizorul se autentifică odată ce contul devine activ. Acest lucru este verificat la nivel de API, dar nu testat pe aplicații reale de televizor, așa că încercați întâi cu propriul dispozitiv.
- Păstrarea datelor: cererile în așteptare expiră după 7 zile și contul dezactivat este șters; cererile respinse, expirate sau șterse sunt curățate după 30 de zile. Parolele nu sunt stocate de plugin; Jellyfin le gestionează.
- Actualizări: cu o licență pe viață a cărei fereastră de actualizare s-a încheiat, rămâneți la depozitul privat, ca Jellyfin să nu instaleze o versiune pe care licența nu o acoperă. Dacă se întâmplă, folosiți Roll back to x.y.z pe pagina License.
Concluzie
O pagină publică de înregistrare este sigură doar atunci când este plictisitoare: coduri care se reînnoiesc singure, aprobare înainte ca ceva să fie activat și drepturi implicite care nu depășesc niciodată ce are nevoie un spectator nou. Înregistrare vă oferă exact asta și vă scutește de crearea manuală a conturilor în serile dumneavoastră. Când sunteți gata pentru pasul următor, plugin-ul funcționează împreună cu Cashier pentru a vinde abonamente plătite pentru serverul dumneavoastră.
Începeți de pe pagina produsului, urmați ghidul utilizatorului pentru filele exacte și verificați changelog-ul înainte de actualizare. Mai multe materiale despre self-hosting găsiți în Bază de cunoștințe, iar dacă ceva nu funcționează, contactați-ne.