Добавление вашего первого сайта

В ServBay добавить новый сайт для запуска локального проекта просто и интуитивно понятно. В этом документе подробно описано, как шаг за шагом создать свой первый сайт в ServBay: вы узнаете все этапы, важные параметры и получите практические советы.

ServBay гибко поддерживает любые варианты — разработку на PHP, Node.js, статических сайтов, а также настройку обратного прокси или редиректов.

Обзор

ServBay создан, чтобы предоставить веб-разработчикам мощную и удобную в управлении локальную среду разработки. Дружелюбный графический интерфейс (GUI) позволяет вам легко добавлять, настраивать и управлять несколькими локальными сайтами. Следуя простым шагам ниже, вы сможете быстро создать свой первый сайт и оптимально его настроить для собственного проекта.

Необходимые условия

Перед началом убедитесь, что:

• Вы успешно установили и запустили приложение ServBay на macOS.

Шаги по добавлению сайта

Ниже приведена пошаговая инструкция по добавлению нового сайта через GUI ServBay:

Шаг 1: Откройте приложение ServBay

Найдите иконку ServBay в папке приложений macOS и дважды щёлкните для запуска.

Шаг 2: Перейдите в раздел управления сайтами

После запуска ServBay вы увидите главное окно. В левом навигационном меню выберите пункт Сайты — это откроет страницу управления сайтами в ServBay.

Шаг 3: Начните добавление нового сайта

На странице управления сайтами найдите и нажмите кнопку + в левом нижнем углу. После этого справа откроется новая форма для ввода параметров будущего сайта.

Шаг 4: Настройте параметры сайта

В появившейся форме настройки укажите или выберите следующие важные параметры:

1. Название: Придумайте понятное и легко различимое название для сайта. Оно будет использоваться только внутри ServBay для удобства управления и различения разных сайтов.
2. Домен: Укажите домен, по которому вы хотите локально открывать этот сайт. Чтобы избежать конфликтов с реальными доменами, настоятельно рекомендуется использовать .demo или другие локальные TLD, предлагаемые ServBay, например, servbay.demo или myproject.servbay.demo. ServBay автоматически настроит локальный DNS, чтобы вы могли открывать сайт через этот домен в браузере.
3. Протокол: Выберите поддерживаемый протокол. Обычно используется HTTP/HTTPS по умолчанию, и ServBay автоматически позаботится о локальной конфигурации HTTPS.
4. Тип запроса SSL-сертификата: Настройте шифрование сайта с помощью SSL/TLS.
   • ServBay CA: Рекомендуется для локальной разработки. ServBay автоматически создаст и будет управлять SSL-сертификатом, выданным встроенным PKI CA. Вам нужно просто доверить корневой сертификат (ServBay User CA или ServBay Public CA) в системе, чтобы получить HTTPS-доступ без предупреждений в браузере.
   • ACME: Если необходимо смоделировать рабочую среду, можно воспользоваться протоколом ACME (например, Let's Encrypt, ZeroSSL, Google Trust Services и т.д.), чтобы получить реальный общедоверенный сертификат для вашего локального домена (если он публичен и направлен на ваш локальный ServBay). ServBay поддерживает автоматическую выдачу и обновление сертификатов через ACME.
5. Тип сайта: Выберите подходящий тип сайта в зависимости от стека технологий:
   • PHP: Для проектов на PHP (WordPress, Laravel, Symfony и др.). ServBay сконфигурирует веб-сервер (Nginx или Apache) совместно с PHP-FPM для обработки PHP-запросов.
   • Node.js: Для приложений на Node.js. ServBay обычно настраивает обратный прокси, который направляет HTTP-запросы на порт, прослушиваемый вашим приложением.
   • Статический: Для сайтов только на HTML, CSS, JS и других статических файлах. Файлы отдаются напрямую через веб-сервер.
   • Обратный прокси: Позволяет проксировать запросы с выбранного домена или пути на другие локальные либо удалённые адреса и порты. Полезно для интеграции с внешними сервисами.
   • Редирект: Все запросы к этому домену перенаправляются на другой URL.
6. Версия PHP: Если выбран тип PHP, выберите версию PHP из выпадающего списка — она должна быть установлена и запущена через менеджер пакетов ServBay.
7. Правила URL-резрайтинга (псевдостатические): Большинство современных фреймворков и CMS используют резрайтинг для красивых URL (например, /about вместо /index.php?page=about). ServBay предлагает готовые пресеты для популярных систем (Laravel, WordPress, Discuz! и др.), которые можно применить одним кликом. Для кастомных или малоизвестных фреймворков потребуется вручную отредактировать конфигурацию веб-сервера (Nginx или Apache).
8. Корневая директория: Укажите физический путь к файлам сайта. Это стартовая директория, из которой веб-сервер будет обслуживать контент. Рекомендуется размещать проект в стандартной папке ServBay www, например, /Applications/ServBay/www/servbay-demo. Проверьте, что директория существует, и процесс ServBay имеет туда доступ на чтение.

WARNING

Для разработчиков, использующих фреймворки (например, Laravel), обязательно указывайте корневой каталог на директорию public, где находится index.php, а не на корень всего проекта.

Шаг 5: Сохраните и активируйте сайт

Проверьте введенные параметры и нажмите кнопку Добавить внизу формы. ServBay автоматически сгенерирует и применит конфигурации для веб-сервера (Nginx или Apache) и обновит локальные DNS-записи.

После успешного сохранения сайт появится в списке. Для быстрого перехода откройте сайт в браузере с помощью иконки в правом верхнем углу.

Шаг 6: Удобные быстрые действия с сайтом

Для каждого сайта в списке ServBay предоставляются удобные кнопки управления, что упрощает ваш рабочий процесс:

1. Открыть в IDE: Открывает корневую директорию сайта в назначенном редакторе или IDE.
2. Открыть в браузере: Запускает URL сайта в вашем браузере по умолчанию.
3. Посмотреть логи сайта: Быстрый доступ к логам веб-сервера для указанного сайта (как к access, так и к error), что удобно для отладки.
4. Приостановить/Запустить сайт: Временно отключает или включает доступ к сайту.
5. Удалить сайт: Удаляет из ServBay конфигурацию сайта (файлы сайта при этом не удаляются).

Простой пример: создание статического HTML-сайта

Чтобы убедиться, что ваш первый сайт настроен верно, выполните быструю проверку:

1. Добавьте новый сайт по описанным выше шагам — например, укажите домен servbay.demo, выберите тип Статический, а корневую директорию /Applications/ServBay/www/servbay-demo-static.

2. Создайте эту директорию в файловой системе: /Applications/ServBay/www/servbay-demo-static.

3. В этом каталоге создайте файл index.html.

4. Откройте index.html в любом текстовом редакторе и вставьте следующий код:

   <!DOCTYPE html>
   <html>
   <head>
       <title>ServBay Static Test</title>
   </head>
   <body>
       <h1>Поздравляем! Ваш первый сайт на ServBay успешно запущен!</h1>
       <p>Если вы видите эту страницу, значит ServBay корректно настроен и обслуживает ваш статический сайт.</p>
   </body>
   </html>

5. Сохраните файл index.html.

6. Вернитесь в раздел управления сайтами ServBay, найдите созданный сайт servbay.demo и кликните на иконку браузера.

7. Ваш браузер должен автоматически открыть http://servbay.demo (или https://servbay.demo — в зависимости от SSL-настроек) и отобразить содержимое вашей страницы index.html.

Важные замечания

• Конфликт доменов: Избегайте использования доменов, конфликтующих с внутренними сетями или VPN. .demo — безопасный выбор.
• Права на директории: Убедитесь, что пользователь, под которым запускается ServBay (обычно ваш текущий), имеет права на чтение в выбранной папке и поддиректориях.
• Занятые порты: ServBay по умолчанию использует стандартные порты (HTTP 80, HTTPS 443). Если эти порты заняты другими программами, веб-сервер ServBay может не запуститься, и сайт будет недоступен. Освободите порты при необходимости.
• Доверие к CA ServBay: Для корректной работы HTTPS без предупреждений вручную доверьте корневой сертификат ServBay CA на вашем Mac. В официальной документации ServBay описано, как это сделать шаг за шагом.

Часто задаваемые вопросы (FAQ)

• Q: Почему при открытии сайта вижу ошибку HTTP Error 403 - Forbidden или HTTP Error 404 - File not found?
  • A: Это наиболее частая ошибка среди разработчиков.
  • Сначала проверьте, правильно ли указан корневой каталог сайта. Во многих современных фреймворках (Laravel, Symfony, CakePHP и др.) корень проекта (где находятся vendor, composer.json, package.json) не является корнем сайта/точкой входа.
  • Поэтому укажите корневую директорию сайта именно на папку, где размещён входной файл (index.php, index.htm, index.html).
  • Наиболее частые директории для входных файлов: public, web, www, htdocs, wwwroot, webroot и аналогичные.
• Q: Добавил сайт, но в браузере сообщение «Сайт недоступен» или «Соединение отклонено»?
  • A: Проверьте, запущен ли ServBay и работают ли веб-серверы (Caddy/Nginx/Apache) — это отображается в главном окне ServBay.
  • Убедитесь, что домен в браузере и в настройке сайта совпадают.
  • Проверьте, что сайт активен (не приостановлен) в списке сайтов ServBay.
  • Проверьте корректность указанного корневого пути, присутствует ли входной файл (index.html, index.php и пр.).
  • Убедитесь, что порты 80 и 443 не заняты другими программами.
• Q: Мой PHP-сайт не работает — показана пустая страница или скачивается файл?
  • A: Убедитесь, что в конфигурации сайта выбрана правильная версия PHP, что она установлена и включена через менеджер пакетов ServBay.
  • Проверьте права на файлы в корневой директории сайта.
  • Посмотрите логи сайта на предмет ошибок PHP (через быстрые действия).
  • Убедитесь, что в проекте есть index.php или другой файл — точка входа, настроенная по умолчанию в ServBay.
• Q: После настройки HTTPS браузер выводит предупреждение о сертификате?
  • A: Если вы используете ServBay CA, удостоверьтесь, что корневой сертификат добавлен в доверенные системы/браузеры. В официальной документации есть пошаговая инструкция по установке и доверию CA.
  • Если используете ACME, проверьте, что домен корректно резолвится на вашу машину и что сертификат успешно выдан и установлен. Детали процесса выпуска смотрите в логах ServBay.
• Q: Не работают URL-резрайты, некоторые страницы недоступны?
  • A: Проверьте, что в настройках сайта выбран резрайтинг для вашего фреймворка.
  • Для Apache — убедитесь в наличии файла .htaccess в корне или нужной папке и в соответствующих правах к нему, а также, что в конфиге Apache разрешён его учёт.
  • Для Nginx или Caddy резрайты настраиваются в авто-конфиге — проверьте, что нужные правила были загружены.

Итоги

Следуя этим шагам, вы должны успешно добавить и запустить свой первый сайт во встроенной среде разработки ServBay. Мощные инструменты управления сайтами, гибкие настройки (SSL, тип сайта, версия PHP, резрайты) и удобные быстрые действия значительно повысят вашу продуктивность на локальной машине. Продолжайте изучать дополнительные возможности ServBay (менеджер пакетов, БД и др.), чтобы выстроить полный и комфортный процесс локальной разработки.