Docker部署Gatsby v5应用无法通过localhost访问求助

核心问题分析 #

• 初始配置中，docker-compose.yml映射了9000:9000，但Gatsby develop命令默认使用8000端口，容器内实际运行的服务端口是8000，导致外部9000端口没有对应服务，自然无法访问。
• 切换到npm start后，若package.json中的start命令未明确指定端口和绑定地址，Gatsby仍会默认用8000端口且可能仅绑定容器内的localhost，外部无法通过本地localhost访问，这就是只能通过容器IP访问的原因。

分步解决方案 #

1. 修正package.json的start命令 #

确保start命令明确指定绑定0.0.0.0和目标端口9000：

{
  "scripts": {
    "start": "gatsby develop -H 0.0.0.0 -p 9000"
  }
}

• -H 0.0.0.0：让服务监听容器内所有网卡地址，允许外部通过端口映射访问
• -p 9000：指定服务运行在9000端口，和docker-compose.yml的映射端口对应

2. 确认docker-compose.yml的端口映射正确性 #

保持端口映射为9000:9000，确保容器内端口和外部端口一致：

version: "3.9"

services:
  node:
    build: .
    volumes:
      - .:/usr/src/app
      - /usr/src/app/node_modules
    ports:
      - "9000:9000"  # 外部9000端口映射到容器内9000端口
    command: npm start
    tty: true

3. 检查端口占用情况 #

确保本地9000端口未被其他程序占用，执行以下命令排查：

# Linux/macOS
lsof -i :9000

# Windows
netstat -ano | findstr :9000

如果端口被占用，要么停止占用程序，要么修改docker-compose.yml中的外部端口（比如改成9001:9000）。

4. 验证Docker端口转发 #

重启Docker服务后重新启动容器，确保端口转发规则生效：

docker-compose down
docker-compose up --build

启动后查看容器端口映射状态：

docker inspect <容器名称或ID> | grep -A 10 "Ports"

确认输出中包含0.0.0.0:9000->9000/tcp或[::]:9000->9000/tcp。

额外注意事项 #

• 不要依赖容器内部IP访问，因为容器IP每次重启可能变化，端口映射是标准访问方式
• 若使用Docker Desktop，确保"Settings -> Resources -> Network"中的端口转发未被限制
• 检查本地防火墙是否允许9000端口的入站连接

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