Docker容器tmate-master无法连接PostgreSQL数据库求助

问题背景 #

在AWS Lightsail实例上使用官方Docker容器运行tmate服务器，正常运行2个月后突发故障，tmate-master容器初始化后持续抛出PostgreSQL连接超时错误：

tmate-master      | 09:41:22.932 [error] Postgrex.Protocol (#PID<0.2044.0>) failed to connect: ** (DBConnection.ConnectionError) tcp connect (tmate-db:5432): timeout
tmate-master      | 09:41:39.181 [error] Postgrex.Protocol (#PID<0.2045.0>) failed to connect: ** (DBConnection.ConnectionError) tcp connect (tmate-db:5432): timeout
tmate-master      | 09:41:56.813 [error] Postgrex.Protocol (#PID<0.2041.0>) failed to connect: ** (DBConnection.ConnectionError) tcp connect (tmate-db:5432): timeout

已确认PostgreSQL服务正常，宿主机可直接连接数据库，tmate-master容器能ping通数据库容器，但TCP连接始终超时。核心docker-compose.yml配置如下：

version: "3.5"

services:
  tmate-master:    
    image: tmate/tmate-master:latest    
    container_name: tmate-master    
    hostname: tmate-1    
    domainname: example.com    
    restart: unless-stopped    
    expose:    
    - 4000    
    environment:      
      PG_URI: postgres://tmate:postgrespassword@tmate-db:5432/tmate      
      PG_POOLSIZE: 5    
    networks:      
      bridge:
      internal:  
      
  tmate-db:    
    image: postgres:12-alpine    
    container_name: tmate-db    
    restart: unless-stopped    
    environment:      
      POSTGRES_USER: tmate      
      POSTGRES_PASSWORD: postgrespassword      
      POSTGRES_DB: tmate    
    volumes:
    - pgdata:/var/lib/postgresql/data
    networks:      
      internal:
      
volumes:  
  pgdata:
  
networks:  
  bridge:  
  internal:    
    internal: true

已尝试更换PostgreSQL版本、回滚Docker、恢复旧实例备份、改用AWS RDS、调整网络配置等方案，均未解决问题。

排查方向与解决方案 #

1. 验证容器内TCP端口连通性（而非仅ping） #

ping仅能确认网络可达，TCP端口可能被容器内防火墙或策略拦截。在tmate-master容器内执行以下命令测试5432端口：

# 进入tmate-master容器
docker exec -it tmate-master sh
# 使用telnet测试端口连通性
telnet tmate-db 5432
# 或用nc工具测试
nc -zv tmate-db 5432

若连接失败，需检查容器内iptables规则或是否存在内置防火墙限制。

2. 调整PostgreSQL连接参数 #

数据库服务正常但可能因连接数耗尽或参数限制拒绝新连接：

• 进入tmate-db容器查看PostgreSQL日志：

  docker exec -it tmate-db tail -f /var/log/postgresql/postgresql-12-main.log
  

  查找是否有max_connections相关报错，若存在则修改postgresql.conf：

  docker exec -it tmate-db vi /var/lib/postgresql/data/postgresql.conf
  

  将max_connections值从默认100调至200，重启容器：

  docker restart tmate-db
  

3. 配置Postgrex连接超时参数 #

tmate基于Elixir的Postgrex库，默认超时设置可能过短。在docker-compose.yml的tmate-master服务环境变量中添加：

environment:
  PG_URI: postgres://tmate:postgrespassword@tmate-db:5432/tmate
  PG_POOLSIZE: 5
  PG_TIMEOUT: 30000  # 延长至30秒超时
  PG_SSL: "false"    # 强制关闭SSL（若数据库未配置SSL）

重新启动容器：

docker-compose down && docker-compose up -d

4. 绕过DNS直接使用容器IP连接 #

虽然ping能解析域名，但DNS缓存或网络冲突可能导致TCP连接异常：

• 获取tmate-db容器的IP地址：

  docker inspect tmate-db | grep "IPAddress"
  

• 修改PG_URI为容器IP：

  PG_URI: postgres://tmate:postgrespassword@<容器实际IP>:5432/tmate
  

• 临时关闭internal网络的隔离性测试：

  networks:  
    bridge:  
    internal:    
      internal: false
  

5. 手动构建tmate-master镜像（适配新环境） #

官方仓库已停止维护，镜像可能存在兼容性问题，尝试手动构建：

1. 克隆tmate仓库：

   git clone https://github.com/tmate-io/tmate.git
   cd tmate/master
   

2. 编辑Dockerfile，更新Elixir版本为稳定版（如1.15），确保Postgrex版本适配目标PostgreSQL版本。
3. 构建自定义镜像：

   docker build -t my-tmate-master .
   

4. 修改docker-compose.yml中tmate-master的镜像为my-tmate-master，启动容器测试。

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