Часто задаваемые вопросы о ServBay

При использовании локальной среды Web-разработки ServBay разработчики могут сталкиваться с определёнными трудностями. В этом документе рассмотрены два популярных вопроса: как обновить ServBay Runtime и как устранить проблему с недоступностью локальных сайтов при использовании прокси-сервисов, таких как 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 и т. д.), которые обычно указывают на локальный адрес 127.0.0.1.

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

Чтобы решить эту проблему, необходимо добавить соответствующие правила в настройки прокси-программы, указав, что определённые локальные домены не должны обрабатываться прокси или их DNS-запросы не следует перехватывать. Обычно нужный результат достигается путём настройки правил "обхода прокси", "игнорирования прокси", "белого списка" или "исключений".

Рассмотрим пример на ClashX Pro:

1. Откройте приложение ClashX Pro.
2. В строке меню macOS найдите иконку ClashX Pro, кликните по ней и выберите Дополнительные настройки.
3. В открывшемся окне перейдите на вкладку Общие.
4. Найдите поле с названием Игнорировать настройки прокси для этих хостов и доменов (или похожее наименование).
5. Добавьте ваши локальные доменные имена в этот список. Для охвата всех доменов, используемых в ServBay, рекомендуется добавить localhost, 127.0.0.1, а также конкретные домены и подстановочные имена, используемые в вашей среде. Например, если в качестве суффикса локальных доменов вы используете .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, чтобы проверить разрешение доменного имени.