Ini ialah arahan websockify yang boleh dijalankan dalam penyedia pengehosan percuma OnWorks menggunakan salah satu daripada berbilang stesen kerja dalam talian percuma kami seperti Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS.
JADUAL:
NAMA
websockify - WebSockets ke jambatan soket TCP
SINOPSIS
websockify [pilihan] [source_addr:]source_port target_addr:target_port
websockify [pilihan] [source_addr:]source_port -- WRAP_COMMAND_LINE
PILIHAN
-h, --help tunjukkan mesej bantuan ini dan keluar
-v, --mesej verbose verbose dan trafik setiap bingkai
--record=FILE rekod sesi ke FILE.[session_number]
-D, --daemon menjadi daemon (proses latar belakang)
--run-sekali mengendalikan sambungan WebSocket tunggal dan keluar
--timeout=TIMEOUT selepas TIMEOUT saat keluar apabila tidak disambungkan
--cert=Fail sijil SSL CERT
--key=KEY fail kunci SSL (jika berasingan daripada sijil)
--ssl-only tidak membenarkan sambungan tidak disulitkan
--web=DIR jalankan pelayan web pada port yang sama. Layan fail daripada DIR.
--wrap-mode=MODE tindakan yang perlu diambil apabila program yang dibalut keluar atau
daemonizes: keluar (lalai), abaikan, respawn
DESCRIPTION
Pada peringkat paling asas, websockify hanya menterjemahkan trafik WebSockets kepada TCP biasa
trafik soket. Websockify menerima jabat tangan WebSockets, menghuraikannya, dan kemudian bermula
memajukan trafik antara pelanggan dan sasaran dalam kedua-dua arah.
websockify dahulunya dinamakan wsproxy dan merupakan sebahagian daripada projek noVNC.
NOTA
Soket Web perduaan data
Websockify menyokong semua versi protokol WebSockets (Hixie dan HyBI). Yang lebih tua
Versi protokol Hixie hanya menyokong muatan teks UTF-8. Untuk mengangkut
data binari melalui UTF-8 pengekodan mesti digunakan untuk merangkum data dalam UTF-8.
Websockify menggunakan base64 untuk mengekod semua trafik ke dan dari klien. Ini tidak menjejaskan
data antara websockify dan pelayan.
Dienkripsi WebSocket sambungan (wss://)
Untuk menyulitkan trafik menggunakan skema URI WebSocket 'wss://' anda perlu menjana a
sijil untuk websockify dimuatkan. Secara lalai websockify memuatkan nama fail sijil
self.pem tetapi pilihan --cert=CERT boleh mengatasi nama fail. Anda boleh menjana kendiri
sijil ditandatangani menggunakan openssl. Apabila diminta untuk nama biasa, gunakan nama hos bagi
pelayan tempat proksi akan dijalankan:
openssl req -baharu -x509 -hari 365 -nod -keluar self.pem -keyout self.pem
Websock Javascript perpustakaan
Websock.js (lihat https://github.com/kanaka/websockify) Pustaka perpustakaan Javascript
menyediakan objek Websock yang serupa dengan objek WebSocket standard tetapi Websock
membolehkan komunikasi dengan soket TCP mentah (iaitu aliran binari) melalui websockify. ini
dicapai dengan pengekodan base64 aliran data antara Websock dan websockify.
Websock telah terbina dalam menerima penimbalan baris gilir; peristiwa mesej tidak mengandungi sebenar
data tetapi hanyalah pemberitahuan bahawa terdapat data baharu yang tersedia. Beberapa kaedah rQ*
tersedia untuk membaca data binari daripada baris gilir terima.
API Websock didokumenkan pada halaman wiki API websock.js:
https://github.com/kanaka/websockify/wiki/websock.js
Lihat bahagian "Balut Program" di bawah untuk contoh penggunaan Websock dan websockify sebagai a
klien telnet pelayar (wstelnet.html).
Tambahan melayari laman web ciri-ciri
Ini tidak diperlukan untuk operasi asas.
* Daemonizing: Apabila pilihan -D ditentukan, websockify berjalan di latar belakang sebagai
proses daemon.
* SSL (URI wss:// WebSockets): Ini dikesan secara automatik oleh websockify oleh
menghidu bait pertama yang dihantar daripada klien dan kemudian membalut soket jika
data bermula dengan '\x16' atau '\x80' (menunjukkan SSL).
* Dasar keselamatan kilat: websockify mengesan permintaan dasar keselamatan kilat (sekali lagi oleh
menghidu paket pertama) dan menjawab dengan dasar keselamatan kilat yang sesuai
tindak balas (dan kemudian menutup port). Ini bermakna tiada dasar keselamatan kilat yang berasingan
pelayan diperlukan untuk menyokong emulator sandaran WebSockets flash.
* Rakaman sesi: Ciri ini yang membenarkan rakaman trafik yang dihantar dan
diterima daripada klien ke fail menggunakan pilihan --record.
* Pelayan web mini: websockify boleh mengesan dan bertindak balas kepada permintaan web biasa pada
port yang sama seperti proksi WebSockets dan dasar keselamatan Flash. Fungsi ini adalah
aktifkan dengan pilihan --web DIR di mana DIR ialah punca direktori web
hidang.
* Balut program: lihat bahagian "Balut Program" di bawah.
Doh Dumpling a Program
Sebagai tambahan kepada proksi daripada alamat sumber kepada alamat sasaran (yang mungkin pada a
sistem yang berbeza), websockify mempunyai keupayaan untuk melancarkan program pada sistem tempatan dan
trafik WebSockets proksi ke port TCP biasa yang dimiliki/terikat oleh program.
Ini dicapai dengan perpustakaan LD_PRELOAD kecil (rebind.so) yang memintas bind()
panggilan sistem oleh program. Port yang ditentukan dipindahkan ke localhost/loopback percuma yang baharu
pelabuhan tinggi. websockify kemudian proksi trafik WebSockets diarahkan ke port asal ke
port baru (dipindahkan) program.
Mod bungkus program digunakan dengan menggantikan sasaran dengan -- diikuti oleh program
baris arahan untuk dibalut.
`./websockify 2023 -- ARGS PROGRAM`
Pilihan --wrap-mode boleh digunakan untuk menunjukkan tindakan yang perlu diambil apabila dibungkus
program keluar atau daemoni.
Berikut ialah contoh menggunakan websockify untuk membungkus arahan vncserver (yang mana latar belakang
sendiri) untuk digunakan dengan noVNC:
`./websockify 5901 --wrap-mode=ignore -- vncserver -geometry 1024x768 :1`
Berikut ialah contoh pembalut telnetd (dari krb5-telnetd).telnetd keluar selepas
sambungan ditutup supaya mod bungkus ditetapkan untuk mengeluarkan semula arahan:
`sudo ./websockify 2023 --wrap-mode=respawn -- telnetd -debug 2023`
Halaman wstelnet.html menunjukkan klien telnet berasaskan WebSockets yang ringkas.
Gunakan websockify dalam talian menggunakan perkhidmatan onworks.net
