Skip to content

建议:blind tunnel(tunnelThrough)连接拆除同为 abortive 关闭,属 #1982 同一 RST 家族 #1986

Closed

Description

@ranxianglei

来源: #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

  1. ranxianglei commented on Oct 3, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 结论先行:建议方案 B(文档化 blind tunnel 不在优雅关闭保证范围内),不实现 A。理由基于代码审核——本 issue 的家族归类正确,但「正常路径存在 RST 产生机制」这一前提在现行代码中不成立,A 是为一个零实例的失败模式加复杂度。请 owner 拍板。

    查重结论:与 #1982/#1985 相关但非重复——#1982/#1985 覆盖 MITM TLS 腿与 plain-TCP HTTP 腿,本 issue 是 blind(非白名单)腿,范围独立,带来源标记立项合规,保持打开。

    审核取证(先纠正 issue 描述的一处分寸)

    1. src/mitm.ts:182-240 tunnelThrough:established 之后只有 upstream.pipe(clientSocket); clientSocket.pipe(upstream) 两个 error handler 会 destroy() 双 socket;两个 close handler 只递减计数器。普通 close 不触发 destroy。issue 说「任一侧 error/close 时仍直接 destroy()」中的 close 半边不成立——destroy 只出现在错误路径(及建立前的 502/504 超时/失败路径)。
    2. 正常终止路径今天已经是优雅的: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 机制。
    3. fix(server): graceful post-response client close — linger for peer close signal (#1982) #1985 的 linger 机制结构性覆盖不了 blind 腿,印证 issue 的判断:gate 要求 rec.lastResponseEndAt !== null(server.ts installPostResponseLinger wrappedDestroy),blind socket 永不产生请求/响应周期,该值恒为 null——即使把机制装上去也永远不会 arm。照搬确实失去语义基础。
    4. blind 腿的真实拆除面清点(既有行为清单):① 错误路径双 destroy——语义上就该 abortive(死隧道无可保护对象,排空死对端只会放大暴露面;与 fix(server): graceful post-response client close — linger for peer close signal (#1982) #1985「error paths deliberately stay abortive」同一决策);② 建立前 502/504 write+同 tick destroy——错误路径,客户端无论如何都拿到连接失败并重试;③ Node KAT 不作用于 CONNECT socket(无已完成响应周期;实证:建议:客户端侧连接请优雅关闭(close_notify+FIN),避免向下游客户端发出 RST #1982 台账里裸腿存活 29.8s ≫ 5s KAT 默认值),idle blind 隧道不会被 reaper 杀;④ self-restart 的 server.closeAllConnections()(src/restart.ts:191)是进程级事件,对所有连接种类一视同仁,下游按代理重启重连处理,非 blind 特有缺口。
    5. 观测性已经就位(这是 B 的关键补强):blind-tunnel clientSocket 走真实 accept,进 conn ledger(kind=tcp, reqs=0——建议:客户端侧连接请优雅关闭(close_notify+FIN),避免向下游客户端发出 RST #1982 台账里 reqs=0 的裸腿记录即此通道)。fix(server): graceful post-response client close — linger for peer close signal (#1982) #1985 合入后,任何 bare destroyed 关闭从 debug 升 warn 并带 [ABORTIVE — peer may see RST/ECONNRESET] 标记——注意错误路径连带销毁健康 client 腿时,那条健康腿的记录恰好分类为 destroyed(自身无 error 事件),会打出 warn 行。也就是说:若真实部署中 blind 腿 RST ever 成为问题,bili.log 会先于用户报告暴露它;届时可凭证据重启 A 的讨论。

    结构化七问

    1. 是什么问题:blind tunnel(非白名单域名的透明字节管道)连接拆除仍含 destroy 形态,疑似属 建议:客户端侧连接请优雅关闭(close_notify+FIN),避免向下游客户端发出 RST #1982「响应完成后 RST」家族;issue 提请 owner 在 A(正常路径优雅排空)/ B(文档化排除)之间拍板。
    2. 什么原因导致的:审核修正——「原因」层的前提部分不成立:正常终止路径经 pipe() end 传播已是优雅关闭,RST 产生器不存在;现存 destroy 全部位于错误/超时路径,而该路径上 abortive 是正确语义(隧道已死)。blind 腿与 建议:客户端侧连接请优雅关闭(close_notify+FIN),避免向下游客户端发出 RST #1982 的关联是「同家族、不同暴露面」,不是「同一缺陷未修完」。
    3. 怎么修复的:未实施(等拍板)。建议 B:在 fix(server): graceful post-response client close — linger for peer close signal (#1982) #1985 引入的连接生命周期文档处(README 新小节/CONFIGURATION.md)加一段边界声明——优雅关闭保证以 HTTP 帧语义(响应完成 = 交付证明点)为界,opaque pipe 无此语义、不在保证范围内,错误路径保持 abortive 为有意设计;并指明观测通道(warn [ABORTIVE] 行 + ledger reqs=0 记录)作为未来复核入口。若 owner 选 A:实现路径为在 tunnelThrough 的正常终止分支(任一侧 'end' 且无 error)resume() 排空+等反向 FIN(有界预算复用 BILI_POST_RESPONSE_LINGER_MS),「管道已排空」判定取双向 FIN 齐备——但这是在给零实例缺陷建机制,我不推荐。
    4. 是否有回归问题:不涉及(尚未改码)。上述第 4 条即为既有行为清点:KAT 不触碰 blind 隧道、错误路径语义不变、restart drain 行为不变,B 方案仅增文档、零行为变更。
    5. 是否破坏缓存:不涉及。
    6. 是否改了设计方向:不改。B 维持 fix(server): graceful post-response client close — linger for peer close signal (#1982) #1985 的边界(交付证明点 = linger 的语义基础)并把它显式文档化;A 反而会把保证扩展到无语义域,属于方向性扩展,当前证据不足以支撑。
    7. 是否引入了新的配置:不涉及(B 零配置;若选 A 则复用 BILI_POST_RESPONSE_LINGER_MS,不加新旋钮——除非 owner 认为 blind 腿需要独立预算)。

    判定:建议 B,等 owner 拍板。拍板后我开一个 docs-only PR(Closes #1986)落地边界声明;若拍 A,我按上面第 3 条的实现路径+定向测试(真实子进程 CONNECT 到 mock upstream,断言双侧干净 EOF、无 ECONNRESET)另立 PR。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions