Управляйте MZAP откуда угодно через Cloudflare Tunnel или ngrok

Нужно сменить музыку на объекте, где вас сейчас нет, поправить расписание из дома или проверить, что играет в другом здании? Туннель даёт Multi Zone Audio Player (MZAP 7) защищённый публичный веб-адрес, так что вы можете открыть его полный веб-интерфейс в любом браузере, откуда угодно.

На роутере ничего менять не нужно: никакого проброса портов, никаких правил брандмауэра, никакого статического IP-адреса. Программа туннеля работает на компьютере с MZAP и сама устанавливает исходящее соединение со службой туннеля, которая передаёт запросы вашего браузера обратно в MZAP.

Через туннель работает всё, включая живые индикаторы уровня, состояние воспроизведения, прогресс трека, громкость и маршрутизацию.

В этом руководстве рассмотрены два варианта:

	Cloudflare Tunnel	ngrok
Лучше всего подходит для	Постоянного удалённого доступа	Попробовать, коротких сеансов
Что нужно	Домен, которым управляет Cloudflare	Только бесплатная учётная запись
Адрес	Ваш собственный, напр. `mzap.yourdomain.com`	Адрес на `ngrok-free.app`
Как работает	Как служба Windows, переживает перезагрузки	Пока открыто окно ngrok
Стоимость	Бесплатно	Есть бесплатный тариф

Примечание: это руководство посвящено доступу через браузер. Подключение мобильного приложения MZAP Remote или ИИ-ассистента через туннель мы опишем в отдельной статье.

Прежде чем начать: включите вход по паролю

Не пропускайте этот шаг. По умолчанию вход по паролю в MZAP выключен, потому что в закрытой локальной сети он нужен не всегда. Туннель выводит MZAP в интернет: без входа по паролю любой, кто найдёт адрес, получит полный контроль над вашей аудиосистемой.

Интерфейс MZAP пока не переведён на русский язык, поэтому ниже названия кнопок и ролей приведены на английском — так, как вы увидите их в программе.

В MZAP откройте вкладку Users (Пользователи).
Нажмите Create (Создать), введите имя пользователя и надёжный пароль и выберите роль Admin (администратор с полным доступом).
Нажмите Enable Authentication (Включить аутентификацию) и подтвердите.
Для тех, кто будет подключаться удалённо, создайте отдельные учётные записи с ролью Operator (может управлять воспроизведением и громкостью) или Viewer (может только просматривать). Также можно ограничить каждую учётную запись только определёнными плеерами и зонами.

Перезагрузите MZAP: теперь должно появиться окно входа. Подробнее о ролях и назначениях читайте в разделе Пользователи и доступ документации.

Порт MZAP: оба туннеля направлены на порт 5000, на котором работает веб-интерфейс MZAP. Если вы меняли порт API в настройках MZAP, укажите свой порт.

Вариант A: Cloudflare Tunnel (рекомендуется)

Этот вариант подходит для постоянного удалённого доступа. Вы получаете стабильный адрес на собственном домене, HTTPS настраивается автоматически, а туннель запускается вместе с Windows.

Что нужно: бесплатная учётная запись Cloudflare и домен, DNS которого управляет Cloudflare. Если ваш домен зарегистрирован у другого регистратора, его можно бесплатно добавить в Cloudflare и сменить серверы имён (nameservers). При добавлении домена Cloudflare пошагово подскажет, как это сделать.

1. Создайте туннель

Войдите в панель управления Cloudflare.
Перейдите в Networking → Tunnels и нажмите Create a tunnel.
Дайте туннелю понятное имя, например mzap-lobby, и нажмите Create Tunnel.

2. Установите коннектор на компьютер с MZAP

Когда вас спросят об операционной системе, выберите Windows.
Скачайте и установите cloudflared по ссылке, которую показывает панель.
Скопируйте из панели команду установки. Она выглядит примерно так, только с вашим длинным токеном в конце:
```
cloudflared.exe service install eyJhIjoi...
```
На компьютере с MZAP откройте командную строку от имени администратора (щелчок правой кнопкой мыши → Запуск от имени администратора), вставьте команду и нажмите Enter.
Вернитесь в панель, дождитесь, пока туннель получит статус connected, и нажмите Continue.

Теперь коннектор работает как служба Windows. Он запускается вместе с Windows и сам переподключается после сбоя сети.

3. Дайте MZAP публичный адрес

На вкладке туннеля Routes нажмите Add route → Published application.
Hostname: введите поддомен, например mzap, и выберите свой домен из списка.
Service URL: введите http://localhost:5000
Нажмите Save.

Примерно через минуту откройте https://mzap.yourdomain.com в любом браузере, войдите — и готово.

Не используйте «Quick Tunnels» для MZAP. Cloudflare также предлагает мгновенные туннели на случайных адресах trycloudflare.com без учётной записи. Страница через них открывается, но они не поддерживают обновления в реальном времени, которые использует MZAP: индикаторы и состояние воспроизведения замирают. Используйте именованный туннель, как описано выше.

Вариант B: ngrok (быстрее всего попробовать)

ngrok — самый быстрый способ проверить удалённый доступ. Домен не нужен, а вся настройка занимает около пяти минут.

1. Создайте бесплатную учётную запись

Зарегистрируйтесь на ngrok.com.
В панели управления ngrok откройте Your Authtoken и скопируйте токен.

2. Установите ngrok на компьютер с MZAP

Откройте командную строку или PowerShell и выполните:

winget install ngrok.ngrok

Или скачайте ngrok для Windows с ngrok.com/download и распакуйте архив. Если вы используете zip-архив, выполняйте приведённые ниже команды из папки, в которой лежит ngrok.exe.

3. Подключите ngrok к своей учётной записи

Это нужно сделать только один раз:

ngrok config add-authtoken YOUR_TOKEN

4. Запустите туннель

ngrok http 5000

ngrok покажет строку Forwarding с адресом вида https://xxxx.ngrok-free.app. Откройте этот адрес в любом браузере, войдите — и готово.

Туннель работает, пока открыто это окно. Нажмите Ctrl+C, чтобы закрыть его, — адрес сразу перестанет работать.

Советы:

Как сохранить тот же адрес: на бесплатном тарифе адрес может меняться при каждом запуске ngrok. В панели управления ngrok в разделе Domains можно получить постоянный адрес, а затем запускать туннель командой ngrok http 5000 --url=https://your-name.ngrok-free.app.
Как увидеть, что происходит: пока ngrok работает, откройте http://127.0.0.1:4040 на компьютере с MZAP — там видны запросы, проходящие через туннель.
«ERR_NGROK_121» / «agent version is too old»: ваша версия ngrok устарела. Выполните ngrok update (или winget upgrade ngrok.ngrok, если устанавливали через winget) и попробуйте снова.
Для постоянного доступа используйте Cloudflare Tunnel. ngrok лучше всего подходит для сеансов, во время которых кто-то следит за работой.

Контрольный список безопасности

✅ Вход по паролю включён в MZAP, а пароль Admin надёжный и нигде больше не используется.
✅ Удалённые пользователи работают под учётными записями Operator или Viewer, а не под учётной записью Admin.
✅ У каждого человека своя учётная запись, так что вы можете удалить одну, не затрагивая остальных.
✅ Закрывайте туннели, которые вам не нужны. Останавливайте ngrok клавишами Ctrl+C; приостанавливайте или удаляйте туннель Cloudflare в панели управления.
✅ Сообщайте адрес только тем, кому он действительно нужен.

Для дополнительной защиты с Cloudflare можно поставить Cloudflare Access перед MZAP — тогда посетителям придётся ещё и подтвердить свою электронную почту, прежде чем они попадут на страницу входа MZAP. Как это настроить, смотрите в документации Cloudflare.

Устранение неполадок

Страница не загружается: проверьте, что MZAP запущен и что http://localhost:5000 открывается на самом компьютере с MZAP.
Cloudflare показывает ошибку 502 или 1033: коннектор не может связаться с MZAP или не запущен. Проверьте, что служба Cloudflared работает (в окне «Службы» Windows) и что Service URL имеет значение http://localhost:5000.
Индикаторы и состояние не меняются: скорее всего, вы используете Cloudflare Quick Tunnel (trycloudflare.com). Перейдите на именованный туннель.
Окно входа не появляется: вход по паролю ещё не включён. Вернитесь к разделу Прежде чем начать.

Есть вопросы или ваша конфигурация не вписывается в это руководство? Свяжитесь с нами. Мы с радостью поможем.