You need to enable JavaScript to run this app. WSL2版Windows Docker中非活跃TCP套接字自动断开原因及解决办法
优惠活动
大模型
产品
解决方案
定价
更多

WSL2版Windows Docker中非活跃TCP套接字自动断开原因及解决办法

WSL2 Docker容器空闲TCP连接6分钟自动断开问题成因及解决方案

问题成因

这是WSL2虚拟NAT网络栈的已知设计特性,其默认的连接跟踪表会强制清理空闲时长达到390秒(6分30秒)的TCP连接条目,且不会向连接两端发送FIN或RST通知,触发上层应用感知到连接被断开。你观察到的所有空闲连接同时断开的现象,正是因为该清理机制是全局定时触发的,而非按单个连接的建立时间单独计时。

解决方案

方案1:修改WSL2系统级TCP保活配置(永久生效)

在WSL2发行版内编辑/etc/sysctl.conf文件,添加以下参数:

net.ipv4.tcp_keepalive_time = 120
net.ipv4.tcp_keepalive_intvl = 30
net.ipv4.tcp_keepalive_probes = 8

保存后执行sysctl -p即可立即生效。该配置会让TCP连接每120秒无活动就自动发送保活报文,避免被NAT连接跟踪表判定为空闲连接清理。
如果需要让Docker容器默认继承该配置,可在Docker启动命令中添加--sysctl参数传递上述配置,或修改Docker daemon的全局默认sysctl配置。

方案2:应用层开启TCP保活(无系统权限时适用)

无需修改系统配置,直接在业务代码中开启TCP套接字的保活选项,将保活触发间隔设置为小于390秒即可。例如Node.js环境可调用socket.setKeepAlive(true, 120000),其余编程语言均有对应TCP保活的配置接口。

方案3:切换WSL2镜像网络模式(彻底解决NAT相关问题)

如果你的Windows版本支持WSL2镜像网络功能(Windows 11 22H2及以上、Windows 10最新累积更新),可在Windows用户目录下创建.wslconfig文件,添加以下配置:

[wsl2]
networkingMode=mirrored

保存后执行wsl --shutdown重启WSL即可。该模式下WSL2直接共享Windows主机的网络栈,不存在独立的NAT层,自然不会触发连接超时清理问题。

内容的提问来源于stack exchange,提问作者Wyck

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 14:06:03