如何配置 PostgreSQL 允许远程连接 - 以 Odoo 数据库为例

如何配置 PostgreSQL 允许远程连接 - 以 Odoo 数据库为例

问题背景

在使用 Odoo 时，我们经常需要通过远程工具（如 DataGrip、pgAdmin 等）连接数据库进行管理和查询。然而，PostgreSQL 默认只允许本地连接，需要进行适当的配置才能实现远程访问。本文将详细介绍如何配置 PostgreSQL 以允许远程连接。

环境说明

• 操作系统：Linux（Ubuntu/Debian）
• PostgreSQL 版本：14.0
• 远程连接工具：DataGrip
• 虚拟机 IP：192.168.239.128

配置步骤

1. 修改 PostgreSQL 配置文件

PostgreSQL 的主配置文件通常位于 /etc/postgresql/14/main/postgresql.conf。我们需要修改监听地址以允许远程连接。

sudo nano /etc/postgresql/14/main/postgresql.conf

找到如下行（通常是被注释的）：

#listen_addresses = 'localhost'

修改为：

listen_addresses = '*'

这里的 '*' 表示允许来自任何 IP 地址的连接。

2. 配置客户端认证

编辑 pg_hba.conf 文件来配置客户端认证：

sudo nano /etc/postgresql/14/main/pg_hba.conf

在文件末尾添加以下行：

host    all             all             192.168.239.0/24         md5

这行配置表示：

• host：允许 TCP/IP 连接
• all：允许访问所有数据库
• all：允许所有用户
• 192.168.239.0/24：允许来自这个子网的连接
• md5：使用 MD5 加密的密码认证

3. 重启 PostgreSQL 服务

配置修改后，需要重启 PostgreSQL 服务使更改生效：

sudo systemctl restart postgresql

4. 验证配置

可以使用以下命令验证 PostgreSQL 是否正在监听远程连接：

sudo netstat -plnt | grep postgres

应该能看到类似这样的输出：

tcp        0      0 0.0.0.0:5432            0.0.0.0:*               LISTEN      1234/postgres

5. 配置防火墙

检查防火墙设置，在虚拟机上运行：

sudo ufw status

如果系统开启了防火墙，需要允许 PostgreSQL 端口（5432）的访问：

sudo ufw allow 5432/tcp

在 DataGrip 中配置连接

1. 点击 “+” 或 “New” -> “Data Source” -> “PostgreSQL”
2. 填写连接信息：
   • Host: 192.168.239.128
   • Port: 5432
   • Database: 您的数据库名称
   • User: odoo 或 postgres
   • Password: 数据库用户密码

故障排查

如果连接仍然失败，可以检查以下几点：

1. 确认 PostgreSQL 服务状态：

   sudo systemctl status postgresql

2. 检查端口是否正在监听：

   sudo netstat -plnt | grep 5432

3. 验证 PostgreSQL 版本和运行状态：

   sudo -u postgres psql -c “SELECT version();”

4. 检查系统日志中的错误信息：

   sudo tail -f /var/log/postgresql/postgresql-14-main.log

安全建议

1. 不建议在生产环境中使用 listen_addresses = '*'，应该只允许特定的 IP 地址。
2. 建议使用强密码和 SSL 连接。
3. 定期更新 PostgreSQL 到最新的安全版本。
4. 为不同的应用创建独立的数据库用户，并只授予必要的权限。

结论

通过以上配置，我们成功启用了 PostgreSQL 的远程连接功能，使得可以通过 DataGrip 等工具远程管理 Odoo 数据库。在实际应用中，请根据自己的网络环境和安全需求调整相关配置。

配置完成后，您就可以使用 DataGrip 或其他数据库管理工具远程连接和管理您的 Odoo 数据库了。记得妥善保管数据库密码，定期备份重要数据。