CONFIGURATION PARAMETER文件位置
config_file
指定主服务器配置文件（通常叫 postgresql.conf）。
Sets the server's main configuration file.
字符串 重启生效 引入 8.0 现存至 20 devel 0 次默认值变更
- 类型
- 字符串string
- 上下文
- 重启生效只能在服务器启动时设置，修改后需要重启
- 默认值
未设置- 分类
- 文件位置
- 引入版本
- 8.0
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
已记录的默认值在 PostgreSQL 9.0–19 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
指定主服务器配置文件（通常叫 postgresql.conf）。这个参数只能在 postgres 命令行上设置。
机制详解
设置服务器主配置文件。该值在服务器启动时固定，修改后必须重启。
该路径在服务器启动早期解析，服务账号必须具备正确的目录遍历与文件权限。路径参数是否需要重启，与目标文件内容是否可 reload 是两个不同问题。
应把 config_file 与 allow_alter_system、data_directory、hba_file 一起监控和变更。先在对应角色与真实负载上验证，再按其 postmaster context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
config_file 是部署拓扑而非负载调优项。使用绝对路径、最小权限和原子化配置发布，并在重启/重载前由 postgres 服务账号验证可读写性。
-
OLAP分析与批处理
规则与 OLTP 相同；若数据或配置位于独立挂载点，额外验证启动顺序、备份覆盖和故障切换节点上的路径一致性。
-
小规格低配实例与开发机
保持默认同目录布局最简单；只有备份、包管理或权限隔离有明确收益时才拆分路径。
常见问题
- 服务账号缺少目录遍历、读取或写入权限。
- 混淆路径参数的重启要求与目标文件内容的 reload 行为。
- 故障切换节点或备份清单未包含相同路径。
- 使用相对路径并依赖不稳定的工作目录。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 8.0 ← 7.4 新增此参数
PostgreSQL 8.0 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 8.0 | — | — | — | 字符串 |
— | — | — |
| 8.1 | — | — | — | 字符串 |
— | — | — |
| 8.2 | — | — | — | 字符串 |
— | — | — |
| 8.3 | — | — | — | 字符串 |
— | — | — |
| 8.4 | — | — | — | 字符串 |
— | — | — |
| 9.0 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.1 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.2 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.3 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.4 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.5 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 9.6 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 10 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 11 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 12 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 13 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 14 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 15 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 16 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 17 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 18 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 19 | 未设置 |
— |
重启生效 |
字符串 |
— |
— |
— |
| 20 | — | — | — | 字符串 |
— | — | — |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
config_file |
字符串 | 重启生效 | 未设置 |
— | |
| 指定主服务器配置文件（通常叫 postgresql.conf）。 | 现存 | ||||
data_directory |
字符串 | 重启生效 | 未设置 |
— | |
| 指定用于数据存储的目录。 | 现存 | ||||
extension_destdir |
字符串 | 会话（超级用户） | 空字符串 |
— | |
| 加载扩展时添加到路径前面的目录。 | 于 18 移除 | ||||
external_pid_file |
字符串 | 重启生效 | 未设置 |
— | |
| 指定服务器应创建的额外进程 ID（PID）文件的名称，供服务器管理程序使用。 | 现存 | ||||
hba_file |
字符串 | 重启生效 | 未设置 |
— | |
| 指定基于主机的认证配置文件（通常叫 pg_hba.conf）。 | 现存 | ||||
hosts_file |
字符串 | — | — | ||
| 指定基于主机的 SSL 配置文件（通常称为 pg_hosts.conf）。 | 现存 | ||||
ident_file |
字符串 | 重启生效 | 未设置 |
— | |
| 指定用于用户名称映射的配置文件（通常叫 pg_ident.conf）。 | 现存 | ||||