Добавление и настройка сайта на основе Docker-контейнера в ServBay

ServBay — это локальная среда для веб-разработки, специально созданная для macOS и поддерживающая различные языки и технологические стеки. Помимо прямого размещения сайтов с помощью встроенных пакетов ServBay (PHP, Node.js, Python, Go, Java, базы данных и др.), вы также можете запускать и управлять сайтами или сервисами внутри Docker-контейнеров. Такой подход обеспечивает максимальную гибкость, изоляцию среды и её воспроизводимость, что особенно важно для проектов со специфическими требованиями и зависимостями.

В этой статье вы узнаете, как добавить сайт, работающий в Docker-контейнере, в ServBay и интегрировать его в локальный процесс разработки с помощью функции обратного проксирования.

Обзор

Настроив ServBay в качестве обратного прокси, вы сможете перенаправлять запросы к определённым доменам на сервисы, работающие внутри Docker-контейнеров, используя их внутренние порты. ServBay берет на себя обработку входящего трафика (например, HTTPS-сертификаты, разрешение доменных имён и др.), в то время как Docker-контейнер обеспечивает выполнение вашего приложения. Такой подход совмещает удобное управление ServBay с мощными возможностями контейнеризации Docker.

Ниже описаны пошаговые действия по добавлению и настройке сайта на базе Docker-контейнера с помощью ServBay.

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

Перед началом убедитесь, что выполнены следующие условия:

1. Установлен и запущен ServBay: Вы успешно установили и запустили ServBay на macOS.
2. Установлен и работает Docker: На вашем Mac установлен Docker Desktop или другой вариант Docker, и его сервисы активны.
3. Готов образ Docker и контейнер: У вас уже создан или загружен образ Docker с вашим сайтом или приложением, и вы можете запустить контейнер на его основе.

Подробные шаги добавления сайта

Шаг 1: Подготовка и запуск Docker-контейнера

Для начала убедитесь, что ваш Docker-контейнер запущен, а внутренний сервис (например, веб-сервер) слушает определённый порт, который проброшен на хостовую машину (ваш macOS) с помощью соответствующей настройки портов Docker.

Например, если у вас простой контейнер с Nginx, где Nginx внутри контейнера слушает порт 80, вы можете запустить контейнер с помощью такой команды:

docker run -d --name my-nginx-servbay -p 8080:80 nginx

В этом примере внутри Docker-контейнера my-nginx-servbay Nginx слушает порт 80, а с помощью параметра -p 8080:80 этот порт пробрасывается на порт 8080 хостовой машины. ServBay будет обращаться именно к порту 8080 на вашей машине.

Убедитесь, что внутренний сервис контейнера слушает нужный порт и что этот порт правильно проброшен на хост, исходя из ваших сценариев и настроек Dockerfile.

Шаг 2: Откройте интерфейс управления ServBay

Откройте папку приложений на вашем Mac и дважды кликните по иконке ServBay, чтобы запустить интерфейс управления ServBay.

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

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

На иллюстрации: кликните на «Сайты» в навигации слева для перехода к управлению.

Шаг 4: Добавление нового сайта

В нижней части страницы управления сайтами находится кнопка с символом +. Нажмите её: справа появится форма для ввода данных нового сайта.

На иллюстрации: нажмите кнопку «+» внизу страницы для добавления сайта.

Шаг 5: Настройка параметров сайта

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

1. Название (Name): Введите понятное название сайта, например, Docker Nginx Demo. Это имя используется только для управления в ServBay.
2. Домен (Domain): Укажите желаемое доменное имя для доступа к сайту из браузера. Рекомендуется использовать домен с суффиксом .servbay.demo (например, docker.servbay.demo), чтобы избежать конфликтов с существующими публичными доменами. ServBay автоматически создаст запись в файле hosts и привяжет домен к адресу 127.0.0.1.
3. Протокол (Protocol): Выберите желаемый протокол. Как правило, достаточно оставить HTTP/HTTPS. ServBay будет слушать порты HTTP (80) и HTTPS (443), обрабатывая подключение согласно настройкам SSL.
4. Способ получения SSL-сертификата (SSL Certificate Request Method): Рекомендуется выбрать вариант ServBay CA. ServBay автоматически сгенерирует и управляет SSL-сертификатом, доверенным вашей системой, на основе ServBay User CA. Для полноценной работы HTTPS установите корневой сертификат ServBay Public CA в цепочку доверенных устройств на вашем Mac — это обеспечит доверие браузера к локальным сертификатам. При необходимости можно выбрать ACME (например, для Let's Encrypt) или Custom (для собственного сертификата).
5. Тип сайта (Website Type): [Ключевой параметр] — укажите Обратный прокси (Reverse Proxy). Это значит, что ServBay будет точкой входа для выбранного домена и будет проксировать запросы к указанному адресу бэкенда.
6. IP-адрес (IP Address): Введите адрес, на котором сервис Docker-контейнера отображается на хост-машине. В большинстве случаев это будет локальный адрес 127.0.0.1.
7. Порт (Port): Укажите порт, который вы пробросили с помощью Docker на хост-машине. Это значение соответствует <порт на хосте> из команды docker run -p <порт на хосте>:<порт в контейнере>. Например, если был указан -p 8080:80, здесь пишите 8080.

На иллюстрации: заполнение данных для сайта с обратным прокси на базе Docker.

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

После заполнения всех необходимых данных нажмите кнопку Добавить (Add) внизу формы.

ServBay автоматически добавит обратные прокси-правила в настройки веб-сервера (например, Caddy или Nginx) и обновит hosts-файл системы на вашем Mac, добавив туда нужное доменное имя.

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

Шаг 7: Откройте сайт и используйте быстрые действия

Когда сайт добавлен, вернитесь в раздел управления сайтами — вы увидите новую запись. Убедитесь, что статус указан как «Работает».

Теперь можете открыть свой сайт в браузере (например, http://docker.servbay.demo или https://docker.servbay.demo). Если всё настроено правильно, ServBay направит ваш запрос к сервису в Docker-контейнере, и страница откроется.

В списке сайтов ServBay доступны удобные быстрые действия:

1. Открыть корневую директорию сайта в IDE: (Для сайтов с обратным проксированием может либо не работать, либо вести к конфигурационной папке ServBay — зависит от версии и настроек.)
2. Открыть сайт в браузере: Мгновенный переход по адресу сайта в новой вкладке.
3. Просмотр логов сайта: Быстрый доступ к логам доступа и ошибкам для текущего сайта — удобно для диагностики.
4. Пауза или запуск сайта: Временное отключение или включение обратного прокси ServBay для выбранного сайта.
5. Удалить сайт: Полное удаление настройки сайта из ServBay.

На иллюстрации: панель быстрых действий для сайта в списке ServBay.

Важные рекомендации и лучшие практики

• Статус Docker-контейнера: Убедитесь, что нужный контейнер всегда работает, иначе ServBay не сможет проксировать запросы.
• Проброс портов: Проверьте, что значения параметров проброса портов Docker (-p) и порт, указанный в ServBay, совпадают, а также что порт не занят другим приложением.
• Firewall: Проверьте настройки брандмауэра macOS: порты ServBay (по умолчанию 80, 443) и проброшенный Docker-порт должны быть открыты.
• Режим сети Docker: Обычно проще использовать стандартный режим bridge и пробрасывать порты через -p. При использовании режима host ServBay может обращаться к внутреннему порту контейнера напрямую (например, порт 80 — значит, ServBay указывает порт 80), но в этом режиме возможны конфликты по портам.
• ServBay CA: Для корректной работы HTTPS рекомендуется установить ServBay Public CA. Тогда локальные SSL-сертификаты будут доверенными для браузеров и системы, и не возникнет тревожных предупреждений.

Часто задаваемые вопросы и решение проблем (FAQ)

Вопрос: После добавления сайт недоступен, браузер пишет об ошибке соединения или таймауте?

Ответ: Проверьте следующее:

1. Статус сайта в ServBay: Убедитесь, что статус выбранного сайта — «Работает».
2. Статус Docker-контейнера: В терминале выполните docker ps и убедитесь, что нужный контейнер запущен.
3. Проброс портов Docker: Выполните docker ps и посмотрите информацию о портах (PORTS), чтобы убедиться, что порт хоста (например, 0.0.0.0:8080->80/tcp или 127.0.0.1:8080->80/tcp, в данном случае 8080) совпадает с тем, что вы указали в ServBay.
4. Работа веб-сервиса внутри контейнера: Убедитесь, что в контейнере запущен веб-сервис (например, Nginx, Apache, Node и др.) на правильном порту и без ошибок. Для просмотра логов контейнера используйте docker logs <ID или имя>.
5. Логи ServBay: В ServBay кликните по иконке логов сайта и посмотрите детали ошибок или проблем с проксированием.
6. Проверьте файл hosts системы: Файл /etc/hosts должен содержать запись, связывающую ваш домен ServBay с 127.0.0.1.
7. Firewall: Убедитесь, что порты, используемые ServBay и Docker, не заблокированы брандмауэром.

Вопрос: Может ли ServBay управлять контейнерами Docker напрямую?

Ответ: ServBay отвечает за управление локальными веб-сервисами, базами данных, языковыми средами и маршрутизацию трафика (в том числе на Docker-контейнеры). Для управления жизненным циклом контейнеров Docker (запуск, остановка, сборка образов и т.д.), используйте командную строку Docker или Docker Desktop — эти функции не входят в ServBay.

Вопрос: Что такое ServBay CA и зачем его устанавливать?

Ответ: ServBay CA (Certificate Authority) — система управления сертификатами для безопасной работы по HTTPS в локальной среде. ServBay User CA подписывает SSL-сертификаты ваших сайтов, а ServBay Public CA — корневой сертификат. Установка ServBay Public CA как доверенного корневого сертификата позволяет системе и браузерам считать все локальные сайты, размещённые через ServBay, безопасными и не выводить предупреждения о небезопасном соединении. Это важно для разработки и тестирования сценариев, аналогичных боевым HTTPS-сервисам.

Итоги

Добавление сайта на основе Docker-контейнера в ServBay — это быстрый и гибкий инструмент для локальной разработки. ServBay становится центральной точкой управления доменами и трафиком, а Docker обеспечивает изоляцию среды для ваших приложений. Благодаря обратному проксированию вы без труда интегрируете любые проекты на Docker в рабочий процесс с ServBay. Следуйте описанным шагам и рекомендациям — и ваш локальный Docker-сайт будет работать стабильно и удобно.