CONFIGURATION PARAMETER连接和认证 / SSL
ssl_ciphers
设置 TLS 1.2 及更低版本允许使用的密码套件列表。
Sets the list of allowed TLSv1.2 (and lower) ciphers.
字符串 重载生效 引入 9.1 现存至 20 devel 2 次默认值变更
- 类型
- 字符串string
- 上下文
- 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
- 默认值
HIGH:MEDIUM:+3DES:!aNULL- 分类
- 连接和认证 / SSL
- 引入版本
- 9.1
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 仅简述或分类有更新。
默认值变迁
默认值一共换过 3 档，每段的宽度按它覆盖的大版本数伸展，深色的一段是当前查看的 PostgreSQL 18。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
指定允许用于 TLS 1.2 及更低版本连接的 SSL 密码套件列表； 对于 TLS 1.3 连接，请参见 ssl_tls13_ciphers。 该设置的语法及支持的值列表可参见 OpenSSL 包中的 ciphers 手册页。 默认值是HIGH:MEDIUM:+3DES:!aNULL。除非你有特定的安全需求，否则这个默认值通常是合理的选择。
这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
默认值的解释：
HIGH使用
HIGH组中密码（例如 AES、Camellia、3DES）的密码套件。MEDIUM使用
MEDIUM组中密码（例如 RC4、SEED）的密码套件。+3DESOpenSSL对
HIGH的默认排序有问题， 因为它将 3DES 排在 AES128 之前。这是不正确的，因为 3DES 的安全性低于 AES128， 并且速度也慢得多。+3DES会把它重新排序到其他所有HIGH和MEDIUM密码之后。!aNULL禁用不进行认证的匿名密码套件。这类密码套件容易遭受MITM攻击，因此不应使用。
可用的密码组细节可能会随着OpenSSL 版本变化。 可使用命令 openssl ciphers -v 'HIGH:MEDIUM:+3DES:!aNULL'来查看当前安装的OpenSSL版本的实际细节。 注意这个列表是根据服务器密钥类型在运行时过滤过的。
机制详解
ssl_ciphers 名称在本项目 2008 年历史边界以及 PG9.0 的 GUC 源码中已经存在，但只在定义 USE_SSL 时编译。本项目可审计的 PG9.0 备用构建没有启用 OpenSSL，因此该名称首次出现在 PG9.1 官方镜像快照；这个矩阵边界反映构建能力，而不是功能最初发明时间。
该 OpenSSL 密码字符串控制 TLS 1.2 及更低版本握手；PG18+ 的 TLS 1.3 套件由 ssl_tls13_ciphers 单独配置。SIGHUP reload 会改变新 TLS 上下文和新连接使用的策略，但不会重新协商已经建立的会话。
应把 ssl_ciphers 视为完整传输策略的一部分，与 ssl、pg_hba.conf、证书和私钥、CA 与吊销设置、协议上下限、ssl_groups 及客户端能力联合验证。必须针对实际安装的 OpenSSL 构建测试，因为可接受的密码名称与安全级别依赖库版本。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
把 ssl_ciphers 作为传输安全策略而非性能旋钮。遵循组织 TLS 基线，并测试证书轮换、重新加载及每类客户端。
-
OLAP分析与批处理
分析流量应采用相同 TLS 下限；大流量可能暴露 CPU 成本，但只能在正确性之后压测，不能据此接受过时协议。
-
小规格低配实例与开发机
保持 ssl_ciphers 简单且安全，使用托管证书与针对当前 OpenSSL 版本评审过的库默认值，并在到期前演练续期。
常见问题
- 编辑 ssl_ciphers 后没有重新加载配置，也没有核对有效值与后续行为。
- 只更新一个 TLS 文件或策略参数，留下无效证书链、不可读私钥或不兼容协议集合。
- 误以为重新加载会重新协商既有会话；TLS 策略变化只影响新握手。
- 没有回滚计划及客户端或运维兼容测试，就全局修改 ssl_ciphers。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 仅描述更新
简述
Sets the list of allowed SSL ciphers.Sets the list of allowed TLSv1.2 (and lower) ciphers. -
PostgreSQL 11 ← 10 仅描述更新
分类
Connections and Authentication / Security and AuthenticationConnections and Authentication / SSL -
PostgreSQL 10 ← 9.6 属性变更
上下文
重启生效重载生效 -
PostgreSQL 9.4 ← 9.3 默认值变更
默认值
DEFAULT:!LOW:!EXP:!MD5:@STRENGTHHIGH:MEDIUM:+3DES:!aNULL -
PostgreSQL 9.3 ← 9.2 默认值变更
默认值
ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTHDEFAULT:!LOW:!EXP:!MD5:@STRENGTH -
PostgreSQL 9.1 ← 9.0 新增此参数
PostgreSQL 9.1 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.1 | ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.2 | ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.3 | DEFAULT:!LOW:!EXP:!MD5:@STRENGTH |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.4 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.5 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.6 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重启生效 |
字符串 |
— |
— |
— |
| 10 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
| 11 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
| 12 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
| 13 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
| 14 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
| 15 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
| 16 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
| 17 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
| 18 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
| 19 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
| 20 沿用 | HIGH:MEDIUM:+3DES:!aNULL |
— |
重载生效 |
字符串 |
— |
— |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| SSL 17 | |||||
ssl |
布尔 | 重载生效 | off |
101 次 | |
| 启用 SSL/TLS 连接。 | 现存 | ||||
ssl_ca_file |
字符串 | 重载生效 | 空字符串 |
101 次 | |
| 设置 SSL 证书颁发机构文件的位置。 | 现存 | ||||
ssl_cert_file |
字符串 | 重载生效 | server.crt |
101 次 | |
| 设置 SSL 服务器证书文件的位置。 | 现存 | ||||
ssl_ciphers |
字符串 | 重载生效 | HIGH:MEDIUM:+3DES:!aNULL |
103 次 | |
| 设置 TLS 1.2 及更低版本允许使用的密码套件列表。 | 现存 | ||||
ssl_crl_dir |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置 SSL 证书吊销列表目录的位置。 | 现存 | ||||
ssl_crl_file |
字符串 | 重载生效 | 空字符串 |
101 次 | |
| 设置 SSL 证书吊销列表文件的位置。 | 现存 | ||||
ssl_dh_params_file |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置 SSL DH 参数文件的位置。 | 现存 | ||||
ssl_ecdh_curve |
字符串 | 重载生效 | prime256v1 |
101 次 | |
| 设置 ECDH 使用的椭圆曲线。 | 于 18 移除 | ||||
ssl_groups |
字符串 | 重载生效 | X25519:prime256v1 |
— | |
| 设置 Diffie-Hellman 密钥交换使用的组。 | 现存 | ||||
ssl_key_file |
字符串 | 重载生效 | server.key |
101 次 | |
| 设置 SSL 服务器私钥文件的位置。 | 现存 | ||||
ssl_max_protocol_version |
枚举 | 重载生效 | 空字符串 |
— | |
| 设置允许使用的最高 SSL/TLS 协议版本。 | 现存 | ||||
ssl_min_protocol_version |
枚举 | 重载生效 | TLSv1.2 |
131 次 | |
| 设置允许使用的最低 SSL/TLS 协议版本。 | 现存 | ||||
ssl_passphrase_command |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置用于获取 SSL 私钥口令的命令。 | 现存 | ||||
ssl_passphrase_command_supports_reload |
布尔 | 重载生效 | off |
— | |
| 控制重新加载服务器配置时是否调用 ssl_passphrase_command。 | 现存 | ||||
ssl_prefer_server_ciphers |
布尔 | 重载生效 | on |
101 次 | |
| 优先采用服务器端的密码套件顺序。 | 现存 | ||||
ssl_sni |
布尔 | 重载生效 | off |
— | |
| 设置是否解释 SSL 连接中的 SNI 扩展。 | 现存 | ||||
ssl_tls13_ciphers |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置 TLS 1.3 允许使用的密码套件列表。 | 现存 | ||||