支持的版本:当前 (17) / 16 / 15 / 14 / 13
开发版本:devel
不支持的版本:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4

32.16. 密码文件 #

用户主目录中的 .pgpass 文件可以包含在连接需要密码时使用的密码(并且没有指定其他密码)。在 Microsoft Windows 上,该文件名为 %APPDATA%\postgresql\pgpass.conf(其中 %APPDATA% 指的是用户配置文件中的 Application Data 子目录)。或者,可以使用连接参数 passfile 或环境变量 PGPASSFILE 来指定要使用的密码文件。

此文件应包含以下格式的行:

hostname:port:database:username:password

(您可以通过复制上面的行并在前面加上 # 来向文件中添加提醒注释。)前四个字段中的每一个都可以是字面值,或 *,它匹配任何内容。将使用与当前连接参数匹配的第一行中的密码字段。(因此,当您使用通配符时,请将更具体的条目放在前面。)如果某个条目需要包含 :\,请使用 \ 转义此字符。如果指定了主机名参数,则主机名字段与 host 连接参数匹配;否则,如果指定了 hostaddr 参数,则与该参数匹配;如果两者都没有给出,则搜索主机名 localhost。当连接是 Unix 域套接字连接且 host 参数与 libpq 的默认套接字目录路径匹配时,也会搜索主机名 localhost。在备用服务器中,replication 的数据库字段与到主服务器的流复制连接匹配。否则,数据库字段的用途有限,因为同一集群中的所有数据库的用户都具有相同的密码。

在 Unix 系统上,密码文件的权限必须禁止任何对世界或组的访问;通过诸如 chmod 0600 ~/.pgpass 之类的命令来实现此目的。如果权限没有这么严格,则会忽略该文件。在 Microsoft Windows 上,假定该文件存储在安全目录中,因此不会进行特殊的权限检查。

提交更正

如果您在文档中发现任何不正确、与您使用特定功能的经验不符或需要进一步澄清的内容,请使用此表单报告文档问题。