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
相关产品推荐
相关产品推荐

