Docker部署Odoo 14连接PostgreSQL失败求助：连接被拒绝

看起来你的Odoo和PostgreSQL稳定运行一个月后突然炸锅了，这种偶发的连接拒绝对排查来说其实有迹可循——咱们一步步来揪出问题：

第一步：先从Odoo容器内部验证网络连通性 #

你说PostgreSQL在172.17.0.3:5432正常运行，但得从Odoo容器内部实打实测一遍，Docker桥接网络有时候会有隐性的IP或端口拦截问题：

• 先进入Odoo容器的shell：

  docker exec -it odoo-app bash
  

• 如果容器里没装ping工具，先装上：

  apt update && apt install -y iputils-ping telnet
  

• 先ping PostgreSQL的IP，看网络是否通：

  ping 172.17.0.3
  

• 再用telnet测5432端口是否开放：

  telnet 172.17.0.3 5432
  

  如果返回Connected说明端口没问题；如果ping通但telnet连不上，那大概率是PostgreSQL的监听配置或者防火墙拦了；如果ping都不通，先查PostgreSQL容器的当前IP：

  docker inspect odoo-postgres | grep "IPAddress"
  

  对比之前的172.17.0.3，如果IP变了，那就是容器重启后Docker重新分配了IP——这是个常见坑，建议以后用容器名odoo-postgres代替固定IP作为数据库主机，Docker内部DNS会自动解析，再也不用怕IP变来变去。

第二步：检查PostgreSQL的监听与权限配置 #

如果telnet连不上，得确认PostgreSQL是否允许外部容器访问：

• 进入PostgreSQL容器：

  docker exec -it odoo-postgres bash
  

• 查看postgresql.conf里的监听地址，确保不是只监听localhost：

  cat /var/lib/postgresql/data/postgresql.conf | grep listen_addresses
  

  正常应该是listen_addresses = '*'，如果是localhost，那只能容器内部访问，Odoo肯定连不上，改完后重启PostgreSQL容器。
• 再检查pg_hba.conf的权限规则，确保允许Odoo所在的网段连接：

  cat /var/lib/postgresql/data/pg_hba.conf
  

  找类似这条规则：

  host    all             all             172.17.0.0/16         scram-sha-256
  

  如果没有，手动加上然后重启PostgreSQL容器。

第三步：排查群晖NAS本身的问题 #

毕竟容器跑在群晖上，系统层面的变化也可能影响：

• 资源占用：打开群晖的资源监视器，看看CPU、内存、磁盘是不是跑满了——如果PostgreSQL因为资源不足被系统强制暂停，肯定会导致连接失败。
• 防火墙设置：最近有没有开群晖的防火墙？去控制面板 > 安全 > 防火墙，确保允许Docker内部网段（172.17.0.0/16）的5432端口通信，或者直接加一条允许两个容器IP互访的规则。
• Docker服务状态：有时候群晖的Docker服务抽风会导致内部网络故障，试试重启Docker服务：打开群晖Docker应用，右上角菜单设置 > 常规，点击重启Docker服务（注意会重启所有容器，先确认数据安全）。

第四步：核对Odoo的数据库配置 #

别排除配置悄悄变了的可能：

• 进入Odoo容器，查看odoo.conf（通常在/etc/odoo/odoo.conf），确认db_host、db_port、db_user、db_password和PostgreSQL的配置完全匹配：

  cat /etc/odoo/odoo.conf | grep -E "db_host|db_port|db_user|db_password"
  

• 也可以在群晖Docker GUI里打开odoo-app容器的设置 > 环境变量，检查数据库相关的变量（比如HOST、USER、PASSWORD）是否正确。

第五步：看PostgreSQL的日志找线索 #

Odoo的日志只说连接拒绝，但PostgreSQL的日志会有更细节的原因，比如连接数满了、认证失败：

• 在群晖Docker GUI里打开odoo-postgres容器的日志标签，或者用命令：

  docker logs odoo-postgres
  

  搜connection refused、authentication failed、max_connections这些关键词，大概率能直接定位问题。

快速临时修复（如果是IP变化导致） #

如果确认是PostgreSQL容器IP变了，最快的方法是把Odoo的db_host改成新IP；但更稳妥的是创建自定义Docker网络：

1. 在群晖Docker GUI的网络标签里，新建一个自定义桥接网络（比如叫odoo-network）
2. 分别把odoo-app和odoo-postgres容器移到这个自定义网络里（编辑容器的设置 > 网络）
3. 把Odoo的db_host改成odoo-postgres（容器名），以后不管容器IP怎么变，Docker都会自动解析，彻底解决IP变动的问题。

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