Access Links 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 depozitul tău de plugin-uri (recomandat). Jellyfin instalează și actualizează apoi singur plugin-ul.

În contul MediaLab Works deschide Licențe → Depozitul 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 → „Repositories”, apasă +, dă-i un nume (de exemplu MediaLab Works), lipește adresa și salvează.
În Tablou de bord → Plugin-uri → Catalog găsește Access Links by MediaLab, apasă Instalează, apoi repornește Jellyfin.

Depozitul 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ă.

Din catalogul public. https://medialab.works/jellyfin/manifest.json arată toate plugin-urile MediaLab Works lansate, cu versiunile lor publice; medialab Server îl adaugă singur. Îl poți adăuga la fel ca să instalezi un plugin înainte să ai o cheie: plugin-ul îți cere apoi licența sau pornește perioada de probă din pagina lui Licență. Cu o licență lifetime a cărei perioadă de actualizări s-a încheiat, folosește depozitul tău privat, care oferă doar versiunile permise de licență.

Manual, dintr-o arhivă zip.

În Cont → Licențe descarcă jf-accesslinks_x.y.z.zip (SHA-256 al fișierului apare lângă buton).
Dezarhivează-l într-un dosar nou Access Links by MediaLab_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 → Access Links by MediaLab și apasă 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, nimic de plată 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 depozit: 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ă depozitul 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 Access Links din meniul tabloului de bord Jellyfin (sau Tablou de bord → Plugin-uri → Access Links by MediaLab).

HTTPS: Access Links lucrează doar cu adrese HTTPS. Dacă pagina spune că HTTPS nu e pornit, configurează HTTPS și un certificat în setările de rețea ale Jellyfin; până atunci linkurile https:// nu se deschid.
Adresa locală: o lași goală ca să se folosească automat IP-ul serverului în rețea, portul HTTPS local și adresa de bază (base URL), scrii un nume din rețeaua ta (de exemplu media.lan; portul HTTPS se adaugă singur) sau o adresă completă https://…. Sfat: dacă certificatul e emis pe un nume, folosește acel nume, rezolvat în rețeaua ta către server; o adresă IP goală face de obicei browserele să avertizeze.
Adresa externă: o scrii exact cum ai scrie-o în browser din afara casei, cu portul extern, de exemplu https://example.com:2096. Portul extern poate fi diferit de cel local. Dacă în Jellyfin e setată o adresă https:// la Published server URIs, pagina ți-o propune cu un buton. Ce lipești din bara browserului după adresă (de exemplu /web/#/home) se taie singur.
Apasă Salvează.

Utilizare zilnică

Pagina arată toate linkurile pe grupuri: Jellyfin (interfața web, ecranul de conectare, pagina de cod a Quick Connect-ului Jellyfin, panoul de administrare, adresa serverului pentru aplicații) și câte un grup pentru fiecare plugin MediaLab instalat și activ pe server (Conectare rapidă, Înregistrare, Cashier, Share Links, Headend). Fiecare link arată cui îi e destinat și adresa lui locală și externă.
Pentru fiecare adresă: Deschide, Copiază sau QR. Arată codul QR pe ecran ca să-l scaneze un telefon, de exemplu pentru pagina de telefon a Conectării rapide sau formularul de înregistrare.
Verifică toate linkurile citește certificatele, confirmă că adresa externă ajunge chiar la acest server și testează fiecare pagină. Avertizările spun exact ce nu e în regulă: HTTPS oprit, certificat expirat sau care expiră în mai puțin de 14 zile, certificat care nu acoperă adresa sau o adresă externă care ajunge la alt server.
Alte servere Emby / Jellyfin: adaugi numele, tipul și adresa https:// a altui server (până la 50). Linkurile lui se construiesc singure; Verifică arată numele, versiunea, tipul real și ce pagini de plugin-uri există pe el (o pagină lipsă înseamnă de obicei că plugin-ul nu e instalat acolo).

Ce trimite și unde

Verificările rulează doar când apeși Verifică toate linkurile sau Verifică: serverul se conectează la adresele introduse ca să le citească certificatul, informațiile publice ale serverului și dacă fiecare pagină răspunde. Nu se trimite nimic secret.
Codurile QR se generează pe serverul tău; nicio adresă nu ajunge la un serviciu extern.
La medialab.works nu ajunge nimic în afară de verificarea licenței.

Probleme frecvente

„HTTPS nu e pornit pe acest server”: pornește HTTPS cu un certificat în setările de rețea ale Jellyfin, apoi repornește Jellyfin.
„Certificatul nu acoperă adresa locală”: adresa locală e o adresă IP sau un nume care lipsește din certificat. Folosește un nume acoperit de certificat, rezolvat în rețeaua ta către server.
„Adresa externă nu răspunde din server”: multe routere nu pot ajunge din interior la propria adresă externă („hairpin NAT”). Deschide linkul extern de pe un telefon, pe date mobile, ca să verifici.
„Adresa externă ajunge la ALT server”: redirecționarea portului sau reverse proxy-ul trimite adresa la alt server Jellyfin sau Emby; corectează redirecționarea sau adresa externă.