MZAP/7
Cerca
Download Acquista
← Tutti gli articoli di aiuto

Aiuto

Controlla MZAP da ovunque con Cloudflare Tunnel o ngrok

Devi cambiare la musica in una sede dove non ti trovi, correggere una programmazione da casa o controllare cosa sta suonando in un altro edificio? Un tunnel assegna a Multi Zone Audio Player (MZAP 7) un indirizzo web pubblico e sicuro, così puoi aprirne l’interfaccia web completa da qualsiasi browser, ovunque tu sia.

Non c’è nulla da cambiare sul router: nessun port forwarding, nessuna regola del firewall, nessun IP statico. L’app del tunnel gira sul computer di MZAP e apre una connessione in uscita verso il servizio di tunnel, che poi inoltra a MZAP le richieste del tuo browser.

Attraverso il tunnel funziona tutto, compresi i misuratori di livello in tempo reale, lo stato di riproduzione, l’avanzamento dei brani, il volume e il routing.

Questa guida illustra due opzioni:

Cloudflare Tunnelngrok
Ideale perAccesso remoto permanenteProve e sessioni brevi
Ti serveUn dominio gestito da CloudflareSolo un account gratuito
IndirizzoIl tuo, ad es. mzap.yourdomain.comUn indirizzo ngrok-free.app
FunzionamentoCome servizio di Windows, resiste ai riavviiFinché la finestra di ngrok resta aperta
CostoGratuitoPiano gratuito disponibile

Nota: questa guida riguarda l’accesso dal browser. Il collegamento tramite tunnel dell’app mobile MZAP Remote o di un assistente AI sarà trattato in un articolo a parte.

Prima di iniziare: attiva l’accesso con credenziali

Non saltare questo passaggio. In MZAP l’accesso con credenziali è disattivato per impostazione predefinita, perché su una rete locale chiusa non sempre serve. Un tunnel, però, mette MZAP su internet: senza accesso con credenziali, chiunque trovi l’indirizzo ottiene il pieno controllo del tuo impianto audio.

  1. In MZAP, apri la scheda Utenti.
  2. Fai clic su Crea, inserisci un nome utente e una password robusta e imposta il ruolo Amministratore.
  3. Fai clic su Abilita Autenticazione e conferma.
  4. Per le persone che si collegheranno da remoto, crea account separati con il ruolo Operatore (può controllare riproduzione e volume) oppure Visualizzatore (può solo guardare). Puoi anche limitare ogni account a player e zone specifici.

Ricarica MZAP: ora dovrebbe comparire una finestra di accesso. Per i dettagli su ruoli e assegnazioni, consulta Users & Access nella documentazione.

La porta di MZAP: entrambi i tunnel puntano alla porta 5000, che serve l’interfaccia web di MZAP. Se hai cambiato la porta API nelle impostazioni di MZAP, usa la tua.

Opzione A: Cloudflare Tunnel (consigliata)

Usala per un accesso remoto permanente. Ottieni un indirizzo stabile sul tuo dominio, l’HTTPS viene gestito al posto tuo e il tunnel si avvia automaticamente con Windows.

Ti serve: un account Cloudflare gratuito e un dominio il cui DNS sia gestito da Cloudflare. Se il tuo dominio è registrato presso un altro provider, puoi aggiungerlo gratuitamente a Cloudflare e cambiarne i nameserver. Cloudflare ti guida passo passo quando aggiungi un dominio.

1. Crea il tunnel

  1. Accedi alla dashboard di Cloudflare.
  2. Vai su Networking → Tunnels e fai clic su Create a tunnel.
  3. Dagli un nome facile da riconoscere, ad esempio mzap-lobby, e fai clic su Create Tunnel.

2. Installa il connettore sul computer di MZAP

  1. Quando ti viene chiesto il sistema operativo, scegli Windows.

  2. Scarica e installa cloudflared dal link mostrato nella dashboard.

  3. Copia il comando di installazione dalla dashboard. Ha questo aspetto, con il tuo lungo token alla fine:

    cloudflared.exe service install eyJhIjoi...

  4. Sul computer di MZAP, apri il Prompt dei comandi come amministratore (clic destro → Esegui come amministratore), incolla il comando e premi Invio.

  5. Torna nella dashboard, attendi che il tunnel risulti connected, quindi fai clic su Continue.

Ora il connettore funziona come servizio di Windows. Si avvia con Windows e si riconnette da solo dopo un’interruzione della rete.

3. Assegna a MZAP un indirizzo pubblico

  1. Nella scheda Routes del tunnel, fai clic su Add route → Published application.
  2. Hostname: inserisci un sottodominio, ad esempio mzap, e scegli il tuo dominio dall’elenco.
  3. Service URL: inserisci http://localhost:5000
  4. Fai clic su Save.

Entro un minuto apri https://mzap.yourdomain.com in qualsiasi browser, accedi e sei dentro.

Evita i “Quick Tunnels” con MZAP. Cloudflare offre anche tunnel istantanei su indirizzi casuali trycloudflare.com, senza bisogno di un account. La pagina si apre, ma non supportano gli aggiornamenti in tempo reale usati da MZAP: misuratori e stato di riproduzione restano bloccati. Usa un tunnel con nome, come descritto sopra.

Opzione B: ngrok (la più rapida da provare)

ngrok è il modo più veloce per provare l’accesso remoto. Non serve un dominio e bastano circa cinque minuti.

1. Crea un account gratuito

  1. Registrati su ngrok.com.
  2. Nella dashboard di ngrok, apri Your Authtoken e copia il token.

2. Installa ngrok sul computer di MZAP

Apri il Prompt dei comandi o PowerShell ed esegui:

winget install ngrok.ngrok

In alternativa, scarica ngrok per Windows da ngrok.com/download ed estrai l’archivio. Se usi lo zip, esegui i comandi qui sotto dalla cartella che contiene ngrok.exe.

3. Collega ngrok al tuo account

Va fatto una sola volta:

ngrok config add-authtoken YOUR_TOKEN

4. Avvia il tunnel

ngrok http 5000

ngrok mostra una riga Forwarding con un indirizzo del tipo https://xxxx.ngrok-free.app. Apri quell’indirizzo in qualsiasi browser, accedi e sei dentro.

Il tunnel resta aperto finché questa finestra è aperta. Premi Ctrl+C per chiuderlo: l’indirizzo smette subito di funzionare.

Suggerimenti:

  • Mantenere lo stesso indirizzo: con il piano gratuito l’indirizzo può cambiare a ogni avvio di ngrok. Nella dashboard di ngrok, in Domains, puoi riservare un indirizzo fisso e poi avviare il tunnel con ngrok http 5000 --url=https://your-name.ngrok-free.app.
  • Vedere cosa succede: mentre ngrok è in esecuzione, apri http://127.0.0.1:4040 sul computer di MZAP per osservare le richieste che passano nel tunnel.
  • “ERR_NGROK_121” / “agent version is too old”: la tua versione di ngrok è obsoleta. Esegui ngrok update, oppure winget upgrade ngrok.ngrok se l’hai installato con winget, poi riprova.
  • Per un accesso sempre attivo, usa invece Cloudflare Tunnel. ngrok è più adatto a sessioni in cui qualcuno è presente a controllare.

Checklist di sicurezza

  • ✅ L’accesso con credenziali è attivo in MZAP e la password dell’Amministratore è robusta e unica.
  • ✅ Chi si collega da remoto usa account Operatore o Visualizzatore, non l’account Amministratore.
  • ✅ Ogni persona ha il proprio account, così puoi rimuoverne uno senza toccare gli altri.
  • ✅ Chiudi i tunnel che non ti servono. Ferma ngrok con Ctrl+C; metti in pausa o elimina un tunnel Cloudflare dalla dashboard.
  • ✅ Condividi l’indirizzo solo con chi ne ha bisogno.

Per una protezione in più con Cloudflare, puoi mettere Cloudflare Access davanti a MZAP: così i visitatori dovranno anche confermare la propria email prima di arrivare alla pagina di accesso di MZAP. Per la configurazione, consulta la documentazione di Cloudflare.

Risoluzione dei problemi

  • La pagina non si carica: verifica che MZAP sia in esecuzione e che http://localhost:5000 si apra sul computer di MZAP stesso.
  • Cloudflare mostra l’errore 502 o 1033: il connettore non riesce a raggiungere MZAP oppure non è in esecuzione. Controlla in Servizi di Windows che il servizio Cloudflared sia in esecuzione e che il Service URL sia http://localhost:5000.
  • Misuratori e stato restano fermi: probabilmente stai usando un Quick Tunnel di Cloudflare (trycloudflare.com). Passa a un tunnel con nome.
  • Non compare la finestra di accesso: l’accesso con credenziali non è ancora attivo. Torna a Prima di iniziare.

Hai domande o una configurazione che non rientra in questa guida? Contattaci. Saremo felici di aiutarti.