MZAP/7
Suche
Download Kaufen
← Alle Hilfeartikel

Hilfe

MZAP von überall steuern mit Cloudflare Tunnel oder ngrok

Sie möchten die Musik an einem Standort ändern, an dem Sie gerade nicht sind, von zu Hause aus einen Zeitplan korrigieren oder nachsehen, was in einem anderen Gebäude läuft? Ein Tunnel gibt Multi Zone Audio Player (MZAP 7) eine sichere öffentliche Webadresse, sodass Sie die vollständige Weboberfläche von jedem Browser aus öffnen können, egal wo Sie sind.

An Ihrem Router müssen Sie nichts ändern: keine Portweiterleitung, keine Firewall-Regeln, keine statische IP-Adresse. Die Tunnel-App läuft auf dem MZAP-Computer und baut eine ausgehende Verbindung zum Tunnel-Dienst auf, der die Anfragen Ihres Browsers an MZAP weiterleitet.

Über den Tunnel funktioniert alles, auch die Live-Pegelanzeigen, der Wiedergabestatus, der Titelfortschritt, die Lautstärke und das Routing.

Diese Anleitung stellt zwei Möglichkeiten vor:

Cloudflare Tunnelngrok
Ideal fürDauerhaften FernzugriffZum Ausprobieren, kurze Sitzungen
Sie benötigenEine von Cloudflare verwaltete DomainNur ein kostenloses Konto
AdresseIhre eigene, z. B. mzap.yourdomain.comEine ngrok-free.app-Adresse
LäuftAls Windows-Dienst, auch nach NeustartsSolange das ngrok-Fenster geöffnet ist
KostenKostenlosKostenloser Tarif verfügbar

Hinweis: In dieser Anleitung geht es um den Zugriff über den Browser. Wie Sie die mobile App MZAP Remote oder einen KI-Assistenten über einen Tunnel verbinden, erklären wir in einem separaten Artikel.

Bevor Sie beginnen: Anmeldung aktivieren

Überspringen Sie diesen Schritt nicht. Die Anmeldung ist in MZAP standardmäßig deaktiviert, weil sie in einem geschlossenen lokalen Netzwerk nicht immer nötig ist. Ein Tunnel stellt MZAP jedoch ins Internet: Ohne Anmeldung erhält jeder, der die Adresse findet, die volle Kontrolle über Ihr Audiosystem.

  1. Öffnen Sie in MZAP die Registerkarte Benutzer.
  2. Klicken Sie auf Erstellen, geben Sie einen Benutzernamen und ein sicheres Passwort ein und wählen Sie die Rolle Admin.
  3. Klicken Sie auf Authentifizierung aktivieren und bestätigen Sie.
  4. Legen Sie für Personen, die sich aus der Ferne verbinden, eigene Konten mit der Rolle Operator (kann Wiedergabe und Lautstärke steuern) oder Viewer (kann nur zusehen) an. Sie können jedes Konto außerdem auf bestimmte Player und Zonen beschränken.

Laden Sie MZAP neu: Jetzt sollte ein Anmeldedialog erscheinen. Details zu Rollen und Zuweisungen finden Sie unter Users & Access in der Dokumentation.

Der Port von MZAP: Beide Tunnel verweisen auf Port 5000, über den die Weboberfläche von MZAP bereitgestellt wird. Wenn Sie den API-Port in den Einstellungen von MZAP geändert haben, verwenden Sie stattdessen Ihren Port.

Option A: Cloudflare Tunnel (empfohlen)

Diese Variante eignet sich für dauerhaften Fernzugriff. Sie erhalten eine feste Adresse unter Ihrer eigenen Domain, HTTPS wird automatisch für Sie eingerichtet, und der Tunnel startet zusammen mit Windows.

Sie benötigen: ein kostenloses Cloudflare-Konto und eine Domain, deren DNS von Cloudflare verwaltet wird. Liegt Ihre Domain bei einem anderen Registrar, können Sie sie kostenlos zu Cloudflare hinzufügen und ihre Nameserver umstellen. Cloudflare führt Sie beim Hinzufügen einer Domain durch diese Schritte.

1. Den Tunnel erstellen

  1. Melden Sie sich im Cloudflare-Dashboard an.
  2. Gehen Sie zu Networking → Tunnels und klicken Sie auf Create a tunnel.
  3. Geben Sie ihm einen Namen, den Sie wiedererkennen, zum Beispiel mzap-lobby, und klicken Sie auf Create Tunnel.

2. Den Connector auf dem MZAP-Computer installieren

  1. Wenn nach Ihrem Betriebssystem gefragt wird, wählen Sie Windows.

  2. Laden Sie cloudflared über den im Dashboard angezeigten Link herunter und installieren Sie es.

  3. Kopieren Sie den Installationsbefehl aus dem Dashboard. Er sieht so aus, mit Ihrem eigenen langen Token am Ende:

    cloudflared.exe service install eyJhIjoi...

  4. Öffnen Sie auf dem MZAP-Computer die Eingabeaufforderung als Administrator (Rechtsklick → Als Administrator ausführen), fügen Sie den Befehl ein und drücken Sie die Eingabetaste.

  5. Warten Sie im Dashboard, bis der Tunnel als connected angezeigt wird, und klicken Sie dann auf Continue.

Der Connector läuft jetzt als Windows-Dienst. Er startet zusammen mit Windows und verbindet sich nach einem Netzwerkausfall von selbst wieder.

3. MZAP eine öffentliche Adresse geben

  1. Klicken Sie auf der Registerkarte Routes des Tunnels auf Add route → Published application.
  2. Hostname: Geben Sie eine Subdomain ein, zum Beispiel mzap, und wählen Sie Ihre Domain aus der Liste.
  3. Service URL: Geben Sie http://localhost:5000 ein.
  4. Klicken Sie auf Save.

Nach spätestens einer Minute können Sie https://mzap.yourdomain.com in einem beliebigen Browser öffnen, sich anmelden — fertig.

Verwenden Sie für MZAP keine „Quick Tunnels“. Cloudflare bietet auch sofort verfügbare Tunnel unter zufälligen trycloudflare.com-Adressen ohne Konto an. Damit lässt sich die Seite zwar öffnen, aber die Live-Aktualisierungen, die MZAP verwendet, werden nicht unterstützt: Pegelanzeigen und Wiedergabestatus frieren ein. Verwenden Sie einen benannten Tunnel wie oben beschrieben.

Option B: ngrok (am schnellsten ausprobiert)

ngrok ist der schnellste Weg, den Fernzugriff zu testen. Sie benötigen keine Domain, und die Einrichtung dauert etwa fünf Minuten.

1. Ein kostenloses Konto erstellen

  1. Registrieren Sie sich auf ngrok.com.
  2. Öffnen Sie im ngrok-Dashboard Your Authtoken und kopieren Sie das Token.

2. ngrok auf dem MZAP-Computer installieren

Öffnen Sie die Eingabeaufforderung oder PowerShell und führen Sie Folgendes aus:

winget install ngrok.ngrok

Alternativ können Sie ngrok für Windows von ngrok.com/download herunterladen und entpacken. Wenn Sie die ZIP-Datei verwenden, führen Sie die folgenden Befehle in dem Ordner aus, der ngrok.exe enthält.

3. ngrok mit Ihrem Konto verbinden

Dies ist nur einmal nötig:

ngrok config add-authtoken YOUR_TOKEN

4. Den Tunnel starten

ngrok http 5000

ngrok zeigt eine Forwarding-Zeile mit einer Adresse wie https://xxxx.ngrok-free.app an. Öffnen Sie diese Adresse in einem beliebigen Browser, melden Sie sich an — fertig.

Der Tunnel bleibt offen, solange dieses Fenster geöffnet ist. Drücken Sie Strg+C, um ihn zu schließen; die Adresse funktioniert dann sofort nicht mehr.

Tipps:

  • Dieselbe Adresse behalten: Im kostenlosen Tarif kann sich die Adresse bei jedem Start von ngrok ändern. Im ngrok-Dashboard können Sie unter Domains eine feste Adresse reservieren und den Tunnel dann mit ngrok http 5000 --url=https://your-name.ngrok-free.app starten.
  • Sehen, was passiert: Während ngrok läuft, können Sie auf dem MZAP-Computer http://127.0.0.1:4040 öffnen und die Anfragen verfolgen, die durch den Tunnel laufen.
  • „ERR_NGROK_121“ / „agent version is too old“: Ihre ngrok-Version ist veraltet. Führen Sie ngrok update aus bzw. winget upgrade ngrok.ngrok, wenn Sie es mit winget installiert haben, und versuchen Sie es dann erneut.
  • Für ständigen Zugriff verwenden Sie besser Cloudflare Tunnel. ngrok eignet sich am besten für Sitzungen, bei denen jemand dabei ist.

Sicherheits-Checkliste

  • ✅ Die Anmeldung ist in MZAP aktiviert, und das Admin-Passwort ist sicher und wird nirgendwo sonst verwendet.
  • ✅ Personen aus der Ferne verwenden Operator- oder Viewer-Konten, nicht das Admin-Konto.
  • ✅ Jede Person hat ihr eigenes Konto, sodass Sie eines entfernen können, ohne die anderen zu beeinträchtigen.
  • ✅ Schließen Sie Tunnel, die Sie nicht brauchen. Beenden Sie ngrok mit Strg+C; pausieren oder löschen Sie einen Cloudflare-Tunnel im Dashboard.
  • ✅ Geben Sie die Adresse nur an Personen weiter, die sie benötigen.

Für zusätzlichen Schutz mit Cloudflare können Sie Cloudflare Access vor MZAP schalten. Besucher müssen dann zusätzlich ihre E-Mail-Adresse bestätigen, bevor sie die Anmeldeseite von MZAP erreichen. Die Einrichtung ist in der Dokumentation von Cloudflare beschrieben.

Fehlerbehebung

  • Die Seite lädt nicht: Prüfen Sie, ob MZAP läuft und ob sich http://localhost:5000 auf dem MZAP-Computer selbst öffnen lässt.
  • Cloudflare zeigt Fehler 502 oder 1033: Der Connector erreicht MZAP nicht oder läuft nicht. Prüfen Sie in den Windows-Diensten, ob der Dienst Cloudflared läuft und ob die Service URL http://localhost:5000 lautet.
  • Pegelanzeigen und Status bewegen sich nicht: Sie verwenden wahrscheinlich einen Cloudflare Quick Tunnel (trycloudflare.com). Wechseln Sie zu einem benannten Tunnel.
  • Es erscheint kein Anmeldedialog: Die Anmeldung ist noch nicht aktiviert. Gehen Sie zurück zu Bevor Sie beginnen.

Fragen oder eine Einrichtung, die nicht zu dieser Anleitung passt? Kontaktieren Sie uns. Wir helfen Ihnen gern weiter.