Docker容器内运行ng serve无法外部访问的问题排查

环境信息 #

• 宿主机：Windows 11
• 容器系统：Linux Alpine

问题详情 #

为常规Angular应用编写了Dockerfile、package.json、docker-compose.yml及docker-compose.override.yml配置（代码片段如下）：

• package.json：

{...}

• Dockerfile：

...

• docker-compose.yml：

...

• docker-compose.override.yml：

...

运行docker compose后无报错，容器日志显示服务正常启动，且在容器内访问127.0.0.1:44464正常。已尝试移除npm start脚本中的SSL证书并添加--host 0.0.0.0，但宿主机浏览器仍无法访问该服务。

排查与解决方案 #

1. 检查端口映射配置 #

确认docker-compose（或override）文件中是否正确将容器内的Angular服务端口映射到宿主机端口。例如容器内服务监听44464，需添加：

services:
  your-app:
    ports:
      - "44464:44464" # 格式：宿主机端口:容器内端口

Windows环境下可通过netstat -ano | findstr :44464检查端口是否被系统占用。

2. 确认Angular服务监听地址 #

即使添加了--host 0.0.0.0，仍需验证服务是否真的监听所有网卡。在容器内执行：

ss -tulpn | grep 44464

若输出显示0.0.0.0:44464或:::44464则监听正常；若仅显示127.0.0.1:44464，需检查npm脚本是否正确传递参数：

"scripts": {
  "start": "ng serve --host 0.0.0.0 --port 44464"
}

同时确认Dockerfile中执行的是npm start，未覆盖该命令。

3. 检查Windows防火墙设置 #

Windows Defender防火墙可能拦截端口入站请求，可临时关闭防火墙测试，或添加允许规则：

• 打开「Windows Defender防火墙」→「高级设置」→「入站规则」→「新建规则」
• 选择「端口」→ 输入映射的宿主机端口 → 允许连接 → 应用到所有网络类型

4. 验证Docker网络模式（WSL2后端） #

若Docker使用WSL2后端，可尝试host网络模式测试（该模式下无需端口映射，直接用localhost:44464访问）：

services:
  your-app:
    network_mode: "host"

注意：host模式仅在Windows的Docker Desktop WSL2后端中支持。

5. 检查WSL2网络转发 #

若Docker基于WSL2，可能存在网络转发问题，可在管理员PowerShell中执行：

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=44464 connectaddress=$(wsl hostname -I | cut -d' ' -f1) connectport=44464

执行后重启Docker Desktop。

6. 测试宿主机端口连通性 #

在宿主机用PowerShell测试端口是否可达：

Test-NetConnection localhost -Port 44464

若返回TcpTestSucceeded: True，说明端口连通正常，问题可能在Angular服务本身或浏览器缓存；若失败，回到端口映射和防火墙环节排查。

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