主要更新内容
- 终端 WebSocket 连接新增 Ping/Pong 心跳保活(30 s 间隔、75 s 读超时),防止 Nginx / Cloudflare 等反向代理因空闲超时断开等待中的连接,并及时检测半开套接字(如休眠浏览器)。
- 会话清理定时器改为"首次挂起时锁定截止时间":浏览器断开后,被控端因代理空闲超时反复断线重连不再无限续期 5 分钟保留窗口;双方重新就位后下一次挂起才获得新窗口。
admin.terminate_terminal_sessionsRPC 新增可选参数client_id,允许终止仍附着在同一浏览器标签页上的半开会话(关闭标签页后残留的半开套接字场景)。ListRecoverableSessions现在会过滤掉已超过清理截止时间的会话,不再返回已过期条目。
Bug修复
- 修复被控端因反向代理空闲超时(Nginx 60 s / Cloudflare 100 s)反复断线重连时,会话保留定时器被无限重置、导致挂起会话永远无法被回收的问题。
- 修复半开 WebSocket 连接(如浏览器休眠)未被及时检测,会话长期处于悬空状态的问题。
- 修复关闭浏览器标签页后残留半开套接字,导致该会话无法通过常规"可恢复会话"路径终止的问题。
其他
SafeConn新增SetPongHandler方法,支持自定义 Pong 帧处理。- 协议注释修正:服务端→被控端消息列表补充
ready帧。 terminalSessionRetention由const改为var,便于测试中调整保留时长。- 新增
recoverable_test.go(319 行),覆盖挂起会话清理、代理抖动不续期、半开连接终止等场景;forward_test.go补充被控端收到ready帧的断言。
Commits
Full Changelog: 1.6.2...Snapshot-2611211259