initdb

初始化 PostgreSQL 数据目录

补充说明

initdb 创建新的 PostgreSQL 数据目录和系统表，是实例生命周期的第一步。它只初始化空集群，不创建业务库和用户。

常用示例

initdb -D /var/lib/pgsql/data
initdb -D /var/lib/pgsql/data -U postgres -E UTF8 --locale=C
initdb -D /var/lib/pgsql/data --auth-local=peer --auth-host=scram-sha-256
initdb -D /var/lib/pgsql/data --pwfile=/tmp/pgpass
initdb -D /var/lib/pgsql/data --data-checksums
initdb -D /var/lib/pgsql/data --waldir=/data/pg_wal

易错点与排错

• 必须以数据库运行用户执行；root 会被拒绝。
• 目标目录必须为空；覆盖已有数据目录会失败或造成数据丢失。
• 编码和 locale 初始化后很难更改；建库前确认业务需求。
• --data-checksums 开启后不能直接关闭；能帮助发现静默损坏。
• pg_hba.conf 的默认认证方式影响首次连接；远程访问要提前配置。
• --pwfile 里的密码只用于超级用户，文件权限要收紧。
• 独立 WAL 目录要提前规划容量和挂载，迁移时注意路径。

相关命令

• pg_ctl — 启动与停止
• createdb — 创建数据库
• psql — 连接