websocat

WebSocket 客户端/服务端与数据转发工具

补充说明

websocat 可以在 WebSocket、TCP、stdio、文件之间转发数据，适合调试 WebSocket 服务和构造简单服务端。

常用示例

websocat ws://localhost:8080/ws
websocat -t ws://localhost:8080/ws
websocat -l 127.0.0.1:9000 -
websocat --header 'Authorization: Bearer TOKEN' wss://example.com/ws

易错点与排错

• 默认可能是二进制模式；文本协议加 -t，否则对端可能收到 binary frame。
• wss:// 需要正确 TLS/证书；自签证书用 -k 仅限测试。
• 服务端模式 -l 要确认绑定地址；默认可能暴露到所有接口。
• --header/--origin 缺失会被服务端拒绝；浏览器同源策略在 CLI 里不适用，但服务端可能校验。
• 代理环境要设置 https_proxy/ws_proxy；不是所有版本都支持。
• 长连接要加 ping/重连；断线后默认不会自动恢复。
• 不要把 websocat 暴露成无认证的公网 shell/转发器。