Anleitung: Pinggy-Reverse-Proxy in ServBay konfigurieren

Pinggy ist ein leichtgewichtiges und benutzerfreundliches NAT-Traversal-Tool, mit dem Sie lokal laufende Webdienste schnell und sicher im öffentlichen Internet verfügbar machen können. Durch die Integration von Pinggy ermöglicht ServBay macOS-Entwicklern das einfache Erstellen öffentlicher Zugangstunnel – perfekt für Code-Demos, API-Tests oder zum Teilen von Entwicklungsergebnissen mit externen Partnern. Diese Anleitung führt Sie Schritt für Schritt durch die Konfiguration und Nutzung von Pinggy in ServBay.

Übersicht

ServBay bietet eine native Unterstützung für Pinggy und macht dessen Installation und Verwaltung extrem einfach. Direkt über die grafische Oberfläche von ServBay können Sie Pinggy-Tunnel steuern und Ihre lokal gehosteten Websites unter einem öffentlichen Link erreichbar machen.

Anwendungsfälle

• Schnelle Demos: Präsentieren Sie Kunden oder Kollegen unmittelbar die Websites oder Anwendungen, an denen Sie lokal auf Ihrem Mac arbeiten.
• API- und Webhook-Tests: Bieten Sie externen Diensten (z.B. Social Logins oder Messaging-Systemen), die öffentliche Callback-URLs benötigen, einen temporären Zugangspunkt.
• Remote-Debugging: Geben Sie Teammitgliedern aus der Ferne einfachen Zugriff auf Ihre lokale Entwicklungsumgebung zu Debugging-Zwecken.
• Mobiles Testen: Erlauben Sie mobilen Geräten die Verbindung zu lokal laufenden Backend-Services über einen öffentlichen Link.

Voraussetzungen

1. ServBay installiert: Stellen Sie sicher, dass auf Ihrem Mac die aktuelle ServBay-Version installiert und gestartet wurde.
2. Pinggy-Konto: Registrieren Sie ein Pinggy-Konto auf der offiziellen Pinggy-Website. Es gibt sowohl kostenlose als auch kostenpflichtige Pläne.
3. Lokale Website: Betreiben Sie bereits mindestens eine Website in ServBay, z.B. servbay.demo oder kirby.test.

Schritt-für-Schritt-Anleitung

1. Pinggy-Paket in ServBay installieren

Wenn Sie Pinggy zum ersten Mal in ServBay nutzen, müssen Sie zunächst das Paket installieren:

1. Öffnen Sie die ServBay-App.

2. Klicken Sie in der linken Navigation auf Pakete (Packages).

3. Suchen Sie in der Paketliste nach Pinggy.

4. Klicken Sie auf den Installationsbutton neben Pinggy.

5. Nach der Installation können Sie versuchen, den Dienst über den Schalter rechts neben Pinggy zu starten. Sollte der Start oder Status abnormal sein, ist das erwartbar – Pinggy wurde noch nicht konfiguriert. Die Konfiguration folgt im nächsten Schritt.

   

2. Ihren Pinggy Access Token abrufen

Pinggy verwendet einen Access Token zur Verifizierung Ihres Kontos und zur Aktivierung der Tunneldienste.

1. Besuchen Sie das Pinggy Dashboard und melden Sie sich mit Ihren Zugangsdaten an.

2. Nach dem Login finden Sie Ihren Access Token üblicherweise im Abschnitt „Access token“ auf der Startseite des Dashboards.

3. Kopieren Sie diesen Token (Zeichenkette) und bewahren Sie ihn sicher auf.

   

3. Pinggy in ServBay konfigurieren

Nachdem Sie den Access Token erhalten haben, wechseln Sie zurück in die ServBay-App zur Einrichtung:

1. Wählen Sie in der linken Navigation Tunnel aus.

2. Klicken Sie in der Tunnel-Liste auf Pinggy.

   

3. Auth Token (Zugriffs-Token):

   • Fügen Sie in das Feld Auth Token den kopierten Access Token aus dem Pinggy-Dashboard präzise ein.

4. Tunnel konfigurieren (Lokale & Externe Domains): ServBay erlaubt die Einrichtung mehrerer Pinggy-Tunnel für verschiedene lokal gehostete Sites.

   • Lokale Domain (Local Domain):
     • Wählen Sie aus der Dropdown-Liste die lokale Website, die Sie öffentlich machen möchten, z.B. thinkphp.test oder servbay.demo.
   • Externe Domain (External Domain):
     • Für kostenlose Pinggy-Nutzer: Dieses Feld leer lassen. Pinggy erstellt automatisch eine zufällige öffentliche URL für Ihren Tunnel (meist mit .a.free.pinggy.link oder .pinggy.link). Nach erfolgreichem Aufbau zeigt ServBay diese URL automatisch an.
     • Für zahlende Pinggy-Nutzer: Wenn Ihr Pinggy-Account benutzerdefinierte oder reservierte Domains unterstützt, können Sie hier die gewünschte externe Domain eintragen.

5. Weitere Tunnel hinzufügen:

   • Um zusätzliche Tunnel für weitere lokale Sites zu erstellen, klicken Sie auf das +-Symbol neben einem bestehenden Tunnel-Eintrag und wiederholen Sie Schritt 4.

6. Konfiguration speichern:

   • Nach Abschluss der Einrichtung klicken Sie unten rechts auf Speichern (Save).

4. Pinggy-Dienst starten & überprüfen

1. Nach dem Speichern startet ServBay automatisch den Pinggy-Dienst mit Ihrer Konfiguration.
2. Beobachten Sie die Statusanzeige neben dem Eintrag Pinggy in der Tunnel-Liste. Wird alles korrekt erkannt und die Verbindung hergestellt, erscheint das Licht grün – der Dienst läuft.
3. Für jeden gestarteten Tunnel wird das Feld External Domain (sofern zuvor leer) nun mit der von Pinggy zugewiesenen öffentlichen URL angezeigt, z.B. https://random-string.a.free.pinggy.link.
4. Zugriff prüfen:
   • Klicken Sie auf das Kopieren-Symbol neben der externen Domain, um die URL zu übernehmen.
   • Oder nutzen Sie das Browser-Symbol (Kompass oder Globus), um die Adresse direkt im Standardbrowser zu öffnen.
   • Bei erfolgreicher Einrichtung ist Ihre lokale Website nun über den Pinggy-Link öffentlich erreichbar.

5. Pinggy-Tunnel verwalten

Im Pinggy-Konfigurationsbereich von ServBay können Sie Ihre Tunnel komfortabel verwalten:

• Externe Domain kopieren: Mit dem Kopieren-Symbol holen Sie die öffentliche URL für die Weitergabe.
• Im Browser öffnen: Übers Browser-Symbol führen Sie schnelle Zugangstests durch.
• Neuen Tunnel hinzufügen: Mit dem +-Symbol fügen Sie weitere Tunnel hinzu.
• Tunnel entfernen: Über das --Symbol (Minus) löschen Sie nicht mehr benötigte Tunnels.
• Dienst stoppen/starten: Mit dem Schalter neben dem Pinggy-Eintrag können Sie alle Pinggy-Tunnel komplett ein- oder ausschalten.

Hinweise

• Pinggy Free Version: Kostenlose Pinggy-Links sind dynamisch und ändern sich nach jedem Neustart des Diensts oder Tunnels. Kostenlose Konten haben Beschränkungen wie begrenzte Verbindungen oder Bandbreite. Für feste Domains oder erweiterte Features empfiehlt sich ein Upgrade auf die kostenpflichtige Version.
• Lokale Dienste: Stellen Sie sicher, dass die in „Local Domain“ ausgewählten Websites in ServBay korrekt konfiguriert und aktiv sind (inklusive korrekter PHP-Version, aktivem Webserver wie Caddy/Nginx, etc.). Pinggy leitet den Verkehr lediglich weiter.
• Firewall und Netzwerk: Vergewissern Sie sich, dass keine macOS-Firewall oder Drittanbieter-Sicherheitssoftware ServBay oder Pinggy beim Netzwerkzugriff blockiert.
• HTTPS-Sicherheit: Von Pinggy bereitgestellte Tunnel sind in der Regel HTTPS-gesichert, sodass die Datenübertragung verschlüsselt erfolgt – ein Muss für moderne Webanwendungen.

Häufige Fragen (FAQ)

• F: Pinggy-Dienst startet nicht, die Statusanzeige ist nicht grün. Was tun?
  • A: Prüfen Sie zunächst, ob Ihr Pinggy Access Token korrekt eingegeben wurde. Testen Sie dann Ihre Internetverbindung. Über das Log-Symbol rechts in der Dienstleiste können Sie eventuelle Fehlermeldungen einsehen.
• F: Warum muss ich als Pinggy-Free-User das Feld „External Domain“ leer lassen?
  • A: Das ist das Standardverfahren für kostenlose Pinggy-Tunnel. Sie müssen keinen externen Domainnamen eintragen. Nach Verbindungsaufbau weist ServBay Ihnen automatisch einen temporären öffentlichen Link zu.
• F: Worin unterscheiden sich Pinggy und andere Tunneldienste wie Ngrok?
  • A: Sowohl Pinggy als auch Ngrok sind leistungsfähige NAT-Traversal-Lösungen, unterscheiden sich aber z.B. hinsichtlich Features, Gratis-Limits, Preisen, Konfigurationsaufwand und Serverstandorten. Pinggy punktet insbesondere mit Einfachheit und Benutzerfreundlichkeit. Wählen Sie das Tool, das am besten zu Ihren Anforderungen (z.B. spezifische Protokolle, benutzerdefinierte Domains, Budget) passt – ServBay unterstützt verschiedene Dienste für maximale Flexibilität.

Zusammenfassung

Dank der Pinggy-Integration bietet ServBay macOS-Entwicklern eine extrem komfortable Lösung zum Teilen von lokalen Webprojekten. Mit wenigen Handgriffen können Sie Ihre Entwicklungsumgebung sicher im Internet verfügbar machen – für Demos, Tests und Zusammenarbeit. Achten Sie darauf, Pinggy entsprechend Ihrem Kontotyp richtig zu konfigurieren und den Status Ihrer lokalen Webdienste im Blick zu behalten, um alle Vorteile voll auszuschöpfen.