SECURE PIPES 2.0.14 Benutzerhandbuch

Screenshots und Diagramm zeigen die englische Oberfläche. Die Anleitungen sind übersetzt; die Bezeichnungen können je nach gewählter App-Sprache abweichen.

Lokale Portweiterleitung auf macOS

Greifen Sie über einen Port auf Ihrem Mac auf eine Remote-Datenbank, einen Webdienst oder einen Unix-Socket zu, ohne diesen Dienst direkt verfügbar zu machen.

So funktioniert der Tunnel

Ein Client stellt eine Verbindung zu einem lokalen Listener auf Ihrem Mac her. Secure Pipes überträgt den Stream über SSH. Der SSH-Server stellt dann eine Verbindung zum konfigurierten Remote-Ziel her. Das Ziel muss nicht der SSH-Server selbst sein: Es muss von diesem Server aus erreichbar sein.

Öffnen Sie das Diagramm in voller Größe.

Das folgende Beispiel ordnet 127.0.0.1:15432 auf Ihrem Mac 127.0.0.1:5432 zu, wie es vom SSH-Server gesehen wird. Diese beiden Loopback-Adressen beziehen sich auf unterschiedliche Computer.

Konfigurieren Sie eine lokale Weiterleitung

Lokaler Weiterleitungseditor mit einem PostgreSQL-Beispiel

  1. Wählen Sie Verbindungen → + → Neue lokale Weiterleitung….
  2. Geben Sie einen beschreibenden Verbindungsnamen ein und wählen Sie einen Hostprofil: aus oder geben Sie benutzerdefinierte SSH-Details ein.
  3. Legen Sie Lokale Bindungsadresse: auf 127.0.0.1 und seinen Port auf 15432 fest.
  4. Wählen Sie Entferntes TCP und geben Sie die Zieladresse 127.0.0.1 und den Port 5432 ein.
  5. Lassen Sie Strenge Prüfung des Hostschlüssels aktiviert. Konfigurieren Sie das Passwort oder die Schlüsseldatei.
  6. Klicken Sie im gespeicherten Profil auf Hinzufügen und dann auf Verbinden.
  7. Sobald die Verbindung hergestellt ist, konfigurieren Sie Ihren Datenbank-Client für Host 127.0.0.1, Port 15432. Die Datenbank verwendet weiterhin ihre eigene Authentifizierung.

Der SSH-Server muss eine Weiterleitung zulassen. Der Zieldienst muss ausgeführt werden und von diesem Server aus erreichbar sein. Durch einen verbundenen Tunnel wird die Authentifizierung auf Anwendungsebene nicht entfernt.

Verwalten Sie mehrere Zuordnungen

Klicken Sie im Editor auf Portweiterleitungen verwalten…. Ein Profil kann bis zu 128 Zuordnungen enthalten, einschließlich der ersten Zeile. Für mehrere lokale/Remote-Zuordnungen ist nach der gemeinsamen siebentägigen Testversion Pro erforderlich.

Zwei lokale TCP-Mappings im eigentlichen Mapping-Manager

  • Verwendungszweck ist eine Notiz; die Routenführung wird dadurch nicht geändert.
  • Aktiviert steuert, ob diese Zeile bei der nächsten Verbindung einen Listener erstellt.
  • Klicken Sie zum Bearbeiten auf eine Zelle. Hinzufügen erbt die vorhergehenden Adressen und lässt die Ports leer.
  • Duplizieren oder ⌘D kopiert eine Zeile; Weisen Sie vor dem Speichern einen anderen Listener-Port zu.
  • Ziehen Sie den Zeilengriff, um die Reihenfolge neu anzuordnen. Durch das Speichern wird die erste Zeile zur Haupteditorzuordnung.
  • Die erste Zeile kann nicht direkt entfernt werden. Deaktivieren Sie es oder ordnen Sie es entsprechend neu an.
  • Speichern wendet den Tabellenentwurf auf den Editor an; Speichern Sie auch den Verbindungseditor. Abbrechen verwirft den Tabellenentwurf.

Alle Zuordnungen teilen die SSH-Einstellungen und den Lebenszyklus des Profils. Sie erstellen nicht jeweils eine unabhängige SSH-Verbindung. Durch das Trennen der Verbindung zum Profil werden dessen Zuordnungen gestoppt. Durch das Bearbeiten eines gespeicherten Profils wird eine bereits laufende SSH-Sitzung nicht im laufenden Betrieb neu konfiguriert. Stellen Sie die Verbindung erneut her, um die Änderungen zu übernehmen.

Verwenden Sie ein Unix-Socket-Ziel

Wählen Sie Entfernter Unix-Socket und geben Sie einen absoluten Pfad auf dem SSH-Server ein, z. B. /var/run/service.sock. Der Zielport wird deaktiviert. Dabei wird weiterhin ein lokaler TCP-Listener verwendet. Das Ziel ist ein Unix-Socket. Das SSH-Konto benötigt die Berechtigung, auf diesen Socket zuzugreifen.

Socket-Pfade müssen den Validierungsregeln der App entsprechen. Verwenden Sie einen absoluten Pfad ohne Leerzeichen, Anführungszeichen, Steuerzeichen oder # und halten Sie ihn innerhalb der unterstützten Länge. Socket-Menüs bieten allgemeine Pfade und Historie.

Listener-Sicherheit und Fehlerbehebung

Verwenden Sie Loopback für Dienste, die nur für Ihren Mac bestimmt sind. Durch die Bindung an 0.0.0.0 oder * kann der Listener abhängig vom Netzwerk und der Firewall anderen Computern ausgesetzt werden. Eine weitergeleitete Datenbank ist immer noch eine Datenbank: Beschränken Sie, wer darauf zugreifen kann.

Wenn der Start fehlschlägt, überprüfen Sie die fehlerhafte Zeile und den fehlerhaften Port im Fehlerprotokoll. Ein verwendeter lokaler Port kann den Start des Profils verhindern. Bevorzugen Sie ungenutzte High-Ports wie 15432 gegenüber privilegierten Low-Ports.

Die lokale Portweiterleitung überträgt TCP, nicht gewöhnliches UDP. Die UDP-Unterstützung unter SOCKS ist eine andere Funktion. siehe SOCKS Proxy.

Basierend auf Secure Pipes 2.0.14 · Aktualisiert am 18. Oktober 2026