Руководство по настройке обратного прокси-сервиса Pinggy в ServBay

Pinggy — это легковесный и простой инструмент проброса портов, позволяющий быстро и безопасно опубликовать локально работающий веб-сервис в интернете. Благодаря интеграции Pinggy, ServBay предоставляет разработчикам на macOS удобный способ создания публичных туннелей для демонстраций кода, тестирования API или обмена результатами локальной разработки с коллегами. В этом руководстве вы найдёте пошаговые инструкции по настройке и использованию Pinggy в ServBay.

Обзор

Встроенная поддержка Pinggy в ServBay делает установку и администрирование туннелей максимально простыми. Прямо из графического интерфейса ServBay вы можете управлять туннелями Pinggy, отображая любой локальный сайт, размещённый на ServBay, по публичному URL для доступа из интернета.

Основные сценарии использования

• Быстрая демонстрация: Мгновенно покажите сайт или приложение, находящееся в разработке на вашем macOS, клиенту или коллегам.
• Тестирование API и Webhook: Создайте временную публичную точку входа для сторонних сервисов, требующих публичного callback (например, соцлогин, очередь сообщений).
• Удалённая отладка: Позволяет членам удалённых команд получить доступ и отлаживать ваш локальный проект.
• Тестирование на мобильных устройствах: Предоставьте мобильным устройствам доступ к локальному бэкенду через публичный URL.

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

1. Установленный ServBay: Убедитесь, что на вашем macOS установлена и работает последняя версия ServBay.
2. Аккаунт Pinggy: Зарегистрируйтесь на официальном сайте Pinggy. Доступны как бесплатный, так и платные тарифы.
3. Локальный сайт: Как минимум, один локальный сайт должен быть настроен и запущен в ServBay (например, servbay.demo или kirby.test).

Пошаговая инструкция

1. Установка пакета Pinggy в ServBay

Если вы впервые используете Pinggy в ServBay, выполните установку его пакета:

1. Откройте приложение ServBay.

2. В левом меню выберите Пакеты (Packages).

3. Найдите или введите в поиск Pinggy в списке доступных пакетов.

4. Нажмите кнопку установки рядом с Pinggy.

5. После завершения установки попробуйте включить сервис с помощью переключателя справа от Pinggy. Если служба не запускается или отображается ошибка — это нормально, так как Pinggy ещё не настроен. Настройка будет выполняться на следующих шагах.

   

2. Получение Access token Pinggy

Чтобы пользоваться сервисом туннелей, Pinggy требует Access token для аутентификации.

1. Перейдите в Pinggy Dashboard и войдите в аккаунт.

2. После входа на главной странице панели откройте раздел "Access token" (Токен доступа) и скопируйте ваш личный токен.

3. Сохраните Access token в безопасном месте — это строка символов.

   

3. Настройка Pinggy в ServBay

Получив Access token, вернитесь в приложение ServBay для дальнейшей настройки:

1. В левом меню выберите пункт Tunnel.

2. В списке туннелей кликните по Pinggy.

   

3. Auth Token (токен авторизации):

   • Вставьте ваш Access token, скопированный из панели Pinggy, в поле Auth Token.

4. Настройка туннеля (Local Domain и External Domain): ServBay позволяет создать Pinggy-туннели для любого локального сайта, размещённого на платформе.

   • Local Domain (локальный сайт):
     • Выберите нужный сайт из выпадающего списка — это тот, который вы хотите сделать доступным через интернет, например thinkphp.test или servbay.demo.
   • External Domain (внешний домен):
     • Бесплатные аккаунты Pinggy: Оставьте это поле пустым. Сервис автоматически сгенерирует случайный публичный URL (обычно заканчивается на .a.free.pinggy.link или .pinggy.link). ServBay потом автоматически подставит и покажет этот адрес после успешного создания туннеля.
     • Платные аккаунты Pinggy: Если в вашем тарифе доступен кастомный или выделенный домен, укажите желаемое доменное имя.

5. Добавление дополнительных туннелей:

   • Для создания туннеля к другому локальному сайту, нажмите + справа от существующих туннелей и повторите шаг 4.

6. Сохранение настроек:

   • После настройки всех нужных туннелей нажмите Save (Сохранить) в правом нижнем углу экрана.

4. Запуск и проверка работы Pinggy

1. После сохранения ServBay попробует запустить сервис Pinggy с вашей новой конфигурацией.
2. Проверьте индикатор состояния рядом с пунктом Pinggy в списке Tunnel. Если всё верно, индикатор станет зелёным — сервис работает.
3. Для каждого запущенного туннеля (если External Domain было пустым) поле External Domain теперь покажет публичный URL, выданный Pinggy, например, https://random-string.a.free.pinggy.link.
4. Проверка доступа:
   • Нажмите на иконку копирования рядом с внешним доменом, чтобы скопировать адрес для передачи коллегам.
   • Либо щёлкните на иконку браузера (в виде компаса или глобуса), чтобы открыть URL сразу в браузере по умолчанию.
   • Если всё сделано правильно, ваш локальный сайт будет доступен по этому Pinggy-адресу из интернета.

5. Управление туннелями Pinggy

Прямо из интерфейса настройки Pinggy в ServBay вы можете:

• Копировать внешний домен: Быстро скопируйте URL для обмена с кем-либо.
• Открыть в браузере: Мгновенно проверьте доступность туннеля одним кликом.
• Добавить туннель: Кликните + для создания новых туннелей.
• Удалить туннель: Кликните - для удаления неактуального туннеля.
• Запуск/остановка службы: Остановите или перезапустите Pinggy глобально через переключатель справа от него.

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

• Особенности бесплатной версии Pinggy: Бесплатные публичные адреса генерируются динамически, они меняются после каждого перезапуска Pinggy или туннеля. Кроме того, в бесплатной версии есть ограничения по числу одновременных подключений, скорости и длительности работы. Для выделенного домена, большей производительности или дополнительных функций — переходите на платный тариф.
• Зависимость от локального сервиса: Убедитесь, что выбранный в Local Domain сайт действительно работает (правильные версии PHP, запущен Caddy/Nginx, корректные конфигурации сайта). Pinggy просто проксирует трафик — сам сайт должен быть рабочим.
• Фаерволы и сеть: Проверьте, что фаервол macOS или сторонние средства безопасности не блокируют сетевые соединения ServBay и клиента Pinggy.
• Безопасность HTTPS: Pinggy обычно использует HTTPS для проброшенных туннелей, что гарантирует безопасную передачу данных — это важно для современных веб-приложений.

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

• В: Сервис Pinggy не запускается, индикатор не зелёный, что делать?
  • О: Сначала проверьте, правильно ли введён Access token Pinggy. Далее проверьте соединение с интернетом. Посмотрите логи клиента Pinggy (иконка log справа от сервиса), там будет подробное описание ошибки.
• В: Я пользуюсь бесплатной версией — почему поле External Domain просит оставить пустым?
  • О: Это обычное поведение бесплатного тарифа Pinggy. Вам не нужно вручную указывать внешний домен — после запуска туннеля ServBay автоматически получит и покажет выделенный временный URL.
• В: В чём отличие Pinggy от других туннельных сервисов, например Ngrok? Какой выбрать?
  • О: И Pinggy, и Ngrok — отличные инструменты для проброса портов (“интернетизации” локальных сервисов), но отличаются по возможностям, ограничениям бесплатных тарифов, ценам, сложности настройки и географии серверов. Pinggy выделяется лёгкостью и простотой. Выберите сервис исходя из нужных функций (поддержка нужных протоколов, кастомные домены, бюджет и т.д.) и собственных предпочтений. ServBay поддерживает несколько подобных инструментов, предоставляя гибкость выбора.

Итоги

Pinggy, интегрированный в ServBay, даёт веб-разработчикам на macOS простое и удобное решение для обмена локальными сайтами. Несложная настройка позволяет быстро и безопасно сделать локальное окружение доступным из интернета, что крайне удобно для демонстраций, тестирования и командной работы. Для максимальной надёжности убедитесь, что настройки соответствуют вашему тарифу Pinggy, а ваши локальные сайты исправно функционируют — так вы получите максимум пользы от сервиса.