目录

listen_addresses

确定要侦听的TCP/IP地址的服务器参数

listen_addresses 是一个 配置参数，用于确定服务器应该侦听哪个或哪些TCP/IP地址。

listen_addresses 在 PostgreSQL 8.0 中添加。

用法

listen_addresses 可以由包含以下一个或多个元素的逗号分隔列表组成

  • 主机名
  • IP地址（IPv4和IPv6）
  • 0.0.0.0 表示服务器应侦听所有IPv4地址
  • :: 表示服务器应侦听所有IPv6地址
  • * 表示服务器应侦听所有可用地址

如果 listen_addresses 设置为空字符串，则服务器将不侦听任何IP接口，并且只能通过Unix域套接字进行连接。

如果 listen_addresses 包含多个值，则将按其提供的顺序进行评估。如果后面的值与前面的值冲突，从而无法绑定到指定的地址，则会发出 LOG 条目。例如，如果 listen_addresses 设置为 127.0.0.1,*，则PostgreSQL将绑定到 127.0.0.1 但不绑定到其他IPv4地址（但如果可用，则将绑定到所有IPv6地址）。请参见下面的示例。

默认值

listen_addresses 的默认值为：localhost。

按PostgreSQL版本分列的详细信息

listen_addresses (PostgreSQL 17)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  
待重启 false

文档: listen_addresses

listen_addresses (PostgreSQL 16)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  
待重启 false

文档: listen_addresses

listen_addresses (PostgreSQL 15)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  
待重启 false

文档: listen_addresses

listen_addresses (PostgreSQL 14)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  
待重启 false

文档: listen_addresses

listen_addresses (PostgreSQL 13)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  
待重启 false

文档: listen_addresses

listen_addresses (PostgreSQL 12)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  
待重启 false

文档: listen_addresses

listen_addresses (PostgreSQL 11)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  
待重启 false

文档: listen_addresses

listen_addresses (PostgreSQL 10)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  
待重启 false

文档: listen_addresses

listen_addresses (PostgreSQL 9.6)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  
待重启 false

文档: listen_addresses

listen_addresses (PostgreSQL 9.5)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  
待重启 false

文档: listen_addresses

listen_addresses (PostgreSQL 9.4)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  

文档: listen_addresses

listen_addresses (PostgreSQL 9.3)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  

文档: listen_addresses

listen_addresses (PostgreSQL 9.2)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  

文档: listen_addresses

listen_addresses (PostgreSQL 9.1)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  

文档: listen_addresses

listen_addresses (PostgreSQL 9.0)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  

文档: listen_addresses

listen_addresses (PostgreSQL 8.4)

设置 localhost
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  
枚举值  
启动值 localhost
重置值 localhost
源文件  
源代码行号  

文档: listen_addresses

listen_addresses (PostgreSQL 8.3)

设置  
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  

文档: listen_addresses

listen_addresses (PostgreSQL 8.2)

设置  
单位  
类别 连接和身份验证 / 连接设置
简短描述 设置要侦听的主机名或IP地址。
额外描述  
上下文 postmaster
变量类型 字符串
来源 默认
最小值  
最大值  

文档: listen_addresses

更改历史记录

示例

当 listen_addresses 设置为 * 时的日志条目

[2022-08-20 08:28:43 UTC]    LOG:  00000: listening on IPv4 address "0.0.0.0", port 5432
[2022-08-20 08:28:43 UTC]    LOG:  00000: listening on IPv6 address "::", port 5432
[2022-08-20 08:28:43 UTC]    LOG:  00000: listening on Unix socket "/tmp/.s.PGSQL.5432"
[2022-08-20 08:28:43 UTC]    LOG:  00000: database system was shut down at 2022-08-20 08:28:43 UTC
[2022-08-20 08:28:43 UTC]    LOG:  00000: database system is ready to accept connections

当 listen_addresses 设置为 127.0.0.1,* 时的日志条目

[2022-08-20 09:13:42 UTC]    LOG:  00000: listening on IPv4 address "127.0.0.1", port 5432
[2022-08-20 09:13:42 UTC]    LOG:  XX000: could not bind IPv4 address "0.0.0.0": Address already in use
[2022-08-20 09:13:42 UTC]    HINT:  Is another postmaster already running on port 5432? If not, wait a few seconds and retry.
[2022-08-20 09:13:42 UTC]    LOG:  00000: listening on IPv6 address "::", port 5432
[2022-08-20 09:13:42 UTC]    LOG:  00000: listening on Unix socket "/tmp/.s.PGSQL.5432"
[2022-08-20 09:13:42 UTC]    LOG:  00000: database system was shut down at 2022-08-20 09:13:42 UTC
[2022-08-20 09:13:42 UTC]    LOG:  00000: database system is ready to accept connections

分类

连接管理，GUC配置项

另请参阅

port，inet_server_addr()

反馈

提交关于 "listen_addresses" 的任何评论、建议或更正 此处。