← Všechny články nápovědy

Nápověda

Ovládejte MZAP odkudkoli přes Cloudflare Tunnel nebo ngrok

Potřebujete změnit hudbu na místě, kde zrovna nejste, opravit plán z domova nebo zkontrolovat, co hraje v jiné budově? Tunel dá přehrávači Multi Zone Audio Player (MZAP 7) bezpečnou veřejnou webovou adresu, takže jeho celé webové rozhraní otevřete z libovolného prohlížeče, odkudkoli.

Na routeru není potřeba nic měnit: žádné přesměrování portů, žádná pravidla firewallu, žádná statická IP adresa. Aplikace tunelu běží na počítači s MZAP a navazuje odchozí spojení se službou tunelu, která požadavky z vašeho prohlížeče předává zpět do MZAP.

Přes tunel funguje všechno včetně živých ukazatelů úrovně, stavu přehrávání, průběhu skladby, hlasitosti a směrování.

Tento návod popisuje dvě možnosti:

Cloudflare Tunnelngrok
Vhodné proTrvalý vzdálený přístupVyzkoušení, krátké relace
PotřebujeteDoménu spravovanou v CloudflareJen bezplatný účet
AdresaVlastní, např. mzap.yourdomain.comAdresa ngrok-free.app
BěžíJako služba Windows, přežije restartDokud je otevřené okno ngrok
CenaZdarmaK dispozici je bezplatný tarif

Poznámka: Tento návod se týká přístupu přes prohlížeč. Připojení mobilní aplikace MZAP Remote nebo AI asistenta přes tunel popíšeme v samostatném článku.

Než začnete: zapněte přihlašování

Tento krok nevynechávejte. Přihlašování je v MZAP ve výchozím stavu vypnuté, protože v uzavřené místní síti není vždy potřeba. Tunel ale MZAP zpřístupní na internetu: bez přihlašování získá kdokoli, kdo adresu najde, plnou kontrolu nad vaším ozvučením.

  1. V MZAP otevřete kartu Uživatelé.
  2. Klikněte na Vytvořit, zadejte uživatelské jméno a silné heslo a nastavte roli na Administrátor.
  3. Klikněte na Povolit ověřování a potvrďte.
  4. Pro lidi, kteří se budou připojovat na dálku, vytvořte samostatné účty s rolí Operátor (může ovládat přehrávání a hlasitost) nebo Prohlížející (může jen sledovat). Každý účet můžete také omezit na konkrétní přehrávače a zóny.

Znovu načtěte MZAP: nyní by se mělo zobrazit přihlašovací okno. Podrobnosti o rolích a přiřazeních najdete v dokumentaci v části Uživatelé a přístup.

Port MZAP: oba tunely míří na port 5000, na kterém běží webové rozhraní MZAP. Pokud jste v nastavení MZAP změnili port API, použijte svůj port.

Možnost A: Cloudflare Tunnel (doporučeno)

Tuto možnost použijte pro trvalý vzdálený přístup. Získáte stabilní adresu na vlastní doméně, o HTTPS je postaráno a tunel se spouští automaticky se systémem Windows.

Potřebujete: bezplatný účet Cloudflare a doménu, jejíž DNS spravuje Cloudflare. Pokud máte doménu u jiného registrátora, můžete ji zdarma přidat do Cloudflare a přepnout její jmenné servery (nameservery). Cloudflare vás při přidávání domény celým postupem provede.

1. Vytvořte tunel

  1. Přihlaste se do ovládacího panelu Cloudflare.
  2. Přejděte do Networking → Tunnels a klikněte na Create a tunnel.
  3. Pojmenujte ho tak, abyste ho poznali, například mzap-lobby, a klikněte na Create Tunnel.

2. Nainstalujte konektor na počítač s MZAP

  1. Až budete vyzváni k výběru operačního systému, zvolte Windows.

  2. Stáhněte a nainstalujte cloudflared přes odkaz, který ovládací panel zobrazí.

  3. Zkopírujte z ovládacího panelu instalační příkaz. Vypadá takto, jen na konci bude váš vlastní dlouhý token:

    cloudflared.exe service install eyJhIjoi...
  4. Na počítači s MZAP otevřete Příkazový řádek jako správce (pravé tlačítko myši → Spustit jako správce), vložte příkaz a stiskněte Enter.

  5. V ovládacím panelu počkejte, až se tunel zobrazí jako connected, a pak klikněte na Continue.

Konektor nyní běží jako služba Windows. Spouští se spolu se systémem Windows a po výpadku sítě se sám znovu připojí.

3. Přidělte MZAP veřejnou adresu

  1. Na kartě Routes tunelu klikněte na Add route → Published application.
  2. Hostname: zadejte subdoménu, například mzap, a ze seznamu vyberte svou doménu.
  3. Service URL: zadejte http://localhost:5000
  4. Klikněte na Save.

Do minuty otevřete https://mzap.yourdomain.com v libovolném prohlížeči, přihlaste se a jste uvnitř.

Pro MZAP nepoužívejte „Quick Tunnels“. Cloudflare nabízí i okamžité tunely na náhodných adresách trycloudflare.com bez účtu. Stránku sice otevřou, ale nepodporují živé aktualizace, které MZAP používá: ukazatele i stav přehrávání zamrznou. Použijte pojmenovaný tunel podle postupu výše.

Možnost B: ngrok (nejrychlejší vyzkoušení)

ngrok je nejrychlejší způsob, jak vyzkoušet vzdálený přístup. Nepotřebujete doménu a zabere to asi pět minut.

1. Vytvořte si bezplatný účet

  1. Zaregistrujte se na ngrok.com.
  2. V ovládacím panelu ngrok otevřete Your Authtoken a zkopírujte token.

2. Nainstalujte ngrok na počítač s MZAP

Otevřete Příkazový řádek nebo PowerShell a spusťte:

winget install ngrok.ngrok

Nebo si stáhněte ngrok pro Windows z ngrok.com/download a rozbalte ho. Pokud použijete zip, spouštějte níže uvedené příkazy ze složky, ve které je ngrok.exe.

3. Propojte ngrok se svým účtem

Stačí to udělat jen jednou:

ngrok config add-authtoken YOUR_TOKEN

4. Spusťte tunel

ngrok http 5000

ngrok zobrazí řádek Forwarding s adresou ve tvaru https://xxxx.ngrok-free.app. Otevřete tuto adresu v libovolném prohlížeči, přihlaste se a jste uvnitř.

Tunel zůstává otevřený, dokud je otevřené toto okno. Stisknutím Ctrl+C ho zavřete a adresa okamžitě přestane fungovat.

Tipy:

  • Ponechte si stejnou adresu: u bezplatného tarifu se adresa může při každém spuštění ngrok změnit. V ovládacím panelu ngrok si v části Domains můžete zarezervovat pevnou adresu a tunel pak spouštět příkazem ngrok http 5000 --url=https://your-name.ngrok-free.app.
  • Sledujte, co se děje: když ngrok běží, otevřete na počítači s MZAP adresu http://127.0.0.1:4040 a uvidíte požadavky, které procházejí tunelem.
  • “ERR_NGROK_121” / “agent version is too old”: vaše verze ngrok je zastaralá. Spusťte ngrok update, případně winget upgrade ngrok.ngrok, pokud jste ho instalovali přes winget, a zkuste to znovu.
  • Pro nepřetržitý přístup použijte raději Cloudflare Tunnel. ngrok se nejlépe hodí pro relace, při kterých na vše někdo dohlíží.

Bezpečnostní kontrolní seznam

  • ✅ Přihlašování je v MZAP zapnuté a heslo administrátora je silné a jedinečné.
  • ✅ Vzdálení uživatelé mají účty s rolí Operátor nebo Prohlížející, ne účet Administrátor.
  • ✅ Každý má vlastní účet, takže můžete jeden odebrat, aniž byste ovlivnili ostatní.
  • ✅ Zavřete tunely, které nepotřebujete. ngrok zastavíte pomocí Ctrl+C; tunel Cloudflare pozastavíte nebo smažete v ovládacím panelu.
  • ✅ Adresu sdílejte jen s lidmi, kteří ji potřebují.

Pro další ochranu můžete u Cloudflare před MZAP přidat Cloudflare Access, takže návštěvníci budou muset ještě před přihlašovací stránkou MZAP potvrdit i svůj e-mail. Postup nastavení najdete v dokumentaci Cloudflare.

Řešení potíží

  • Stránka se nenačte: zkontrolujte, že MZAP běží a že se adresa http://localhost:5000 otevře přímo na počítači s MZAP.
  • Cloudflare zobrazuje chybu 502 nebo 1033: konektor se nemůže spojit s MZAP nebo neběží. Zkontrolujte, že v aplikaci Služby systému Windows běží služba Cloudflared a že Service URL je http://localhost:5000.
  • Ukazatele a stav se nehýbou: pravděpodobně používáte Cloudflare Quick Tunnel (trycloudflare.com). Přejděte na pojmenovaný tunel.
  • Nezobrazí se přihlašovací okno: přihlašování ještě není zapnuté. Vraťte se k části Než začnete.

Máte otázky nebo nastavení, na které tento návod nesedí? Kontaktujte nás. Rádi vám pomůžeme.