MZAP/7
Szukaj
Pobierz Kup
← Wszystkie artykuły pomocy

Pomoc

Steruj MZAP z dowolnego miejsca przez Cloudflare Tunnel lub ngrok

Musisz zmienić muzykę w lokalizacji, w której akurat cię nie ma, poprawić harmonogram z domu albo sprawdzić, co gra w innym budynku? Tunel daje Multi Zone Audio Player (MZAP 7) bezpieczny publiczny adres internetowy, dzięki czemu możesz otworzyć jego pełny interfejs webowy w dowolnej przeglądarce, z dowolnego miejsca.

Na routerze nie trzeba niczego zmieniać: żadnego przekierowania portów, żadnych reguł zapory, żadnego stałego adresu IP. Aplikacja tunelu działa na komputerze z MZAP i sama nawiązuje połączenie wychodzące z usługą tunelu, która przekazuje żądania z twojej przeglądarki z powrotem do MZAP.

Przez tunel działa wszystko, w tym wskaźniki poziomu na żywo, stan odtwarzania, postęp utworu, głośność i routing.

Ten przewodnik opisuje dwie możliwości:

Cloudflare Tunnelngrok
Najlepsze doStałego dostępu zdalnegoWypróbowania, krótkich sesji
Czego potrzebujeszDomeny zarządzanej przez CloudflareTylko darmowego konta
AdresTwój własny, np. mzap.yourdomain.comAdres w ngrok-free.app
DziałaJako usługa Windows, przetrwa ponowne uruchomienieDopóki okno ngrok jest otwarte
KosztZa darmoDostępny darmowy plan

Uwaga: ten przewodnik dotyczy dostępu przez przeglądarkę. Łączenie aplikacji mobilnej MZAP Remote lub asystenta AI przez tunel opiszemy w osobnym artykule.

Zanim zaczniesz: włącz logowanie

Nie pomijaj tego kroku. Logowanie jest w MZAP domyślnie wyłączone, bo w zamkniętej sieci lokalnej nie zawsze jest potrzebne. Tunel wystawia MZAP do internetu: bez logowania każdy, kto znajdzie adres, uzyska pełną kontrolę nad twoim systemem audio.

  1. W MZAP otwórz kartę Użytkownicy.
  2. Kliknij Utwórz, wpisz nazwę użytkownika i silne hasło, a następnie ustaw rolę Administrator.
  3. Kliknij Włącz uwierzytelnianie i potwierdź.
  4. Dla osób, które będą łączyć się zdalnie, utwórz osobne konta z rolą Operator (może sterować odtwarzaniem i głośnością) lub Obserwator (może tylko podglądać). Każde konto możesz też ograniczyć do wybranych odtwarzaczy i stref.

Odśwież MZAP: powinno pojawić się okno logowania. Szczegóły dotyczące ról i przypisań znajdziesz w sekcji Users & Access dokumentacji.

Port MZAP: oba tunele kierują ruch na port 5000, na którym działa interfejs webowy MZAP. Jeśli zmieniłeś port API w ustawieniach MZAP, użyj swojego portu.

Opcja A: Cloudflare Tunnel (zalecana)

Wybierz tę opcję, jeśli potrzebujesz stałego dostępu zdalnego. Dostajesz stały adres we własnej domenie, HTTPS jest obsługiwany automatycznie, a tunel uruchamia się razem z Windows.

Czego potrzebujesz: darmowego konta Cloudflare i domeny, której DNS zarządza Cloudflare. Jeśli twoja domena jest u innego rejestratora, możesz za darmo dodać ją do Cloudflare i zmienić jej serwery nazw (nameservers). Cloudflare przeprowadzi cię przez to krok po kroku podczas dodawania domeny.

1. Utwórz tunel

  1. Zaloguj się do panelu Cloudflare.
  2. Przejdź do Networking → Tunnels i kliknij Create a tunnel.
  3. Nadaj tunelowi rozpoznawalną nazwę, na przykład mzap-lobby, i kliknij Create Tunnel.

2. Zainstaluj konektor na komputerze z MZAP

  1. Gdy pojawi się pytanie o system operacyjny, wybierz Windows.

  2. Pobierz i zainstaluj cloudflared, korzystając z linku wyświetlonego w panelu.

  3. Skopiuj z panelu polecenie instalacji. Wygląda mniej więcej tak, z twoim długim tokenem na końcu:

    cloudflared.exe service install eyJhIjoi...

  4. Na komputerze z MZAP otwórz Wiersz polecenia jako administrator (kliknij prawym przyciskiem myszy → Uruchom jako administrator), wklej polecenie i naciśnij Enter.

  5. Wróć do panelu, poczekaj, aż tunel pokaże stan connected, a następnie kliknij Continue.

Konektor działa teraz jako usługa Windows. Uruchamia się razem z Windows i sam łączy się ponownie po zaniku sieci.

3. Nadaj MZAP publiczny adres

  1. Na karcie Routes tunelu kliknij Add route → Published application.
  2. Hostname: wpisz subdomenę, na przykład mzap, i wybierz swoją domenę z listy.
  3. Service URL: wpisz http://localhost:5000
  4. Kliknij Save.

Po około minucie otwórz https://mzap.yourdomain.com w dowolnej przeglądarce, zaloguj się i gotowe.

Nie używaj „Quick Tunnels” dla MZAP. Cloudflare oferuje też natychmiastowe tunele pod losowymi adresami trycloudflare.com, bez konta. Strona się przez nie otworzy, ale nie obsługują one aktualizacji na żywo, z których korzysta MZAP: wskaźniki i stan odtwarzania zamarzają. Użyj nazwanego tunelu, tak jak opisano wyżej.

Opcja B: ngrok (najszybsza do wypróbowania)

ngrok to najszybszy sposób, by przetestować dostęp zdalny. Nie potrzebujesz domeny, a całość zajmuje około pięciu minut.

1. Załóż darmowe konto

  1. Zarejestruj się na ngrok.com.
  2. W panelu ngrok otwórz Your Authtoken i skopiuj token.

2. Zainstaluj ngrok na komputerze z MZAP

Otwórz Wiersz polecenia lub PowerShell i uruchom:

winget install ngrok.ngrok

Możesz też pobrać ngrok dla Windows z ngrok.com/download i rozpakować archiwum. Jeśli korzystasz z pliku zip, uruchamiaj poniższe polecenia z folderu, w którym znajduje się ngrok.exe.

3. Połącz ngrok ze swoim kontem

Wystarczy zrobić to raz:

ngrok config add-authtoken YOUR_TOKEN

4. Uruchom tunel

ngrok http 5000

ngrok wyświetli wiersz Forwarding z adresem w rodzaju https://xxxx.ngrok-free.app. Otwórz ten adres w dowolnej przeglądarce, zaloguj się i gotowe.

Tunel działa, dopóki to okno jest otwarte. Naciśnij Ctrl+C, aby go zamknąć — adres natychmiast przestanie działać.

Wskazówki:

  • Zachowaj ten sam adres: w darmowym planie adres może się zmieniać przy każdym uruchomieniu ngrok. W panelu ngrok, w sekcji Domains, możesz zarezerwować stały adres, a potem uruchamiać tunel poleceniem ngrok http 5000 --url=https://your-name.ngrok-free.app.
  • Zobacz, co się dzieje: gdy ngrok działa, otwórz http://127.0.0.1:4040 na komputerze z MZAP, aby podglądać żądania przechodzące przez tunel.
  • „ERR_NGROK_121” / „agent version is too old”: twoja wersja ngrok jest nieaktualna. Uruchom ngrok update (lub winget upgrade ngrok.ngrok, jeśli instalowałeś przez winget) i spróbuj ponownie.
  • Do stałego dostępu używaj Cloudflare Tunnel. ngrok najlepiej sprawdza się w sesjach, podczas których ktoś nad wszystkim czuwa.

Lista kontrolna bezpieczeństwa

  • ✅ Logowanie jest włączone w MZAP, a hasło konta Administrator jest silne i niepowtarzalne.
  • ✅ Osoby zdalne korzystają z kont Operator lub Obserwator, a nie z konta Administrator.
  • ✅ Każda osoba ma własne konto, więc możesz usunąć jedno bez wpływu na pozostałe.
  • ✅ Zamykaj niepotrzebne tunele. Zatrzymuj ngrok skrótem Ctrl+C; wstrzymuj lub usuwaj tunel Cloudflare w panelu.
  • ✅ Udostępniaj adres tylko osobom, które go potrzebują.

Aby dodatkowo zabezpieczyć dostęp przez Cloudflare, możesz postawić Cloudflare Access przed MZAP — wtedy odwiedzający muszą też potwierdzić swój adres e-mail, zanim dotrą do strony logowania MZAP. Sposób konfiguracji opisuje dokumentacja Cloudflare.

Rozwiązywanie problemów

  • Strona się nie ładuje: sprawdź, czy MZAP jest uruchomiony i czy http://localhost:5000 otwiera się na samym komputerze z MZAP.
  • Cloudflare pokazuje błąd 502 lub 1033: konektor nie może połączyć się z MZAP albo nie działa. Sprawdź w oknie Usługi systemu Windows, czy usługa Cloudflared jest uruchomiona, oraz czy Service URL ma wartość http://localhost:5000.
  • Wskaźniki i stan się nie zmieniają: prawdopodobnie korzystasz z Cloudflare Quick Tunnel (trycloudflare.com). Przejdź na nazwany tunel.
  • Nie pojawia się okno logowania: logowanie nie jest jeszcze włączone. Wróć do sekcji Zanim zaczniesz.

Masz pytania albo twoja konfiguracja nie pasuje do tego przewodnika? Skontaktuj się z nami. Chętnie pomożemy.