[Bug]: Relay socket dropped with code 1006 every few minutes while idle — no keepalive, no close reason logged
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 48/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- web-dev
- 领域
- networking
调研方向
Start by locating the relay-client WebSocket implementation and its close and reconnect handling; the issue does not name source files or tests. Check how the socket is kept alive and what close details are available, then trace how a relay disconnect affects connected clients. Done means idle connections stay registered, close details are diagnosable, and clients recover from a dropped link.
由索引模型根据 Issue 内容生成。
描述
Platform
Linux
Operating system version
Debian 13 (standalone server, polyscope-server 0.29.0 running as a systemd unit)
System architecture
Intel (x86_64)
PolyScope Version
0.29.0
Bug description
The relay socket to relay-edge.getpolyscope.com is closed with code 1006 ("Connection ended") on a regular cycle, and it does this when the server is completely idle — no remote client attached, no agent running, nothing hitting the API.
From our log over ~3 days on one server:
[relay-client] Disconnected from relay (code: 1006, reason: Connection ended)
[relay-client] Reconnecting in 5s...
[relay-client] Connecting to relay at wss://relay-edge.getpolyscope.com...
[relay-client] Connected to relay
[relay-client] Registered as server <id>
- 589 such drops in the log
- 539 of 589 (91%) have no client request or diff work in the 40 log lines before them — i.e. the link was idle
- Average interval while idle: ~7 minutes (a separate stretch measured 119 drops over 3.8 days ≈ 45 min; the rate degrades over uptime)
The server itself is healthy the whole time: ~1.4% CPU, 105 MB RSS, no errors, no restarts, network path to the relay fine (TLS handshake and Registered as server succeed within ~4 s every time).
Two things I can see from the client side of this binary:
- There is no application-level keepalive. Searching the compiled relay-client code, there's no
setInterval, no ping/pong, no heartbeat around the relay socket — onlyReconnecting in Nsbackoff after a close. If the edge is reaping idle WebSockets, nothing on the server is holding it open. - The close reason is never logged. We get
code: 1006, reason: Connection endedand nothing else — no close frame from the edge, no distinguishing between idle timeout, edge restart and network death.1006means "no close frame received", so it's being cut underneath the client.
Impact: every drop kills the E2E session for whatever tabs are open. The tab shows a hung/blank page and only recovers on a manual reload — some of the time not even then. Users see "Polyscope has frozen" while the server is perfectly fine.
Steps to reproduce
- Run
polyscope-serverstandalone, signed in, relay connected. - Attach no remote clients and leave it completely idle.
- Watch the log:
Disconnected from relay (code: 1006, reason: Connection ended)arrives within minutes, then reconnects, then repeats indefinitely. - Alternatively watch the socket:
ss -tinp | grep 443 | grep polyscope— the source port rotates andlastsnd/lastrcvgo stale before each close.
Expected
- The relay client should send a WebSocket ping (or equivalent keepalive) at an interval shorter than the edge's idle timeout, so an idle server stays registered.
- Log the actual close code and any close-frame reason from the edge, so this is diagnosable from the server side without guessing.
- Connected clients should be told the link dropped (and re-establish) rather than showing a hung page.
Relevant log output
[relay-client] Connecting to relay at wss://relay-edge.getpolyscope.com...
[relay-client] Connected to relay
[relay-client] Registered as server <id>
[relay-client] Remote client connected: <uuid> (1 remote)
[relay-client] E2E established with client <uuid>
[relay-client] Remote client disconnected: <uuid> (0 remote)
[relay-client] Disconnected from relay (code: 1006, reason: Connection ended) <-- no client activity, link idle
[relay-client] Reconnecting in 5s...
[relay-client] Connecting to relay at wss://relay-edge.getpolyscope.com...
[relay-client] Connected to relay
[relay-client] Registered as server <id>
- 主要语言
- 没有语言数据
- 星标
- 20
- 派生
- 0
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
beyondcode/polyscope-community 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 64/100
-
难度 2/5 1-3 小时 新手友好度 68/100
-
needs information
难度 3/5 1-2 天 新手友好度 52/100
beyondcode/polyscope-community#204 · 1 条评论 ·
-
难度 4/5 3-5 天 新手友好度 22/100
-
难度 4/5 3-5 天 新手友好度 45/100
查看 beyondcode/polyscope-community 的全部 Issue