参考来源与致谢
- 引用来源:Can't log into phpMyAdmin: mysqli_real_connect(): (HY000/1698): Access denied for user 'root'[at]'localhost' | DevAnswers.co
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
通过 phpMyAdmin 使用 root 账号登录时,页面返回类似错误:
mysqli_real_connect(): (HY000/1698): Access denied for user 'root'[at]'localhost'
该错误常见于 Debian、Ubuntu 等发行版默认安装的 MySQL 或 MariaDB。此时 root 账号通常使用 auth_socket 插件认证,只允许本机同名系统用户通过 Unix socket 免密登录,不接受密码方式连接。phpMyAdmin 走的是 TCP 或 socket 密码认证,因此被拒绝。
本文面向企业 IT 运维,给出不开放 root 远程登录的处理思路。不同 MySQL 与 MariaDB 版本语法存在差异,执行前请查阅对应版本文档确认。
准备与风险 #
- 确认拥有服务器 shell 权限,且能通过
sudo进入数据库。 - 操作前备份数据库与账号权限表,例如导出
mysql系统库或使用mysqldump全量备份。 - 建议先在测试环境验证命令,再在生产执行。
- 不要为绕过报错而把 root 改为可远程密码登录。root 是自动化扫描的重点目标,暴露后风险极高。
- 新账号密码使用强随机值,通过安全渠道保存,不要写入明文脚本或工单。
处理步骤 #
1. 以系统管理员身份进入数据库 #
sudo mysql -u root -p
若当前系统用户已匹配 socket 认证,可能无需密码,直接回车即可。若提示认证失败,请改用具备管理权限的账号登录。
2. 创建独立管理账号 #
不要复用 root。新建专用账号,例如 [管理账号],密码用 [强密码] 占位:
CREATE USER '[管理账号]'[at]'localhost' IDENTIFIED BY '[强密码]';
若 phpMyAdmin 与数据库不在同一主机,来源主机需按实际填写,例如 '[管理账号]'[at]'[phpMyAdmin主机地址]'。尽量避免使用 % 通配所有来源。
3. 按最小必要授予权限 #
仅需管理部分库时,只授予对应库权限:
GRANT ALL PRIVILEGES ON `[目标库]`.* TO '[管理账号]'[at]'localhost';
确需全局管理时再授予全局权限,并明确知晓其影响范围:
GRANT ALL PRIVILEGES ON *.* TO '[管理账号]'[at]'localhost' WITH GRANT OPTION;
4. 刷新权限并退出 #
FLUSH PRIVILEGES;
[已移除凭据相关内容]
