Gids voor het Configureren van de Pinggy Reverse Proxy-dienst in ServBay

Pinggy is een lichtgewicht en gebruiksvriendelijke oplossing voor NAT-traversal, waarmee je moeiteloos lokale webservices veilig op het publieke internet kunt beschikbaar maken. Door Pinggy te integreren biedt ServBay macOS-ontwikkelaars een eenvoudige manier om publieke toegangstunnels aan te maken, zowel voor code-demo’s, API-tests als het delen van lokale projecten met externe collega’s. Deze handleiding loopt stap voor stap door het complete proces van Pinggy configureren en gebruiken binnen ServBay.

Overzicht

ServBay ondersteunt Pinggy standaard, waardoor installatie en beheer uitzonderlijk eenvoudig is. Via de grafische interface van ServBay kun je Pinggy-tunnels direct beheren en je lokale websites online koppelen aan een publieke URL, zodat ze van buitenaf benaderbaar zijn.

Toepassingsscenario’s

• Snelle demo’s: Toon direct aan klanten of collega’s de website of applicatie die je lokaal op macOS ontwikkelt.
• API- en Webhook-tests: Lever snel een tijdelijke publieke endpoint voor diensten van derden die externe callbacks vereisen (bijv. social login, message queue).
• Remote debugging: Laat teamleden op afstand makkelijk jouw lokale ontwikkelomgeving benaderen en debuggen.
• Mobiele tests: Geef mobiele apparaten toegang tot jouw lokaal draaiende backend via een publieke URL.

Vereisten

1. ServBay geïnstalleerd: Zorg dat je de nieuwste versie van ServBay hebt geïnstalleerd en actief draait op macOS.
2. Pinggy-account: Je hebt een Pinggy-account nodig. Registreer je via de officiële Pinggy-website. Pinggy biedt gratis en betaalde pakketten.
3. Lokale website: Je hebt minimaal één lokale website geconfigureerd en actief in ServBay (zoals servbay.demo of kirby.test).

Stappenplan

1. Installeer het Pinggy-pakket in ServBay

Bij eerste gebruik van Pinggy binnen ServBay dien je het bijbehorende softwarepakket te installeren:

1. Open de ServBay-app.

2. Klik aan de linkerkant op Pakketten (Packages).

3. Zoek of selecteer Pinggy in de lijst met beschikbare pakketten.

4. Klik op de install-knop naast Pinggy.

5. Na installatie kun je rechts van Pinggy proberen het pakket te activeren met de schakelaar. Bij een eerste, ongeconfigureerde start kan de service falen of een vreemde status tonen—dit is normaal. We ronden de configuratie in de volgende stappen af.

   

2. Verkrijg je Pinggy Access token

Pinggy gebruikt een Access token om je account te verifiëren en tunnels mogelijk te maken.

1. Ga naar Pinggy Dashboard en log in met je accountgegevens.

2. Na succesvolle login vind je je persoonlijke Access token meestal in het "Access token"-gedeelte van het dashboard.

3. Kopieer je Access token. Dit is een serie tekens, bewaar deze veilig.

   

3. Stel Pinggy in via ServBay

Zodra je de Access token hebt, ga je terug naar de ServBay-app:

1. Selecteer Tunnel in de linker navigatie.

2. Klik in de Tunneldienst-lijst op Pinggy.

   

3. Auth Token (autorisatietoken):

   • Plak het zojuist gekopieerde Access token exact in het veld Auth Token.

4. Tunnel configureren (Local Domain & External Domain): ServBay laat je toe om voor meerdere lokale websites Pinggy-tunnels aan te maken.

   • Local Domain (lokaal domein):
     • Kies in het dropdown-menu de website die je via Pinggy openbaar wilt delen. Bijvoorbeeld thinkphp.test of servbay.demo.
   • External Domain (extern domein):
     • Voor gratis Pinggy-gebruikers: Laat dit veld leeg. Pinggy genereert automatisch een willekeurige publieke URL voor je tunnel (meestal eindigend op .a.free.pinggy.link of .pinggy.link). Als de tunnel geslaagd is opgezet, zal ServBay het toegekende adres hier automatisch tonen.
     • Voor betalende Pinggy-gebruikers: Indien je account eigen domeinen of reserveringen ondersteunt, kun je hier je gewenste externe domein invullen.

5. Meerdere tunnels toevoegen:

   • Wil je extra tunnelaansluitingen voor andere lokale websites, klik dan op het + (plus) icoon rechts van een bestaande tunnel en herhaal stap 4 voor elke nieuwe tunnel.

6. Configuratie opslaan:

   • Klik op Opslaan (Save) rechtsonder in het scherm zodra je klaar bent met alle tunnels.

4. Pinggy-dienst starten en valideren

1. Na opslaan probeert ServBay de Pinggy-dienst te starten met de nieuwste instellingen.
2. Kijk bij het Tunnel overzicht naar het statuslampje naast Pinggy. Staat het lampje op groen, dan werkt de tunnel en is de verbinding met de Pinggy-servers succesvol.
3. Voor elke geactiveerde tunnel verschijnt nu bij het veld External Domain (indien niet ingevuld) de toegewezen publieke URL, bijvoorbeeld https://random-string.a.free.pinggy.link.
4. Toegankelijkheid verifiëren:
   • Kopieer het publieke adres snel via het kopieer-icoon naast het domein.
   • Of klik op het browser-icoon (veelal een kompas of wereldbol) om direct via je standaardbrowser te testen.
   • Werkt alles goed, dan is je lokale website nu bereikbaar via de Pinggy-URL.

5. Pinggy-tunnels beheren

Via het ServBay Pinggy-configuratiepaneel kun je eenvoudig tunnels managen:

• Extern domein kopiëren: Klik op het kopieer-icoon om het publieke adres te delen.
• In browser openen: Start een toegankelijkheidstest via het browser-icoon.
• Tunnel toevoegen: Voeg nieuwe tunnels toe met het + icoon.
• Tunnel verwijderen: Verwijder overbodige tunnels met het - (min) icoon.
• Dienst stoppen/starten: (De)activeer alle Pinggy-tunnels globaal via de schakelaar naast de service.

Let op

• Eigenschappen van de gratis Pinggy-versie: Externe domeinen zijn in de gratis versie dynamisch en kunnen na elke tunnelherstart veranderen. Ook zijn er beperkingen in connecties, bandbreedte en maximale gebruiksduur. Wil je vaste domeinen, betere prestaties of extra opties, kies dan voor een betaald Pinggy-abonnement.
• Afhankelijkheid van lokale zijde: Zorg dat de gekozen lokale website in ServBay correct draait (de juiste PHP-versie, webserver zoals Caddy/Nginx actief, website goed geconfigureerd). Pinggy verzorgt enkel het verkeerstransport.
• Firewall & netwerk: Verzeker je ervan dat noch de macOS-firewall, noch een andere beveiligingsapp de ServBay- of Pinggy-client blokkeert.
• HTTPS-beveiliging: Pinggy levert doorgaans standaard HTTPS op hun tunnels, zodat je gegevens beveiligd worden verstuurd—essentieel voor moderne webapplicaties.

Veelgestelde vragen (FAQ)

• Q: De Pinggy-dienst start niet, het statuslampje wordt niet groen. Wat nu?
  • A: Controleer allereerst het Access token op spelfouten. Controleer je internetverbinding. Bekijk de Pinggy-logboeken (log-icoon naast de dienst) voor specifieke foutmeldingen.
• Q: Ik gebruik de gratis Pinggy-dienst. Waarom moet het veld External Domain leeg blijven?
  • A: Dit is hoe Pinggy Free werkt. Je hoeft geen domein op te geven. Na een geslaagd tunnelopzet, haalt ServBay automatisch het tijdelijke publieke adres op en vult dat in voor je.
• Q: Hoe verschilt Pinggy van Ngrok of andere tunneldiensten, en welke moet ik kiezen?
  • A: Zowel Pinggy als Ngrok zijn uitstekende tunnelingtools, maar verschillen per functionaliteit, gratis beperkingen, prijs, complexiteit en serverlocaties. Pinggy is populair vanwege z'n eenvoud en lichtheid. Je keuze hangt af van specifieke noden (protocolondersteuning, eigen domeinen, budget) en voorkeur. ServBay ondersteunt diverse diensten voor maximale flexibiliteit.

Samenvatting

Met de Pinggy-integratie biedt ServBay webontwikkelaars op macOS een uiterst gemakkelijke en veilige oplossing om een lokale website direct te delen. In slechts enkele stappen stel je je ontwikkelomgeving open voor het internet—ideaal voor demo’s, testen en samenwerking. Zorg wel steeds voor de juiste Pinggy-instellingen en sterk draaiende lokale services, zodat je moeiteloos profiteert van de Pinggy-voordelen.