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 18)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: listen_addresses
listen_addresses (PostgreSQL 17)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: listen_addresses
listen_addresses (PostgreSQL 16)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: listen_addresses
listen_addresses (PostgreSQL 15)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: listen_addresses
listen_addresses (PostgreSQL 14)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: listen_addresses
listen_addresses (PostgreSQL 13)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: listen_addresses
listen_addresses (PostgreSQL 12)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: listen_addresses
listen_addresses (PostgreSQL 11)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: listen_addresses
listen_addresses (PostgreSQL 10)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: listen_addresses
listen_addresses (PostgreSQL 9.6)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: listen_addresses
listen_addresses (PostgreSQL 9.5)
| 设置 | localhost |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置要监听的主机名或 IP 地址。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 默认 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | localhost |
| 重置值 | localhost |
| 源文件 | |
| 源代码行 | |
| 需要重新启动 | 否 |
文档: 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
变更历史
- PostgreSQL 8.0
- 添加（提交 2e45c143，替换
tcpip_socket和virtual_host）
- 添加（提交 2e45c143，替换
示例
当 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
参考文献
- PostgreSQL 文档： listen_addresses