CONFIGURATION PARAMETER连接和认证 / SSL
ssl_sni
启用 SSL 连接的 SNI 配置。
Sets whether to interpret SNI extensions in SSL connections.
布尔 引入 19 现存至 20 devel 0 次默认值变更 开发版
- 类型
- 布尔bool
- 分类
- 连接和认证 / SSL
- 引入版本
- 19
- 状态
- 现存
版本轨迹
相对 PostgreSQL 19 无变化。 20 开发版尚未定稿：类型与说明取自手册，默认值、上下文和运行值尚未采样。
默认值变迁
仅记录了 PostgreSQL 19 的默认值。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
启用 SSL 连接的 SNI 配置。设置为 on 时，将使用来自 hosts_file 的主机配置；更多细节参见第 18.9.6 节。
此参数只能在 postgresql.conf 文件中或者服务器命令行上设置。默认值为 off。
机制详解
ssl_sni：设置是否解释 SSL 连接中的 SNI 扩展。重新加载配置即可让服务器采用新值，无需完整重启。 本站在 PG19 Beta 3 实测到它；boot_val 是编译或初始化基线，并不能证明某个运行集群的当前有效值。
在 TLS 下启用后，PostgreSQL 读取客户端的 Server Name Indication，并通过 hosts_file 选择凭据。主机名不区分大小写匹配，/no_sni/ 与 * 提供明确的回退行为；证书身份、客户端校验、CRL、文件权限和 reload 失败仍需独立验证。
应与 hosts_file、ssl、ssl_cert_file、ssl_key_file 一起理解。请在目标服务器检查 SHOW 与 pg_settings，确认 source 和 pending_restart，并在修改前后对比真实负载、日志和资源指标。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
通过分批客户端上线，验证证书选择与到期告警，并监控认证失败。保留测试过的回退方案，把文件权限和密钥轮换作为同一变更的一部分。
-
OLAP分析与批处理
批处理驱动与长连接 ETL 也应采用同一安全策略；测试不发送 SNI 的客户端、凭据到期自动化、reload 行为和证书链兼容性。
-
小规格低配实例与开发机
优先保持简单且有文档的 TLS 与凭据策略。没有覆盖每个主机名和回退路径的测试就不要启用多证书路由，更不能降低验证强度来掩盖配置错误。
常见问题
- 把 ssl_sni 的实测 boot_val 当成初始化后或托管集群当前有效值的证明。
- 忽略 pg_settings 报告的 sighup context，误以为修改会立即生效。
- 孤立修改该参数，没有检查关联上限、可观测性和回滚路径。
- 在生产中依赖测试版行为，却没有在 PostgreSQL 19 正式版发布后重新验证。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 19 ← 18 新增此参数
PostgreSQL 19 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| SSL 17 | |||||
ssl |
布尔 | 重载生效 | off |
101 次 | |
| 启用 SSL 连接。 | 现存 | ||||
ssl_ca_file |
字符串 | 重载生效 | 空字符串 |
101 次 | |
| 指定包含 SSL 服务器证书颁发机构（CA）的文件名。 | 现存 | ||||
ssl_cert_file |
字符串 | 重载生效 | server.crt |
101 次 | |
| 指定包含 SSL 服务器证书的文件名。 | 现存 | ||||
ssl_ciphers |
字符串 | 重载生效 | HIGH:MEDIUM:+3DES:!aNULL |
103 次 | |
| 指定允许用于 TLS 1.2 及更低版本连接的 SSL 密码套件列表；对于 TLS 1.3 连接，请参见 ssl_tls13_ciphers。 | 现存 | ||||
ssl_crl_dir |
字符串 | 重载生效 | 空字符串 |
— | |
| 指定包含 SSL 客户端证书吊销列表（CRL）的目录名称。 | 现存 | ||||
ssl_crl_file |
字符串 | 重载生效 | 空字符串 |
101 次 | |
| 指定包含 SSL 客户端证书吊销列表（CRL）的文件名。 | 现存 | ||||
ssl_dh_params_file |
字符串 | 重载生效 | 空字符串 |
— | |
| 指定包含 Diffie-Hellman 参数的文件名，这些参数用于所谓临时 DH 系列的 SSL 密码套件。 | 现存 | ||||
ssl_ecdh_curve |
字符串 | 重载生效 | prime256v1 |
101 次 | |
| 指定在 ECDH 密钥交换中使用的曲线名称。 | 于 18 移除 | ||||
ssl_groups |
字符串 | 重载生效 | X25519:prime256v1 |
— | |
| 指定用于 TLS 密钥交换的命名组。 | 现存 | ||||
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 密码套件优先顺序，而非客户端的优先顺序。 | 现存 | ||||
ssl_sni |
布尔 | — | — | ||
| 启用 SSL 连接的 SNI 配置。 | 现存 | ||||
ssl_tls13_ciphers |
字符串 | 重载生效 | 空字符串 |
— | |
| 指定允许用于 TLS 版本 1.3 连接的密码套件列表。 | 现存 | ||||