Часті питання щодо ServBay

Під час користування локальним середовищем веб-розробки ServBay розробники можуть зіштовхнутися з певними труднощами. У цьому документі наведено відповіді на два найпоширеніші питання: як оновити ServBay Runtime та як вирішити проблему недоступності локальних сайтів ServBay при використанні проксі-інструментів, таких як ClashX Pro.

Як оновити ServBay Runtime?

ServBay Runtime є ключовим компонентом ServBay, що забезпечує стабільну роботу платформи та розміщених сервісів. При виході нової версії, під час запуску ServBay з’являється нагадування про необхідність оновлення. Вчасне оновлення Runtime підвищує продуктивність, стабільність та забезпечує сумісність з іншими компонентами.

Щоб оновити ServBay Runtime, виконайте такі кроки:

1. Відкрийте програму ServBay.
2. У лівій панелі навігації оберіть Пакети > Загальні сервіси.
3. На правій панелі знайдіть пункт ServBay Runtime.
4. Якщо для ServBay Runtime доступне оновлення, з’явиться жовте повідомлення або кнопка для оновлення. Натисніть цю жовту кнопку оновлення.
5. ServBay завантажить і встановить останню версію Runtime. Зачекайте, поки завершиться процес оновлення.

Після завершення оновлення ServBay Runtime працюватиме в останній версії, що забезпечить підвищену стабільність і продуктивність.

Чому після використання ClashX Pro (або інших проксі-інструментів) локальні сайти ServBay стали недоступними?

Багато розробників використовують ServBay для локальної розробки та тестування, часто налаштовуючи власні домени (наприклад, servbay.demo, myproject.servbay.demo тощо), які зазвичай вказують на локальний IP-адрес 127.0.0.1.

Під час роботи з ClashX Pro або іншими VPN/проксі-інструментами (на зразок Surge, Quantumult X тощо) ці сервіси можуть "перехоплювати" або перенаправляти DNS-запити – змушуючи всі домени проходити через власні проксі-сервери. Подібна поведінка обходить стандартний процес DNS на вашій операційній системі та ігнорує локальні налаштування файлу hosts (система, на якій базується розпізнавання доменів у ServBay). В результаті, локальні домени, вказані у ServBay, не можуть бути коректно оброблені та спрямовані на локальний IP, а ваш сайт стає недоступним.

Щоб вирішити цю проблему, потрібно у налаштуваннях проксі-інструменту створити правило, яке вказуватиме не проксувати ваші локальні домени і не перехоплювати їх DNS-запити. Зазвичай це виконується через списки "Обхід проксі", "Білий список", "Список виключень" – назва залежить від конкретної програми.

Розглянемо налаштування на прикладі ClashX Pro:

1. Запустіть додаток ClashX Pro.
2. На панелі меню macOS відшукайте іконку ClashX Pro, натисніть на неї та оберіть Більше налаштувань.
3. У вікні налаштувань перейдіть на вкладку Загальні.
4. Знайдіть поле з назвою на кшталт Ігнорувати проксі для таких хостів й доменів.
5. Додайте адреси ваших локальних доменів. Для роботи з доменами ServBay радимо вказати localhost, 127.0.0.1 та конкретні домени чи шаблони (wildcards), які ви використовуєте у ServBay. Наприклад, якщо у вас використовується закінчення .servbay.demo, введіть *.servbay.demo. Кілька записів зазвичай розділяються комою , або перенесенням рядка. Типовий список виглядає так:

   localhost, 127.0.0.1, *.servbay.demo, yourproject.servbay.demo

6. Збережіть зміни — у разі потреби застосуйте або перезавантажте налаштування згідно підказок ClashX Pro.

(Ілюстрація: налаштування ігнорування проксі для хостів та доменів у ClashX Pro)

Після виконання цих дій ClashX Pro більше не буде втручатися у розпізнавання зазначених локальних доменів, і доступ до локальних сайтів ServBay має відновитися. Якщо проблема залишилась, перевірте правильність вводу домену у налаштуваннях розділу Веб-сайти у ServBay та переконайтеся, що відповідні служби (наприклад, Caddy або Nginx) працюють нормально. Також можна скористатись командами терміналу ping yourproject.servbay.demo чи dig yourproject.servbay.demo для діагностики розпізнавання домену.