MZAP/7
Hľadať
Stiahnuť Kúpiť
← Všetky články pomocníka

Pomocník

Ovládajte MZAP odkiaľkoľvek cez Cloudflare Tunnel alebo ngrok

Potrebujete zmeniť hudbu na mieste, kde práve nie ste, opraviť plán z domu alebo skontrolovať, čo hrá v inej budove? Tunel dá prehrávaču Multi Zone Audio Player (MZAP 7) bezpečnú verejnú webovú adresu, takže jeho celé webové rozhranie otvoríte z ľubovoľného prehliadača, odkiaľkoľvek.

Na routeri netreba nič meniť: žiadne presmerovanie portov, žiadne pravidlá firewallu, žiadna statická IP adresa. Aplikácia tunela beží na počítači s MZAP a nadviaže odchádzajúce spojenie so službou tunela, ktorá požiadavky z vášho prehliadača odovzdáva späť do MZAP.

Cez tunel funguje všetko vrátane živých ukazovateľov úrovne, stavu prehrávania, priebehu skladby, hlasitosti a smerovania.

Tento návod popisuje dve možnosti:

Cloudflare Tunnelngrok
Vhodné naTrvalý vzdialený prístupVyskúšanie, krátke relácie
PotrebujeteDoménu spravovanú v CloudflareLen bezplatný účet
AdresaVlastná, napr. mzap.yourdomain.comAdresa ngrok-free.app
BežíAko služba Windows, prežije reštartKým je otvorené okno ngrok
CenaZadarmoK dispozícii je bezplatný plán

Poznámka: Tento návod sa týka prístupu cez prehliadač. Pripojeniu mobilnej aplikácie MZAP Remote alebo AI asistenta cez tunel sa budeme venovať v samostatnom článku.

Skôr než začnete: zapnite prihlasovanie

Tento krok nevynechávajte. Prihlasovanie je v MZAP predvolene vypnuté, pretože v uzavretej lokálnej sieti nie je vždy potrebné. Tunel však MZAP sprístupní na internete: bez prihlasovania získa ktokoľvek, kto adresu nájde, úplnú kontrolu nad vaším ozvučením.

  1. V MZAP otvorte kartu Používatelia.
  2. Kliknite na Vytvoriť, zadajte používateľské meno a silné heslo a nastavte rolu na Administrátor.
  3. Kliknite na Povoliť overenie a potvrďte.
  4. Pre ľudí, ktorí sa budú pripájať na diaľku, vytvorte samostatné účty s rolou Operátor (môže ovládať prehrávanie a hlasitosť) alebo Pozorovateľ (môže len sledovať). Každý účet môžete obmedziť aj na konkrétne prehrávače a zóny.

Znova načítajte MZAP: teraz by sa malo zobraziť prihlasovacie okno. Podrobnosti o rolách a priradeniach nájdete v dokumentácii v časti Používatelia a prístup.

Port MZAP: oba tunely smerujú na port 5000, na ktorom beží webové rozhranie MZAP. Ak ste v nastaveniach MZAP zmenili port API, použite svoj port.

Možnosť A: Cloudflare Tunnel (odporúčané)

Túto možnosť použite na trvalý vzdialený prístup. Získate stabilnú adresu na vlastnej doméne, o HTTPS je postarané a tunel sa spúšťa automaticky so systémom Windows.

Potrebujete: bezplatný účet Cloudflare a doménu, ktorej DNS spravuje Cloudflare. Ak máte doménu u iného registrátora, môžete ju bezplatne pridať do Cloudflare a prepnúť jej menné servery (nameservery). Cloudflare vás pri pridávaní domény celým postupom prevedie.

1. Vytvorte tunel

  1. Prihláste sa do ovládacieho panela Cloudflare.
  2. Prejdite do Networking → Tunnels a kliknite na Create a tunnel.
  3. Pomenujte ho tak, aby ste ho spoznali, napríklad mzap-lobby, a kliknite na Create Tunnel.

2. Nainštalujte konektor na počítač s MZAP

  1. Keď sa zobrazí výber operačného systému, zvoľte Windows.

  2. Stiahnite a nainštalujte cloudflared cez odkaz, ktorý zobrazí ovládací panel.

  3. Skopírujte z ovládacieho panela inštalačný príkaz. Vyzerá takto, len na konci bude váš vlastný dlhý token:

    cloudflared.exe service install eyJhIjoi...

  4. Na počítači s MZAP otvorte Príkazový riadok ako správca (pravé tlačidlo myši → Spustiť ako správca), vložte príkaz a stlačte Enter.

  5. V ovládacom paneli počkajte, kým sa tunel zobrazí ako connected, a potom kliknite na Continue.

Konektor teraz beží ako služba Windows. Spúšťa sa spolu so systémom Windows a po výpadku siete sa sám znova pripojí.

3. Prideľte MZAP verejnú adresu

  1. Na karte Routes tunela kliknite na Add route → Published application.
  2. Hostname: zadajte subdoménu, napríklad mzap, a zo zoznamu vyberte svoju doménu.
  3. Service URL: zadajte http://localhost:5000
  4. Kliknite na Save.

Do minúty otvorte https://mzap.yourdomain.com v ľubovoľnom prehliadači, prihláste sa a ste dnu.

Pre MZAP nepoužívajte „Quick Tunnels“. Cloudflare ponúka aj okamžité tunely na náhodných adresách trycloudflare.com bez účtu. Stránku síce otvoria, ale nepodporujú živé aktualizácie, ktoré MZAP používa: ukazovatele aj stav prehrávania zamrznú. Použite pomenovaný tunel podľa postupu vyššie.

Možnosť B: ngrok (najrýchlejšie vyskúšanie)

ngrok je najrýchlejší spôsob, ako vyskúšať vzdialený prístup. Nepotrebujete doménu a zaberie to asi päť minút.

1. Vytvorte si bezplatný účet

  1. Zaregistrujte sa na ngrok.com.
  2. V ovládacom paneli ngrok otvorte Your Authtoken a skopírujte token.

2. Nainštalujte ngrok na počítač s MZAP

Otvorte Príkazový riadok alebo PowerShell a spustite:

winget install ngrok.ngrok

Alebo si stiahnite ngrok pre Windows z ngrok.com/download a rozbaľte ho. Ak použijete zip, spúšťajte príkazy nižšie z priečinka, v ktorom je ngrok.exe.

3. Prepojte ngrok so svojím účtom

Stačí to urobiť iba raz:

ngrok config add-authtoken YOUR_TOKEN

4. Spustite tunel

ngrok http 5000

ngrok zobrazí riadok Forwarding s adresou v tvare https://xxxx.ngrok-free.app. Otvorte túto adresu v ľubovoľnom prehliadači, prihláste sa a ste dnu.

Tunel zostáva otvorený, kým je otvorené toto okno. Stlačením Ctrl+C ho zatvoríte a adresa okamžite prestane fungovať.

Tipy:

  • Ponechajte si rovnakú adresu: pri bezplatnom pláne sa adresa môže pri každom spustení ngrok zmeniť. V ovládacom paneli ngrok si v časti Domains môžete vyhradiť pevnú adresu a tunel potom spúšťať príkazom ngrok http 5000 --url=https://your-name.ngrok-free.app.
  • Sledujte, čo sa deje: kým ngrok beží, otvorte na počítači s MZAP adresu http://127.0.0.1:4040 a uvidíte požiadavky, ktoré prechádzajú tunelom.
  • “ERR_NGROK_121” / “agent version is too old”: vaša verzia ngrok je zastaraná. Spustite ngrok update, prípadne winget upgrade ngrok.ngrok, ak ste ho inštalovali cez winget, a skúste to znova.
  • Na nepretržitý prístup použite radšej Cloudflare Tunnel. ngrok sa najlepšie hodí na relácie, pri ktorých niekto dohliada.

Bezpečnostný kontrolný zoznam

  • ✅ Prihlasovanie je v MZAP zapnuté a heslo administrátora je silné a jedinečné.
  • ✅ Vzdialení používatelia majú účty s rolou Operátor alebo Pozorovateľ, nie účet Administrátor.
  • ✅ Každý človek má vlastný účet, takže môžete jeden odstrániť bez vplyvu na ostatných.
  • ✅ Zatvorte tunely, ktoré nepotrebujete. ngrok zastavíte cez Ctrl+C; tunel Cloudflare pozastavíte alebo odstránite v ovládacom paneli.
  • ✅ Adresu zdieľajte len s ľuďmi, ktorí ju potrebujú.

Pre ďalšiu ochranu môžete pri Cloudflare pred MZAP pridať Cloudflare Access, takže návštevníci budú musieť ešte pred prihlasovacou stránkou MZAP potvrdiť aj svoj e-mail. Postup nastavenia nájdete v dokumentácii Cloudflare.

Riešenie problémov

  • Stránka sa nenačíta: skontrolujte, či MZAP beží a či sa adresa http://localhost:5000 otvorí priamo na počítači s MZAP.
  • Cloudflare zobrazuje chybu 502 alebo 1033: konektor sa nevie spojiť s MZAP alebo nebeží. Skontrolujte, či v aplikácii Služby systému Windows beží služba Cloudflared a či je Service URL nastavená na http://localhost:5000.
  • Ukazovatele a stav sa nehýbu: pravdepodobne používate Cloudflare Quick Tunnel (trycloudflare.com). Prejdite na pomenovaný tunel.
  • Nezobrazí sa prihlasovacie okno: prihlasovanie ešte nie je zapnuté. Vráťte sa k časti Skôr než začnete.

Máte otázky alebo nastavenie, ktoré do tohto návodu nezapadá? Kontaktujte nás. Radi vám pomôžeme.