websockify - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

websockify - WebSockets tới cầu nối TCP socket

SYNOPSIS

websockify [tùy chọn] [source_addr:] source_port target_addr: target_port
websockify [tùy chọn] [source_addr:] source_port - WRAP_COMMAND_LINE

LỰA CHỌN

-h, --help hiển thị thông báo trợ giúp này và thoát
-v, - thông báo chi tiết và lưu lượng truy cập trên mỗi khung hình
--record = FILE ghi các phiên vào FILE. [session_number]
-D, --daemon trở thành một daemon (tiến trình nền)
- chạy một lần xử lý một kết nối WebSocket duy nhất và thoát
--timeout = TIMEOUT sau TIMEOUT giây thoát khi không kết nối
--cert = CERT Tệp chứng chỉ SSL
--key = KEY tệp khóa SSL (nếu tách biệt với cert)
--ssl-only không cho phép các kết nối không được mã hóa
--web = DIR chạy máy chủ web trên cùng một cổng. Cung cấp tệp từ DIR.
--wrap-mode = MODE hành động để thực hiện khi chương trình được bao bọc thoát ra hoặc
daemonizes: thoát (mặc định), bỏ qua, hồi sinh

MÔ TẢ

Ở cấp độ cơ bản nhất, websockify chỉ dịch lưu lượng truy cập WebSockets sang TCP bình thường
lưu lượng ổ cắm. Websockify chấp nhận bắt tay WebSockets, phân tích cú pháp nó và sau đó bắt đầu
chuyển tiếp lưu lượng truy cập giữa khách hàng và mục tiêu theo cả hai hướng.

websockify trước đây có tên là wsproxy và là một phần của dự án noVNC.

GHI CHÚ

WebSockets nhị phân dữ liệu
Websockify hỗ trợ tất cả các phiên bản của giao thức WebSockets (Hixie và HyBI). Cũ hơn
Các phiên bản Hixie của giao thức chỉ hỗ trợ tải trọng văn bản UTF-8. Để vận chuyển
dữ liệu nhị phân trên UTF-8 một mã hóa phải được sử dụng để đóng gói dữ liệu trong UTF-8.
Websockify sử dụng base64 để mã hóa tất cả lưu lượng truy cập đến và đi từ máy khách. Điều này không ảnh hưởng
dữ liệu giữa websockify và máy chủ.

Được mã hóa WebSocket kết nối (wss: //)
Để mã hóa lưu lượng bằng lược đồ WebSocket 'wss: //' URI, bạn cần tạo một
chứng chỉ cho websockify để tải. Theo mặc định, websockify tải tên tệp chứng chỉ
self.pem nhưng tùy chọn --cert = CERT có thể ghi đè tên tệp. Bạn có thể tạo ra một
chứng chỉ đã ký sử dụng openssl. Khi được yêu cầu tên thông thường, hãy sử dụng tên máy chủ của
máy chủ nơi proxy sẽ chạy:

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

Websock Javascript thư viện
Thư viện thư viện Javascript websock.js (xem https://github.com/kanaka/websockify)
cung cấp một đối tượng Websock tương tự như đối tượng WebSocket tiêu chuẩn nhưng Websock
cho phép giao tiếp với các ổ cắm TCP thô (tức là luồng nhị phân) thông qua websockify. Cái này
được thực hiện bằng cách mã hóa base64 luồng dữ liệu giữa Websock và websockify.

Websock tích hợp sẵn bộ đệm hàng đợi nhận; sự kiện tin nhắn không chứa thực tế
dữ liệu nhưng chỉ đơn giản là một thông báo rằng có sẵn dữ liệu mới. Một số phương pháp rQ *
có sẵn để đọc dữ liệu nhị phân từ hàng đợi nhận.

API Websock được ghi lại trên trang wiki API websock.js:

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

Xem phần "Kết thúc chương trình" bên dưới để biết ví dụ về cách sử dụng Websock và websockify làm
trình duyệt telnet client (wstelnet.html).

thêm vào websockify Tính năng, đặc điểm
Chúng không cần thiết cho các hoạt động cơ bản.

* Daemonizing: Khi tùy chọn -D được chỉ định, websockify sẽ chạy trong nền dưới dạng
một quy trình daemon.

* SSL (the wss: // WebSockets URI): Điều này được phát hiện tự động bởi websockify bởi
đánh hơi byte đầu tiên được gửi từ máy khách và sau đó gói ổ cắm nếu
dữ liệu bắt đầu bằng '\ x16' hoặc '\ x80' (cho biết SSL).

* Chính sách bảo mật flash: websockify phát hiện các yêu cầu chính sách bảo mật flash (một lần nữa bằng cách
đánh hơi gói đầu tiên) và trả lời bằng chính sách bảo mật flash thích hợp
phản hồi (và sau đó đóng cổng). Điều này có nghĩa là không có chính sách bảo mật flash riêng biệt
máy chủ cần thiết để hỗ trợ trình giả lập dự phòng WebSockets flash.

* Ghi phiên: Tính năng này cho phép ghi lại lưu lượng đã gửi và
nhận được từ máy khách đến một tệp bằng cách sử dụng tùy chọn --record.

* Máy chủ web nhỏ: websockify có thể phát hiện và phản hồi các yêu cầu web bình thường trên
giống cổng như proxy WebSockets và chính sách bảo mật Flash. Chức năng này là
kích hoạt với tùy chọn --web DIR trong đó DIR là thư mục gốc của thư mục web để
giao banh.

* Kết thúc chương trình: xem phần "Kết thúc chương trình" bên dưới.

Quấn a chương trình
Ngoài việc ủy ​​quyền từ địa chỉ nguồn đến địa chỉ đích (có thể nằm trên
hệ thống khác), websockify có khả năng khởi chạy một chương trình trên hệ thống cục bộ và
proxy WebSockets lưu lượng truy cập đến một cổng TCP bình thường do chương trình sở hữu / ràng buộc.

Điều này được thực hiện với một thư viện LD_PRELOAD nhỏ (rebind.so) chặn bind ()
các cuộc gọi hệ thống của chương trình. Cổng đã chỉ định được chuyển sang một localhost / loopback mới miễn phí
cổng cao. websockify sau đó proxy lưu lượng truy cập WebSockets được chuyển hướng đến cổng ban đầu đến
cổng mới (đã di chuyển) của chương trình.

Chế độ gói chương trình được gọi bằng cách thay thế đích bằng - theo sau là chương trình
dòng lệnh để bọc.

`./websockify 2023 - ARGS CHƯƠNG TRÌNH`

Tùy chọn --wrap-mode có thể được sử dụng để chỉ ra hành động cần thực hiện khi gói
chương trình thoát hoặc daemonizes.

Đây là một ví dụ về việc sử dụng websockify để bọc lệnh vncserver (nền
chính nó) để sử dụng với noVNC:

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

Đây là một ví dụ về gói telnetd (từ krb5-telnetd) .telnetd thoát sau
kết nối đóng để chế độ bọc được đặt để hiển thị lại lệnh:

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

Trang wstelnet.html trình bày một ứng dụng khách telnet đơn giản dựa trên WebSockets.

Sử dụng websockify trực tuyến bằng các dịch vụ onworks.net