本页内容
- 准备工作
- 步骤 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 的教程就结束了。如果你有任何问题,请发表在下面的评论中。