Socat: Unterschied zwischen den Versionen

Aktuelle Version vom 14. Oktober 2025, 12:26 Uhr

socat - Multipurpose relay (SOcket CAT)

Beschreibung

Bidirektionale Byte-Streams aufauben

Daten überagen

Da die Streams aus einer Vielzahl unterschiedlicher Datensenken und -quellen (siehe Adresstypen) aufgebaut werden können

da viele Adressoptionen auf die Streams angewendet werden können, kann socat für viele verschiedene Zwecke verwendet werden Filan ist ein Dienstprogramm, das Informationen über seine aktiven Dateideskriptoren auf stdout ausgibt
Es wurde zum Debuggen von socat geschrieben, kann aber auch für andere Zwecke nützlich sein
Verwenden Sie die Option -h, um weitere Informationen zu erhalten

Procan

Procan ist ein Dienstprogramm, das Informationen über Prozessparameter auf stdout ausgibt

Es wurde geschrieben, um einige UNIX-Prozesseigenschaften besser zu verstehen und zum Debuggen von socat, kann aber auch für andere Zwecke nützlich sein

Lebenszyklus

Der Lebenszyklus einer socat-Instanz besteht in der Regel aus vier Phasen

Init-Phase

In der init-Phase werden die Befehlszeilenoptionen geparst und die Protokollierung initialisiert Während der open-Phase öffnet socat die erste Adresse und anschließend die zweite Adresse

Diese Schritte sind in der Regel blockierend; daher müssen insbesondere bei komplexen Adresstypen wie Socks Verbindungsanfragen oder Authentifizierungsdialoge abgeschlossen sein, bevor der nächste Schritt gestartet wird

Übertragungsphase

In der Übertragungsphase überwacht socat die Lese- und Schreib-Dateideskriptoren beider Streams über select() und wenn auf einer Seite Daten verfügbar sind und auf die andere Seite geschrieben werden können, liest socat diese, führt bei Bedarf Zeilenumbruchkonvertierungen durch und schreibt die Daten in den Schreib-Dateideskriptor des anderen Streams, um dann weiter auf weitere Daten in beide Richtungen zu warten Wenn einer der Streams effektiv EOF erreicht, beginnt die Schließungsphase

Socat überträgt die EOF-Bedingung an den anderen Stream, d. h. es versucht, nur seinen Schreibstream zu schließen, um ihm die Möglichkeit zu geben, ordnungsgemäß zu beenden
Für eine definierte Zeit überträgt socat weiterhin Daten in die andere Richtung, schließt dann aber alle verbleibenden Kanäle und beendet sich

Installation

sudo apt install socat

Aufruf

socat [options] <address> <address>
socat -V
socat -h[h[h]] | -?[?[?]]
filan
procan

Optionen

Unix	GNU	Parameter	Beschreibung

Parameter

Umgebungsvariablen

Exit-Status

Wert	Beschreibung
0	Erfolg
>0	Fehler

Anwendung

Daten von stdin über TCP an 192.168.0.10:80 senden und Antwort anzeigen

socat - TCP:192.168.0.10:80

Auf Port 8080 lauschen und Datenverkehr an 192.168.0.10 auf Port 80 weiterleiten

socat TCP-LISTEN:8080,fork TCP:192.168.0.10:80

Erstellen Sie einen einfachen TCP-Echo-Server auf Port 9000

socat TCP-LISTEN:9000,reuseaddr fork EXEC:/bin/cat

Leiten Sie den Datenverkehr zwischen den Ports 1234 und 5678 auf localhost weiter u

socat TCP4-LISTEN:1234 fork TCP4:localhost:5678

Lesen Sie die Eingabe vom Terminal und senden Sie sie an den UDP-Server study-notes.org#

socat STDIN UDP:192.168.0.10:5678 Dan Nanni

Stellen Sie eine Datei über TCP bereit. Verbinden Sie sich mit Port 8081, um die Protokolldatei zu lesen

socat TCP-LISTEN:8081,fork FILE:/path/to/output.log

Daten über TCP an Port 6000 empfangen und an eine lokale Datei anhängen

socat TCP-LISTEN:6000,reuseaddr OPEN:/path/to/file,create,append

Leiten Sie den TCP-Datenverkehr an Port 7000 an ein serielles Gerät mit einer Baudrate von 115200 weiter

socat TCP-LISTEN:7000,fork /dev/ttyUSB0,b115200,raw

Auf einem UNIX-Socket lauschen und eingehende Daten wiedergeben

socat UNIX-LISTEN:/tmp/mysocket,fork EXEC:/bin/cat

500 ms Verzögerung für weitergeleiteten Datenverkehr zwischen den Ports 12345 und 80 einführen

socat TCP4-LISTEN:12345,fork,delay=500ms TCP4:localhost:80

Verbindung zu example.com auf Port 443 herstellen und dabei die Zertifikatsüberprüfung deaktivieren

socat - OPENSSL:example.com:443,verify=0

Auf Port 8443 über SSL/TLS als einfacher SSL-Echo-Server lauschen

socat OPENSSL-LISTEN:8443,cert=server.pem,verify=0,fork EXEC:/bin/cat

Auf lokalem Port 8080 lauschen und Datenverkehr über SSL/TLS an example.com weiterleiten

socat TCP-LISTEN:8080,fork OPENSSL:www.example.com:443,verify=0

SSL-Verbindungen auf 8443 akzeptieren und an Nicht-SSL 8080 weiterleiten

socat OPENSSL-LISTEN:8443,cert=test.pem,verify=0,fork TCP:localhost:8080

Fehlerbehebung

Konfiguration

Dateien

Datei	Beschreibung

Anhang

Siehe auch

Dokumentation

Man-Page

socat(1)

Links

Projekt

Weblinks

@@ Zeile 1: / Zeile 1: @@
-'''{{BASEPAGENAME}}''' - Beschreibung
+'''socat''' - Multipurpose relay (SOcket CAT)
 == Beschreibung ==
+; Bidirektionale Byte-Streams aufauben
+* Daten überagen
+Da die Streams aus einer Vielzahl unterschiedlicher Datensenken und -quellen (siehe Adresstypen) aufgebaut werden können
+* da viele Adressoptionen auf die Streams angewendet werden können, kann socat für viele verschiedene Zwecke verwendet werden Filan ist ein Dienstprogramm, das Informationen über seine aktiven Dateideskriptoren auf stdout ausgibt
+* Es wurde zum Debuggen von socat geschrieben, kann aber auch für andere Zwecke nützlich sein
+* Verwenden Sie die Option -h, um weitere Informationen zu erhalten
+; Procan
+Procan ist ein Dienstprogramm, das Informationen über Prozessparameter auf stdout ausgibt
+* Es wurde geschrieben, um einige UNIX-Prozesseigenschaften besser zu verstehen und zum Debuggen von socat, kann aber auch für andere Zwecke nützlich sein
+; Lebenszyklus
+Der Lebenszyklus einer socat-Instanz besteht in der Regel aus vier Phasen
+; Init-Phase
+In der init-Phase werden die Befehlszeilenoptionen geparst und die Protokollierung initialisiert Während der open-Phase öffnet socat die erste Adresse und anschließend die zweite Adresse
+* Diese Schritte sind in der Regel blockierend; daher müssen insbesondere bei komplexen Adresstypen wie Socks Verbindungsanfragen oder Authentifizierungsdialoge abgeschlossen sein, bevor der nächste Schritt gestartet wird
+; Übertragungsphase
+In der Übertragungsphase überwacht socat die Lese- und Schreib-Dateideskriptoren beider Streams über select() und wenn auf einer Seite Daten verfügbar sind und auf die andere Seite geschrieben werden können, liest socat diese, führt bei Bedarf Zeilenumbruchkonvertierungen durch und schreibt die Daten in den Schreib-Dateideskriptor des anderen Streams, um dann weiter auf weitere Daten in beide Richtungen zu warten
+Wenn einer der Streams effektiv EOF erreicht, beginnt die Schließungsphase
+* Socat überträgt die EOF-Bedingung an den anderen Stream, d.&nbsp;h.&nbsp;es versucht, nur seinen Schreibstream zu schließen, um ihm die Möglichkeit zu geben, ordnungsgemäß zu beenden
+* Für eine definierte Zeit überträgt socat weiterhin Daten in die andere Richtung, schließt dann aber alle verbleibenden Kanäle und beendet sich
 == Installation ==
 <syntaxhighlight lang="bash" highlight="1" line copy>
-< /syntaxhighlight>
+sudo apt install socat
+</syntaxhighlight>
 == Aufruf ==
 <syntaxhighlight lang="bash" highlight="1" line copy>
-< /syntaxhighlight>
+socat [options] <address> <address>
+socat -V
+socat -h[h[h]] | -?[?[?]]
+filan
+procan
+</syntaxhighlight>
 === Optionen ===
@@ Zeile 33: / Zeile 64: @@
 == Anwendung ==
+Daten von stdin über TCP an 192.168.0.10:80 senden und Antwort anzeigen
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat - TCP:192.168.0.10:80
+</syntaxhighlight>
+Auf Port 8080 lauschen und Datenverkehr an 192.168.0.10 auf Port 80 weiterleiten
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat TCP-LISTEN:8080,fork TCP:192.168.0.10:80
+</syntaxhighlight>
+Erstellen Sie einen einfachen TCP-Echo-Server auf Port 9000
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat TCP-LISTEN:9000,reuseaddr fork EXEC:/bin/cat
+</syntaxhighlight>
+Leiten Sie den Datenverkehr zwischen den Ports 1234 und 5678 auf localhost weiter u
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat TCP4-LISTEN:1234 fork TCP4:localhost:5678
+</syntaxhighlight>
+Lesen Sie die Eingabe vom Terminal und senden Sie sie an den UDP-Server study-notes.org#
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat STDIN UDP:192.168.0.10:5678 Dan Nanni
+</syntaxhighlight>
+Stellen Sie eine Datei über TCP bereit. Verbinden Sie sich mit Port 8081, um die Protokolldatei zu lesen
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat TCP-LISTEN:8081,fork FILE:/path/to/output.log
+</syntaxhighlight>
+Daten über TCP an Port 6000 empfangen und an eine lokale Datei anhängen
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat TCP-LISTEN:6000,reuseaddr OPEN:/path/to/file,create,append
+</syntaxhighlight>
+Leiten Sie den TCP-Datenverkehr an Port 7000 an ein serielles Gerät mit einer Baudrate von 115200 weiter
 <syntaxhighlight lang="bash" highlight="1" line copy>
-< /syntaxhighlight>
+socat TCP-LISTEN:7000,fork /dev/ttyUSB0,b115200,raw
+</syntaxhighlight>
-=== Problembehebung ===
+Auf einem UNIX-Socket lauschen und eingehende Daten wiedergeben
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat UNIX-LISTEN:/tmp/mysocket,fork EXEC:/bin/cat
+</syntaxhighlight>
+ms Verzögerung für weitergeleiteten Datenverkehr zwischen den Ports 12345 und 80 einführen
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat TCP4-LISTEN:12345,fork,delay=500ms TCP4:localhost:80
+</syntaxhighlight>
+Verbindung zu example.com auf Port 443 herstellen und dabei die Zertifikatsüberprüfung deaktivieren
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat - OPENSSL:example.com:443,verify=0
+</syntaxhighlight>
+Auf Port 8443 über SSL/TLS als einfacher SSL-Echo-Server lauschen
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat OPENSSL-LISTEN:8443,cert=server.pem,verify=0,fork EXEC:/bin/cat
+</syntaxhighlight>
+Auf lokalem Port 8080 lauschen und Datenverkehr über SSL/TLS an example.com weiterleiten
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat TCP-LISTEN:8080,fork OPENSSL:www.example.com:443,verify=0
+</syntaxhighlight>
+SSL-Verbindungen auf 8443 akzeptieren und an Nicht-SSL 8080 weiterleiten
+<syntaxhighlight lang="bash" highlight="1" line copy>
+socat OPENSSL-LISTEN:8443,cert=test.pem,verify=0,fork TCP:localhost:8080
+</syntaxhighlight>
+=== Fehlerbehebung ===
 == Konfiguration ==
@@ Zeile 61: / Zeile 159: @@
 === Dokumentation ===
 ; Man-Page
-# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]
+# [https://manpages.debian.org/stable/socat/socat.1.en.html socat(1)]
 <!--
@@ Zeile 71: / Zeile 169: @@
 ==== Weblinks ====
-{{DEFAULTSORT:new}}
+{{DEFAULTSORT:socat}}
-{{DISPLAYTITLE:new}}
+{{DISPLAYTITLE:socat}}
 [[Kategorie:new]]
 </noinclude>
-= TMP =
-Send data from stdin to 192.168.0.10:80 over TCP and show response
- socat - TCP:192.168.0.10:80
-Listen on port 8080 and forward traffic to 192.168.0.10 at port 80
- socat TCP-LISTEN:8080,fork TCP:192.168.0.10:80
-Create a simple TCP echo server on port 9000
- socat TCP-LISTEN:9000,reuseaddr fork EXEC:/bin/cat
-Relay traffic between ports 1234 and 5678 on localhost u
- socat TCP4-LISTEN:1234 fork TCP4:localhost:5678
-Read input from the terminal and send it to UDP server study-notes.org#
- socat STDIN UDP:192.168.0.10:5678 Dan Nanni
-Serve a file over TCP. Connect to port 8081 to read the log file
- socat TCP-LISTEN:8081,fork FILE:/path/to/output.log
-Receive data over TCP at port 6000 and append it to a local file
- socat TCP-LISTEN:6000,reuseaddr OPEN:/path/to/file,create,append
-socat TCP-LISTEN:7000,fork /dev/ttyUSB0,b115200,raw
-Forward TCP traffic on port 7000 to a serial device at 115200 baud rate
-socat UNIX-LISTEN:/tmp/mysocket,fork EXEC:/bin/cat
-Listen on a UNIX socket and echo incoming data
-socat TCP4-LISTEN:12345,fork,delay=500ms TCP4:localhost:80
-Introduce 500ms delay to forwarded traffic between ports 12345 and 80
-socat - OPENSSL:example.com:443,verify=0
-Connect to example.com on port 443 while disabling certificate verification
-socat OPENSSL-LISTEN:8443,cert=server.pem,verify=0,fork EXEC:/bin/cat
-Listen on port 8443 over SSL/TLS as a simple SSL echo server
-socat TCP-LISTEN:8080,fork OPENSSL:www.example.com:443,verify=0
-Listen on local port 8080 and forward traffic to example.com over SSL/TLS
-socat OPENSSL-LISTEN:8443,cert=test.pem,verify=0,fork TCP:localhost:8080
-Accept SSL connections on 8443 and forward them to non-SSL 8080