Contrôler MZAP de n’importe où avec Cloudflare Tunnel ou ngrok

Besoin de changer la musique sur un site où vous n’êtes pas, de corriger une planification depuis chez vous ou de vérifier ce qui passe dans un autre bâtiment ? Un tunnel donne à Multi Zone Audio Player (MZAP 7) une adresse web publique et sécurisée, pour que vous puissiez ouvrir son interface web complète depuis n’importe quel navigateur, où que vous soyez.

Rien à changer sur votre routeur : pas de redirection de ports, pas de règles de pare-feu, pas d’adresse IP fixe. L’application de tunnel s’exécute sur l’ordinateur MZAP et établit une connexion sortante vers le service de tunnel, qui relaie les requêtes de votre navigateur vers MZAP.

Tout fonctionne à travers le tunnel, y compris les vumètres en direct, l’état de lecture, la progression des pistes, le volume et le routage.

Ce guide présente deux options :

	Cloudflare Tunnel	ngrok
Idéal pour	Un accès à distance permanent	Faire un essai, des sessions courtes
Il vous faut	Un domaine géré par Cloudflare	Simplement un compte gratuit
Adresse	La vôtre, par ex. `mzap.yourdomain.com`	Une adresse `ngrok-free.app`
Fonctionnement	En tant que service Windows, résiste aux redémarrages	Tant que la fenêtre ngrok est ouverte
Coût	Gratuit	Offre gratuite disponible

Remarque : ce guide concerne l’accès depuis un navigateur. La connexion de l’application mobile MZAP Remote ou d’un assistant IA à travers un tunnel fera l’objet d’un article séparé.

Avant de commencer : activez la connexion

Ne sautez pas cette étape. La connexion est désactivée par défaut dans MZAP, car elle n’est pas toujours nécessaire sur un réseau local fermé. Un tunnel expose MZAP sur Internet : sans connexion, toute personne qui trouve l’adresse obtient le contrôle total de votre système audio.

Dans MZAP, ouvrez l’onglet Utilisateurs.
Cliquez sur Créer, saisissez un nom d’utilisateur et un mot de passe robuste, puis choisissez le rôle Administrateur.
Cliquez sur Activer l’authentification et confirmez.
Pour les personnes qui se connecteront à distance, créez des comptes distincts avec le rôle Opérateur (peut contrôler la lecture et le volume) ou le rôle Spectateur (peut seulement consulter). Vous pouvez aussi limiter chaque compte à certains players et certaines zones.

Rechargez MZAP : une fenêtre de connexion doit maintenant s’afficher. Consultez Users & Access dans la documentation pour en savoir plus sur les rôles et les attributions.

Le port de MZAP : les deux tunnels pointent vers le port 5000, qui sert l’interface web de MZAP. Si vous avez modifié le port de l’API dans les paramètres de MZAP, utilisez votre port à la place.

Option A : Cloudflare Tunnel (recommandé)

Utilisez cette option pour un accès à distance permanent. Vous obtenez une adresse stable sur votre propre domaine, le HTTPS est géré pour vous et le tunnel démarre automatiquement avec Windows.

Il vous faut : un compte Cloudflare gratuit et un domaine dont le DNS est géré par Cloudflare. Si votre domaine est chez un autre registraire, vous pouvez l’ajouter gratuitement à Cloudflare et changer ses serveurs de noms. Cloudflare vous guide pas à pas lorsque vous ajoutez un domaine.

1. Créer le tunnel

Connectez-vous au tableau de bord Cloudflare.
Allez dans Networking → Tunnels et cliquez sur Create a tunnel.
Donnez-lui un nom facile à reconnaître, par exemple mzap-lobby, puis cliquez sur Create Tunnel.

2. Installer le connecteur sur l’ordinateur MZAP

Lorsque votre système d’exploitation vous est demandé, choisissez Windows.
Téléchargez et installez cloudflared à l’aide du lien affiché dans le tableau de bord.
Copiez la commande d’installation depuis le tableau de bord. Elle ressemble à ceci, avec votre propre long jeton à la fin :
```
cloudflared.exe service install eyJhIjoi...
```
Sur l’ordinateur MZAP, ouvrez l’Invite de commandes en tant qu’administrateur (clic droit → Exécuter en tant qu’administrateur), collez la commande et appuyez sur Entrée.
De retour dans le tableau de bord, attendez que le tunnel apparaisse comme connected, puis cliquez sur Continue.

Le connecteur fonctionne désormais comme un service Windows. Il démarre avec Windows et se reconnecte tout seul après une coupure réseau.

3. Donner une adresse publique à MZAP

Dans l’onglet Routes du tunnel, cliquez sur Add route → Published application.
Hostname : saisissez un sous-domaine, par exemple mzap, et choisissez votre domaine dans la liste.
Service URL : saisissez http://localhost:5000
Cliquez sur Save.

En moins d’une minute, ouvrez https://mzap.yourdomain.com dans n’importe quel navigateur, connectez-vous, et le tour est joué.

Évitez les « Quick Tunnels » pour MZAP. Cloudflare propose aussi des tunnels instantanés sur des adresses trycloudflare.com aléatoires, sans compte. Ils ouvrent bien la page, mais ils ne prennent pas en charge les mises à jour en direct utilisées par MZAP : les vumètres et l’état de lecture se figent. Utilisez un tunnel nommé comme décrit ci-dessus.

Option B : ngrok (le plus rapide pour essayer)

ngrok est le moyen le plus rapide de tester l’accès à distance. Aucun domaine n’est nécessaire, et cela prend environ cinq minutes.

1. Créer un compte gratuit

Inscrivez-vous sur ngrok.com.
Dans le tableau de bord ngrok, ouvrez Your Authtoken et copiez le jeton.

2. Installer ngrok sur l’ordinateur MZAP

Ouvrez l’Invite de commandes ou PowerShell et exécutez :

winget install ngrok.ngrok

Vous pouvez aussi télécharger ngrok pour Windows sur ngrok.com/download et le décompresser. Si vous utilisez le fichier zip, exécutez les commandes ci-dessous depuis le dossier qui contient ngrok.exe.

3. Relier ngrok à votre compte

Cette opération n’est à faire qu’une seule fois :

ngrok config add-authtoken YOUR_TOKEN

4. Démarrer le tunnel

ngrok http 5000

ngrok affiche une ligne Forwarding avec une adresse du type https://xxxx.ngrok-free.app. Ouvrez cette adresse dans n’importe quel navigateur, connectez-vous, et le tour est joué.

Le tunnel reste ouvert tant que cette fenêtre est ouverte. Appuyez sur Ctrl+C pour le fermer : l’adresse cesse immédiatement de fonctionner.

Astuces :

Garder la même adresse : avec l’offre gratuite, l’adresse peut changer à chaque démarrage de ngrok. Dans le tableau de bord ngrok, sous Domains, vous pouvez réserver une adresse fixe, puis démarrer le tunnel avec ngrok http 5000 --url=https://your-name.ngrok-free.app.
Voir ce qui se passe : pendant que ngrok tourne, ouvrez http://127.0.0.1:4040 sur l’ordinateur MZAP pour suivre les requêtes qui passent par le tunnel.
« ERR_NGROK_121 » / « agent version is too old » : votre ngrok n’est plus à jour. Exécutez ngrok update, ou winget upgrade ngrok.ngrok si vous l’avez installé avec winget, puis réessayez.
Pour un accès permanent, utilisez plutôt Cloudflare Tunnel. ngrok convient surtout aux sessions pendant lesquelles quelqu’un garde un œil dessus.

Liste de contrôle de sécurité

✅ La connexion est activée dans MZAP, et le mot de passe Administrateur est robuste et unique.
✅ Les personnes à distance utilisent des comptes Opérateur ou Spectateur, et non le compte Administrateur.
✅ Chaque personne a son propre compte, pour que vous puissiez en supprimer un sans affecter les autres.
✅ Fermez les tunnels dont vous n’avez pas besoin. Arrêtez ngrok avec Ctrl+C ; mettez en pause ou supprimez un tunnel Cloudflare dans le tableau de bord.
✅ Ne partagez l’adresse qu’avec les personnes qui en ont besoin.

Pour une protection supplémentaire avec Cloudflare, vous pouvez placer Cloudflare Access devant MZAP : les visiteurs devront alors aussi confirmer leur adresse e-mail avant d’atteindre la page de connexion de MZAP. Consultez la documentation de Cloudflare pour la mise en place.

Dépannage

La page ne se charge pas : vérifiez que MZAP est lancé et que http://localhost:5000 s’ouvre sur l’ordinateur MZAP lui-même.
Cloudflare affiche l’erreur 502 ou 1033 : le connecteur ne parvient pas à joindre MZAP ou n’est pas en cours d’exécution. Vérifiez dans les Services Windows que le service Cloudflared est en cours d’exécution et que la Service URL est http://localhost:5000.
Les vumètres et l’état ne bougent pas : vous utilisez probablement un Quick Tunnel Cloudflare (trycloudflare.com). Passez à un tunnel nommé.
Aucune fenêtre de connexion n’apparaît : la connexion n’est pas encore activée. Revenez à Avant de commencer.

Des questions, ou une configuration qui ne correspond pas à ce guide ? Contactez-nous. Nous serons ravis de vous aider.