Cashier pentru Jellyfin — instalare

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 Cashier by medialab, 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-cashier_x.y.z.zip (SHA-256 al fișierului apare lângă buton).
Dezarhivează-l într-un dosar nou Cashier 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 → Cashier by medialab ș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

Instalează și licențiază întâi Înregistrare, setează-i adresa publică și SMTP-ul, apoi deschide Tablou de bord → Cashier.

Chei: lipește cheia secretă Stripe (sk_… sau, mai bine, o cheie restricționată rk_…), apasă Salvează și testează, apoi Creează webhook-ul automat.
Setează numele serviciului afișat clienților și adresa publică a serverului (de exemplu https://jellyfin.exemplu.ro), folosită la întoarcerea din Stripe și pentru webhook.
Verifică planurile (perioadă, redări simultane, preț) și apasă Salvează și trimite în Stripe: prețurile se creează în contul tău Stripe. Un preț schimbat creează un preț Stripe nou; abonații existenți rămân pe vechiul preț până își schimbă planul.
Setează zilele de probă și perioada de grație, apoi pornește vânzarea.

Folosire zilnică

Clienții noi aleg un plan pe pagina de înregistrare și plătesc; contul li se activează când Stripe confirmă plata.
Listele Abonați și Plăți arată cine ce plătește; jurnalul arată fiecare schimbare de stare.
Oprirea vânzării lasă toate conturile cum sunt.

Depanare

Plățile nu activează conturile: webhook-ul nu ajunge la server. Verifică dacă adresa publică e accesibilă prin HTTPS din internet; Cashier se reconciliază oricum cu Stripe la 15 minute.
Clienții nu primesc e-mailuri: verifică setările SMTP din Înregistrare.