Сеть и диагностика

Проверить WebSocket-рукопожатие

Выполняет HTTP Upgrade вручную, проверяет код 101 и правильность Sec-WebSocket-Accept.

Python Windows macOS Linux Продвинутый
Скачать websocket_check.py
Описание

Что делает скрипт

Скрипт подключается к 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/ws
  • python websocket_check.py wss://example.com/socket --origin https://example.com
  • python websocket_check.py wss://127.0.0.1:8443/ws --insecure
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get network-websocket-check
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Сеть и диагностика

Проверка соединений, DNS, портов, скорости и сетевых настроек.