无法通过外部CURL命令触发Docker部署的Airbyte同步请求

我尝试用CURL命令触发Docker上部署的Airbyte执行同步操作，命令如下：

curl -u 'airbyte:password' -X POST "http://localhost:8000/api/v1/connections/sync" -H "Accept: application/json" -H "Content-Type:application/json" -d '{"connectionId":"[XXXXXXX8b-1b35-4XXe-9XXX3-e06b5XXXXd04]"}'

执行后出现连接超时错误：

curl: (28) Failed to connect to IPADDRESS port 8001 after 133762 ms: Couldn't connect to server.

我按照官方教程操作，已经尝试替换localhost为以下IP，但均未解决问题：

• WSL中hostname -I输出的IP
• 通过docker inspect $(docker ps -q) --format='{{ .Name }} {{ .Config.Image }} {{range .NetworkSettings.Networks}} {{.IPAddress}} {{end}}'获取的airbyte/server容器IP
• 使用host.docker.internal

1. 核对端口映射与命令端口 #

注意报错指向的是8001端口，但你的CURL命令用的是8000端口，先确认：

• 检查Airbyte的docker-compose.yml中server服务的端口配置，确认实际暴露的端口是8000还是8001；
• 修正CURL命令中的端口，保持与容器映射端口一致。

2. 确认容器端口映射生效 #

执行docker ps查看airbyte-server容器的端口映射，正常应显示0.0.0.0:8000->8000/tcp（或对应端口）。如果没有映射：

1. 打开Airbyte的docker-compose.yml，找到server服务的ports配置，确保为8000:8000（或对应端口）；
2. 重启容器：

docker-compose down
docker-compose up -d

3. 排查防火墙/安全组限制 #

• WSL环境：检查Windows防火墙是否允许8000端口的入站连接，可临时关闭防火墙测试；
• 云服务器：检查安全组是否开放了目标端口；
• 本地环境：确认系统防火墙未拦截该端口的外部请求。

4. 验证Airbyte服务状态 #

执行docker logs airbyte-server查看服务日志，确认：

• 服务是否正常启动；
• 是否有Listening on 0.0.0.0:8000类的日志，说明服务已绑定到正确端口。

5. WSL环境额外处理 #

如果是WSL2部署：

• 先在WSL内部执行CURL命令，确认服务本身可访问；
• 从Windows主机访问时，使用WSL的IP（hostname -I输出）+ 端口，同时确保Windows防火墙允许该IP的端口访问；
• 若仍有问题，可尝试将WSL网络切换为桥接模式。

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