来源: ranxianglei/billion-context#1982(https://github.com/ranxianglei/billion-context/issues/1982)分析「客户端侧连接请优雅关闭(close_notify+FIN),避免向下游客户端发出 RST」时发现 ## 现象 #1985 把优雅关闭覆盖了客户端侧的两条腿:MITM TLS 腿与 plain-TCP 直连腿。但 `src/mitm.ts` 的 blind tunnel(`tunnelThrough`,非白名单域名的透明字节管道)在任一侧 error/close 时仍直接 `destroy()` 双 socket——与 #1982 取证到的「响应完成后 RST」是同一失败家族,只是发生在不透明流量上。 ## 为何不能直接照搬 #1985 post-response linger 的触发点是「已完成响应之后的代理发起关闭」,其正确性依赖 HTTP 帧语义(响应完成 = 我方字节已全部交付的代理信号)。blind tunnel 没有 HTTP 帧、没有请求/响应边界,不存在天然的交付证明点;直接移植会失去语义基础。 ## 影响 走 blind tunnel 的下游客户端在连接拆除时收到 RST 而非 FIN。#1982 下游侧观察到的 196 次此类 RST 中,取证集中在 MITM 腿;blind 腿暴露面取决于实际部署里非白名单域名的流量占比。 ## 建议方向(请 owner 拍板) - **方案 A**:正常终止路径(任一侧先发出 FIN,且无错误状态)同样 resume() 排空+等待对端反向信号(有界预算,复用 BILI_POST_RESPONSE_LINGER_MS 或独立旋钮),错误路径保持 destroy。需要为「管道已排空」定义判定(例如双向都收到 FIN 即净)。 - **方案 B**:文档化 blind tunnel 不在优雅关闭保证范围内,接受现状(错误路径本就该 abortive;正常路径的 RST 风险由下游容忍)。 选 A 还是 B 取决于 blind-tunnel 流量在真实部署中的占比是否值得这套复杂度。
Activity
ranxianglei commentedon Oct 3, 2026
[bot] 🏷 结论先行:建议方案 B(文档化 blind tunnel 不在优雅关闭保证范围内),不实现 A。理由基于代码审核——本 issue 的家族归类正确,但「正常路径存在 RST 产生机制」这一前提在现行代码中不成立,A 是为一个零实例的失败模式加复杂度。请 owner 拍板。
查重结论:与 #1982/#1985 相关但非重复——#1982/#1985 覆盖 MITM TLS 腿与 plain-TCP HTTP 腿,本 issue 是 blind(非白名单)腿,范围独立,带来源标记立项合规,保持打开。
审核取证(先纠正 issue 描述的一处分寸)
src/mitm.ts:182-240tunnelThrough:established 之后只有upstream.pipe(clientSocket); clientSocket.pipe(upstream)两个 error handler 会destroy()双 socket;两个closehandler 只递减计数器。普通 close 不触发 destroy。issue 说「任一侧 error/close 时仍直接 destroy()」中的 close 半边不成立——destroy 只出现在错误路径(及建立前的 502/504 超时/失败路径)。pipe()默认{end: true}——upstream FIN →clientSocket.end(),client FIN →upstream.end(),双向 FIN 由内核自然完成四向握手,全程无任何 destroy。建议:客户端侧连接请优雅关闭(close_notify+FIN),避免向下游客户端发出 RST #1982 定位的两个结构性 RST 产生器(destroySoon()同 tick end+destroy、TLSWrap.close()结构性 destroy 裸 socket)在 blind tunnel 里都不存在。我逐一推演了正常路径各时序(单侧先 FIN、双向同时关、背压暂停期间对端 FIN、half-close 残留字节)——均无 destroy 介入点,无 RST 机制。rec.lastResponseEndAt !== null(server.tsinstallPostResponseLingerwrappedDestroy),blind socket 永不产生请求/响应周期,该值恒为 null——即使把机制装上去也永远不会 arm。照搬确实失去语义基础。server.closeAllConnections()(src/restart.ts:191)是进程级事件,对所有连接种类一视同仁,下游按代理重启重连处理,非 blind 特有缺口。destroyed关闭从 debug 升 warn 并带[ABORTIVE — peer may see RST/ECONNRESET]标记——注意错误路径连带销毁健康 client 腿时,那条健康腿的记录恰好分类为destroyed(自身无 error 事件),会打出 warn 行。也就是说:若真实部署中 blind 腿 RST ever 成为问题,bili.log 会先于用户报告暴露它;届时可凭证据重启 A 的讨论。结构化七问
[ABORTIVE]行 + ledger reqs=0 记录)作为未来复核入口。若 owner 选 A:实现路径为在 tunnelThrough 的正常终止分支(任一侧 'end' 且无 error)resume() 排空+等反向 FIN(有界预算复用BILI_POST_RESPONSE_LINGER_MS),「管道已排空」判定取双向 FIN 齐备——但这是在给零实例缺陷建机制,我不推荐。BILI_POST_RESPONSE_LINGER_MS,不加新旋钮——除非 owner 认为 blind 腿需要独立预算)。判定:建议 B,等 owner 拍板。拍板后我开一个 docs-only PR(Closes #1986)落地边界声明;若拍 A,我按上面第 3 条的实现路径+定向测试(真实子进程 CONNECT 到 mock upstream,断言双侧干净 EOF、无 ECONNRESET)另立 PR。