websockify - Online in de cloud

PROGRAMMA:

NAAM

websockify - WebSockets naar TCP-socketbrug

KORTE INHOUD

websockify [opties] [source_addr:]source_port target_addr:target_port
websockify [opties] [source_addr:]source_port -- WRAP_COMMAND_LINE

OPTIES

-h, --help toon dit helpbericht en sluit af
-v, --verbose uitgebreide berichten en verkeer per frame
--record=FILE neem sessies op in FILE.[sessie_nummer]
-D, --daemon wordt een daemon (achtergrondproces)
--run-once handelt een enkele WebSocket-verbinding af en sluit af
--timeout=TIMEOUT na TIMEOUT seconden verlaten wanneer er geen verbinding is
--cert=CERT SSL-certificaatbestand
--key=KEY SSL-sleutelbestand (indien gescheiden van cert)
--ssl-only staat niet-gecodeerde verbindingen niet toe
--web=DIR voer de webserver uit op dezelfde poort. Serveer bestanden vanuit DIR.
--wrap-mode=MODE actie die moet worden ondernomen wanneer het ingepakte programma afsluit of
daemoniseert: afsluiten (standaard), negeren, respawn

PRODUCTBESCHRIJVING

Op het meest basale niveau vertaalt websockify gewoon WebSockets-verkeer naar normaal TCP
stopcontactverkeer. Websockify accepteert de WebSockets-handshake, parseert deze en begint vervolgens
het doorsturen van verkeer tussen de cliënt en het doel in beide richtingen.

websockify heette voorheen wsproxy en maakte deel uit van het noVNC-project.

OPMERKINGEN

WebSockets binair gegevens
Websockify ondersteunt alle versies van het WebSockets-protocol (Hixie en HyBI). De oudere
Hixie-versies van het protocol ondersteunen alleen UTF-8-tekstpayloads. Om te vervoeren
binaire gegevens via UTF-8, er moet een codering worden gebruikt om de gegevens in UTF-8 in te kapselen.
Websockify gebruikt base64 om al het verkeer van en naar de client te coderen. Dit heeft geen invloed
de gegevens tussen websockify en de server.

gecodeerde WebSocket verbindingen (wss://)
Om het verkeer te versleutelen met behulp van het WebSocket 'wss://' URI-schema, moet u een
certificaat voor websockify om te laden. Standaard laadt websockify een certificaatbestandsnaam
self.pem maar de optie --cert=CERT kan de bestandsnaam overschrijven. U kunt een zelf-
ondertekend certificaat met openssl. Wanneer u om de algemene naam wordt gevraagd, gebruikt u de hostnaam van het
server waarop de proxy zal draaien:

openssl req -new -x509 -dagen 365 -nodes -out self.pem -keyout self.pem

Websok Javascript bibliotheek
De websock.js (zie https://github.com/kanaka/websockify) Javascript-bibliotheekbibliotheek
biedt een Websock-object dat vergelijkbaar is met het standaard WebSocket-object, maar dan met Websock
maakt communicatie mogelijk met onbewerkte TCP-sockets (dwz de binaire stroom) via websockify. Dit
wordt bereikt door base64-codering van de gegevensstroom tussen Websock en websockify.

Websock heeft ingebouwde buffering voor ontvangstwachtrijen; de berichtgebeurtenis bevat geen actual
gegevens, maar is eenvoudigweg een melding dat er nieuwe gegevens beschikbaar zijn. Verschillende rQ*-methoden
zijn beschikbaar om binaire gegevens uit de ontvangstwachtrij te lezen.

De Websock API is gedocumenteerd op de websock.js API-wikipagina:

https://github.com/kanaka/websockify/wiki/websock.js

Zie het gedeelte 'Een programma inpakken' hieronder voor een voorbeeld van het gebruik van Websock en websockify als
browser telnet-client (wstelnet.html).

Extra websockify functionaliteiten
Deze zijn niet nodig voor de basiswerking.

* Daemoniseren: wanneer de optie -D is opgegeven, draait websockify op de achtergrond als
een daemon-proces.

* SSL (de wss:// WebSockets URI): Dit wordt automatisch gedetecteerd door websockify by
snuiven van de eerste byte die door de client is verzonden en vervolgens de socket inpakken als de
gegevens beginnen met '\x16' of '\x80' (wat SSL aangeeft).

* Flash-beveiligingsbeleid: websockify detecteert verzoeken om flash-beveiligingsbeleid (opnieuw door
snuiven van het eerste pakket) en antwoordt met een passend flash-beveiligingsbeleid
antwoord (en sluit vervolgens de poort). Dit betekent dat er geen apart flash-beveiligingsbeleid is
server is nodig voor ondersteuning van de flash WebSockets fallback-emulator.

* Sessieopname: deze functie maakt het mogelijk om het verzonden verkeer op te nemen
ontvangen van de client naar een bestand met behulp van de optie --record.

* Mini-webserver: websockify kan normale webverzoeken op het internet detecteren en erop reageren
dezelfde poort als de WebSockets-proxy en het Flash-beveiligingsbeleid. Deze functionaliteit is
activeer met de optie --web DIR waarbij DIR de hoofdmap van de webmap is
dienen.

* Een programma inpakken: zie het gedeelte 'Een programma inpakken' hieronder.

Wikkel a Programma
Naast proxying van een bronadres naar een doeladres (dat zich mogelijk op een
ander systeem), heeft websockify de mogelijkheid om een ​​programma op het lokale systeem te starten en
proxy WebSockets-verkeer naar een normale TCP-poort die eigendom is van/gebonden is aan het programma.

Dit wordt bereikt met een kleine LD_PRELOAD-bibliotheek (rebind.so) die bind() onderschept
systeemaanroepen door het programma. De opgegeven poort wordt verplaatst naar een nieuwe localhost/loopback free
hoge haven. websockify proxy's vervolgens WebSockets-verkeer dat naar de oorspronkelijke poort wordt geleid
nieuwe (verplaatste) poort van het programma.

De programma-omloopmodus wordt geactiveerd door het doel te vervangen door -- gevolgd door het programma
opdrachtregel om in te pakken.

`./websockify 2023 -- PROGRAMMA ARGS`

De --wrap-mode optie kan worden gebruikt om aan te geven welke actie moet worden ondernomen bij het inpakken
programma wordt afgesloten of gedaemoniseerd.

Hier is een voorbeeld van het gebruik van websockify om de opdracht vncserver (welke achtergronden
zelf) voor gebruik met noVNC:

`./websockify 5901 --wrap-mode=ignore -- vncserver -geometrie 1024x768:1`

Hier is een voorbeeld van het inpakken van telnetd (van krb5-telnetd).telnetd eindigt na de
de verbinding wordt gesloten, zodat de wrap-modus wordt ingesteld om de opdracht opnieuw uit te voeren:

`sudo ./websockify 2023 --wrap-mode=respawn -- telnetd -debug 2023`

De wstelnet.html-pagina demonstreert een eenvoudige, op WebSockets gebaseerde telnet-client.

Gebruik websockify online met behulp van onworks.net-services