websockify - Online sa Cloud

PROGRAMA:

NAME

websockify - Mga WebSocket hanggang TCP socket bridge

SINOPSIS

websockify [mga opsyon] [source_addr:]source_port target_addr:target_port
websockify [mga opsyon] [source_addr:]source_port -- WRAP_COMMAND_LINE

Opsyon

-h, --help ipakita ang mensahe ng tulong na ito at lumabas
-v, --verbose verbose na mga mensahe at bawat frame na trapiko
--record=FILE itala ang mga session sa FILE.[session_number]
-D, --daemon ay naging isang daemon (proseso sa background)
--run-once hawakan ang isang koneksyon sa WebSocket at lumabas
--timeout=TIMEOUT pagkatapos ng TIMEOUT segundo lumabas kapag hindi nakakonekta
--cert=CERT SSL certificate file
--key=KEY SSL key file (kung hiwalay sa cert)
--ssl-only hindi pinapayagan ang mga hindi naka-encrypt na koneksyon
--web=DIR magpatakbo ng webserver sa parehong port. Ihatid ang mga file mula sa DIR.
--wrap-mode=MODE aksyon na gagawin kapag lumabas ang nakabalot na programa o
daemonizes: exit (default), huwag pansinin, respawn

DESCRIPTION

Sa pinakapangunahing antas, isinasalin lamang ng websockify ang trapiko ng WebSockets sa normal na TCP
socket traffic. Tinatanggap ng Websockify ang WebSockets handshake, i-parse ito, at pagkatapos ay magsisimula
pagpapasa ng trapiko sa pagitan ng kliyente at ng target sa parehong direksyon.

Ang websockify ay dating pinangalanang wsproxy at naging bahagi ng noVNC project.

NOTA

Mga WebSocket doble data
Sinusuportahan ng Websockify ang lahat ng bersyon ng WebSockets protocol (Hixie at HyBI). Mas matanda
Sinusuportahan lamang ng mga bersyon ng Hixie ng protocol ang mga payload ng teksto ng UTF-8. Upang maihatid
binary data sa UTF-8 isang encoding ang dapat gamitin para i-encapsulate ang data sa loob ng UTF-8.
Gumagamit ang Websockify ng base64 upang i-encode ang lahat ng trapiko papunta at mula sa kliyente. Hindi ito nakakaapekto
ang data sa pagitan ng websockify at ng server.

Naka-encrypt WebSocket koneksyon (wss://)
Upang i-encrypt ang trapiko gamit ang WebSocket 'wss://' URI scheme kailangan mong bumuo ng a
sertipiko para ma-load ang websockify. Bilang default, naglo-load ang websockify ng pangalan ng file ng certificate
self.pem ngunit ang --cert=CERT na opsyon ay maaaring i-override ang pangalan ng file. Maaari kang bumuo ng isang self-
nilagdaan ang sertipiko gamit ang openssl. Kapag tinanong ang karaniwang pangalan, gamitin ang hostname ng
server kung saan tatakbo ang proxy:

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

Websock Javascript aklatan
Ang websock.js (tingnan ang https://github.com/kanaka/websockify) library ng library ng Javascript
nagbibigay ng Websock object na katulad ng karaniwang WebSocket object ngunit Websock
nagbibigay-daan sa komunikasyon sa mga hilaw na TCP socket (ibig sabihin, ang binary stream) sa pamamagitan ng websockify. Ito
ay nagagawa sa pamamagitan ng base64 na pag-encode ng stream ng data sa pagitan ng Websock at websockify.

Ang Websock ay may built-in na receive queue buffering; ang kaganapan ng mensahe ay hindi naglalaman ng aktwal
data ngunit isa lamang abiso na mayroong bagong data na magagamit. Ilang rQ* na pamamaraan
ay magagamit upang basahin ang binary data mula sa nakatanggap na pila.

Ang Websock API ay nakadokumento sa websock.js API na pahina ng wiki:

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

Tingnan ang seksyong "Wrap a Program" sa ibaba para sa isang halimbawa ng paggamit ng Websock at websockify bilang a
browser telnet client (wstelnet.html).

karagdagan websockify mga tampok
Ang mga ito ay hindi kinakailangan para sa pangunahing operasyon.

* Daemonizing: Kapag ang -D na opsyon ay tinukoy, ang websockify ay tumatakbo sa background bilang
isang proseso ng daemon.

* SSL (ang wss:// WebSockets URI): Awtomatikong nade-detect ito ng websockify ni
sinisinghot ang unang byte na ipinadala mula sa kliyente at pagkatapos ay i-wrap ang socket kung ang
ang data ay nagsisimula sa '\x16' o '\x80' (nagsasaad ng SSL).

* Patakaran sa seguridad ng flash: nakita ng websockify ang mga kahilingan sa patakaran sa seguridad ng flash (muli ni
pagsinghot sa unang packet) at mga sagot na may naaangkop na patakaran sa seguridad ng flash
tugon (at pagkatapos ay isasara ang port). Nangangahulugan ito na walang hiwalay na patakaran sa seguridad ng flash
server ay kailangan para sa pagsuporta sa flash WebSockets fallback emulator.

* Pagre-record ng session: Ang tampok na ito na nagpapahintulot sa pag-record ng trapiko na ipinadala at
natanggap mula sa kliyente sa isang file gamit ang --record na opsyon.

* Mini-webserver: ang websockify ay maaaring makakita at tumugon sa mga normal na kahilingan sa web sa
parehong port tulad ng WebSockets proxy at patakaran sa seguridad ng Flash. Ang pag-andar na ito ay
i-activate gamit ang --web DIR na opsyon kung saan ang DIR ang ugat ng web directory
maglingkod

* I-wrap ang isang programa: tingnan ang seksyong "I-wrap ang isang Programa" sa ibaba.

Balutin a Programa
Bilang karagdagan sa pag-proxy mula sa isang source address patungo sa isang target na address (na maaaring nasa a
ibang sistema), ang websockify ay may kakayahang maglunsad ng isang programa sa lokal na sistema at
proxy na trapiko ng WebSockets sa isang normal na TCP port na pagmamay-ari/nakatali ng program.

Nagagawa ang isang maliit na LD_PRELOAD library (rebind.so) na humarang sa bind()
mga tawag sa system ng programa. Ang tinukoy na port ay inilipat sa isang bagong localhost/loopback na libre
mataas na port. websockify pagkatapos ay i-proxy ang trapiko ng WebSockets na nakadirekta sa orihinal na port sa
bagong (inilipat) na port ng programa.

Ang program wrap mode ay ginagamit sa pamamagitan ng pagpapalit sa target ng -- na sinusundan ng program
command line upang ibalot.

`./websockify 2023 -- PROGRAM ARGS`

Ang --wrap-mode na opsyon ay maaaring gamitin upang isaad kung anong aksyon ang gagawin kapag nakabalot
paglabas o pag-demonize ng programa.

Narito ang isang halimbawa ng paggamit ng websockify upang i-wrap ang vncserver command (na ang mga background
mismo) para gamitin sa noVNC:

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

Narito ang isang halimbawa ng pagbabalot ng telnetd (mula sa krb5-telnetd).telnetd ay lalabas pagkatapos ng
ang koneksyon ay nagsasara upang ang wrap mode ay nakatakda upang respawn muli ang command:

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

Ang wstelnet.html page ay nagpapakita ng isang simpleng WebSockets based telnet client.

Gumamit ng websockify online gamit ang mga serbisyo ng onworks.net