Linux下安装配置MariaDB详细教程

本文详解Linux下高效、可靠安装配置MariaDB的核心要点，强调优先使用系统包管理器（yum或apt）而非手动编译或过时脚本，避免常见坑点如初始化失败、socket路径不一致、权限错误和配置不生效；涵盖RHEL/Debian系具体命令、服务启用、安全加固（mysql_secure_installation）、新版初始化方式（mariadb-install-db）、socket故障排查与修复、官方仓库指定版本安装技巧，并直击“装完连不上”等高频问题的本质——始终聚焦路径、用户、权限、socket四大关键维度，助你一次配通，稳上生产。

mariadb 在大多数现代 Linux 发行版中已取代 mysql，但安装方式不统一，选错方法容易卡在初始化、权限或 socket 错误上。直接结论：优先用系统包管理器安装，除非你明确需要特定小版本（如 10.11.x）或离线部署。

用 yum 或 apt 安装最稳，但要注意发行版差异

系统包管理器安装省心，服务单元、默认路径、日志位置都已预设，适合生产环境快速上线。

• RHEL/CentOS/AlmaLinux/Rocky Linux 8+：yum install -y mariadb-server mariadb（注意不是 MariaDB-server，大小写敏感）
• Debian 12 / Ubuntu 22.04+：apt update && apt install -y mariadb-server mariadb-client
• 安装后必须运行 systemctl start mariadb 和 systemctl enable mariadb，否则服务不启动
• 别跳过 mysql_secure_installation —— 它不只是设 root 密码，还会禁用匿名用户、删除 test 库、禁止远程 root 登录，这步漏掉等于裸奔

mysql_install_db 已废弃，新版本必须用 mariadb-install-db 或 systemd 初始化

如果你从二进制包手动部署，或看到老教程里用 scripts/mysql_install_db，请立刻停手。MariaDB 10.2+ 已移除此脚本，强行调用会报错：

ERROR 1045 (28000): Access denied for user 'root'@'localhost'

正确做法是：

• 确保 mysql 用户存在：useradd -r -s /sbin/nologin -M mysql
• 指定数据目录并赋权：mkdir -p /appdata/mysql && chown -R mysql:mysql /appdata/mysql
• 用新版初始化命令：mariadb-install-db --datadir=/appdata/mysql --user=mysql
• 若提示 libaio.so.1: cannot open shared object file，补装：yum install -y libaio（CentOS）或 apt install -y libaio1（Debian/Ubuntu）

socket 连接失败（Can't connect to local MySQL server through socket）八成是路径不一致

这是最常被忽略的细节：客户端默认连 /var/run/mysqld/mysqld.sock 或 /tmp/mysql.sock，而服务端实际监听的可能是 /var/lib/mysql/mysql.sock。不匹配就报错。

• 先查服务端实际 socket 路径：sudo grep "socket" /etc/my.cnf /etc/mysql/my.cnf 2>/dev/null
• 再查客户端默认路径：mariadb --help | grep "Default options"（看输出里的 socket 行）
• 临时解决：加软链，例如服务端在 /var/lib/mysql/mysql.sock，就执行 sudo ln -sf /var/lib/mysql/mysql.sock /tmp/mysql.sock
• 长期解决：统一改到 /var/run/mysqld/mysqld.sock，并在 [client] 和 [mysqld] 段都显式写 socket = /var/run/mysqld/mysqld.sock

官方仓库装指定版本时，mariadb_repo_setup 脚本必须带 --mariadb-server-version

直接跑 curl -LsS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash 默认装最新稳定版，但可能不是你要的 10.11.x —— 官方脚本不会猜你的意图。

• 装 10.11 系列：curl -LsS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash -s -- --mariadb-server-version=10.11
• 装 10.6：--mariadb-server-version=10.6，不能写成 10.6.0 或 10.6.x
• 执行后务必 yum clean all && yum makecache（RHEL系）或 apt update（Debian系），否则仍会拉旧包
• 包名大小写敏感：yum install MariaDB-server（首字母大写），不是 mariadb-server；APT 侧则仍是小写

真正麻烦的从来不是“怎么装”，而是“为什么装完连不上”“为什么初始化报错”“为什么改了配置不生效”。这些点全卡在路径、用户、权限、socket 四个地方，盯住它们比反复重装更有效。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Linux下安装配置MariaDB详细教程》文章吧，也可关注golang学习网公众号了解相关技术文章。