Access Links para Jellyfin — guía

Instalación

Necesitas Jellyfin Server 12.2 o superior y una cuenta de MediaLab Works con una licencia que cubra el plugin (una suscripción activa, una licencia de por vida dentro de su período de actualizaciones, el paquete de Jellyfin o la prueba gratuita de 30 días).

Desde tu repositorio de plugins (recomendado). Jellyfin instala y actualiza el plugin por sí solo.

En tu cuenta de MediaLab Works abre Licenses → Jellyfin plugin repository y haz clic en Create address. Cópialo: es privado (contiene un token), así que no lo compartas; puedes regenerarlo o revocarlo en cualquier momento.
En Jellyfin abre Dashboard → Plugins → Repositories, haz clic en +, dale un nombre (por ejemplo MediaLab Works), pega la dirección y guarda.
En Dashboard → Plugins → Catalog busca Access Links by MediaLab, haz clic en Install y reinicia Jellyfin.

El repositorio lista solo los plugins que cubren tus licencias, y solo las versiones que permiten. Sus enlaces de descarga están firmados y caducan a las pocas horas, así que Jellyfin siempre lee una lista nueva.

Desde el catálogo público. https://medialab.works/jellyfin/manifest.json lista cada plugin publicado de MediaLab Works con su compilación pública; medialab Server lo añade por sí solo. Puedes añadirlo del mismo modo para instalar un plugin antes de tener una clave: el plugin entonces pide la licencia, o inicia la prueba, en su página License. Con una licencia de por vida cuyo período de actualizaciones ha terminado, mantente en tu repositorio privado, que ofrece solo las versiones que tu licencia permite.

Manualmente, desde un archivo zip.

En Account → Licenses descarga jf-accesslinks_x.y.z.zip (el SHA-256 del archivo se muestra junto al botón).
Extráelo en una carpeta nueva Access Links by MediaLab_x.y.z.0 dentro de la carpeta de plugins de Jellyfin:
- Linux (paquete): /var/lib/jellyfin/plugins/
- Docker (imagen oficial): /config/plugins/ en el volumen de configuración
- Windows: %ProgramData%\Jellyfin\Server\plugins\
Reinicia Jellyfin.

Activación de la licencia

Abre la página del plugin en Dashboard → Plugins → Access Links by MediaLab y haz clic en License.
Pega tu clave de licencia y haz clic en Activate with key. El plugin contacta con el servidor de licencias, vincula la clave a este servidor de Jellyfin y muestra la licencia como Active.
¿Aún no tienes clave? En la misma página escribe tu correo e inicia la prueba gratuita de 30 días (se necesita tarjeta, nada que pagar hoy) o compra una licencia; el plugin se activa solo cuando el pago se ha hecho.

La licencia se comprueba una vez al día y en cada arranque de Jellyfin. Sin internet, el plugin sigue funcionando durante 7 días tras la última comprobación exitosa. Sin una licencia válida, el plugin detiene su trabajo y solo su página License sigue funcionando (prueba, clave, renovación); no se borra nada y todo se reanuda en cuanto la licencia es válida de nuevo. Move license (release this server) en la misma página libera la clave para otro servidor.

Actualizaciones y vuelta atrás

Desde el repositorio: Jellyfin muestra las versiones nuevas en Dashboard → Plugins y puede actualizar el plugin automáticamente; reinicia Jellyfin para cargar la nueva versión.
Desde la página License del plugin: con una licencia válida, Install update instala la versión más nueva que tu licencia permite y Roll back to x.y.z vuelve a la versión anterior (por ejemplo, si algo dejó de funcionar tras una actualización). Reinicia Jellyfin después de cualquiera de las dos. Ambos paquetes se comprueban contra la suma de verificación publicada por el servidor de licencias.
Una licencia de por vida recibe las versiones publicadas durante su período de actualizaciones; después, el plugin sigue funcionando en la última versión que puede usar.
Tras una vuelta atrás, si tu repositorio de plugins está añadido en Jellyfin, la tarea programada Update Plugins de Jellyfin (en el arranque y cada día) instala de nuevo la versión más nueva. Para permanecer un tiempo en la versión anterior, quita los desencadenantes de esa tarea en Dashboard → Scheduled Tasks y añádelos de nuevo más tarde.

Código fuente

El código fuente GPL-3.0 de cada versión está en Account → Licenses (Source code), junto a la descarga, como archivo .tar.gz creado a partir del commit exacto de esa versión.

Configuración

Abre Access Links en el menú del panel de Jellyfin (o Dashboard → Plugins → Access Links by MediaLab).

HTTPS: Access Links solo funciona con direcciones HTTPS. Si la página indica que HTTPS no está activado, configura HTTPS y un certificado en los ajustes de red de Jellyfin; hasta entonces, los enlaces https:// no se abrirán.
Dirección local: déjala vacía para usar automáticamente la IP de red del servidor, su puerto HTTPS local y su URL base; escribe un nombre de tu red (por ejemplo media.lan; el puerto HTTPS se añade solo) o una dirección https://… completa. Consejo: si tu certificado se emitió para un nombre, usa ese nombre, resuelto hacia el servidor en tu red; una IP sin más suele hacer que los navegadores muestren una advertencia.
Dirección externa: escríbela exactamente como lo harías en un navegador fuera de tu casa, con el puerto externo, por ejemplo https://example.com:2096. El puerto externo puede diferir del local. Si hay una dirección https:// configurada en Published server URIs de Jellyfin, la página la sugiere con un botón. Todo lo pegado de la barra del navegador tras la dirección (como /web/#/home) se elimina por ti.
Haz clic en Save.

Uso diario

La página lista cada enlace en grupos: Jellyfin (aplicación web, pantalla de inicio de sesión, la propia página de códigos Quick Connect de Jellyfin, el panel de administración, dirección del servidor para las apps) y un grupo por cada plugin de MediaLab instalado y activo en el servidor (Quick Connect, Registration, Cashier, Share Links, Headend). Cada enlace muestra para quién es y su dirección local y externa.
Para cada dirección: Open, Copy o QR. Muestra el código QR en pantalla para que un teléfono pueda escanearlo, por ejemplo la página de teléfono de Quick Connect o el formulario de registro.
Check all links lee los certificados, confirma que la dirección externa llega a este mismo servidor y prueba cada página. Las advertencias dicen exactamente qué falla: HTTPS desactivado, certificado caducado o que caduca en los próximos 14 días, certificado que no cubre la dirección, o una dirección externa que llega a otro servidor.
Otros servidores de Emby / Jellyfin: añade un nombre, el tipo y la dirección https:// de otro servidor (hasta 50). Sus enlaces se construyen para ti; Check muestra su nombre, versión, tipo real y qué páginas de plugins existen en él (una página que falta suele significar que el plugin no está instalado allí).

Qué envía y a dónde

Las comprobaciones se ejecutan solo cuando haces clic en Check all links o Check: el servidor se conecta a las direcciones que escribiste para leer su certificado, su información pública de servidor y si cada página responde. No se envía nada secreto.
Los códigos QR se generan en tu servidor; ninguna dirección sale a un servicio externo.
Nada va a medialab.works salvo la comprobación de la licencia.

Solución de problemas

«HTTPS is not enabled on this server»: activa HTTPS con un certificado en los ajustes de red de Jellyfin y reinicia Jellyfin.
«The certificate does not cover the local address»: la dirección local es una IP o un nombre que no está en el certificado. Usa un nombre que cubra el certificado, resuelto hacia el servidor en tu red.
«The external address does not answer from the server»: muchos routers no pueden alcanzar su propia dirección externa desde dentro («hairpin NAT»). Abre el enlace externo desde un teléfono con datos móviles para comprobarlo.
«The external address reaches ANOTHER server»: el reenvío de puertos o el proxy inverso envía esa dirección a un servidor distinto de Jellyfin o Emby; corrige el reenvío o la dirección externa.