port 是一个 配置参数，用于确定服务器应该监听哪个 TCP/IP 端口。
port 在 PostgreSQL 7.1 中添加。
用法
提供的端口必须在 1 和 65535 范围内。请注意，根据操作系统和配置的不同，并非所有端口范围都可用于 PostgreSQL 运行所在的系统用户。
提供的端口号也用于确定 Unix 套接字名称。
监听多个端口
PostgreSQL 只能监听一个端口，因此无法为 port 提供多个值。
但是，可以使用外部工具配置通过多个端口进行访问；请参阅 有用链接 部分以了解示例解决方案。
默认值
port 的默认值为：5432。
按 PostgreSQL 版本分列的详细信息
端口 (PostgreSQL 17)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 | |
| 挂起重启 | 否 |
文档：端口
端口 (PostgreSQL 16)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 | |
| 挂起重启 | 否 |
文档：端口
端口 (PostgreSQL 15)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 | |
| 挂起重启 | 否 |
文档：端口
端口 (PostgreSQL 14)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 | |
| 挂起重启 | 否 |
文档：端口
端口 (PostgreSQL 13)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 | |
| 挂起重启 | 否 |
文档：端口
端口 (PostgreSQL 12)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 | |
| 挂起重启 | 否 |
文档：端口
端口 (PostgreSQL 11)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 | |
| 挂起重启 | 否 |
文档：端口
端口 (PostgreSQL 10)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 | |
| 挂起重启 | 否 |
文档：端口
端口 (PostgreSQL 9.6)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 | |
| 挂起重启 | 否 |
文档：端口
端口 (PostgreSQL 9.5)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 | |
| 挂起重启 | 否 |
文档：端口
端口 (PostgreSQL 9.4)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 |
文档：端口
端口 (PostgreSQL 9.3)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 |
文档：端口
端口 (PostgreSQL 9.2)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 |
文档：端口
端口 (PostgreSQL 9.1)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 |
文档：端口
端口 (PostgreSQL 9.0)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 |
文档：端口
端口 (PostgreSQL 8.4)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 引导值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源代码行 |
文档：端口
端口 (PostgreSQL 8.3)
| 设置 | |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
文档：端口
端口 (PostgreSQL 8.2)
| 设置 | |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
文档：端口
变更历史
- PostgreSQL 7.1
- 添加 (提交 6a68f426)
示例
在启动时，PostgreSQL 会在日志中报告其正在监听的 地址 和端口
[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
无法提供多个端口
postgres=# ALTER SYSTEM SET port=5432,5433; ERROR: SET port takes only one argument postgres=# ALTER SYSTEM SET port='5432,5433'; ERROR: invalid value for parameter "port": "5432,5433"
如果在配置文件中提供了多个端口，服务器将无法启动或重新启动，并显示类似于以下内容的消息
waiting for server to start....2022-08-20 00:18:11.565 GMT [19024] LOG: syntax error in file "/var/lib/pgsql/postgresql.conf" line 3, near token ","
参考文献
- PostgreSQL 文档： 端口
有用链接
- 配置 PgBouncer 以实现多端口访问 - Robert Bernier / Percona 于 2023 年 6 月发布的博文