Docker容器内组件连接本地Firebird服务失败的解决方法咨询

容器内的127.0.0.1指向容器自身的回环接口，而非运行Firebird的宿主机，这是导致ConnectionRefusedError的核心原因。以下是具体解决步骤：

1. 修改Python连接代码的主机地址 #

根据操作系统替换连接参数中的host值：

• Windows/macOS（Docker Desktop环境）：使用Docker提供的特殊域名host.docker.internal，它会自动解析到宿主机IP：

import firebirdsql

conn = firebirdsql.connect(
    host='host.docker.internal',  # 替换原127.0.0.1
    database='...',  # 保留你的数据库路径/名称
    port=3050,
    user='sysdba',
    password='masterkey'
)

• Linux系统：使用宿主机的局域网IP（可通过ifconfig或ip addr命令查询）：

import firebirdsql

conn = firebirdsql.connect(
    host='192.168.1.100',  # 替换为你的宿主机实际IP
    database='...',
    port=3050,
    user='sysdba',
    password='masterkey'
)

2. 配置Firebird允许外部连接 #

修改Firebird配置文件（路径通常为C:/Program Files/Firebird/Firebird_2_5/firebird.conf）：

• 找到RemoteBindAddress项，设置为0.0.0.0（允许所有IP访问）或宿主机局域网IP：

RemoteBindAddress = 0.0.0.0

• 重启Firebird服务使配置生效。

3. 调整防火墙规则 #

确保宿主机防火墙允许3050端口的入站连接，放行Docker容器所在的网络段（测试环境可直接允许所有来源访问3050端口）。

4. 清理docker-compose中的无效端口映射 #

你的api服务中3050:3050的端口映射是多余的（实际是容器主动连接宿主机3050，而非宿主机访问容器3050），建议删除避免端口冲突：

version: "3.9"
services:
  gui:
    build:
      context: gui
    restart: always
    ports:
      - 80:80
    depends_on:
      - api

  api:
    build:
      context: api
    restart: always
    ports:
      - 8000:8000  # 仅保留API服务的端口映射
    volumes:
      - C:/Program Files/Firebird/Firebird_2_5/examples/empbuild:/app/api/empbuild:rw

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