Przewodnik: Konfiguracja usługi odwrotnego proxy Pinggy w ServBay

Pinggy to lekki i niezwykle prosty w użyciu serwis do tunelowania z sieci lokalnej na zewnątrz (tzw. reverse proxy). Pozwala w bezpieczny sposób udostępnić lokalnie działające usługi WWW w publicznej sieci internet. Dzięki integracji z ServBay, deweloperzy na macOS mogą jednym kliknięciem utworzyć publiczny tunel – idealny do prezentacji kodu, testów API czy współdzielenia postępów prac z zewnętrznymi współpracownikami. Ten poradnik krok po kroku pokazuje, jak skonfigurować i uruchomić Pinggy w ServBay.

Przegląd

ServBay jest wyposażony we wsparcie dla Pinggy, co czyni instalację i zarządzanie usługą łatwym i przystępnym. Całościowo kontrolujesz tunele bezpośrednio z graficznego interfejsu ServBay – w prosty sposób możesz zamapować hostowaną lokalnie stronę internetową do publicznego adresu URL, zapewniając do niej dostęp z dowolnego miejsca.

Przykładowe zastosowania

• Szybkie prezentacje: Natychmiast zaprezentuj klientowi lub współpracownikom stronę bądź aplikację, nad którą pracujesz lokalnie na macOS.
• Testy API i Webhooków: Udostępnij publiczny endpoint dla usług trzecich, które wymagają zewnętrznego callbacka (np. logowanie społecznościowe, kolejki wiadomości).
• Zdalne debugowanie: Umożliw zdalnej ekipie dostęp do Twojego środowiska deweloperskiego w celu testów i poprawek.
• Testy na urządzeniach mobilnych: Umożliw urządzeniom mobilnym dostęp do lokalnie działającego backendu przez publiczny URL.

Wymagania wstępne

1. Zainstalowany ServBay: Upewnij się, że na Twoim systemie macOS działa najnowsza wersja ServBay.
2. Konto Pinggy: Potrzebujesz aktywnego konta w Pinggy. Zarejestruj się na oficjalnej stronie Pinggy. Dostępne są pakiety darmowe i płatne.
3. Strona lokalna: W ServBay musisz mieć skonfigurowaną i uruchomioną przynajmniej jedną lokalną stronę, np. servbay.demo lub kirby.test.

Instrukcja krok po kroku

1. Instalacja pakietu Pinggy w ServBay

Jeśli korzystasz z Pinggy w ServBay po raz pierwszy, musisz najpierw zainstalować odpowiedni pakiet:

1. Uruchom aplikację ServBay.

2. W lewym pasku nawigacyjnym kliknij Pakiety (Packages).

3. Wyszukaj lub znajdź na liście dostępnych pakietów pozycję Pinggy.

4. Kliknij przycisk instalacji przy Pinggy.

5. Po zakończeniu instalacji możesz włączyć Pinggy, klikając przycisk przełącznika po jego prawej stronie. Jeśli uruchomienie usługi zakończy się błędem lub status będzie nieprawidłowy, to normalne – Pinggy wymaga jeszcze konfiguracji, którą przedstawiamy w kolejnych krokach.

   

2. Pozyskiwanie tokenu dostępu Pinggy (Access token)

Pinggy do uwierzytelniania oraz uruchamiania tunelu wykorzystuje token dostępu.

1. Zaloguj się na Dashboard Pinggy używając swoich danych.

2. Po zalogowaniu zazwyczaj na głównej stronie, w sekcji "Access token", znajdziesz indywidualny token dostępu.

3. Skopiuj ten token. To unikalny ciąg znaków – przechowuj go w bezpiecznym miejscu.

   

3. Konfiguracja Pinggy w aplikacji ServBay

Mając już Access token, powróć do aplikacji ServBay i przejdź do konfiguracji:

1. W lewym pasku nawigacyjnym ServBay wybierz Tunnel.

2. W liście usług tunelowania kliknij Pinggy.

   

3. Auth Token (token autoryzacyjny):

   • W polu Auth Token wklej dokładnie Access token, który skopiowałeś z Dashboardu Pinggy.

4. Konfiguracja tuneli (Local Domain i External Domain): ServBay umożliwia tworzenie tuneli Pinggy dla wielu lokalnych stron hostowanych w ServBay.

   • Local Domain (lokalna domena):
     • Z listy wybierz lokalną stronę, którą chcesz udostępnić przez Pinggy – np. thinkphp.test lub servbay.demo.
   • External Domain (domena zewnętrzna):
     • Jeśli masz darmowe konto Pinggy: Pozostaw to pole puste. Pinggy automatycznie wygeneruje losowy publiczny URL tunelu (zazwyczaj z zakończeniem .a.free.pinggy.link lub .pinggy.link). ServBay po nawiązaniu tunelu sam pobierze i wyświetli ten adres.
     • W przypadku płatnego konta Pinggy: Jeśli Twój plan umożliwia korzystanie z własnych domen lub rezerwację nazw, wpisz tu żądaną domenę zewnętrzną.

5. Dodawanie kolejnych tuneli:

   • Jeśli chcesz utworzyć tunel dla innej strony, kliknij znak + po prawej stronie na pasku istniejącego tunelu. Powtórz krok 4 dla nowego tunelu.

6. Zapisz konfigurację:

   • Po skonfigurowaniu wszystkich tuneli, kliknij Zapisz (Save) w prawym dolnym rogu okna.

4. Uruchomienie i weryfikacja usługi Pinggy

1. Po zapisaniu ustawień ServBay automatycznie spróbuje wystartować Pinggy z nową konfiguracją.
2. Obserwuj wskaźnik statusu obok wpisu Pinggy w liście Tunnel. Jeśli wszystko przebiegło pomyślnie i Pinggy połączył się z serwerem, lampka zmieni kolor na zielony – usługa jest aktywna.
3. Każdy poprawnie uruchomiony tunel wyświetli w polu External Domain przydzielony przez Pinggy publiczny URL (jeśli pole było uprzednio puste), np. https://random-string.a.free.pinggy.link.
4. Test dostępu:
   • Kliknij ikonę kopiowania koło domeny zewnętrznej, by skopiować publiczny adres do schowka.
   • Albo naciśnij ikonę przeglądarki (najczęściej przypomina kompas lub kulę ziemską), by otworzyć adres bezpośrednio domyślną przeglądarką.
   • Jeśli konfiguracja jest prawidłowa, dostęp do lokalnej strony przez publiczny Pinggy URL będzie natychmiast możliwy.

5. Zarządzanie tunelami Pinggy

W interfejsie konfiguracyjnym Pinggy w ServBay łatwo zarządzasz wszystkimi tunelami:

• Kopiowanie domeny zewnętrznej: Kliknij ikonę kopiowania, by błyskawicznie udostępnić adres URL.
• Otwieranie w przeglądarce: Kliknij ikonę przeglądarki do szybkiej weryfikacji połączenia.
• Dodawanie tunelu: Użyj +, by skonfigurować nowy tunel.
• Usuwanie tunelu: Kliknij ikonę -, aby skasować zbędną konfigurację.
• Zatrzymywanie/uruchamianie: Przełącznik obok wpisu serwisu Pinggy pozwala globalnie włączać oraz wyłączać tunele Pinggy.

Wskazówki i uwagi

• Właściwości wersji darmowej Pinggy: Publiczne domeny w darmowej wersji Pinggy są dynamicznie przydzielane i mogą zmieniać się przy każdym restarcie tunelu lub usługi. Darmowa oferta bywa także ograniczona pod kątem liczby połączeń, przepustowości i/lub czasu sesji. Stałe domeny, większą wydajność lub funkcje premium uzyskasz po przejściu na płatny plan.
• Zależności lokalne: Upewnij się, że wybrana w Local Domain strona jest poprawnie skonfigurowana i aktywna w ServBay (dopilnuj, by wybrana wersja PHP, Caddy/Nginx oraz ustawienia strony były poprawne). Pinggy przekazuje jedynie ruch sieciowy.
• Firewall i sieć: Sprawdź, czy firewall macOS lub inny program zabezpieczający nie blokuje połączeń sieciowych ServBay lub klienta Pinggy.
• Bezpieczeństwo HTTPS: Pinggy standardowo zapewnia HTTPS dla wygenerowanych tuneli, gwarantując szyfrowanie transmisji – to kluczowe dla bezpieczeństwa współczesnych aplikacji WWW.

Najczęstsze pytania (FAQ)

• Q: Pinggy nie startuje – wskaźnik nie jest zielony. Co wtedy zrobić?
  • A: Najpierw sprawdź, czy poprawnie wpisałeś Access token z Pinggy. Następnie upewnij się, że masz aktywne połączenie z Internetem. Sprawdź logi klienta Pinggy (kliknij ikonę logów po prawej stronie usługi), z których dowiesz się o szczegółowych błędach.
• Q: Mam darmowe konto, dlaczego pole External Domain należy zostawić puste?
  • A: To standardowe działanie darmowego Pinggy – nie musisz ustawiać domeny ręcznie. Po pomyślnym połączeniu ServBay automatycznie pobierze od serwera Pinggy Twój tymczasowy publiczny URL i wyświetli go w tym polu.
• Q: Czym Pinggy różni się od innych usług tunelowych, jak Ngrok? Którą wybrać?
  • A: Pinggy i Ngrok to popularne narzędzia do tunelowania z sieci lokalnej – różnią się funkcjonalnościami, ograniczeniami darmowej wersji, ceną, stopniem skomplikowania konfiguracji oraz infrastrukturą serwerową. Pinggy jest chwalony za prostotę i lekkość. Wybierz narzędzie najlepiej dopasowane do swoich potrzeb (w zależności od wsparcia dla danego protokołu, dostępności własnych domen, budżetu itd.). ServBay obsługuje wiele tego typu usług, dając Ci elastyczność wyboru.

Podsumowanie

Integracja Pinggy z ServBay daje deweloperom webowym na macOS niezwykle wygodne narzędzie do błyskawicznego i bezpiecznego udostępniania lokalnych środowisk projektowych na zewnątrz. Kilka prostych kroków wystarczy, by uczynić lokalny serwis widocznym globalnie – ułatwia to prezentacje, testowanie i współpracę. Dopasuj konfigurację do swojego typu konta Pinggy i dbaj o sprawność lokalnych usług, by w pełni korzystać z możliwości, jakie daje tunelowanie z Pinggy w ServBay.