Керуйте 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 відкрийте вкладку Користувачі.
Натисніть Створити, введіть ім’я користувача й надійний пароль і встановіть роль Admin.
Натисніть Увімкнути автентифікацію й підтвердьте.
Для тих, хто підключатиметься віддалено, створіть окремі облікові записи з роллю 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). Перейдіть на іменований тунель.
Вікно входу не з’являється: вхід за паролем ще не ввімкнено. Поверніться до розділу Перш ніж почати.

Маєте запитання або ваша конфігурація не вписується в цей посібник? Зв’яжіться з нами. Ми радо допоможемо.