GYscan ws -u URL [选项]
WebSocket测试工具,支持WebSocket连接测试、消息发送、响应断言、自动重连、心跳检测等功能。
基本选项:
-u, --url URL
WebSocket服务器地址 (ws://host:port/path 或 wss://host:port/path)
-m, --message 内容
发送的消息内容,默认:Hello GYscan
-t, --type 类型
消息类型:text(默认)或 binary
-H, --header 请求头
自定义HTTP头,格式:Key:Value,可多次使用
-c, --count 次数
发送消息次数,默认1次
-i, --interval 间隔
发送消息间隔,默认1秒
-o, --timeout 时间
超时时间,默认10秒
-v, --verbose
详细输出模式
连接选项:
--skip-verify
跳过TLS证书验证(用于WSS连接)
--origin 字符串
Origin请求头值
--subprotocols 协议列表
WebSocket子协议列表,逗号分隔
--send-delay 时间
发送消息后延迟
--network-timeout 时间
网络操作超时时间,默认10秒
自动重连选项:
-r, --reconnect
启用自动重连机制
-k, --retries 次数
最大重试次数,默认5
-d, --max-delay 时间
最大重连延迟,默认30秒
响应断言选项:
-a, --assert 断言规则
响应断言,验证服务器响应是否符合预期
支持格式:
contains:text - 响应包含指定文本
regex:pattern - 响应匹配正则表达式
json:field:value - JSON响应中指定字段的值
length_greater:N - 响应长度大于N
心跳检测选项:
--heartbeat
启用心跳检测
--heartbeat-msg 内容
心跳消息内容,默认:ping
--heartbeat-interval 时间
心跳间隔,默认30秒
使用示例:
GYscan ws -u ws://192.168.1.100:8080/echo连接WebSocket服务器并发送默认消息
GYscan ws -u wss://echo.websocket.org -m "Hello" -v连接WSS服务器并启用详细输出
GYscan ws -u ws://192.168.1.100:8080 -m "test" -c 5 -i 2发送5次消息,间隔2秒
GYscan ws -u ws://192.168.1.100:8080 -H "Authorization:Bearer token123"携带自定义HTTP头连接
GYscan ws -u ws://192.168.1.100:8080 -a contains:Hello -a regex:^PONG使用响应断言验证服务器响应
GYscan ws -u ws://192.168.1.100:8080 --heartbeat --heartbeat-msg ping --heartbeat-interval 10s启用心跳检测,每10秒发送ping消息
GYscan ws -u ws://192.168.1.100:8080 -r -k 10 -d 60s启用自动重连,最多10次,最大延迟60秒
GYscan ws -u ws://192.168.1.100:8080 -t binary -m "base64:SGVsbG8="发送二进制消息(支持base64/hex编码)