Asjdf

一只在杭电摸鱼的小火鸡

彻底解决docker在windows上的端口绑定问题

2022-11-10 大约945字 预计阅读2分钟

我相信不少开发者正在或曾经使用 docker 起后端开发环境,那么肯定有不少人遇到过这个莫名奇妙的错误:

Error invoking remote method ‘docker-start-container’: Error: (HTTP code 500) server error - Ports are not available: listen tcp 0.0.0.0:xxxx: bind: An attempt was made to access a socket in a way forbidden by access permissions.

20221110222201-2022-11-10-22-22-02

上面的图片来自网络,我当时忙着处理事务忘记截图了。

我一开始遇到这种问题是直接尝试重启(大多数时候能够解决该问题),直到这一次重启也不管用了,我才重新开始审视这个错误。

考虑到您可能没有耐心看下去(我相信大多数人遇到这个问题的时候没空细究起因),我先把解决方案贴在前面。

# 解决方案

# 正确的解决方案

简单地重新设置“TCP 动态端口范围”,以便 Hyper-V 只保留我们设置的范围内的端口。您可以通过以管理员权限运行以下命令将“TCP 动态端口范围”重置为 49152–65535,但如果您认为它太大,也可以将其更改为较小的范围。

请在命令行中执行下列命令设置动态端口范围:

netsh int ipv4 set dynamic tcp start=49152 num=16384
netsh int ipv6 set dynamic tcp start=49152 num=16384

然后重启电脑。

# 错误的解决方案

来自 StackOverflow 的错误解决方案 在该问题的高赞回答中,他使用了以下命令:

                
                net stop winnat
docker start container_name
net start winnat
                
            

这命令的实质是简化版的重启电脑,让 Hyper-V 初始化一些随机端口来保留,如果没有它仍然没有释放你所需要的端口,你可能不得不再做这样的操作。也就是因此,该回答下面有些人回复有用,有些人回复没用,就是因为这种解决方式解决问题的概率非常的随机。

# 错误背景

进入正题,为什么会发生这个错误?这里不得不说明一下两个和问题有关的特性。

  • Windows 中个东西叫做“TCP 动态端口范围”,这个范围内的端口有时候会被一些服务占用。在 Windows Vista(或 Windows Server 2008)之前,动态端口范围是 1025 到 5000;在其之后的版本中,新的默认起始端口为 49152,新的默认结束端口为 65535。
  • 如果安装了 Hyper-V,则 Hyper-V 会保留一些随机端口号供 Windows 容器主机网络服务使用。

一般情况(正常情况下)Hyper-V 会在“TCP 动态端口范围”中预留一些随机的端口号,但是预留的端口号一般都很大,所以即使预留了成百上千个端口,也影响不大。但是 Windows 自动更新有时会出错(万恶的自动更新),把“TCP 动态端口范围”起始端口被重置为 1024,导致 Hyper-V 在预留端口的时候占用了常用端口号,使得一些常用端口因为被预留而无法使用。

你可以使用命令 netsh int ipv4 show dynamicport tcp 查看当前的“TCP 动态端口范围”,还可使用 netsh int ipv4 show excludeportrange protocol=tcp 查看当前已经被征用的端口。

闽ICP备2022001901号-1 公安网备图标闽公网安备35030302354429号

主题 atom-hugo-theme