pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
listen_addresses (string) #指定服务器用于监听客户端应用连接的 TCP/IP 地址。此值采用以逗号分隔的主机名和/或数字 IP 地址列表的形式。 特殊项*对应所有可用的 IP 接口。项0.0.0.0允许监听所有 IPv4 地址， 而::允许监听所有 IPv6 地址。如果列表为空，服务器不会监听任何 IP 接口，此时只能通过 Unix 域套接字连接。 默认值为localhost，只允许建立本地 TCP/IP “回环”连接。 在客户端认证（第 19 章）允许对谁可以访问服务器进行细粒度控制的同时，listen_addresses 控制哪些接口接受连接尝试，这可以帮助防止在不安全的网络接口上重复恶意连接请求。此参数只能在服务器启动时设置。
port (integer) #服务器监听的 TCP 端口，默认是 5432。请注意，服务器监听的所有 IP 地址都使用同一个端口号。 此参数只能在服务器启动时设置。
max_connections (integer) #决定数据库服务器允许的最大并发连接数。默认值通常是 100 个连接，但如果内核设置不支持 （在 initdb 期间确定），则可能更少。这个参数只能在服务器启动时设置。
当运行一个备库时，你必须设置这个参数等于或大于主库上的参数。 否则，备库上将不允许查询。
superuser_reserved_connections (integer) #决定为 PostgreSQL 超级用户连接保留多少个连接“槽”。 同时活跃的连接数最多始终只能达到 max_connections。 当活跃并发连接数至少达到 max_connections 减去 superuser_reserved_connections 时，新连接将只接受超级用户， 并且不再接受新的复制连接。
默认值是 3 个连接。该值必须小于 max_connections。 这个参数只能在服务器启动时设置。
unix_socket_directories (string) #指定服务器用于监听来自客户端应用的连接的 Unix 域套接字目录。通过列出用逗号分隔的多个目录可以建立多个套接字。 项之间的空白被忽略，如果你需要在名字中包括空白或逗号，在目录名周围放上双引号。 一个空值指定在任何 Unix 域套接字上都不监听，在这种情况中只能使用 TCP/IP 套接字来连接到服务器。 默认值通常是 /tmp，但可以在构建时更改。 这个参数只能在服务器启动时设置。
除了套接字文件本身（名为.s.PGSQL.，其中nnnnnnnn是服务器的端口号），一个名为.s.PGSQL.的普通文件会在每一个nnnn.lockunix_socket_directories目录中被创建。 任何一个都不应该被手工移除。
Windows 没有 Unix 域套接字，因此此参数在 Windows 上没有意义。
unix_socket_group (string) #设置 Unix 域套接字的所属组（套接字的所属用户总是启动服务器的用户）。可以与选项unix_socket_permissions一起用于对 Unix域连接进行访问控制。默认是一个空字符串，表示服务器用户的默认组。这个参数只能在服务器启动时设置。
Windows 没有 Unix 域套接字，因此此参数在 Windows 上没有意义。
unix_socket_permissions (integer) #设置 Unix 域套接字的访问权限。Unix 域套接字使用通常的 Unix 文件系统权限集。参数值应是以 chmod 和 umask 系统调用所接受格式指定的数字权限模式。（要使用惯用的八进制格式，数字必须以 0（零）开头。）
默认权限是 0777，表示任何人都可以连接。合理的其他取值包括 0770（仅属主和所属组，另见 unix_socket_group）和 0700（仅属主）。（注意，对 Unix 域套接字而言，只有写权限起作用，因此设置或撤销读权限和执行权限没有意义。）
此访问控制机制独立于 第 19 章 中描述的机制。
此参数只能在服务器启动时设置。
此参数对完全忽略套接字权限的系统无效，尤其是 Solaris（截至 Solaris 10）。在这些系统上，可以将 unix_socket_directories 指向一个仅向目标用户授予搜索权限的目录，以达到类似效果。Windows 没有 Unix 域套接字，因此此参数在 Windows 上也没有意义。
bonjour (boolean) #启用通过 Bonjour 通告服务器存在的功能。默认值为关闭。此参数只能在服务器启动时设置。
bonjour_name (string) #指定 Bonjour 服务名。空字符串 ''（默认值）表示使用计算机名。 如果编译时未启用 Bonjour 支持，则此参数会被忽略。此参数只能在服务器启动时设置。
tcp_keepalives_idle (integer) #指定在没有活动多少秒之后，TCP 应向客户端发送 keepalive 消息。值 0 表示使用系统默认值。 此参数仅在支持TCP_KEEPIDLE或等效套接字选项的系统以及 Windows 上可用；在其他系统上，它必须为零。 在通过 Unix 域套接字连接的会话中，此参数会被忽略，并始终读作零。
在 Windows 上，值 0 会将此参数设置为 2 小时，因为 Windows 不提供读取系统默认值的方法。
tcp_keepalives_interval (integer) #指定未被客户端确认收到的 TCP keepalive 消息在多少秒后应被重传。值 0 表示使用系统默认值。 此参数仅在支持TCP_KEEPINTVL或等效套接字选项的系统以及 Windows 上可用；在其他系统上，它必须为零。 在通过 Unix 域套接字连接的会话中，此参数会被忽略，并始终读作零。
在 Windows 上，值 0 会将此参数设置为 1 秒，因为 Windows 不提供读取系统默认值的方法。
tcp_keepalives_count (integer) #指定在服务器与客户端之间的连接被视为中断之前，可以丢失多少个 TCP keepalive 消息。 值 0 表示使用系统默认值。 这个参数只有在支持 TCP_KEEPCNT 或等效套接字选项的系统上才可用 ；在其他系统上，它必须为零。在通过 Unix 域套接字连接的会话中， 这个参数会被忽略，并始终读作零。
Windows 不支持此参数，它必须为零。
authentication_timeout (integer) #允许完成客户端认证的最长时间，以秒为单位。如果一个客户端没有在这段时间里完成认证协议，服务器将关闭连接。 这样就避免了出问题的客户端无限制地占有一个连接。 默认值是 1分钟（1m）。这个参数只能在服务器命令行上或者在postgresql.conf文件中设置。
ssl (boolean) #启用SSL连接。使用前请阅读第 17.9 节。默认值是off。这个参数只能在服务器启动时设置。SSL通信只能在 TCP/IP 连接上使用。
ssl_ca_file (string) #指定包含 SSL 服务器证书颁发机构（CA）的文件名。默认值为空，表示没有载入 CA 文件，并且客户端证书验证没有被执行。（在以前的 PostgreSQL 版本中，此文件名被硬编码为root.crt。）相对路径是相对于数据目录的。这个参数只能在服务器启动时设置。
ssl_cert_file (string) #指定包含 SSL 服务器证书的文件名。默认值是server.crt。相对路径是相对于数据目录的。这个参数只能在服务器启动时设置。
ssl_crl_file (string) #指定包含 SSL 服务器证书吊销列表（CRL）的文件名。默认为空，表示不加载 CRL 文件。（在以前的 PostgreSQL 版本中，此文件名被硬编码为root.crl。）相对路径是相对于数据目录的。这个参数只能在服务器启动时设置。
ssl_key_file (string) #指定包含 SSL 服务器私钥的文件名。默认值是server.key。相对路径是相对于数据目录的。这个参数只能在服务器启动时设置。
ssl_ciphers (string) #指定允许 SSL 连接使用的SSL密码套件列表。该设置的语法及支持的值列表，可参见OpenSSL包中的ciphers手册页。此设置只影响使用 TLS 1.2 及更低版本的连接。目前没有控制 TLS 1.3 连接所用密码套件的设置。默认值是HIGH:MEDIUM:+3DES:!aNULL。除非你有特定的安全需求，否则通常是合理的。这个参数只能在服务器启动时设置。
默认值的解释：
HIGH使用HIGH组中密码（例如 AES、Camellia、3DES）的密码套件。
ssl_renegotiation_limit (integer) #指定在一个SSL加密连接上可以流过多少数据之后将进行会话密钥的重新协商。当可以检查大量流量时，重新协商能降低攻击者进行密码分析的机会，但它也会带来很大的性能损失。该限制以发送和接收流量的总和来检查。如果这个参数被设置为 0，则禁用重新协商。默认值为0。
2009 年 11 月之前的 SSL 库在使用 SSL 重新协商时不安全，原因是 SSL 协议中的一个漏洞。作为针对该漏洞的权宜修复，一些厂商发布的 SSL 库不具备重新协商能力。如果在客户端或服务器上正在使用这类库，应当禁用 SSL 重新协商。
由于 OpenSSL 中的 bug，启用 SSL 重新协商（即把 ssl_renegotiation_limit配置为非零）很可能导致诸如长连接中断之类的问题。
MEDIUM使用MEDIUM组中密码（例如 RC4、SEED）的密码套件。
+3DESOpenSSL对HIGH的默认排序有问题， 因为它将 3DES 排在 AES128 之前。这是不正确的，因为 3DES 的安全性低于 AES128， 并且速度也慢得多。+3DES会把它重新排序到其他所有 HIGH和MEDIUM密码之后。
!aNULL禁用不进行认证的匿名密码套件。这类密码套件容易遭受中间人攻击，因此不应使用。
可用的密码套件细节可能会随着OpenSSL 版本变化。 可使用命令 openssl ciphers -v 'HIGH:MEDIUM:+3DES:!aNULL'来查看当前安装的OpenSSL版本的实际细节。 注意这个列表是根据服务器密钥类型在运行时过滤过的。
ssl_prefer_server_ciphers (bool) #指定是否使用服务器的 SSL 密码套件优先顺序，而非客户端的优先顺序。默认值为 true。此参数只能在服务器启动时设置。
旧版 PostgreSQL没有此设置，始终采用客户端的优先顺序。此设置主要用于与这些旧版本保持向后兼容。采用服务器的优先顺序通常更好，因为服务器更可能得到适当配置。
ssl_ecdh_curve (string) #指定在 ECDH 密钥交换中使用的曲线名称。所有连接的客户端都必须支持该曲线。它不必与服务器椭圆曲线密钥使用的曲线相同。默认值为 prime256v1。此参数只能在服务器启动时设置。
OpenSSL 中最常见曲线的名称：prime256v1（NIST P-256）、secp384r1（NIST P-384）、secp521r1（NIST P-521）。
可以用 openssl ecparam -list_curves 命令显示可用曲线的完整列表，但其中并非所有曲线都能用于 TLS。
password_encryption (boolean) #在 CREATE USER 或 ALTER ROLE 中指定密码，且既没有写 ENCRYPTED 也没有写 UNENCRYPTED 时，此参数决定密码是否被加密。默认值为 on（加密密码）。
krb_server_keyfile (string) #设置服务器的Kerberos密钥文件的位置。详情请参考第 19.3.3 节。 这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
krb_caseins_users (boolean) #设置是否应该以大小写不敏感的方式对待GSSAPI用户名。默认值是off（大小写敏感）。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
db_user_namespace (boolean) #此参数启用各数据库独立的用户名。默认关闭。 此参数只能在postgresql.conf文件中或在服务器命令行上设置。
如果启用此参数，你应以username@dbname的形式创建用户。 连接的客户端传入username时，会在用户名后附加@和数据库名， 然后由服务器查找此数据库专属的用户名。请注意，在 SQL 环境中创建名称包含@的用户时，需要用引号括起用户名。
启用此参数后，仍然可以创建普通的全局用户。只需在客户端指定用户名时附加@，例如joe@。 服务器查找用户名之前会去掉@。
db_user_namespace会使客户端和服务器的用户名表示形式不同。 认证检查始终使用服务器端的用户名，因此认证方法必须针对服务器端的用户名配置，而不是客户端的用户名。 由于md5在客户端和服务器上都使用用户名作为盐值，md5不能与db_user_namespace一起使用。
此特性旨在作为找到完整解决方案之前的临时措施。届时将移除此选项。
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。