Controle o MZAP de qualquer lugar com Cloudflare Tunnel ou ngrok

Precisa trocar a música em um local onde você não está, ajustar uma programação de casa ou conferir o que está tocando em outro prédio? Um túnel dá ao Multi Zone Audio Player (MZAP 7) um endereço web público e seguro, para que você abra a interface web completa de qualquer navegador, de qualquer lugar.

Não é preciso mudar nada no roteador: nada de redirecionamento de portas, regras de firewall ou IP fixo. O aplicativo do túnel roda no computador do MZAP e abre uma conexão de saída com o serviço de túnel, que repassa ao MZAP as solicitações do seu navegador.

Tudo funciona pelo túnel, incluindo os medidores de nível em tempo real, o status de reprodução, o progresso das faixas, o volume e o roteamento.

Este guia apresenta duas opções:

	Cloudflare Tunnel	ngrok
Ideal para	Acesso remoto permanente	Testes e sessões curtas
Você precisa de	Um domínio gerenciado pela Cloudflare	Apenas uma conta gratuita
Endereço	O seu próprio, por ex. `mzap.yourdomain.com`	Um endereço `ngrok-free.app`
Funcionamento	Como serviço do Windows, continua após reinicializações	Enquanto a janela do ngrok estiver aberta
Custo	Gratuito	Plano gratuito disponível

Observação: este guia trata do acesso pelo navegador. A conexão do aplicativo móvel MZAP Remote ou de um assistente de IA por meio de um túnel será abordada em um artigo separado.

Não pule esta etapa. O login vem desativado por padrão no MZAP, porque em uma rede local fechada nem sempre é necessário. Um túnel coloca o MZAP na internet: sem login, qualquer pessoa que descobrir o endereço terá controle total do seu sistema de áudio.

No MZAP, abra a aba Usuários.
Clique em Criar, informe um nome de usuário e uma senha forte e defina o perfil como Administrador.
Clique em Ativar Autenticação e confirme.
Para quem vai se conectar remotamente, crie contas separadas com o perfil Operador (pode controlar a reprodução e o volume) ou Visualizador (pode apenas acompanhar). Você também pode limitar cada conta a players e zonas específicos.

Recarregue o MZAP: agora deve aparecer uma janela de login. Veja Users & Access na documentação para mais detalhes sobre perfis e atribuições.

A porta do MZAP: os dois túneis apontam para a porta 5000, que serve a interface web do MZAP. Se você mudou a porta da API nas configurações do MZAP, use a sua.

Opção A: Cloudflare Tunnel (recomendada)

Use esta opção para acesso remoto permanente. Você ganha um endereço estável no seu próprio domínio, o HTTPS é cuidado para você e o túnel inicia automaticamente com o Windows.

Você precisa de: uma conta gratuita da Cloudflare e um domínio cujo DNS seja gerenciado pela Cloudflare. Se o seu domínio estiver em outro registrador, você pode adicioná-lo à Cloudflare gratuitamente e trocar os servidores de nomes. A Cloudflare orienta você nesse processo ao adicionar um domínio.

1. Crie o túnel

Faça login no painel da Cloudflare.
Vá em Networking → Tunnels e clique em Create a tunnel.
Dê um nome fácil de reconhecer, por exemplo mzap-lobby, e clique em Create Tunnel.

2. Instale o conector no computador do MZAP

Quando for solicitado o sistema operacional, escolha Windows.
Baixe e instale o cloudflared pelo link exibido no painel.
Copie o comando de instalação do painel. Ele é parecido com este, com o seu token longo no final:
```
cloudflared.exe service install eyJhIjoi...
```
No computador do MZAP, abra o Prompt de Comando como administrador (clique com o botão direito → Executar como administrador), cole o comando e pressione Enter.
De volta ao painel, aguarde até o túnel aparecer como connected e clique em Continue.

Agora o conector roda como serviço do Windows. Ele inicia com o Windows e se reconecta sozinho depois de uma queda de rede.

3. Dê ao MZAP um endereço público

Na aba Routes do túnel, clique em Add route → Published application.
Hostname: informe um subdomínio, por exemplo mzap, e escolha o seu domínio na lista.
Service URL: informe http://localhost:5000
Clique em Save.

Em até um minuto, abra https://mzap.yourdomain.com em qualquer navegador, faça login e pronto.

Evite os “Quick Tunnels” com o MZAP. A Cloudflare também oferece túneis instantâneos em endereços aleatórios trycloudflare.com, sem precisar de conta. A página abre, mas eles não suportam as atualizações em tempo real que o MZAP usa: os medidores e o status de reprodução ficam congelados. Use um túnel nomeado, como descrito acima.

Opção B: ngrok (a mais rápida para testar)

O ngrok é a forma mais rápida de testar o acesso remoto. Você não precisa de domínio, e leva cerca de cinco minutos.

1. Crie uma conta gratuita

Cadastre-se em ngrok.com.
No painel do ngrok, abra Your Authtoken e copie o token.

2. Instale o ngrok no computador do MZAP

Abra o Prompt de Comando ou o PowerShell e execute:

winget install ngrok.ngrok

Ou baixe o ngrok para Windows em ngrok.com/download e descompacte o arquivo. Se usar o zip, execute os comandos abaixo a partir da pasta que contém o ngrok.exe.

3. Conecte o ngrok à sua conta

Você só precisa fazer isso uma vez:

ngrok config add-authtoken YOUR_TOKEN

4. Inicie o túnel

ngrok http 5000

O ngrok exibe uma linha Forwarding com um endereço como https://xxxx.ngrok-free.app. Abra esse endereço em qualquer navegador, faça login e pronto.

O túnel fica aberto enquanto esta janela estiver aberta. Pressione Ctrl+C para fechá-lo, e o endereço para de funcionar na hora.

Dicas:

Manter o mesmo endereço: no plano gratuito, o endereço pode mudar a cada vez que você inicia o ngrok. No painel do ngrok, em Domains, você pode reservar um endereço fixo e depois iniciar o túnel com ngrok http 5000 --url=https://your-name.ngrok-free.app.
Ver o que está acontecendo: com o ngrok em execução, abra http://127.0.0.1:4040 no computador do MZAP para acompanhar as solicitações que passam pelo túnel.
“ERR_NGROK_121” / “agent version is too old”: o seu ngrok está desatualizado. Execute ngrok update, ou winget upgrade ngrok.ngrok se você o instalou pelo winget, e tente de novo.
Para acesso permanente, use o Cloudflare Tunnel. O ngrok é mais indicado para sessões em que alguém está acompanhando.

Checklist de segurança

✅ O login está ativado no MZAP, e a senha do Administrador é forte e exclusiva.
✅ Quem acessa remotamente usa contas de Operador ou Visualizador, não a conta de Administrador.
✅ Cada pessoa tem a sua própria conta, assim você pode remover uma sem afetar as outras.
✅ Feche os túneis de que não precisa. Pare o ngrok com Ctrl+C; pause ou exclua um túnel da Cloudflare no painel.
✅ Compartilhe o endereço apenas com quem precisa dele.

Para uma proteção extra com a Cloudflare, você pode colocar o Cloudflare Access na frente do MZAP, para que os visitantes também precisem confirmar o e-mail antes de chegar à página de login do MZAP. Consulte a documentação da Cloudflare para a configuração.

Solução de problemas

A página não carrega: verifique se o MZAP está em execução e se http://localhost:5000 abre no próprio computador do MZAP.
A Cloudflare mostra o erro 502 ou 1033: o conector não consegue alcançar o MZAP ou não está em execução. Verifique em Serviços do Windows se o serviço Cloudflared está em execução e se o Service URL é http://localhost:5000.
Os medidores e o status não se mexem: você provavelmente está usando um Quick Tunnel da Cloudflare (trycloudflare.com). Mude para um túnel nomeado.
A janela de login não aparece: o login ainda não foi ativado. Volte para Antes de começar.

Dúvidas ou uma configuração que não se encaixa neste guia? Fale conosco. Teremos prazer em ajudar.

Antes de começar: ative o login