CONFIGURATION PARAMETER连接和认证 / 连接设置
unix_socket_directories
设置创建 Unix 域套接字的目录。
Sets the directories where Unix-domain sockets will be created.
字符串 重启生效 引入 9.3 现存至 20 devel 0 次默认值变更
- 类型
- 字符串string
- 上下文
- 重启生效只能在服务器启动时设置，修改后需要重启
- 默认值
/var/run/postgresql- 分类
- 连接和认证 / 连接设置
- 引入版本
- 9.3
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 9.3 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 14 完全一致，下面就是同一段文字。
指定服务器用于监听来自客户端应用的连接的 Unix 域套接字目录。通过列出用逗号分隔的多个目录可以建立多个套接字。 项之间的空白被忽略，如果你需要在名字中包括空白或逗号，在目录名周围放上双引号。 一个空值指定在任何 Unix 域套接字上都不监听，在这种情况中只能使用 TCP/IP 套接字来连接到服务器。
以 @ 开头的值表示应在抽象命名空间中创建 Unix 域套接字（目前仅在 Linux 上支持）。 在这种情况下，此值不指定一个“目录”，而是一个前缀，从中计算实际套接字名称的方式与文件系统命名空间相同。 虽然抽象套接字名称前缀可以自由选择（因为它不是文件系统位置），但惯例上仍然使用类似文件系统的值，例如 @/tmp。
默认值通常是 /tmp，但可以在构建时更改。 在 Windows 上，默认值为空，这意味着默认不会创建 Unix 域套接字。这个参数只能在服务器启动时设置。
除了套接字文件本身（名为.s.PGSQL.，其中nnnnnnnn是服务器的端口号），一个名为.s.PGSQL.的普通文件会在每一个nnnn.lockunix_socket_directories目录中被创建。 任何一个都不应该被手工移除。 对于抽象命名空间，没有锁文件被建立。
机制详解
unix_socket_directories：设置创建 Unix 域套接字的目录。PostgreSQL 启动时在每个所列目录创建套接字与锁文件；在支持的系统上，以 @ 开头的值选择抽象命名空间。
unix_socket_directories 属于 POSTMASTER 上下文：PostgreSQL 在服务器启动时读取它，重新加载配置或会话 SET 都不能使新值生效。
Unix 套接字可达性由目录存在性与遍历权限、套接字组和模式、服务器账号及客户端搜索路径共同决定；pg_hba.conf 的 local 记录仍负责认证。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
把 unix_socket_directories 纳入同一套 Unix 套接字访问策略：选择可信目录、所有者、组成员与权限，并测试本地连接池、监控、备份和管理工具。
-
OLAP分析与批处理
分析工具采用同一套经评审本地访问边界；只有客户端与操作系统生命周期受管时才新增目录或组。
-
小规格低配实例与开发机
保持 unix_socket_directories 简单且最小权限。本地套接字只带来很小的 TCP 开销差异，不应为方便而开放给所有用户。
常见问题
- 期待重新加载或 SET 激活 unix_socket_directories，而它实际需要受控重启服务器。
- 放宽套接字模式，却忽略目录遍历、组成员与 pg_hba.conf local 认证。
- 加入易失或不存在目录，导致重启后服务器无法启动或本地客户端找错位置。
- 没有回滚计划及客户端或运维兼容测试，就全局修改 unix_socket_directories。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 9.3 ← 9.2 新增此参数
PostgreSQL 9.3 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.3 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.4 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.5 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.6 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 10 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 11 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 12 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 13 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 14 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 15 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 16 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 17 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 18 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 19 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
| 20 沿用 | /var/run/postgresql |
— |
重启生效 |
字符串 |
— |
— |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 连接设置 11 | |||||
bonjour |
布尔 | 重启生效 | off |
— | |
| 启用通过 Bonjour 广播服务器。 | 现存 | ||||
bonjour_name |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置 Bonjour 服务名称。 | 现存 | ||||
listen_addresses |
字符串 | 重启生效 | localhost |
— | |
| 设置服务器监听的主机名或 IP 地址。 | 现存 | ||||
max_connections |
整数 | 重启生效 | 100 |
9.62 次 | |
| 设置数据库并发连接的最大数量。 | 现存 | ||||
port |
整数 | 重启生效 | 5432 |
— | |
| 设置服务器监听的 TCP 端口。 | 现存 | ||||
reserved_connections |
整数 | 重启生效 | 0 |
— | |
| 设置为具有 pg_use_reserved_connections 权限的角色保留的连接槽数量。 | 现存 | ||||
superuser_reserved_connections |
整数 | 重启生效 | 3 |
9.62 次 | |
| 设置为超级用户保留的连接槽数量。 | 现存 | ||||
unix_socket_directories |
字符串 | 重启生效 | /var/run/postgresql |
— | |
| 设置创建 Unix 域套接字的目录。 | 现存 | ||||
unix_socket_directory |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置创建 Unix 域套接字的目录。 | 于 9.3 移除 | ||||
unix_socket_group |
字符串 | 重启生效 | 空字符串 |
— | |
| 设置 Unix 域套接字的所属组。 | 现存 | ||||
unix_socket_permissions |
整数 | 重启生效 | 511 |
— | |
| 设置 Unix 域套接字的访问权限。 | 现存 | ||||