本页内容

  • 准备工作
  • 步骤 1 - 配置防火墙
  • 步骤 2 - 安装 PostgreSQL 14
  • 步骤 3 - 安装 SSL
  • 步骤 4 - 为 PostgreSQL 配置 Certbot 续期
  • 步骤 5 - 配置 PostgreSQL
  • 步骤 6 - 配置 PostgreSQL 连接
  • 步骤 7 - 续订证书
  • 步骤 8 - 测试连接
  • 步骤 9 - 检查客户端
  • 结论

默认情况下,所有 PostgreSQL 连接都是不安全的,在高流量的生产环境中运行时可能会引发安全问题。SSL 加密可确保传输的任何数据都不会在连接过程中被中间人截获。

本教程将教你如何为 PostgreSQL 连接启用 SSL/TLS。

准备工作

  • 一台 Linux 服务器。在本教程中,我们使用的是一台 Ubuntu 22.04 服务器。
  • 一个非 root 的 sudo 用户。
  • 一个完全限定域名(FQDN),例如 postgresql.example.com。
  • 确保系统一切均已更新。$ sudo apt update $ sudo apt upgrade
  • 系统需要安装一些软件包。$ sudo apt install curl nano software-properties-common apt-transport-https ca-certificates lsb-release ubuntu-keyring -y 其中部分软件包可能已安装在你的系统上。

一台 Linux 服务器。在本教程中,我们使用的是一台 Ubuntu 22.04 服务器。

一个非 root 的 sudo 用户。

一个完全限定域名(FQDN),例如 postgresql.example.com。

确保系统一切均已更新。

$ sudo apt update
$ sudo apt upgrade

系统需要安装一些软件包。

$ sudo apt install curl nano software-properties-common apt-transport-https ca-certificates lsb-release ubuntu-keyring -y

其中部分软件包可能已安装在你的系统上。

步骤 1 - 配置防火墙

在安装任何软件包之前,第一步是配置防火墙以开放 HTTP、HTTPS 和 PostgreSQL 的端口。

检查防火墙的状态。

$ sudo ufw status

你应该会看到类似下面的输出。

Status: active

To                         Action      From
--                         ------      ----
OpenSSH                    ALLOW       Anywhere
OpenSSH (v6)               ALLOW       Anywhere (v6)

在防火墙中开放 HTTP、HTTPS 和 PostgreSQL 端口。

$ sudo ufw allow 5432
$ sudo ufw allow http
$ sudo ufw allow https

再次检查状态以确认。

$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
OpenSSH                    ALLOW       Anywhere                  
80/tcp                     ALLOW       Anywhere                  
443                        ALLOW       Anywhere                  
5432                       ALLOW       Anywhere                  
OpenSSH (v6)               ALLOW       Anywhere (v6)             
80/tcp (v6)                ALLOW       Anywhere (v6)             
443 (v6)                   ALLOW       Anywhere (v6)
5432 (v6)                  ALLOW       Anywhere (v6)             

步骤 2 - 安装 PostgreSQL 14

Ubuntu 22.04 默认自带 PostgreSQL 14。要安装,请执行以下命令。

$ sudo apt install postgresql postgresql-contrib

postgresql-contrib 软件包包含了一些额外的工具。

你也可以使用该 PostgreSQL 官方 APT 仓库进行安装。运行以下命令以添加 PostgreSQL 的 GPG 密钥。

$ curl https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor | sudo tee /usr/share/keyrings/postgresql-key.gpg >/dev/null

将 APT 仓库添加到你的源列表中。

$ sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/postgresql-key.gpg arch=amd64] http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

更新系统仓库。

$ sudo apt update

现在,你可以使用上述命令安装 PostgreSQL。

检查 PostgreSQL 服务的状态。

$ sudo systemctl status postgresql
? postgresql.service - PostgreSQL RDBMS
     Loaded: loaded (/lib/systemd/system/postgresql.service; enabled; vendor preset: enabled)
     Active: active (exited) since Mon 2022-12-12 00:01:06 UTC; 19s ago
   Main PID: 3497 (code=exited, status=0/SUCCESS)
        CPU: 1ms

Dec 12 00:01:06 postgresql systemd[1]: Starting PostgreSQL RDBMS...
Dec 12 00:01:06 postgresql systemd[1]: Finished PostgreSQL RDBMS.

你可以看到该服务默认已启用并正在运行。

为 postgres 账户设置密码。

$ sudo -i -u postgres psql -c "ALTER USER postgres PASSWORD '<new_password>';"

步骤 3 - 安装 SSL

要使用 Let's Encrypt 安装 SSL 证书,我们需要下载 Certbot 工具。为此我们将使用 Snapd 软件包安装器。Ubuntu 22.04 已预装 Snap。

确保你的 Snapd 版本是最新的。

$ sudo snap install core 
$ sudo snap refresh core

安装 Certbot。

$ sudo snap install --classic certbot

使用以下命令,通过创建指向 /usr/bin 目录的符号链接,确保 Certbot 命令可以运行。

$ sudo ln -s /snap/bin/certbot /usr/bin/certbot

生成 SSL 证书。

$ sudo certbot certonly --standalone --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m 
[email protected]
 -d postgresql.example.com

上述命令会将证书下载到你服务器上的 /etc/letsencrypt/live/postgresql.example.com 目录。

生成 Diffie-Hellman 组证书。

$ sudo openssl dhparam -dsaparam -out /etc/ssl/certs/dhparam.pem 4096

步骤 4 - 为 PostgreSQL 配置 Certbot 续期

PostgreSQL 没有权限访问 Let's Encrypt 文件夹中的证书,因此我们无法直接让它使用该文件夹中的证书。替代方案是将证书复制到 PostgreSQL 目录,但这只是临时生效,因为证书会过期,你将不得不再次手动复制。

最佳方法是使用续期钩子(renewal hook),它会在每次续期时自动运行并执行复制操作。

查找 PostgreSQL 数据目录。

$ sudo -i -u postgres psql -U postgres -c 'SHOW data_directory'

创建续期钩子文件并将其打开进行编辑。

$ sudo nano /etc/letsencrypt/renewal-hooks/deploy/postgresql.sh

将以下代码粘贴到其中。

#!/bin/bash
umask 0177
DOMAIN=postgresql.example.com
DATA_DIR=/var/lib/postgresql/15/main
cp /etc/letsencrypt/live/$DOMAIN/fullchain.pem $DATA_DIR/server.crt
cp /etc/letsencrypt/live/$DOMAIN/privkey.pem $DATA_DIR/server.key
chown postgres:postgres $DATA_DIR/server.crt $DATA_DIR/server.key
# only for SELinux - CentOS, Red Hat
# chcon -t postgresql_db_t $DATA_DIR/server.crt $DATA_DIR/server.key

按 Ctrl + X 保存文件,并在提示时输入 Y。

使该文件可执行。

$ sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/postgresql.sh

步骤 5 - 配置 PostgreSQL

查找 PostgreSQL 配置文件的路径。

$ sudo -i -u postgres psql -U postgres -c 'SHOW config_file'

打开该文件进行编辑。

$ sudo nano /etc/postgresql/15/main/postgresql.conf

找到 Connection Settings(连接设置)部分,取消注释 listen_address 变量,并将其值改为 *。确保其内容如下所示。

listen_address = '*'		# what IP address(es) to listen on;

找到 SSL 部分,并编辑该文件以匹配以下值。

ssl = on  
ssl_cert_file = 'server.crt'  
ssl_key_file = 'server.key'  
ssl_prefer_server_ciphers = on
ssl_dh_params_file = '/etc/ssl/certs/dhparam.pem'

按 Ctrl + X 保存文件,并在提示时输入 Y。

步骤 6 - 配置 PostgreSQL 连接

打开 /etc/postgresql/15/main/pg_hba.conf 文件进行编辑。

$ sudo nano /etc/postgresql/15/main/pg_hba.conf

添加以下行以为 PostgreSQL 启用 SSL。

hostssl all  all  0.0.0.0/0  scram-sha-256

按 Ctrl + X 保存文件,并在提示时输入 Y。

步骤 7 - 续订证书

运行以下命令以执行强制续订。这将触发部署脚本,该脚本会将证书复制到 PostgreSQL 使用的正确位置。

$ sudo certbot renew --force-renewal

确认证书已复制到 PostgreSQL 数据目录。

$ sudo ls /var/lib/postgresql/15/main/

你将看到以下输出,其中会显示证书文件。

base          pg_dynshmem   pg_notify    pg_snapshots  pg_subtrans  PG_VERSION  postgresql.auto.conf  server.crt
global        pg_logical    pg_replslot  pg_stat       pg_tblspc    pg_wal      postmaster.opts       server.key
pg_commit_ts  pg_multixact  pg_serial    pg_stat_tmp   pg_twophase  pg_xact     postmaster.pid

重启 PostgreSQL 以使更改生效。

$ sudo systemctl restart postgresql

步骤 8 - 测试连接

从另一台已安装 PostgreSQL 客户端的机器连接到数据库。

$ psql -d "dbname=postgres sslmode=require" -h postgresql.example.com -U postgres

你应该会看到如下 PostgreSQL 提示符。我们使用的是 PostgreSQL 14 客户端,因此你会看到一条关于版本不兼容的警告。

Password for user postgres:
psql (14.5 (Ubuntu 14.5-0ubuntu0.22.04.1), server 15.1 (Ubuntu 15.1-1.pgdg22.04+1))
WARNING: psql major version 14, server major version 15.
         Some psql features might not work.
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
Type "help" for help.

postgres=#

这确认了一次成功的 SSL 连接。

退出 shell。

postgres=# \q

如果你的应用使用连接字符串,请按以下格式用于 SSL 连接。

postgres://user:
[email protected]
:5432/database_name?sslmode=require

如果你在客户端侧的 /var/lib/postgresql/.postgresql 位置拥有 Let's Encrypt 的根证书,可以将 SSL 模式改为 verify-full 或 verify-ca。

创建 /var/lib/postgresql/.postgresql 目录。

$ sudo mkdir -p /var/lib/postgresql/.postgresql

Let's Encrypt 的根证书为 ISRG Root X1,位于服务器上的 /usr/share/ca-certificates/mozilla/ISRG_Root_X1.crt 位置。

将根证书复制到 /var/lib/postgresql/.postgresql 目录。

$ sudo cp /usr/share/ca-certificates/mozilla/ISRG_Root_X1.crt /var/lib/postgresql/.postgresql/root.crt

使用 verify-full 或 verify-ca 模式测试连接,你应该会看到连接成功。

步骤 9 - 检查客户端

登录到服务器上的 PostgreSQL shell。

$ sudo -i -u postgres psql

运行以下 SQL 命令以查看已连接的客户端。

SELECT ssl.pid, usename, datname, ssl, ssl.version, ssl.cipher, ssl.bits, client_addr
FROM pg_catalog.pg_stat_ssl ssl, pg_catalog.pg_stat_activity activity
WHERE ssl.pid = activity.pid;

你应该会看到类似的输出。

 pid  | usename  | datname  | ssl | version |         cipher         | bits |  client_addr
------+----------+----------+-----+---------+------------------------+------+----------------
 5126 | postgres | postgres | t   | TLSv1.3 | TLS_AES_256_GCM_SHA384 |  256 | 122.161.84.220
 5154 | postgres | postgres | f   |         |                        |      |
(2 rows)

这从服务端确认了客户端连接。

结论

至此,本篇关于为 PostgreSQL 连接启用 SSL 的教程就结束了。如果你有任何问题,请发表在下面的评论中。