如何将Docker容器连接至本地主机（localhost）

1. 修正React应用的监听地址 #

React开发服务器默认仅绑定容器内的localhost，外部无法访问。启动时需指定监听所有网络接口：

• 临时启动命令（容器内执行）：

  HOST=0.0.0.0 npm start
  

• 永久修改package.json的启动脚本：

  "scripts": {
    "start": "HOST=0.0.0.0 react-scripts start"
  }
  

2. 启动容器时配置端口映射 #

必须将容器内的React端口（默认3000）映射到本地主机端口，否则本地无法直接访问容器内服务。示例命令：

docker run -d -p 3000:3000 [你的容器镜像名或ID]

• 格式说明：-p 本地端口:容器端口，如果本地3000端口被占用，可替换为其他端口，比如-p 3001:3000，之后访问localhost:3001即可。

3. 验证端口映射状态 #

启动容器后，执行以下命令确认映射生效：

docker ps

查看输出的PORTS列，若显示0.0.0.0:3000->3000/tcp或:::3000->3000/tcp，说明映射成功。

4. 检查本地防火墙设置 #

若上述步骤完成后仍无法访问，检查本地主机防火墙是否允许对应端口的入站请求：

• Ubuntu系统（ufw防火墙）：

  sudo ufw allow 3000
  

• Windows/macOS：在系统防火墙设置中，添加对应端口的允许规则。

5. 确认容器内应用的监听状态 #

进入容器内部，检查端口是否被正确监听：

# 进入容器终端
docker exec -it [容器ID或名称] bash
# 检查3000端口监听情况
netstat -tulpn | grep 3000

若输出包含0.0.0.0:3000，说明应用已正确绑定到所有接口。

内容的提问来源于stack exchange，提问作者Arjun-Phalguna