ws 命令 - GYscan

← 返回文档导航

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编码)