Bitnami PostgreSQL-repmgr跨服务器Docker容器无法识别彼此

跨服务器部署bitnami/postgresql-repmgr集群时，复制失败的核心原因是集群节点的网络标识、监听配置未适配跨主机环境，以下是具体修正方案：

关键配置修正点 #

1. 修正节点网络标识（REPMGR_NODE_NETWORK_NAME） #

该变量定义节点在集群中对外暴露的访问地址，跨服务器时不能再用Docker内部容器名，必须替换为节点所在服务器的公网/私网可访问IP：

• 对于pg-0（第一台服务器），设置为第一台服务器的IP
• 对于pg-1（第二台服务器），设置为第二台服务器的IP

2. 允许PostgreSQL监听所有接口 #

默认容器内PostgreSQL仅监听Docker内部地址，需添加POSTGRESQL_LISTEN_ADDRESS=0.0.0.0，确保外部服务器能连接。

3. 修正伙伴节点格式（REPMGR_PARTNER_NODES） #

伙伴节点必须指定完整的IP:端口格式，确保节点能正确定位到对方的PostgreSQL服务（默认端口5432）。

4. 开放服务器间的端口访问 #

确保两台服务器的安全组/防火墙规则允许双向访问5432端口，即第一台服务器允许第二台的IP访问5432，第二台允许第一台的IP访问5432。

修正后的docker-compose配置 #

第一台服务器（pg-0）配置 #

pg-0:
  image: bitnami/postgresql-repmgr:14
  ports:
    - "5432:5432"
  container_name: db1
  volumes:
    - pg_0_data:/bitnami/postgresql
  environment:
    - POSTGRESQL_POSTGRES_PASSWORD=adminpassword
    - POSTGRESQL_USERNAME=customuser
    - POSTGRESQL_PASSWORD=custompassword
    - POSTGRESQL_DATABASE=customdatabase
    - REPMGR_PASSWORD=repmgrpassword
    - REPMGR_PRIMARY_HOST=<第一台服务器IP>
    - REPMGR_PARTNER_NODES=<第一台服务器IP>:5432,<第二台服务器IP>:5432
    - REPMGR_NODE_NAME=pg-0
    - REPMGR_NODE_NETWORK_NAME=<第一台服务器IP>
    - POSTGRESQL_LISTEN_ADDRESS=0.0.0.0
  networks:
    - main

第二台服务器（pg-1）配置 #

pg-1:
  image: bitnami/postgresql-repmgr:14
  ports:
    - "5432:5432"
  container_name: db2
  volumes:
    - pg_1_data:/bitnami/postgresql
  environment:
    - POSTGRESQL_POSTGRES_PASSWORD=adminpassword
    - POSTGRESQL_USERNAME=customuser
    - POSTGRESQL_PASSWORD=custompassword
    - POSTGRESQL_DATABASE=customdatabase
    - REPMGR_PASSWORD=repmgrpassword
    - REPMGR_PRIMARY_HOST=<第一台服务器IP>
    - REPMGR_PARTNER_NODES=<第一台服务器IP>:5432,<第二台服务器IP>:5432
    - REPMGR_NODE_NAME=pg-1
    - REPMGR_NODE_NETWORK_NAME=<第二台服务器IP>
    - POSTGRESQL_LISTEN_ADDRESS=0.0.0.0
  networks:
    - main

验证步骤 #

1. 在pg-0容器内测试连接pg-1：

   docker exec -it db1 psql -h <第二台服务器IP> -U repmgr -d repmgr
   

   输入REPMGR_PASSWORD，若能成功进入repmgr数据库，则网络连接正常。
2. 查看容器日志排查错误：

   docker logs db1
   docker logs db2
   

   重点关注repmgr注册、复制连接相关的报错信息。

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