Docker备份容器无法解析PostgreSQL容器主机名问题排查

1. 验证基础DNS解析能力 #

先进入backup容器，安装DNS工具包测试主机名解析：

# 进入容器
docker exec -it <backup-container-name> sh
# 安装bind-tools（包含nslookup、dig）
apk add --no-cache bind-tools
# 测试解析db主机名
nslookup db
dig db

如果能正常解析出IP，说明DNS配置本身没问题，问题出在cron的环境上；如果解析失败，继续下一步。

2. 统一容器DNS配置 #

对比Django容器和backup容器的/etc/resolv.conf内容：

# 在Django容器内执行
cat /etc/resolv.conf
# 在Backup容器内执行
cat /etc/resolv.conf

若两者内容不一致，在docker-compose.yml的backup服务中手动指定Docker内置DNS服务器：

services:
  backup:
    # 其他已有配置...
    dns:
      - 127.0.0.11

重启backup容器后再次测试解析。

3. 修复cron环境变量缺失问题 #

Alpine的busybox cron默认不会继承容器的完整环境变量，导致pg_dump运行时无法读取DNS配置。可通过两种方式解决：

• 在cron脚本开头加载容器环境变量：

  #!/bin/sh
  # 加载容器全局环境变量
  . /etc/profile
  # 执行备份命令
  pg_dump -h db -U <db用户名> <数据库名> > /backups/$(date +%Y%m%d_%H%M%S).sql
  

• 直接在cron任务中使用Postgres容器的IP（先通过docker inspect ken_db | grep IPAddress获取IP）：

  0 3 * * * pg_dump -h <db容器IP> -U <db用户名> <数据库名> > /backups/$(date +%Y%m%d_%H%M%S).sql
  

4. 替换镜像规避musl libc兼容性问题 #

如果上述方法无效，可能是Alpine默认的musl libc与Docker内置DNS存在解析兼容性问题。可以将backup容器的基础镜像替换为基于glibc的轻量镜像（如debian:bookworm-slim），其DNS解析行为与Python官方镜像一致，能直接识别Docker网络内的主机名。

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