Access Links pour Emby — Guide

Installation

Vous avez besoin d’Emby Server 4.10.1 ou plus récent.

Connectez-vous à votre compte MediaLab Works, ouvrez Licences et téléchargez le DLL du plugin (disponible avec un abonnement actif, une licence à vie dans sa période de mises à jour, ou pendant l’essai gratuit de 30 jours).
Copiez le DLL dans le dossier des plugins Emby et redémarrez Emby Server :
- Linux (paquet) : /var/lib/emby/plugins/
- Docker : le dossier plugins dans votre volume de configuration Emby
- Windows : %AppData%\Emby-Server\programdata\plugins\
Ouvrez Access Links dans le menu du tableau de bord Emby et cliquez sur License. Collez votre clé de licence et activez-la, ou saisissez votre e-mail pour démarrer l’essai gratuit de 30 jours ou acheter une licence. Le plugin contacte le serveur de licences, lie la clé à ce serveur Emby et affiche la licence comme Active.

La licence est vérifiée une fois par jour (et à chaque démarrage d’Emby). Sans internet, le plugin continue de fonctionner pendant 7 jours après la dernière vérification réussie ; ensuite, il est arrêté jusqu’à ce qu’il puisse à nouveau vérifier.

Licence

Sans licence valide, le plugin est arrêté ; seule la page License continue de fonctionner (vous pouvez y démarrer l’essai, acheter, saisir la clé ou mettre à jour).

Avec une licence valide, la même page peut installer une mise à jour ou revenir à la version précédente si une mise à jour pose problème. Redémarrez Emby dans les deux cas.

Configuration

Ouvrez Access Links dans le menu du tableau de bord Emby.

HTTPS : Access Links ne fonctionne qu’avec des adresses HTTPS. Si la page indique que HTTPS n’est pas activé, ajoutez un certificat dans les paramètres réseau d’Emby ; d’ici là, les liens https:// ne s’ouvriront pas.
Adresse locale : laissez-la vide pour utiliser automatiquement l’IP réseau et le port HTTPS du serveur, saisissez un nom de votre réseau (p. ex. media.lan ; le port HTTPS est ajouté pour vous) ou une adresse https://… complète. Astuce : si votre certificat est délivré pour un nom, utilisez ce nom, résolu vers le serveur dans votre réseau ; une simple adresse IP fait généralement avertir les navigateurs.
Adresse externe : saisissez-la exactement comme vous le feriez dans un navigateur en dehors de chez vous, avec le port externe, p. ex. https://example.com:2096. Le port externe peut différer du local. Si Emby connaît déjà une adresse externe, la page vous la propose avec un bouton. Tout ce qui est collé depuis la barre du navigateur après l’adresse (comme /web/index.html#!/home) est supprimé pour vous.
Cliquez sur Save.

Utilisation quotidienne

La page liste chaque lien par groupes : Emby (application web, écran de connexion, tableau de bord d’administration, adresse du serveur pour les applications) et un groupe pour chaque plugin MediaLab installé sur le serveur (Quick Connect, Registration, Cashier, Share Links, MediaLab TV, Headend). Chaque lien indique pour qui il est destiné et son adresse locale et externe.
Pour chaque adresse : Open, Copy ou QR. Affichez le QR code à l’écran pour qu’un téléphone puisse le scanner, par exemple la page Quick Connect ou le formulaire d’inscription.
Check all links lit les certificats, confirme que l’adresse externe atteint bien ce même serveur et teste chaque page. Les avertissements indiquent exactement ce qui ne va pas : HTTPS désactivé, certificat expiré ou expirant dans les 14 jours, certificat ne couvrant pas l’adresse, ou adresse externe atteignant un autre serveur.
Other Emby / Jellyfin servers : ajoutez un nom, le type et l’adresse https:// d’un autre serveur (jusqu’à 50). Ses liens sont construits pour vous ; Check affiche son nom, sa version, son type réel et les pages de plugins qui existent dessus (une page manquante signifie généralement que le plugin n’y est pas installé).

Ce qu’il envoie et où

Les vérifications ne s’exécutent que lorsque vous cliquez sur Check all links ou Check : le serveur se connecte alors aux adresses saisies pour lire leur certificat, leurs informations publiques de serveur et vérifier si chaque page répond. Rien de secret n’est envoyé.
Les QR codes sont générés sur votre serveur ; aucune adresse ne part vers un service externe.
Rien ne va vers medialab.works, si ce n’est la vérification de la licence.

Dépannage

« HTTPS is not enabled on this server » : ajoutez un certificat dans les paramètres réseau d’Emby, puis redémarrez Emby.
« The certificate does not cover the local address » : l’adresse locale est une adresse IP ou un nom absent du certificat. Utilisez un nom couvert par le certificat, résolu vers le serveur dans votre réseau.
« The external address does not answer from the server » : de nombreux routeurs ne peuvent pas atteindre leur propre adresse externe depuis l’intérieur (« hairpin NAT »). Ouvrez le lien externe depuis un téléphone en données mobiles pour le vérifier.
« The external address reaches ANOTHER server » : la redirection de port ou le proxy inverse envoie cette adresse vers un autre serveur Emby ou Jellyfin ; corrigez la redirection ou l’adresse externe.