无法通过IP地址连接Docker中PostgreSQL的问题求助

我使用C# Visual Studio 2022/.NET6开发，尝试通过容器IP地址172.17.0.2连接Docker容器中的PostgreSQL时出现异常，连接字符串如下：

"Host=172.17.0.2:5432;Database=postgres;Username=postgres;Password=xxxxx"

但使用localhost连接时可成功：

"Host=localhost:5432;Database=postgres;Username=postgres;Password=xxxxx"

容器安装步骤 #

Step 1 - 安装Postgres
docker pull postgres
docker run --name gb-postgres -p 5432:5432 -e POSTGRES_PASSWORD=xxxxxx -d postgres

Step 2 - 获取容器IP地址
运行 docker ps
复制容器ID后执行 docker inspect {容器ID}
复制输出中的IPAddress

Step 3 - 配置API
在Program.cs中使用该IP地址

异常信息 #

Npgsql.NpgsqlException (0x80004005): Failed to connect to 172.17.0.3:5432
 ---> System.TimeoutException: Timeout during connection attempt
   at Npgsql.Internal.NpgsqlConnector.Connect(NpgsqlTimeout timeout)
   at Npgsql.Internal.NpgsqlConnector.Connect(NpgsqlTimeout timeout)
   at Npgsql.Internal.NpgsqlConnector.RawOpen(SslMode sslMode, NpgsqlTimeout timeout, Boolean async, CancellationToken cancellationToken, Boolean isFirstAttempt)
   at Npgsql.Internal.NpgsqlConnector.<Open>g__OpenCore|203_1(NpgsqlConnector conn, SslMode sslMode, NpgsqlTimeout timeout, Boolean async, CancellationToken cancellationToken, Boolean isFirstAttempt)
   at Npgsql.Internal.NpgsqlConnector.Open(NpgsqlTimeout timeout, Boolean async, CancellationToken cancellationToken)
   at Npgsql.PoolingDataSource.OpenNewConnector(NpgsqlConnection conn, NpgsqlTimeout timeout, Boolean async, CancellationToken cancellationToken)
   at Npgsql.PoolingDataSource.<Get>g__RentAsync|28_0(NpgsqlConnection conn, NpgsqlTimeout timeout, Boolean async, CancellationToken cancellationToken)
   at Npgsql.NpgsqlConnection.<Open>g__OpenAsync|45_0(Boolean async, CancellationToken cancellationToken)
   at Npgsql.NpgsqlConnection.Open()
   at Program.Main(String[] args) in D:\data\code\Dust-IO\388013gb3\cloud\API\GB3API\ConsoleApp1\Program.cs:line 14

C#程序代码 #

using System;
using Npgsql;

class Program
{
    static void Main(string[] args)
    {
        string connectionString = "Host=172.17.0.2;Database=GB3;Username=postgres;Password=xxxxx";

        using (var connection = new NpgsqlConnection(connectionString))
        {
            try
            {
                connection.Open();
                Console.WriteLine("Connected to PostgreSQL database.");

                // Perform database operations here

                connection.Close();
                Console.WriteLine("Connection closed.");
            }
            catch (Exception ex)
            {
                Console.WriteLine("Error: " + ex.Message);
            }
        }

        Console.ReadLine();
    }
}

其他连接情况 #

• 使用Visual Studio 2022扩展Npgsql PostgreSQL Integration连接时，提示“Exception while connecting”错误
• 使用VS Code扩展PostgreSQL by Chris Kolkman连接时，报错“ETIMEDOUT 172.17.0.2:5432”

docker inspect输出（网络部分） #

"Networks": {
    "bridge": {
        "IPAMConfig": null,
        "Links": null,
        "Aliases": null,
        "NetworkID": "d9371cf11864c75a9c35d03ce24bf90bb78af8f44b43e6336b0630a6d79d9503",
        "EndpointID": "b235ae6eb713404f9fbbcd35453acb6e9dcb213ad6d51fa8809272912a569e15",
        "Gateway": "172.17.0.1",
        "IPAddress": "172.17.0.3",
        "IPPrefixLen": 16,
        "IPv6Gateway": "",
        "GlobalIPv6Address": "",
        "GlobalIPv6PrefixLen": 0,
        "MacAddress": "02:42:ac:11:00:03",
        "DriverOpts": null
    }
}

排查与解决方法 #

1. 修正IP地址不一致问题
   从docker inspect输出看，容器实际IP是172.17.0.3，但代码中用的是172.17.0.2，先将连接字符串的IP替换为正确的容器IP，重新测试连接。

2. 理解Docker平台网络限制
   Windows/macOS下的Docker Desktop基于虚拟机运行，宿主机器无法直接访问容器的桥接网络IP（172.17.x.x这类地址），这是平台虚拟化机制导致的。这种场景下只能依赖端口映射用localhost:5432连接。

3. 检查PostgreSQL绑定配置
   进入容器查看postgresql.conf中的listen_addresses配置，确保设置为*（允许所有IP访问）：

docker exec -it gb-postgres bash
cat /var/lib/postgresql/data/postgresql.conf | grep listen_addresses

如果不是*，修改后重启容器：

docker restart gb-postgres

4. 排查防火墙拦截
   检查宿主机器的防火墙规则，确认没有拦截5432端口的入站/出站请求；Linux环境下还需检查iptables规则是否限制了容器桥接网络的访问。

5. 推荐更可靠的连接方式

• 保持使用localhost:5432（依赖已配置的端口映射-p 5432:5432）
• 创建自定义Docker网络，通过容器名称gb-postgres作为Host连接，这种方式不受容器IP变化影响：

  "Host=gb-postgres:5432;Database=postgres;Username=postgres;Password=xxxxx"
  

  注意：应用需和容器在同一个自定义网络中，创建网络并重新运行容器的命令示例：

  docker network create gb-network
  docker stop gb-postgres
  docker rm gb-postgres
  docker run --name gb-postgres --network gb-network -p 5432:5432 -e POSTGRES_PASSWORD=xxxxxx -d postgres
  

内容的提问来源于stack exchange，提问作者Syed Rafey Husain