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 期间确定),则可能更少。这个参数只能在服务器启动时设置。
增大这个参数可能会导致PostgreSQL请求比操作系统默认配置所允许的更多的System V共享内存或信号量。如有必要,关于如何调整这些参数的信息请参见第 17.4.1 节。
当运行一个备库时,你必须设置这个参数等于或大于主库上的参数。 否则,备库上将不允许查询。
superuser_reserved_connections (integer) #决定为 PostgreSQL 超级用户连接保留多少个连接“槽”。 同时活跃的连接数最多始终只能达到 max_connections。 当活跃并发连接数至少达到 max_connections 减去 superuser_reserved_connections 时,新连接将只接受超级用户, 并且不再接受新的复制连接。
默认值是 3 个连接。该值必须小于 max_connections。 这个参数只能在服务器启动时设置。
unix_socket_directory (string) #指定服务器用于监听来自客户端应用连接的 Unix 域套接字的目录。默认值通常是/tmp,但可以在构建时更改。这个参数只能在服务器启动时设置。
除了套接字文件本身(名为.s.PGSQL.,其中nnnnnnnn是服务器的端口号),还会在unix_socket_directory目录中创建一个名为.s.PGSQL.的普通文件。这两个文件都不应该被手工移除。nnnn.lock
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_directory 指向一个仅向目标用户授予搜索权限的目录,以达到类似效果。Windows 没有 Unix 域套接字,因此此参数在 Windows 上也没有意义。
bonjour (boolean) #启用通过 Bonjour 通告服务器存在的功能。默认值为关闭。此参数只能在服务器启动时设置。
bonjour_name (string) #指定 Bonjour 服务名。空字符串 ''(默认值)表示使用计算机名。 如果编译时未启用 Bonjour 支持,则此参数会被忽略。此参数只能在服务器启动时设置。
tcp_keepalives_idle (integer) #指定在一个原本空闲的连接上发送 keepalive 包之前要等待的秒数。值 0 表示使用系统默认值。此参数仅在支持TCP_KEEPIDLE或TCP_KEEPALIVE符号的系统以及 Windows 上可用;在其他系统上,它必须为零。在通过 Unix 域套接字连接的会话中,此参数会被忽略,并始终读作零。
在 Windows 上,值 0 会将此参数设置为 2 小时,因为 Windows 不提供读取系统默认值的方法。
tcp_keepalives_interval (integer) #指定在一个原本空闲的连接上两次发送 keepalive 之间间隔的秒数。值 0 表示使用系统默认值。此参数仅在支持TCP_KEEPINTVL符号的系统以及 Windows 上可用;在其他系统上,它必须为零。在通过 Unix 域套接字连接的会话中,此参数会被忽略,并始终读作零。
在 Windows 上,值 0 会将此参数设置为 1 秒,因为 Windows 不提供读取系统默认值的方法。
tcp_keepalives_count (integer) #指定在一个原本空闲的连接上要发送的 keepalive 包数量。值 0 表示使用系统默认值。此参数仅在支持TCP_KEEPCNT符号的系统上可用;在其他系统上,它必须为零。在通过 Unix 域套接字连接的会话中,此参数会被忽略,并始终读作零。
Windows 不支持此参数,它必须为零。
authentication_timeout (integer) #允许完成客户端认证的最长时间,以秒为单位。如果一个客户端没有在这段时间里完成认证协议,服务器将关闭连接。 这样就避免了出问题的客户端无限制地占有一个连接。 默认值是 1分钟(1m)。这个参数只能在服务器命令行上或者在postgresql.conf文件中设置。
ssl (boolean) #启用SSL连接。使用前请阅读第 17.9 节。默认值是off。这个参数只能在服务器启动时设置。SSL通信只能在 TCP/IP 连接上使用。
ssl_renegotiation_limit (integer) #指定在一个SSL加密连接上可以流过多少数据之后将进行会话密钥的重新协商。当可以检查大量流量时,重新协商能降低攻击者进行密码分析的机会,但它也会带来很大的性能损失。该限制以发送和接收流量的总和来检查。如果这个参数被设置为 0,则禁用重新协商。默认值为0。
2009 年 11 月之前的 SSL 库在使用 SSL 重新协商时不安全,原因是 SSL 协议中的一个漏洞。作为针对该漏洞的权宜修复,一些厂商发布的 SSL 库不具备重新协商能力。如果在客户端或服务器上正在使用这类库,应当禁用 SSL 重新协商。
由于 OpenSSL 中的 bug,启用 SSL 重新协商(即把 ssl_renegotiation_limit配置为非零)很可能导致诸如长连接中断之类的问题。
ssl_ciphers (string) #指定允许在安全连接上使用的SSL密码列表。支持的密码列表请参见openssl手册页。
password_encryption (boolean) #在 CREATE USER 或 ALTER ROLE 中指定密码,且既没有写 ENCRYPTED 也没有写 UNENCRYPTED 时,此参数决定密码是否被加密。默认值为 on(加密密码)。
krb_server_keyfile (string) #设置服务器的Kerberos密钥文件的位置。详情请参考第 19.3.5 节或第 19.3.3 节。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
krb_srvname (string) #设置Kerberos服务名。详情请参考第 19.3.5 节。这个参数只能在postgresql.conf文件中或者服务器命令行上设置。
krb_caseins_users (boolean) #设置是否应该以大小写不敏感的方式对待Kerberos和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 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。