← Todos los artículos de ayuda

Ayuda

Controle MZAP desde cualquier lugar con Cloudflare Tunnel o ngrok

¿Necesita cambiar la música en un local donde no está, corregir una programación desde casa o comprobar qué suena en otro edificio? Un túnel le da a Multi Zone Audio Player (MZAP 7) una dirección web pública y segura, para que pueda abrir su interfaz web completa desde cualquier navegador, esté donde esté.

No hay que tocar nada en el router: ni redirección de puertos, ni reglas de firewall, ni IP estática. La aplicación del túnel se ejecuta en el equipo de MZAP y abre una conexión saliente hacia el servicio de túnel, que devuelve a MZAP las solicitudes de su navegador.

A través del túnel funciona todo, incluidos los medidores de nivel en tiempo real, el estado de reproducción, el progreso de las pistas, el volumen y el enrutamiento.

Esta guía cubre dos opciones:

Cloudflare Tunnelngrok
Ideal paraAcceso remoto permanentePruebas y sesiones cortas
NecesitaUn dominio gestionado por CloudflareSolo una cuenta gratuita
DirecciónLa suya propia, p. ej. mzap.yourdomain.comUna dirección ngrok-free.app
FuncionamientoComo servicio de Windows, sobrevive a los reiniciosMientras la ventana de ngrok esté abierta
CosteGratisPlan gratuito disponible

Nota: esta guía trata sobre el acceso desde el navegador. La conexión de la app móvil MZAP Remote o de un asistente de IA a través de un túnel se explicará en un artículo aparte.

Antes de empezar: active el inicio de sesión

No se salte este paso. En MZAP, el inicio de sesión está desactivado de forma predeterminada, porque en una red local cerrada no siempre hace falta. Un túnel pone MZAP en internet: sin inicio de sesión, cualquiera que encuentre la dirección obtiene el control total de su sistema de audio.

  1. En MZAP, abra la pestaña Usuarios.
  2. Haga clic en Crear, introduzca un nombre de usuario y una contraseña segura, y asigne el rol Administrador.
  3. Haga clic en Habilitar Autenticación y confirme.
  4. Para las personas que se conectarán de forma remota, cree cuentas independientes con el rol Operador (puede controlar la reproducción y el volumen) o Visor (solo puede ver). También puede limitar cada cuenta a reproductores y zonas concretos.

Vuelva a cargar MZAP: ahora debería aparecer un cuadro de inicio de sesión. Consulte Users & Access en la documentación para conocer los detalles sobre roles y asignaciones.

El puerto de MZAP: ambos túneles apuntan al puerto 5000, que sirve la interfaz web de MZAP. Si cambió el puerto de la API en la configuración de MZAP, use el suyo.

Opción A: Cloudflare Tunnel (recomendada)

Úsela para tener acceso remoto permanente. Obtiene una dirección estable en su propio dominio, Cloudflare se encarga del HTTPS y el túnel se inicia automáticamente con Windows.

Necesita: una cuenta gratuita de Cloudflare y un dominio cuyo DNS esté gestionado por Cloudflare. Si su dominio está en otro registrador, puede añadirlo a Cloudflare gratis y cambiar sus servidores de nombres. Cloudflare le guía en el proceso al añadir un dominio.

1. Cree el túnel

  1. Inicie sesión en el panel de Cloudflare.
  2. Vaya a Networking → Tunnels y haga clic en Create a tunnel.
  3. Póngale un nombre fácil de reconocer, por ejemplo mzap-lobby, y haga clic en Create Tunnel.

2. Instale el conector en el equipo de MZAP

  1. Cuando se le pida el sistema operativo, elija Windows.

  2. Descargue e instale cloudflared desde el enlace que muestra el panel.

  3. Copie el comando de instalación del panel. Tiene este aspecto, con su propio token largo al final:

    cloudflared.exe service install eyJhIjoi...
  4. En el equipo de MZAP, abra el Símbolo del sistema como administrador (clic derecho → Ejecutar como administrador), pegue el comando y pulse Intro.

  5. De vuelta en el panel, espere a que el túnel aparezca como connected y haga clic en Continue.

El conector ya funciona como servicio de Windows. Se inicia con Windows y se vuelve a conectar por sí solo tras un corte de red.

3. Dé a MZAP una dirección pública

  1. En la pestaña Routes del túnel, haga clic en Add route → Published application.
  2. Hostname: introduzca un subdominio, por ejemplo mzap, y elija su dominio de la lista.
  3. Service URL: introduzca http://localhost:5000
  4. Haga clic en Save.

En menos de un minuto, abra https://mzap.yourdomain.com en cualquier navegador, inicie sesión y listo.

Evite los “Quick Tunnels” para MZAP. Cloudflare también ofrece túneles instantáneos en direcciones aleatorias trycloudflare.com, sin necesidad de cuenta. La página se abre, pero no admiten las actualizaciones en tiempo real que usa MZAP: los medidores y el estado de reproducción se quedan congelados. Use un túnel con nombre, como se describe arriba.

Opción B: ngrok (la más rápida para probar)

ngrok es la forma más rápida de probar el acceso remoto. No necesita un dominio y se configura en unos cinco minutos.

1. Cree una cuenta gratuita

  1. Regístrese en ngrok.com.
  2. En el panel de ngrok, abra Your Authtoken y copie el token.

2. Instale ngrok en el equipo de MZAP

Abra el Símbolo del sistema o PowerShell y ejecute:

winget install ngrok.ngrok

O bien descargue ngrok para Windows desde ngrok.com/download y descomprímalo. Si usa el zip, ejecute los comandos siguientes desde la carpeta que contiene ngrok.exe.

3. Conecte ngrok a su cuenta

Solo tiene que hacerlo una vez:

ngrok config add-authtoken YOUR_TOKEN

4. Inicie el túnel

ngrok http 5000

ngrok muestra una línea Forwarding con una dirección del tipo https://xxxx.ngrok-free.app. Abra esa dirección en cualquier navegador, inicie sesión y listo.

El túnel permanece abierto mientras esta ventana esté abierta. Pulse Ctrl+C para cerrarlo: la dirección deja de funcionar de inmediato.

Consejos:

  • Mantener la misma dirección: con el plan gratuito, la dirección puede cambiar cada vez que inicia ngrok. En el panel de ngrok, en Domains, puede reservar una dirección fija e iniciar el túnel con ngrok http 5000 --url=https://your-name.ngrok-free.app.
  • Ver qué está pasando: mientras ngrok se ejecuta, abra http://127.0.0.1:4040 en el equipo de MZAP para ver las solicitudes que pasan por el túnel.
  • “ERR_NGROK_121” / “agent version is too old”: su versión de ngrok está desactualizada. Ejecute ngrok update, o winget upgrade ngrok.ngrok si lo instaló con winget, y vuelva a intentarlo.
  • Para un acceso permanente, use Cloudflare Tunnel. ngrok es más adecuado para sesiones en las que hay alguien pendiente.

Lista de comprobación de seguridad

  • ✅ El inicio de sesión está activado en MZAP y la contraseña del Administrador es segura y única.
  • ✅ Las personas remotas usan cuentas de Operador o Visor, no la cuenta de Administrador.
  • ✅ Cada persona tiene su propia cuenta, así puede eliminar una sin afectar a las demás.
  • ✅ Cierre los túneles que no necesite. Detenga ngrok con Ctrl+C; pause o elimine un túnel de Cloudflare desde el panel.
  • ✅ Comparta la dirección solo con quien la necesite.

Para una protección adicional con Cloudflare, puede colocar Cloudflare Access delante de MZAP, de modo que los visitantes también tengan que confirmar su correo electrónico antes de llegar a la página de inicio de sesión de MZAP. Consulte la documentación de Cloudflare para configurarlo.

Solución de problemas

  • La página no carga: compruebe que MZAP se está ejecutando y que http://localhost:5000 se abre en el propio equipo de MZAP.
  • Cloudflare muestra el error 502 o 1033: el conector no puede llegar a MZAP o no se está ejecutando. Compruebe en Servicios de Windows que el servicio Cloudflared está en ejecución y que el Service URL es http://localhost:5000.
  • Los medidores y el estado no se mueven: probablemente está usando un Quick Tunnel de Cloudflare (trycloudflare.com). Cambie a un túnel con nombre.
  • No aparece el cuadro de inicio de sesión: el inicio de sesión aún no está activado. Vuelva a Antes de empezar.

¿Tiene preguntas o una configuración que no encaja en esta guía? Contáctenos. Estaremos encantados de ayudarle.