Проверить WebSocket-рукопожатие
Выполняет HTTP Upgrade вручную, проверяет код 101 и правильность Sec-WebSocket-Accept.
Что делает скрипт
Скрипт подключается к ws или wss URL, отправляет корректный WebSocket handshake и сверяет ответный ключ. При успехе отправляется кадр закрытия, чтобы не оставлять соединение. Для wss сертификат проверяется по умолчанию, --insecure отключает проверку.
Быстрый старт
python websocket_check.py ws://127.0.0.1:8080/ws
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python websocket_check.py ws://127.0.0.1:8080/wspython websocket_check.py wss://example.com/socket --origin https://example.compython websocket_check.py wss://127.0.0.1:8443/ws --insecure
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
websocket_check.py
#!/usr/bin/env python3
"""Проверка WebSocket-рукопожатия без внешних библиотек."""
from __future__ import annotations
import argparse
import base64
import hashlib
import os
import socket
import ssl
import sys
from urllib.parse import urlsplit
GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"
def recv_until(sock: socket.socket, marker: bytes, limit: int = 65536) -> bytes:
data = b""
while marker not in data:
chunk = sock.recv(4096)
if not chunk:
break
data += chunk
if len(data) > limit:
break
return data
def build_request(host_header: str, path: str, key: str, origin: str | None) -> bytes:
lines = [
f"GET {path} HTTP/1.1",
f"Host: {host_header}",
"Upgrade: websocket",
"Connection: Upgrade",
f"Sec-WebSocket-Key: {key}",
"Sec-WebSocket-Version: 13",
]
if origin:
lines.append(f"Origin: {origin}")
return ("\r\n".join(lines) + "\r\n\r\n").encode("ascii")
def main() -> int:
parser = argparse.ArgumentParser(description="Проверить WebSocket-рукопожатие")
parser.add_argument("url", help="ws:// или wss:// URL")
parser.add_argument("--origin", help="Значение заголовка Origin")
parser.add_argument("--timeout", type=float, default=8.0, help="Таймаут соединения")
parser.add_argument("--insecure", action="store_true", help="Не проверять сертификат wss")
args = parser.parse_args()
parts = urlsplit(args.url)
if parts.scheme not in {"ws", "wss"} or not parts.hostname:
parser.error("Нужен ws:// или wss:// URL")
secure = parts.scheme == "wss"
host = parts.hostname
port = parts.port or (443 if secure else 80)
host_header = host if port == (443 if secure else 80) else f"{host}:{port}"
path = parts.path or "/"
if parts.query:
path += "?" + parts.query
key = base64.b64encode(os.urandom(16)).decode("ascii")
request = build_request(host_header, path, key, args.origin)
expected_accept = base64.b64encode(hashlib.sha1((key + GUID).encode("ascii")).digest()).decode("ascii")
try:
raw = socket.create_connection((host, port), timeout=args.timeout)
raw.settimeout(args.timeout)
if secure:
context = ssl.create_default_context()
if args.insecure:
context.check_hostname = False
context.verify_mode = ssl.CERT_NONE
sock = context.wrap_socket(raw, server_hostname=host)
else:
sock = raw
except (OSError, ssl.SSLError) as error:
print(f"Ошибка соединения: {error}", file=sys.stderr)
return 1
try:
sock.sendall(request)
response = recv_until(sock, b"\r\n\r\n")
header_blob, _, rest = response.partition(b"\r\n\r\n")
if not header_blob:
print("Сервер закрыл соединение без ответа", file=sys.stderr)
return 1
lines = header_blob.decode("iso-8859-1", "replace").split("\r\n")
status_line = lines[0]
headers: dict[str, str] = {}
for line in lines[1:]:
if ":" in line:
name, value = line.split(":", 1)
headers[name.strip().lower()] = value.strip()
print(f"Статус: {status_line}")
if not status_line.startswith("HTTP/1.1 101"):
print("Ожидался код 101 Switching Protocols", file=sys.stderr)
return 1
if headers.get("upgrade", "").lower() != "websocket":
print("Нет заголовка Upgrade: websocket", file=sys.stderr)
return 1
actual_accept = headers.get("sec-websocket-accept", "")
if actual_accept != expected_accept:
print("Неверный Sec-WebSocket-Accept", file=sys.stderr)
return 1
print("Рукопожатие успешно")
payload = (1000).to_bytes(2, "big")
mask = os.urandom(4)
masked = bytes(byte ^ mask[index % 4] for index, byte in enumerate(payload))
frame = bytes([0x88, 0x80 | len(payload)]) + mask + masked
sock.sendall(frame)
try:
sock.settimeout(1.0)
sock.recv(1024)
except OSError:
pass
return 0
except OSError as error:
print(f"Ошибка обмена: {error}", file=sys.stderr)
return 1
finally:
sock.close()
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.