Docker启动Postgres容器报错：端口不可用（权限限制）求助

1. 排查端口占用情况 #

先确认54322端口是否被其他进程占用：

• Windows系统执行命令：

  netstat -ano | findstr :54322
  

找到输出中的PID，打开任务管理器结束对应进程。如果占用端口的是系统关键进程，直接更换端口更稳妥。

2. 修改Docker端口映射配置 #

如果端口无法释放，直接调整端口映射：

• 打开项目根目录的docker-compose.yml，找到postgres服务的ports配置项，把54322:5432改成其他未被占用的端口，比如54323:5432
• 同步修改app.env里的数据库连接端口，确保应用能正确连接到Postgres容器

3. 解决Windows端口预留限制 #

Windows会预留部分端口给系统服务，若54322在预留范围内，会导致无法绑定：

• 先查看预留端口范围：

  netsh int ipv4 show excludedportrange protocol=tcp
  

如果54322在输出范围内，执行以下步骤：

1. 停止winnat服务：

   net stop winnat
   

2. 右键任务栏Docker图标，选择“Restart”重启Docker Desktop服务
3. 重新启动winnat服务：

   net start winnat
   

• 若问题仍存在，可手动调整动态端口范围（需管理员权限）：

  netsh int ipv4 set dynamicport tcp start=49152 num=16384
  

执行后重启电脑，确保54322不在动态端口范围内。

4. 提升权限运行相关程序 #

普通用户权限可能不足以绑定端口：

• 右键Docker Desktop图标，选择“以管理员身份运行”
• 用管理员权限打开命令提示符/终端，再执行docker-compose up命令

5. 检查防火墙或杀毒软件拦截 #

部分安全软件会拦截Docker的端口绑定操作：

• 暂时关闭Windows防火墙或第三方杀毒软件，尝试启动容器
• 若能正常启动，在安全软件中添加Docker相关的端口允许规则，或把Docker进程加入信任列表

内容的提问来源于stack exchange，提问作者Eugene Zaryanov