如何配置Hasura+Docker Compose+Traefik实现Actions跨服务调用？

1. 统一Docker网络配置 #

不同Docker Compose项目默认使用独立的隔离网络，导致Hasura容器无法直接访问另一个Compose中的API容器。解决思路是让两个服务加入同一个共享网络：

• 先创建自定义共享网络：

  docker network create shared-backend-network
  

• 在Hasura所在的docker-compose.yml中，给Hasura服务指定该网络：

  services:
    hasura:
      # 其他配置
      networks:
        - shared-backend-network
  networks:
    shared-backend-network:
      external: true
  

• 在API服务所在的docker-compose.yml中，同样给API服务绑定该共享网络：

  services:
    api-service:
      # 其他配置
      networks:
        - shared-backend-network
  networks:
    shared-backend-network:
      external: true
  

• 重启两个Compose服务：docker-compose up -d

2. 修正Actions的访问URL #

外部可访问的localhost或宿主机IP地址在Docker容器内部无效（容器的localhost指向自身），必须使用API服务的容器服务名+内部端口作为访问地址：

• 假设API服务在Compose中的服务名为api-service，内部监听端口为3000，则Actions的URL需改为：http://api-service:3000/your-action-path
• 无需映射API服务到宿主机端口，只要容器间能通过共享网络访问内部端口即可。

3. 验证容器间连通性 #

进入Hasura容器，测试能否正常访问API服务：

# 进入Hasura容器
docker exec -it <hasura-container-name> sh
# 测试API接口
curl http://api-service:3000/your-action-path

如果请求失败，检查：

• API服务是否正常启动：docker ps
• 两个服务是否都已加入共享网络：docker network inspect shared-backend-network

4. 排查API服务的访问限制 #

部分API框架会默认限制请求来源，确保API服务允许Hasura的请求：

• 比如在Express中放宽CORS限制（生产环境建议指定具体来源）：

  const cors = require('cors');
  app.use(cors({ origin: '*' }));
  

• 检查API服务的防火墙或中间件是否拦截了容器内部的请求。

5. 通过日志定位具体错误 #

• 查看Hasura日志，获取更详细的错误信息：

  docker-compose logs hasura
  

• 查看API服务日志，确认是否收到Hasura的请求：

  docker-compose logs api-service
  

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