PostgreSQL忘记postgres用户密码怎么重置

文章导读
PostgreSQL 忘记 postgres 用户密码,只要还能登录数据库所在主机,通常可以自己重置:核心做法是把 pg_hba.conf 里 postgres 的本地认证临时放开,重新加载配置后进去执行 ALTER USER,改完立刻把认证方式改回去。真正要先弄清楚的是你有没有主机层权限、实例是不是云托管、以及这段临时放开的时间窗里库是不是暴露在不可信网络上。
📋 目录
  1. 壹 先确认当前场景和目标
  2. 贰 按这个顺序处理
  3. 叁 改完后怎么验证
  4. 肆 容易忽略的边界
A A

PostgreSQL 忘记 postgres 用户密码,只要还能登录数据库所在主机,通常可以自己重置:核心做法是把 pg_hba.conf 里 postgres 的本地认证临时放开,重新加载配置后进去执行 ALTER USER,改完立刻把认证方式改回去。真正要先弄清楚的是你有没有主机层权限、实例是不是云托管、以及这段临时放开的时间窗里库是不是暴露在不可信网络上。

忘记 postgres 密码但还能登录主机时,重置路径通常是:先用系统用户通过 peer 认证试一次,不行就把 pg_hba.conf 中 postgres 的本地认证临时改为 trust,reload 后执行 ALTER USER 改密码,再把配置改回并再次 reload。前提是有主机 root 或 postgres 系统账号、能 reload 数据库;云托管实例没有这些权限,应从控制台重置。临时 trust 行要限定在本机并尽快移除,改完用 pg_hba_file_rules 和一次新密码登录确认。

先确认当前场景和目标

这个问题成立的前提是:数据库跑在你(或团队)能 SSH 上去的主机上,并且你手上有 root 或者能 sudo -u postgres 的账号。满足这个前提,重置密码是运维常规操作;不满足,比如用的是托管数据库服务,或者容器里没留系统用户,处理方式完全不同,别按下面的步骤硬套。

动手前先确认几件事,能省掉大部分返工:

  • 数据库是主库、备库还是单机。备库的认证配置通常要单独改,密码是否随流复制同步要结合部署方式确认。
  • PostgreSQL 大版本。9.x 以后基本都在 pg_hba.conf 里控制本地认证,10 以后还能用 pg_hba_file_rules 视图检查配置是否生效。
  • 配置文件和数据目录的实际位置。Debian/Ubuntu 系一般在 /etc/postgresql/<版本>/main/,RPM 系常见 /var/lib/pgsql/data/,但被改过就是另一回事。
  • 有没有别的超级用户还能登录。如果有,直接用它执行 ALTER USER postgres,可以完全跳过改认证配置这一步。
  • 当前 password_encryption 的值。它决定新密码存成 SCRAM-SHA-256 还是 md5 格式,老客户端可能只认后者。

按这个顺序处理

第一步先用系统用户试一次,很多发行版的默认配置里 local all postgres peer 是开着的,不需要密码就能进:

sudo -u postgres psql -c "SELECT current_user, version();"

能进就直接跳到改密码,其它步骤都不用做。进不去再往下走,先定位配置文件:

# 查看进程启动参数,-D 后面是数据目录
ps -ef | grep "[p]ostgres" | head -n 3

# 在 postgresql.conf 里确认 hba_file 指向
sudo grep -E "^[^#]*hba_file" /etc/postgresql/16/main/postgresql.conf

编辑 pg_hba.conf,在文件靠前位置加一行临时规则。注意这张表是首条匹配生效,加在末尾可能被前面的规则拦住。把地址限定成回环地址或本机,不要写成 all all 0.0.0.0/0 trust:

PostgreSQL忘记postgres用户密码怎么重置
# TYPE   DATABASE  USER      ADDRESS        METHOD
host     all       postgres  127.0.0.1/32   trust
host     all       postgres  ::1/128        trust

改 pg_hba.conf 只需要 reload,不用重启服务:

sudo systemctl reload postgresql
# 或者:sudo -u postgres pg_ctl reload -D /var/lib/pgsql/data

然后不带密码连进去改密码。示例里的密码按实际情况替换,包含单引号时要写成两个单引号:

psql -h 127.0.0.1 -U postgres -d postgres

ALTER USER postgres WITH PASSWORD 'Replace_With_Strong_Password';
SELECT current_user, version();

改完立刻把刚才加的两行注释掉或删掉,再 reload 一次。如果库监听在公网地址上,临时 trust 窗口里任何能连到 5432 的人都可以作为 postgres 登录,所以这一步不要拖,也不要开着窗口去处理别的事。

如果因为权限或配置混乱导致服务根本起不来,还有一条备选路:停库后以单用户模式启动,直接改密码。它会短暂中断服务,通常只在前面几步都走不通时用,并且操作前先备份 pg_hba.conf 和 postgresql.conf。

PostgreSQL忘记postgres用户密码怎么重置

改完后怎么验证

验证不要只看“命令没报错”,至少确认三件事:能用新密码连上、认证配置已经恢复、密码存储格式符合预期。

# 带密码手动连接,看是否提示输入并成功进入
psql -h 127.0.0.1 -U postgres -d postgres -W

# 确认没有残留的 trust 规则(PG 10 及以上)
SELECT type, database, user_name, address, auth_method FROM pg_hba_file_rules;

# 看密码哈希前缀是 SCRAM-SHA-256$ 还是 md5
SHOW password_encryption;
SELECT rolname, substr(rolpassword, 1, 13) FROM pg_authid WHERE rolname = 'postgres';

预期信号是:不带 -W 时会因为 trust 已移除而要求密码,输入新密码后进得去;pg_hba_file_rules 里 postgres 相关的记录 auth_method 已经不是 trust;pg_authid 里前缀和 password_encryption 的设置一致。最后别忘了应用侧:如果连接串或配置中心里存着旧密码,也要一起换掉,否则你会看到数据库好好的、业务却连不上。

容易忽略的边界

最需要划分清楚的是托管数据库。云厂商的实例不给你主机和 pg_hba.conf,通常只能通过控制台或工单重置密码,本文步骤在那里不适用,硬操作还可能触发实例异常。容器部署的 PostgreSQL 也要注意:改配置文件必须落到挂载卷上,否则容器重启后配置回滚,密码状态会变得难以判断。

另外几个容易踩的点:主备架构下 pg_hba.conf 是各自独立的文件,不是复制过去的内容;只改 postgres 一个账号,复制账号、监控账号、备份脚本用的账号仍然会失败;password_encryption 为 md5 时新密码按 md5 存,换成 scram-sha-256 后过老的客户端驱动可能连不上,需要结合客户端版本评估。

回退建议很简单:改配置前先 cp pg_hba.conf pg_hba.conf.bak,任何一步失败就把备份还原再 reload;如果 reload 后服务异常,先用 journalctl -u postgresql 或数据目录下的日志文件确认是配置语法问题还是认证问题,再决定继续排查还是回退。临时 trust 规则一定要清零,这条比改密码本身更重要。