MZAP/7
Zoeken
Download Kopen
← Alle helpartikelen

Help

MZAP overal bedienen met Cloudflare Tunnel of ngrok

Wilt u de muziek wijzigen op een locatie waar u niet bent, thuis een planning aanpassen of controleren wat er in een ander gebouw speelt? Een tunnel geeft Multi Zone Audio Player (MZAP 7) een veilig openbaar webadres, zodat u de volledige webinterface vanuit elke browser kunt openen, waar u ook bent.

Op uw router hoeft u niets te wijzigen: geen port forwarding, geen firewallregels, geen vast IP-adres. De tunnel-app draait op de MZAP-computer en maakt een uitgaande verbinding met de tunneldienst, die de verzoeken van uw browser doorstuurt naar MZAP.

Alles werkt via de tunnel, ook de live niveaumeters, de afspeelstatus, de voortgang van het nummer, het volume en de routering.

Deze handleiding behandelt twee opties:

Cloudflare Tunnelngrok
Het beste voorPermanente toegang op afstandUitproberen, korte sessies
U hebt nodigEen domein dat door Cloudflare wordt beheerdAlleen een gratis account
AdresUw eigen adres, bijv. mzap.yourdomain.comEen ngrok-free.app-adres
DraaitAls Windows-service, ook na herstartenZolang het ngrok-venster open is
KostenGratisGratis abonnement beschikbaar

Let op: deze handleiding gaat over toegang via de browser. Hoe u de mobiele app MZAP Remote of een AI-assistent via een tunnel verbindt, leest u in een apart artikel.

Voordat u begint: aanmelden inschakelen

Sla deze stap niet over. Aanmelden staat in MZAP standaard uit, omdat het op een gesloten lokaal netwerk niet altijd nodig is. Een tunnel zet MZAP echter op internet: zonder aanmelden krijgt iedereen die het adres vindt volledige controle over uw audiosysteem.

  1. Open in MZAP het tabblad Gebruikers.
  2. Klik op Aanmaken, voer een gebruikersnaam en een sterk wachtwoord in en kies de rol Beheerder.
  3. Klik op Authenticatie inschakelen en bevestig.
  4. Maak voor mensen die op afstand verbinding maken aparte accounts aan met de rol Operator (kan afspelen en volume bedienen) of de rol Kijker (kan alleen meekijken). U kunt elk account ook beperken tot bepaalde spelers en zones.

Laad MZAP opnieuw: er zou nu een aanmeldvenster moeten verschijnen. Zie Users & Access in de documentatie voor meer informatie over rollen en toewijzingen.

De poort van MZAP: beide tunnels verwijzen naar poort 5000, waarop de webinterface van MZAP draait. Hebt u de API-poort in de instellingen van MZAP gewijzigd, gebruik dan uw eigen poort.

Optie A: Cloudflare Tunnel (aanbevolen)

Gebruik deze optie voor permanente toegang op afstand. U krijgt een vast adres op uw eigen domein, HTTPS wordt voor u geregeld en de tunnel start automatisch met Windows.

U hebt nodig: een gratis Cloudflare-account en een domein waarvan de DNS door Cloudflare wordt beheerd. Staat uw domein bij een andere registrar, dan kunt u het gratis aan Cloudflare toevoegen en de nameservers omzetten. Cloudflare begeleidt u hierbij wanneer u een domein toevoegt.

1. De tunnel aanmaken

  1. Meld u aan bij het Cloudflare-dashboard.
  2. Ga naar Networking → Tunnels en klik op Create a tunnel.
  3. Geef de tunnel een herkenbare naam, bijvoorbeeld mzap-lobby, en klik op Create Tunnel.

2. De connector installeren op de MZAP-computer

  1. Kies Windows wanneer naar uw besturingssysteem wordt gevraagd.

  2. Download en installeer cloudflared via de link die het dashboard toont.

  3. Kopieer de installatieopdracht uit het dashboard. Die ziet er zo uit, met uw eigen lange token aan het eind:

    cloudflared.exe service install eyJhIjoi...

  4. Open op de MZAP-computer de Opdrachtprompt als administrator (rechtsklik → Als administrator uitvoeren), plak de opdracht en druk op Enter.

  5. Wacht in het dashboard tot de tunnel als connected wordt weergegeven en klik dan op Continue.

De connector draait nu als Windows-service. Hij start met Windows en maakt na een netwerkonderbreking vanzelf opnieuw verbinding.

3. MZAP een openbaar adres geven

  1. Klik op het tabblad Routes van de tunnel op Add route → Published application.
  2. Hostname: voer een subdomein in, bijvoorbeeld mzap, en kies uw domein uit de lijst.
  3. Service URL: voer http://localhost:5000 in.
  4. Klik op Save.

Binnen een minuut kunt u https://mzap.yourdomain.com in elke browser openen, u aanmelden en aan de slag gaan.

Gebruik geen “Quick Tunnels” voor MZAP. Cloudflare biedt ook directe tunnels op willekeurige trycloudflare.com-adressen zonder account. Daarmee opent de pagina wel, maar ze ondersteunen de live-updates die MZAP gebruikt niet: meters en afspeelstatus bevriezen. Gebruik een benoemde tunnel zoals hierboven beschreven.

Optie B: ngrok (snelst uit te proberen)

ngrok is de snelste manier om toegang op afstand te testen. U hebt geen domein nodig en het duurt ongeveer vijf minuten.

1. Een gratis account aanmaken

  1. Meld u aan op ngrok.com.
  2. Open in het ngrok-dashboard Your Authtoken en kopieer de token.

2. ngrok installeren op de MZAP-computer

Open de Opdrachtprompt of PowerShell en voer uit:

winget install ngrok.ngrok

U kunt ngrok voor Windows ook downloaden van ngrok.com/download en uitpakken. Gebruikt u het zip-bestand, voer de onderstaande opdrachten dan uit in de map waarin ngrok.exe staat.

3. ngrok aan uw account koppelen

Dit hoeft u maar één keer te doen:

ngrok config add-authtoken YOUR_TOKEN

4. De tunnel starten

ngrok http 5000

ngrok toont een Forwarding-regel met een adres als https://xxxx.ngrok-free.app. Open dat adres in elke browser, meld u aan en u bent binnen.

De tunnel blijft open zolang dit venster open is. Druk op Ctrl+C om hem te sluiten; het adres werkt dan meteen niet meer.

Tips:

  • Hetzelfde adres houden: met het gratis abonnement kan het adres elke keer dat u ngrok start veranderen. In het ngrok-dashboard kunt u onder Domains een vast adres claimen en de tunnel vervolgens starten met ngrok http 5000 --url=https://your-name.ngrok-free.app.
  • Zien wat er gebeurt: open terwijl ngrok draait http://127.0.0.1:4040 op de MZAP-computer om de verzoeken te volgen die door de tunnel gaan.
  • “ERR_NGROK_121” / “agent version is too old”: uw ngrok is verouderd. Voer ngrok update uit, of winget upgrade ngrok.ngrok als u het met winget hebt geïnstalleerd, en probeer het opnieuw.
  • Voor permanente toegang gebruikt u beter Cloudflare Tunnel. ngrok is vooral geschikt voor sessies waarbij iemand meekijkt.

Beveiligingschecklist

  • ✅ Aanmelden is ingeschakeld in MZAP en het wachtwoord van de beheerder is sterk en uniek.
  • ✅ Mensen op afstand gebruiken accounts met de rol Operator of Kijker, niet het beheerdersaccount.
  • ✅ Iedereen heeft een eigen account, zodat u er één kunt verwijderen zonder de anderen te raken.
  • ✅ Sluit tunnels die u niet nodig hebt. Stop ngrok met Ctrl+C; pauzeer of verwijder een Cloudflare-tunnel in het dashboard.
  • ✅ Deel het adres alleen met mensen die het nodig hebben.

Voor extra bescherming met Cloudflare kunt u Cloudflare Access vóór MZAP plaatsen, zodat bezoekers ook hun e-mailadres moeten bevestigen voordat ze de aanmeldpagina van MZAP bereiken. Zie de documentatie van Cloudflare voor de installatie.

Problemen oplossen

  • De pagina laadt niet: controleer of MZAP draait en of http://localhost:5000 opent op de MZAP-computer zelf.
  • Cloudflare toont fout 502 of 1033: de connector kan MZAP niet bereiken of draait niet. Controleer in Services van Windows of de service Cloudflared actief is en of de Service URL http://localhost:5000 is.
  • Meters en status bewegen niet: u gebruikt waarschijnlijk een Cloudflare Quick Tunnel (trycloudflare.com). Stap over op een benoemde tunnel.
  • Er verschijnt geen aanmeldvenster: aanmelden is nog niet ingeschakeld. Ga terug naar Voordat u begint.

Vragen, of een situatie die niet in deze handleiding past? Neem contact met ons op. We helpen u graag.