k2safe/go-omni
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(ws): release generic WebSocket client and server v0.31.0-preview

Browse Source
This commit is contained in:
k2safe
2026-10-29 19:20:12 +08:00
parent 19ee9746e9
commit 3272974bc1
58 changed files with 7654 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
RELEASE.md
View File

@@ -1,3 +1,21 @@
# v0.31.0-preview — WebSocket
新增可选通用 [WebSocket 模块](ws/README.md)。Client/Server 共用 Session，标准 WS/WSS 可与第三方互通；RPC 是另选的版本化协议。Hub 只管理进程内连接，订阅恢复仅恢复明确保存的订阅意图，不重放历史业务消息。
现有 HTTP 功能无需改配置。独立 App 使用 `ws/omni.Mount`，生成项目在 svc 登记 WS Stop/Drain，并可手写 `RegisterCustomRoutes(*omni.App) error`；重新生成入口后自动接入。资源只在 HTTP 和 WS 后台任务均退出后释放；未能确认处理器或后台任务退出时返回 `lifecycle.ErrResourcesRetained` 并保留依赖。
默认消息 1 MiB、每方向队列 64 条/4 MiB、压缩关闭、Origin 同源；重连显式启用。用户身份、组权限、业务错误和持久化由项目决定。服务端暂支持 nethttp HTTP/1.1 Upgrade，其他 Runner 明确拒绝。依赖固定 Gorilla WebSocket v1.5.3，工具链安全状态与实际测试结果见 [验收报告](reports/websocket-validation-2026-10-29.md)。
```sh
go get git.yuntuo.hk/k2safe/go-omni@v0.31.0-preview
go install git.yuntuo.hk/k2safe/go-omni/cmd/go-omni@v0.31.0-preview
go test -race ./ws/... ./app ./httpx
go run ./examples/websocket
go run ./examples/websocketRPC
```
**已知限制**：修补工具链下，核心 WS 包扫描未发现已知漏洞；包含 `ws/omni` 的完整接入仍受原有 x/net HTTP/2 的 4 项可达漏洞影响，框架整体安全发布门槛尚未通过。浏览器实测未完成。本次发布保留 Go 1.22 源码兼容，依赖安全升级需单独完成并回归，详情和证据见上述验收报告。
# v0.30.0-preview
新增通用 `telemetry.HeaderPropagator`，让服务在不修改业务 Handler 的情况下接入使用自定义 Trace/Span/Request Header 的上游网关。配置 Header 名称后，入站建立远程父 Span，`logx.TraceID` / `RequestID`、访问日志和审计沿用上下文；出站 `telemetry.Transport` 同时注入 W3C 和兼容 Header。