port 是一个 配置参数，用于确定服务器应该监听哪个 TCP/IP 端口。
port 在 PostgreSQL 7.1 中添加。
用法
提供的端口必须在 1 和 65535 之间。请注意，根据操作系统和配置的不同，并非所有端口范围都可供 PostgreSQL 运行的用户使用。
所提供的端口号在确定 Unix 套接字名称时也会被使用。
监听多个端口
PostgreSQL 只能监听一个端口，因此无法为 port 提供多个值。
但是，可以使用外部工具配置通过多个端口进行访问；有关示例解决方案，请参阅 有用链接 部分。
默认值
port 的默认值为：5432。
按 PostgreSQL 版本详细信息
端口 (PostgreSQL 19)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 18)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 17)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 16)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 15)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 14)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 13)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 12)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 11)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 10)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 9.6)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 9.5)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档：port
端口 (PostgreSQL 9.4)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 |
文档：port
端口 (PostgreSQL 9.3)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 |
文档：port
端口 (PostgreSQL 9.2)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 |
文档：port
端口 (PostgreSQL 9.1)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 |
文档：port
端口 (PostgreSQL 9.0)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 |
文档：port
端口 (PostgreSQL 8.4)
| 设置 | 5432 |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
| 枚举值 | |
| 启动值 | 5432 |
| 重置值 | 5432 |
| 源文件 | |
| 源行 |
文档：port
端口 (PostgreSQL 8.3)
| 设置 | |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
文档：port
端口 (PostgreSQL 8.2)
| 设置 | |
| 单位 | |
| 类别 | 连接和身份验证 / 连接设置 |
| 简短描述 | 设置服务器监听的 TCP 端口。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | 整数 |
| 来源 | 命令行 |
| 最小值 | 1 |
| 最大值 | 65535 |
文档：port
变更历史
- 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 文档： port
有用链接
- 配置 PgBouncer 以实现多端口访问 - 2023 年 6 月 Percona 的 Robert Bernier 撰写的博客文章