1. 安装之前先搞清楚 MariaDB 到底是什么很多人第一次接触 MariaDB 是在购买某云服务器时看到镜像市场里既有 MySQL 又有 MariaDB顺手选了一个装上以后发现mysql命令也能用、3306端口也正常于是稀里糊涂地把它当成了 MySQL 的“换皮版本”。这个认识不算错但不完整。MariaDB 是 MySQL 的一个分支由最初一批 MySQL 核心开发者维护保留了 MySQL 的协议兼容性又在存储引擎、查询优化、线程池等方面走出了自己的路线。从使用角度看MariaDB 能直接承接绝大多数 MySQL 的业务场景迁移 WordPress、搭建监控系统、给 Java 或 Python 应用做数据存储几乎不需要改代码。很多企业选它原因很简单——开源协议更宽松、社区驱动更活跃、部分场景下性能表现更稳。对我来说它最大的价值在于“少折腾”安装方式成熟、默认配置合理、生态兼容性好适合作为自建数据库的入门首选也适合在生产环境里长期跑。这篇文章面向这几类读者第一次在 Linux 服务器上装数据库的人想从 MySQL 平滑切换过去的人以及已经装好但遇到各种报错的人。我会把从环境准备、版本选型、安装执行到基础优化的完整过程拆开讲重点说那些文档里不会写、但实际操作中一定会碰到的细节。2. 环境规划与版本选型这一步决定了后面顺不顺利2.1 先选操作系统版本再谈数据库版本我见过太多人一上来就执行安装命令装到一半发现 glibc 版本太低、包依赖冲突、systemd 不认识服务文件最后只能重装系统。MariaDB 虽然跨平台支持很好但不同操作系统、不同发行版对软件包的维护节奏完全不一样提前确认操作系统是第一步。以最常见的 Linux 发行版为例操作系统包管理器MariaDB 维护渠道Debian / Ubuntuapt官方仓库、发行版自带仓库CentOS / Rocky Linux / AlmaLinuxdnf / yum官方仓库、发行版自带仓库openSUSE / SLESzypper官方仓库、发行版自带仓库Arch Linuxpacman社区维护包Alpine Linuxapk社区维护包选择发行版自带仓库的 MariaDB优点是跟随系统安全更新安装时依赖冲突最少缺点是版本通常比较保守。比如 Debian 稳定版自带的 MariaDB 可能是两年前的版本缺少一些新功能。选择官方仓库则能拿到最新的稳定版但需要手动配置仓库源还要留意仓库签名和系统版本的匹配。我个人建议新部署的测试环境优先用官方仓库拿新版本生产环境用发行版仓库或官方长期支持版本。举个例子某公司内部系统用的 PHP 版本老连接数据库的驱动只支持特定旧协议如果贸然上了最新版 MariaDB可能连认证插件都不兼容这类问题排查起来非常头疼。2.2 MariaDB 版本号的学问MariaDB 的版本号看起来简单实际有门道。以 10.11、10.6、11.4 这类版本为例需要知道几个关键概念长期支持版本官方会把某些版本定义为长期支持版比如 10.6 和 10.11这类版本维护周期长达五年适合生产环境。短期支持版本新功能版本比如 11.x 系列的非 LTS 版本功能更新快但维护周期短不适合追求稳定的人。版本号含义MariaDB 从 10.0 之后采用了与 MySQL 不同的版本节奏10.x 系列其实对应的是比较大的架构演进11.x 是新的主版本分支。选版本时不要盲目追求最新。我踩过这样一个坑测试环境用了某个刚发布的 11.x 版本结果团队里的监控系统依赖的认证插件变了导致服务起不来。后来统一锁到 10.11 LTS再没出过兼容性问题。如果你是新手直接用当前最新的长期支持版就行省心。2.3 硬件和架构的基本盘MariaDB 本身不挑硬件装好后占用内存大概在 200MB 到 500MB 之间具体看缓冲区配置。但有几个点必须先确认架构必须是 x86_64 或 aarch64这是绝大多数软件包的支持范围。磁盘剩余空间至少 5GB 以上日志、数据文件、binlog 加起来很容易超预期。内存小于 1GB 的机器要特别注意默认配置可能偏高后面需要调低 buffer pool。另外提醒一句如果是云服务器选择镜像时注意看系统版本不要选 EOL停止维护版本。比如某云上还有 CentOS 7 的镜像但 CentOS 7 已经停止维护软件源很多都失效了安装 MariaDB 时要么换源、要么走官方仓库会浪费很多时间不如直接用较新的系统。2.4 生产环境到底选 MariaDB 还是 MySQL这个问题几乎每周都有人问。我的看法是没有绝对好坏只有适不适合。如果你要平滑迁移且代码里有大量 MySQL 专属语法MariaDB 通常可以直接兼容但反过来不一定。如果你依赖某些 MySQL 商业版特性比如特定的企业级备份工具那就要慎重。如果你用的是云数据库托管服务直接选云厂商提供的 MySQL 实例更省事自建 MariaDB 反而增加运维成本。如果你是个人项目、开源项目或者想要自由控制权限和插件MariaDB 是个好选择。还有一个非常实际的因素团队熟悉度。如果团队里所有人都在 MySQL 生态里泡了很多年突然切换到 MariaDB学习成本虽然不高但没必要给自己找事。如果团队本来就开放愿意尝试更新的事务引擎和优化器行为MariaDB 值得一试。3. 主流 Linux 发行版的安装全流程从零到能连上数据库3.1 通用前置操作更新系统与基础依赖这一步我每次都会做虽然不值一提但真的能避免后续一堆麻烦。# Debian / Ubuntu sudo apt update sudo apt upgrade -y # CentOS / Rocky Linux / AlmaLinux sudo dnf update -y # openSUSE sudo zypper refresh系统更新完成后顺手安装常用工具# Debian / Ubuntu sudo apt install -y curl wget gnupg software-properties-common # CentOS / Rocky Linux / AlmaLinux sudo dnf install -y curl wget gnupg2如果你是刚买的服务器建议先确认时区和时间同步。数据库对时间敏感日志排查也依赖准确时间这一步虽然和安装无关但影响后续所有操作。3.2 使用 apt 在 Debian / Ubuntu 上安装 MariaDBDebian 系系统的安装方式非常友好有两种路径。第一种直接安装发行版自带版本sudo apt update sudo apt install -y mariadb-server安装完成后检查服务状态sudo systemctl status mariadb如果没启动手动启动并设置开机自启sudo systemctl enable --now mariadb第二种使用官方仓库安装最新版本。先导入签名密钥sudo apt-get install -y apt-transport-https curl sudo curl -o /etc/apt/trusted.gpg.d/mariadb-release-key.asc https://archive.mariadb.org/PublicKey然后添加官方源。这里要注意不同架构和系统版本对应的镜像源地址不一样建议在官网首页用脚本生成功能自动生成配置不要手抄老文章里的地址否则极容易 404。生成后执行sudo apt update sudo apt install -y mariadb-server用官方仓库的好处大家都知道版本新、修复及时。坏处是如果你系统的仓库管理比较严格比如有安全基线可能会对非官方源有顾虑。3.3 使用 dnf / yum 在 RHEL 系发行版上安装 MariaDBCentOS、Rocky Linux、AlmaLinux 这些系统的安装方式类似。先确认是否自带 mariadbdnf module list mariadb有些系统默认启用了一个低版本的模块需要先重置或禁用sudo dnf module reset mariadb然后直接安装sudo dnf install -y mariadb-server启动并设置开机自启sudo systemctl enable --now mariadb如果需要最新版本同样需要配置官方仓库。以 Rocky Linux 9 为例先安装包管理器工具sudo dnf install -y wget再到官网生成对应的仓库文件放到/etc/yum.repos.d/目录。装完后可以用dnf info mariadb-server查看版本确认拿到的是预期版本。这里有个常见的坑部分 RHEL 系系统自带mysql或者mariadb命令但服务名和实际软件包不匹配导致执行systemctl start mysql时报错。MariaDB 的服务名统一是mariadb不要搞混。3.4 使用 zypper 在 openSUSE 上安装 MariaDBopenSUSE 的操作更简单自带仓库就能装到很新的版本sudo zypper install -y mariadb mariadb-tools安装后同样启动服务sudo systemctl enable --now mariadbopenSUSE 下有一个不同点默认配置文件路径可能是/etc/my.cnf还有一些额外配置在/etc/my.cnf.d/。修改配置时优先改.d目录下的自定义文件不要动系统默认的主配置这样升级时不容易冲突。3.5 安装后立刻要做的三件事装完数据库只是开始我习惯按固定顺序做三件事第一查看版本信息mariadb --version mysql --version这两条命令都会显示版本因为 MariaDB 提供的客户端兼容 mysql 命令。第二检查监听端口ss -lntp | grep 3306如果端口没监听可能是服务没起来或者配置里改过端口。第三用 socket 连接本地数据库sudo mariadb -u root或者sudo mysql -u root如果这一句能直接进入数据库说明基本安装成功。需要注意的是MariaDB 在 Debian 系安装默认使用了unix_socket认证root 用户只能通过系统用户登录这也是很多新手连接时报错的原因后面会详细讲。4. 容器化与源码编译两种特殊场景的取舍4.1 Docker 部署开发环境和快速验证的首选如果你只是本地开发、快速验证、搭演示环境Docker 是最省事的方式。不用管系统依赖不用纠结版本冲突一条命令就能拉起来docker run -d \ --name mariadb-dev \ -p 3306:3306 \ -e MARIADB_ROOT_PASSWORDyourpassword \ -e MARIADB_DATABASEtestdb \ -v mariadb_data:/var/lib/mysql \ mariadb:10.11几个参数解释一下MARIADB_ROOT_PASSWORD必须设置否则容器起不来。MARIADB_DATABASE可选自动创建数据库。-v mariadb_data:/var/lib/mysql必须挂载数据目录否则容器删除后数据全丢。mariadb:10.11指定镜像标签最好写具体版本不要用latest。进入容器执行 SQLdocker exec -it mariadb-dev mariadb -u root -pDocker 方式适合跑测试但生产环境我不建议无脑容器化。数据库是有状态服务容器本身的网络、存储、生命周期管理都会增加复杂度除非你已经有一套成熟的编排系统否则虚拟机或物理机上直接装可能更省心。4.2 源码编译安装什么时候才值得自己做源码编译是很多人好奇但没必要轻易尝试的路。编译一次 MariaDB耗时取决于机器配置通常在十几分钟到半小时期间可能遇到依赖问题、编译器兼容问题、CMake 版本不够等问题。源码编译真正适用的场景就几种官方没有提供你所在系统的预编译包。你需要启用特殊编译选项比如自定义字符集、特殊存储引擎。你需要裁剪功能做极简部署。你对性能有极致要求想通过编译参数优化指令集。否则不要自己编译。包管理器装好的版本性能损失可以忽略维护成本却低得多。如果你真的要编译大概步骤是这样sudo apt install -y build-essential cmake libssl-dev libpcre3-dev zlib1g-dev wget https://archive.mariadb.org/mariadb-10.11.6/source/mariadb-10.11.6.tar.gz tar -xzf mariadb-10.11.6.tar.gz cd mariadb-10.11.6 cmake . -DCMAKE_INSTALL_PREFIX/usr/local/mariadb -DMYSQL_DATADIR/data/mysql make -j$(nproc) sudo make install编译完成后还需要手动初始化数据目录、创建系统用户、配置服务脚本每一步都有讲究。我的建议是除非真的有必要不然用系统包管理器装完十分钟就能进入下一步操作省下的时间拿去优化 SQL 更值。4.3 二进制包安装被很多人忽略的折中方案二进制包预编译包是个折中方案不用编译又能避开系统仓库的旧版本。官方会为常见 Linux 发行版提供预编译的二进制 tar 包解压后配置一下就能用。流程大致是# 下载二进制包 wget https://archive.mariadb.org/mariadb-10.11.6/binaries/mariadb-10.11.6-linux-systemd-x86_64.tar.gz # 解压到指定目录 sudo tar -xzf mariadb-10.11.6-linux-systemd-x86_64.tar.gz -C /usr/local/ # 创建软链接方便管理 sudo ln -s /usr/local/mariadb-10.11.6-linux-systemd-x86_64 /usr/local/mariadb # 创建数据目录 sudo mkdir -p /data/mysql sudo chown -R mysql:mysql /data/mysql # 初始化数据库 sudo /usr/local/mariadb/scripts/mariadb-install-db --usermysql --basedir/usr/local/mariadb --datadir/data/mysql这种方式适合需要统一版本交给自动化运维工具管理的团队。但要注意二进制包对 glibc 版本有要求老系统可能跑不起来。5. 安装后的配置、安全加固与常用优化让数据库进入可用状态5.1 解决一个让人困惑的认证问题装完 MariaDB 后很多人执行mysql -u root -p登录输入任意密码都会失败其实问题不在密码而在认证方式。MariaDB 在 Debian 系系统的默认安装里root 用户使用unix_socket认证插件也就是说只有通过系统用户root登录时才能进入数据库而且不需要密码。如果你用普通用户身份或者通过 TCP/IP 远程登录就会认证失败。解决办法有两种第一种直接用系统 root 身份进入sudo mariadb进入后新建一个专门的数据库管理用户CREATE USER adminlocalhost IDENTIFIED BY 强密码; GRANT ALL PRIVILEGES ON *.* TO adminlocalhost WITH GRANT OPTION; FLUSH PRIVILEGES;然后退出用新用户登录mysql -u admin -p第二种如果你想保留 root 的密码登录方式可以手动修改认证方式ALTER USER rootlocalhost IDENTIFIED VIA mysql_native_password USING PASSWORD(新密码); FLUSH PRIVILEGES;生产环境建议用第一种方式保留 root 的 socket 认证日常操作用一个专用账号权限按需分配。5.2 安全初始化脚本是必跑的MariaDB 自带安全初始化脚本执行后能清理匿名账户、移除测试数据库、禁用 root 远程登录sudo mariadb-secure-installation脚本会问你一系列问题逐项确认。有几个选项强烈建议选是设置 root 密码或确认 socket 认证方式。移除匿名用户。禁止 root 远程登录。删除 test 数据库并清空权限表。这个脚本不是摆设很多安全问题都是因为装完数据库后跳过这一步暴露在公网的 3306 端口上被扫描工具扫到然后被爆破。5.3 修改数据目录和配置文件的基本姿势MariaDB 的配置主要是my.cnf通常路径为/etc/mysql/mariadb.conf.d/。不建议直接改主文件可以新建一个自定义配置文件比如/etc/mysql/mariadb.conf.d/99-custom.cnf[mysqld] # 端口 port 3306 # 监听地址默认只监听本地改为 0.0.0.0 监听所有 bind-address 127.0.0.1 # 默认字符集 character-set-server utf8mb4 collation-server utf8mb4_unicode_ci # InnoDB 缓冲池大小建议设为物理内存的 50%~70% innodb_buffer_pool_size 1G # 慢查询日志 slow_query_log 1 slow_query_log_file /var/log/mysql/mariadb-slow.log long_query_time 2 # 二进制日志 log_bin /var/log/mysql/mariadb-bin # 最大连接数 max_connections 300修改配置后重启服务sudo systemctl restart mariadb关于监听地址多说一句如果只有本机应用访问数据库bind-address保持127.0.0.1就好。如果真的要远程访问请同时配置防火墙规则只放行特定 IP不要直接对公网开放 3306。5.4 日志文件与数据目录的隔离我接手过一个数据目录小于 1GB 导致数据库反复崩溃的案例。MariaDB 的数据、日志、binlog 都会写入数据目录默认位置是/var/lib/mysql。如果系统盘空间小建议把数据目录改到大容量磁盘# 停止服务 sudo systemctl stop mariadb # 复制数据目录到新位置 sudo rsync -av /var/lib/mysql/ /data/mysql/ # 修改配置文件 sudo vim /etc/mysql/mariadb.conf.d/99-custom.cnf # 添加配置 # datadir /data/mysql # 创建软链接或直接改属主 sudo chown -R mysql:mysql /data/mysql # 启动服务 sudo systemctl start mariadb注意有 SELinux 的 RHEL 系系统改了数据目录后还要更新 SELinux 上下文否则服务起不来。可以用restorecon -R /data/mysql处理或者临时用setenforce 0测试但这只是定位问题不要长期关闭 SELinux。5.5 远程连接的授权与防火墙速查如果应用服务器和数据库不在同一台机器上你需要做三件事第一创建远程访问用户CREATE USER appuser192.168.1.100 IDENTIFIED BY 强密码; GRANT ALL PRIVILEGES ON appdb.* TO appuser192.168.1.100; FLUSH PRIVILEGES;第二修改监听地址bind-address 0.0.0.0第三放行防火墙端口# RHEL 系 sudo firewall-cmd --permanent --add-rich-rulerule familyipv4 source address192.168.1.100 port protocoltcp port3306 accept sudo firewall-cmd --reload # Debian 系 sudo ufw allow from 192.168.1.100 to any port 3306 proto tcp有个习惯值得养成远程访问用户的 IP 白名单尽量精确到单个 IP不要用%通配所有地址能显著减少暴露风险。6. 安装与使用中的高频问题与排查实录6.1 服务起不来的常见原因MariaDB 服务启动失败的原因我见过的大致有这几种第一数据目录权限不对。检查方法很直接ls -ld /var/lib/mysql目录属主必须是mysql:mysql。如果不对sudo chown -R mysql:mysql /var/lib/mysql第二配置文件里有语法错误或参数名不对。可以先用命令检查配置sudo mariadbd --validate-config有不认识的关键词会直接报错。第三端口被占用。某些系统上可能残留旧版的 mysqld或者 3306 被其他程序占用sudo ss -lntp | grep 3306如果有其他进程占用要么停掉要么改端口。第四数据目录里已有数据但版本不一致。比如从 MySQL 迁移数据目录直接拷过来启动时可能报table mysql.plugin doesnt exist之类的错误。这种情况不要盲目删数据先备份再找迁移方案。6.2 连接数据库时提示密码错误或 Access denied这个问题有两种常见原因。第一种是认证插件不匹配。客户端用的是mysql_native_password但服务端要求的是unix_socket或者其他插件。可以登录后查看用户表SELECT user, host, plugin FROM mysql.user;然后按需调整认证插件。第二种是客户端连接时走错了 host。比如你用mysql -u root连接默认以当前系统用户名匹配 host如果不匹配就会出现 access denied。明确指定 host 一般能解决mysql -u root -h 127.0.0.1 -P 3306 -p6.3 磁盘空间被填满导致服务假死这个场景很难排查因为数据库看起来没报错只是所有写入操作都卡住。查看磁盘会发现/var/lib/mysql所在分区已经 100% 占用。常见元凶是 binlog 日志尤其开启log_bin又没有设置过期时间。查看 binlog 占用du -sh /var/lib/mysql/mariadb-bin.*设置自动清理策略在配置文件中加入expire_logs_days 7或者用 SQL 手动清理PURGE BINARY LOGS BEFORE NOW() - INTERVAL 7 DAY;因为 binlog 是数据恢复的重要依据不要直接删文件否则可能导致主从复制中断。6.4 升级版本时的注意事项跨版本升级是风险最高的操作。比如从 10.4 升到 10.11不光是版本跨度还会涉及系统表结构升级。基本流程是# 备份 sudo mariadb-dump --all-databases --single-transaction all_backup.sql # 停止服务 sudo systemctl stop mariadb # 安装新版本 # 启动服务 sudo systemctl start mariadb # 执行升级检查 sudo mariadb-upgrade升级前一定要做全量备份并且先在测试环境跑一遍升级流程。即使官方说明支持直接升级也不建议跳过测试。另外配置文件里的过期参数在新版本里可能被移除启动时会有不认识的参数警告虽不影响启动但建议查一下官方文档对应关系保持配置干净。6.5 忘记 root 密码时的应急方案这个场景我处理过很多次说一个安全环境下可操作的方法。先停掉服务然后以跳过授权表方式启动sudo systemctl stop mariadb sudo mariadbd --skip-grant-tables --skip-networking 此时不需要密码就能进入数据库sudo mariadb -u root然后手动重置密码FLUSH PRIVILEGES; ALTER USER rootlocalhost IDENTIFIED BY 新密码; FLUSH PRIVILEGES;最后重启服务恢复正常模式sudo kill %1 sudo systemctl start mariadb这种操作只应在本地安全环境下进行处理完立即恢复正常认证。7. 我的一些选择建议与长期维护心得接触 MariaDB 这几年我自己形成了一套固定的使用习惯。装新数据库第一件事永远是确认操作系统生命周期和磁盘空间再决定是走系统仓库还是官方仓库。测试环境求新生产环境求稳这个原则一直没变过。如果你只能记住几个关键词我希望是这三个版本兼容性、备份先于操作、端口白名单管理。尤其是版本兼容性数据库升级不像普通软件一旦数据目录升级到新格式再想降级就非常痛苦。另外想提醒的是MariaDB 社区文档质量很高遇到问题先查官方文档很多时候比网上零散文章准确得多。尤其涉及系统表、权限、复制机制时文档里都有详细的说明能少走很多弯路。这篇文章介绍到的安装路径覆盖了个人开发、企业生产、容器化、源码编译几种主流场景核心目标是让你装得稳、用得顺。实际上安装只是数据库运维的起点后续的监控、备份、性能调优才是更漫长的过程。如果你刚装好第一台 MariaDB先把基本的安全配置和备份做了再慢慢深入优化节奏会更舒服。最后分享一个小技巧每次安装后我都会把配置文件、初始化的 SQL 命令、版本信息记到一个统一的操作手册里。这样半年后哪怕机器换了、装的人不在后来者也能照着手册快速复现环境。数据库看似软件问题实际上往往是管理问题把操作规范化比你会不会写复杂 SQL 更影响系统的长期健康。希望这篇内容能让你少踩几个坑。接下来放心去装吧。
1. 安装之前先搞清楚 MariaDB 到底是什么很多人第一次接触 MariaDB 是在购买某云服务器时看到镜像市场里既有 MySQL 又有 MariaDB顺手选了一个装上以后发现mysql命令也能用、3306端口也正常于是稀里糊涂地把它当成了 MySQL 的“换皮版本”。这个认识不算错但不完整。MariaDB 是 MySQL 的一个分支由最初一批 MySQL 核心开发者维护保留了 MySQL 的协议兼容性又在存储引擎、查询优化、线程池等方面走出了自己的路线。从使用角度看MariaDB 能直接承接绝大多数 MySQL 的业务场景迁移 WordPress、搭建监控系统、给 Java 或 Python 应用做数据存储几乎不需要改代码。很多企业选它原因很简单——开源协议更宽松、社区驱动更活跃、部分场景下性能表现更稳。对我来说它最大的价值在于“少折腾”安装方式成熟、默认配置合理、生态兼容性好适合作为自建数据库的入门首选也适合在生产环境里长期跑。这篇文章面向这几类读者第一次在 Linux 服务器上装数据库的人想从 MySQL 平滑切换过去的人以及已经装好但遇到各种报错的人。我会把从环境准备、版本选型、安装执行到基础优化的完整过程拆开讲重点说那些文档里不会写、但实际操作中一定会碰到的细节。2. 环境规划与版本选型这一步决定了后面顺不顺利2.1 先选操作系统版本再谈数据库版本我见过太多人一上来就执行安装命令装到一半发现 glibc 版本太低、包依赖冲突、systemd 不认识服务文件最后只能重装系统。MariaDB 虽然跨平台支持很好但不同操作系统、不同发行版对软件包的维护节奏完全不一样提前确认操作系统是第一步。以最常见的 Linux 发行版为例操作系统包管理器MariaDB 维护渠道Debian / Ubuntuapt官方仓库、发行版自带仓库CentOS / Rocky Linux / AlmaLinuxdnf / yum官方仓库、发行版自带仓库openSUSE / SLESzypper官方仓库、发行版自带仓库Arch Linuxpacman社区维护包Alpine Linuxapk社区维护包选择发行版自带仓库的 MariaDB优点是跟随系统安全更新安装时依赖冲突最少缺点是版本通常比较保守。比如 Debian 稳定版自带的 MariaDB 可能是两年前的版本缺少一些新功能。选择官方仓库则能拿到最新的稳定版但需要手动配置仓库源还要留意仓库签名和系统版本的匹配。我个人建议新部署的测试环境优先用官方仓库拿新版本生产环境用发行版仓库或官方长期支持版本。举个例子某公司内部系统用的 PHP 版本老连接数据库的驱动只支持特定旧协议如果贸然上了最新版 MariaDB可能连认证插件都不兼容这类问题排查起来非常头疼。2.2 MariaDB 版本号的学问MariaDB 的版本号看起来简单实际有门道。以 10.11、10.6、11.4 这类版本为例需要知道几个关键概念长期支持版本官方会把某些版本定义为长期支持版比如 10.6 和 10.11这类版本维护周期长达五年适合生产环境。短期支持版本新功能版本比如 11.x 系列的非 LTS 版本功能更新快但维护周期短不适合追求稳定的人。版本号含义MariaDB 从 10.0 之后采用了与 MySQL 不同的版本节奏10.x 系列其实对应的是比较大的架构演进11.x 是新的主版本分支。选版本时不要盲目追求最新。我踩过这样一个坑测试环境用了某个刚发布的 11.x 版本结果团队里的监控系统依赖的认证插件变了导致服务起不来。后来统一锁到 10.11 LTS再没出过兼容性问题。如果你是新手直接用当前最新的长期支持版就行省心。2.3 硬件和架构的基本盘MariaDB 本身不挑硬件装好后占用内存大概在 200MB 到 500MB 之间具体看缓冲区配置。但有几个点必须先确认架构必须是 x86_64 或 aarch64这是绝大多数软件包的支持范围。磁盘剩余空间至少 5GB 以上日志、数据文件、binlog 加起来很容易超预期。内存小于 1GB 的机器要特别注意默认配置可能偏高后面需要调低 buffer pool。另外提醒一句如果是云服务器选择镜像时注意看系统版本不要选 EOL停止维护版本。比如某云上还有 CentOS 7 的镜像但 CentOS 7 已经停止维护软件源很多都失效了安装 MariaDB 时要么换源、要么走官方仓库会浪费很多时间不如直接用较新的系统。2.4 生产环境到底选 MariaDB 还是 MySQL这个问题几乎每周都有人问。我的看法是没有绝对好坏只有适不适合。如果你要平滑迁移且代码里有大量 MySQL 专属语法MariaDB 通常可以直接兼容但反过来不一定。如果你依赖某些 MySQL 商业版特性比如特定的企业级备份工具那就要慎重。如果你用的是云数据库托管服务直接选云厂商提供的 MySQL 实例更省事自建 MariaDB 反而增加运维成本。如果你是个人项目、开源项目或者想要自由控制权限和插件MariaDB 是个好选择。还有一个非常实际的因素团队熟悉度。如果团队里所有人都在 MySQL 生态里泡了很多年突然切换到 MariaDB学习成本虽然不高但没必要给自己找事。如果团队本来就开放愿意尝试更新的事务引擎和优化器行为MariaDB 值得一试。3. 主流 Linux 发行版的安装全流程从零到能连上数据库3.1 通用前置操作更新系统与基础依赖这一步我每次都会做虽然不值一提但真的能避免后续一堆麻烦。# Debian / Ubuntu sudo apt update sudo apt upgrade -y # CentOS / Rocky Linux / AlmaLinux sudo dnf update -y # openSUSE sudo zypper refresh系统更新完成后顺手安装常用工具# Debian / Ubuntu sudo apt install -y curl wget gnupg software-properties-common # CentOS / Rocky Linux / AlmaLinux sudo dnf install -y curl wget gnupg2如果你是刚买的服务器建议先确认时区和时间同步。数据库对时间敏感日志排查也依赖准确时间这一步虽然和安装无关但影响后续所有操作。3.2 使用 apt 在 Debian / Ubuntu 上安装 MariaDBDebian 系系统的安装方式非常友好有两种路径。第一种直接安装发行版自带版本sudo apt update sudo apt install -y mariadb-server安装完成后检查服务状态sudo systemctl status mariadb如果没启动手动启动并设置开机自启sudo systemctl enable --now mariadb第二种使用官方仓库安装最新版本。先导入签名密钥sudo apt-get install -y apt-transport-https curl sudo curl -o /etc/apt/trusted.gpg.d/mariadb-release-key.asc https://archive.mariadb.org/PublicKey然后添加官方源。这里要注意不同架构和系统版本对应的镜像源地址不一样建议在官网首页用脚本生成功能自动生成配置不要手抄老文章里的地址否则极容易 404。生成后执行sudo apt update sudo apt install -y mariadb-server用官方仓库的好处大家都知道版本新、修复及时。坏处是如果你系统的仓库管理比较严格比如有安全基线可能会对非官方源有顾虑。3.3 使用 dnf / yum 在 RHEL 系发行版上安装 MariaDBCentOS、Rocky Linux、AlmaLinux 这些系统的安装方式类似。先确认是否自带 mariadbdnf module list mariadb有些系统默认启用了一个低版本的模块需要先重置或禁用sudo dnf module reset mariadb然后直接安装sudo dnf install -y mariadb-server启动并设置开机自启sudo systemctl enable --now mariadb如果需要最新版本同样需要配置官方仓库。以 Rocky Linux 9 为例先安装包管理器工具sudo dnf install -y wget再到官网生成对应的仓库文件放到/etc/yum.repos.d/目录。装完后可以用dnf info mariadb-server查看版本确认拿到的是预期版本。这里有个常见的坑部分 RHEL 系系统自带mysql或者mariadb命令但服务名和实际软件包不匹配导致执行systemctl start mysql时报错。MariaDB 的服务名统一是mariadb不要搞混。3.4 使用 zypper 在 openSUSE 上安装 MariaDBopenSUSE 的操作更简单自带仓库就能装到很新的版本sudo zypper install -y mariadb mariadb-tools安装后同样启动服务sudo systemctl enable --now mariadbopenSUSE 下有一个不同点默认配置文件路径可能是/etc/my.cnf还有一些额外配置在/etc/my.cnf.d/。修改配置时优先改.d目录下的自定义文件不要动系统默认的主配置这样升级时不容易冲突。3.5 安装后立刻要做的三件事装完数据库只是开始我习惯按固定顺序做三件事第一查看版本信息mariadb --version mysql --version这两条命令都会显示版本因为 MariaDB 提供的客户端兼容 mysql 命令。第二检查监听端口ss -lntp | grep 3306如果端口没监听可能是服务没起来或者配置里改过端口。第三用 socket 连接本地数据库sudo mariadb -u root或者sudo mysql -u root如果这一句能直接进入数据库说明基本安装成功。需要注意的是MariaDB 在 Debian 系安装默认使用了unix_socket认证root 用户只能通过系统用户登录这也是很多新手连接时报错的原因后面会详细讲。4. 容器化与源码编译两种特殊场景的取舍4.1 Docker 部署开发环境和快速验证的首选如果你只是本地开发、快速验证、搭演示环境Docker 是最省事的方式。不用管系统依赖不用纠结版本冲突一条命令就能拉起来docker run -d \ --name mariadb-dev \ -p 3306:3306 \ -e MARIADB_ROOT_PASSWORDyourpassword \ -e MARIADB_DATABASEtestdb \ -v mariadb_data:/var/lib/mysql \ mariadb:10.11几个参数解释一下MARIADB_ROOT_PASSWORD必须设置否则容器起不来。MARIADB_DATABASE可选自动创建数据库。-v mariadb_data:/var/lib/mysql必须挂载数据目录否则容器删除后数据全丢。mariadb:10.11指定镜像标签最好写具体版本不要用latest。进入容器执行 SQLdocker exec -it mariadb-dev mariadb -u root -pDocker 方式适合跑测试但生产环境我不建议无脑容器化。数据库是有状态服务容器本身的网络、存储、生命周期管理都会增加复杂度除非你已经有一套成熟的编排系统否则虚拟机或物理机上直接装可能更省心。4.2 源码编译安装什么时候才值得自己做源码编译是很多人好奇但没必要轻易尝试的路。编译一次 MariaDB耗时取决于机器配置通常在十几分钟到半小时期间可能遇到依赖问题、编译器兼容问题、CMake 版本不够等问题。源码编译真正适用的场景就几种官方没有提供你所在系统的预编译包。你需要启用特殊编译选项比如自定义字符集、特殊存储引擎。你需要裁剪功能做极简部署。你对性能有极致要求想通过编译参数优化指令集。否则不要自己编译。包管理器装好的版本性能损失可以忽略维护成本却低得多。如果你真的要编译大概步骤是这样sudo apt install -y build-essential cmake libssl-dev libpcre3-dev zlib1g-dev wget https://archive.mariadb.org/mariadb-10.11.6/source/mariadb-10.11.6.tar.gz tar -xzf mariadb-10.11.6.tar.gz cd mariadb-10.11.6 cmake . -DCMAKE_INSTALL_PREFIX/usr/local/mariadb -DMYSQL_DATADIR/data/mysql make -j$(nproc) sudo make install编译完成后还需要手动初始化数据目录、创建系统用户、配置服务脚本每一步都有讲究。我的建议是除非真的有必要不然用系统包管理器装完十分钟就能进入下一步操作省下的时间拿去优化 SQL 更值。4.3 二进制包安装被很多人忽略的折中方案二进制包预编译包是个折中方案不用编译又能避开系统仓库的旧版本。官方会为常见 Linux 发行版提供预编译的二进制 tar 包解压后配置一下就能用。流程大致是# 下载二进制包 wget https://archive.mariadb.org/mariadb-10.11.6/binaries/mariadb-10.11.6-linux-systemd-x86_64.tar.gz # 解压到指定目录 sudo tar -xzf mariadb-10.11.6-linux-systemd-x86_64.tar.gz -C /usr/local/ # 创建软链接方便管理 sudo ln -s /usr/local/mariadb-10.11.6-linux-systemd-x86_64 /usr/local/mariadb # 创建数据目录 sudo mkdir -p /data/mysql sudo chown -R mysql:mysql /data/mysql # 初始化数据库 sudo /usr/local/mariadb/scripts/mariadb-install-db --usermysql --basedir/usr/local/mariadb --datadir/data/mysql这种方式适合需要统一版本交给自动化运维工具管理的团队。但要注意二进制包对 glibc 版本有要求老系统可能跑不起来。5. 安装后的配置、安全加固与常用优化让数据库进入可用状态5.1 解决一个让人困惑的认证问题装完 MariaDB 后很多人执行mysql -u root -p登录输入任意密码都会失败其实问题不在密码而在认证方式。MariaDB 在 Debian 系系统的默认安装里root 用户使用unix_socket认证插件也就是说只有通过系统用户root登录时才能进入数据库而且不需要密码。如果你用普通用户身份或者通过 TCP/IP 远程登录就会认证失败。解决办法有两种第一种直接用系统 root 身份进入sudo mariadb进入后新建一个专门的数据库管理用户CREATE USER adminlocalhost IDENTIFIED BY 强密码; GRANT ALL PRIVILEGES ON *.* TO adminlocalhost WITH GRANT OPTION; FLUSH PRIVILEGES;然后退出用新用户登录mysql -u admin -p第二种如果你想保留 root 的密码登录方式可以手动修改认证方式ALTER USER rootlocalhost IDENTIFIED VIA mysql_native_password USING PASSWORD(新密码); FLUSH PRIVILEGES;生产环境建议用第一种方式保留 root 的 socket 认证日常操作用一个专用账号权限按需分配。5.2 安全初始化脚本是必跑的MariaDB 自带安全初始化脚本执行后能清理匿名账户、移除测试数据库、禁用 root 远程登录sudo mariadb-secure-installation脚本会问你一系列问题逐项确认。有几个选项强烈建议选是设置 root 密码或确认 socket 认证方式。移除匿名用户。禁止 root 远程登录。删除 test 数据库并清空权限表。这个脚本不是摆设很多安全问题都是因为装完数据库后跳过这一步暴露在公网的 3306 端口上被扫描工具扫到然后被爆破。5.3 修改数据目录和配置文件的基本姿势MariaDB 的配置主要是my.cnf通常路径为/etc/mysql/mariadb.conf.d/。不建议直接改主文件可以新建一个自定义配置文件比如/etc/mysql/mariadb.conf.d/99-custom.cnf[mysqld] # 端口 port 3306 # 监听地址默认只监听本地改为 0.0.0.0 监听所有 bind-address 127.0.0.1 # 默认字符集 character-set-server utf8mb4 collation-server utf8mb4_unicode_ci # InnoDB 缓冲池大小建议设为物理内存的 50%~70% innodb_buffer_pool_size 1G # 慢查询日志 slow_query_log 1 slow_query_log_file /var/log/mysql/mariadb-slow.log long_query_time 2 # 二进制日志 log_bin /var/log/mysql/mariadb-bin # 最大连接数 max_connections 300修改配置后重启服务sudo systemctl restart mariadb关于监听地址多说一句如果只有本机应用访问数据库bind-address保持127.0.0.1就好。如果真的要远程访问请同时配置防火墙规则只放行特定 IP不要直接对公网开放 3306。5.4 日志文件与数据目录的隔离我接手过一个数据目录小于 1GB 导致数据库反复崩溃的案例。MariaDB 的数据、日志、binlog 都会写入数据目录默认位置是/var/lib/mysql。如果系统盘空间小建议把数据目录改到大容量磁盘# 停止服务 sudo systemctl stop mariadb # 复制数据目录到新位置 sudo rsync -av /var/lib/mysql/ /data/mysql/ # 修改配置文件 sudo vim /etc/mysql/mariadb.conf.d/99-custom.cnf # 添加配置 # datadir /data/mysql # 创建软链接或直接改属主 sudo chown -R mysql:mysql /data/mysql # 启动服务 sudo systemctl start mariadb注意有 SELinux 的 RHEL 系系统改了数据目录后还要更新 SELinux 上下文否则服务起不来。可以用restorecon -R /data/mysql处理或者临时用setenforce 0测试但这只是定位问题不要长期关闭 SELinux。5.5 远程连接的授权与防火墙速查如果应用服务器和数据库不在同一台机器上你需要做三件事第一创建远程访问用户CREATE USER appuser192.168.1.100 IDENTIFIED BY 强密码; GRANT ALL PRIVILEGES ON appdb.* TO appuser192.168.1.100; FLUSH PRIVILEGES;第二修改监听地址bind-address 0.0.0.0第三放行防火墙端口# RHEL 系 sudo firewall-cmd --permanent --add-rich-rulerule familyipv4 source address192.168.1.100 port protocoltcp port3306 accept sudo firewall-cmd --reload # Debian 系 sudo ufw allow from 192.168.1.100 to any port 3306 proto tcp有个习惯值得养成远程访问用户的 IP 白名单尽量精确到单个 IP不要用%通配所有地址能显著减少暴露风险。6. 安装与使用中的高频问题与排查实录6.1 服务起不来的常见原因MariaDB 服务启动失败的原因我见过的大致有这几种第一数据目录权限不对。检查方法很直接ls -ld /var/lib/mysql目录属主必须是mysql:mysql。如果不对sudo chown -R mysql:mysql /var/lib/mysql第二配置文件里有语法错误或参数名不对。可以先用命令检查配置sudo mariadbd --validate-config有不认识的关键词会直接报错。第三端口被占用。某些系统上可能残留旧版的 mysqld或者 3306 被其他程序占用sudo ss -lntp | grep 3306如果有其他进程占用要么停掉要么改端口。第四数据目录里已有数据但版本不一致。比如从 MySQL 迁移数据目录直接拷过来启动时可能报table mysql.plugin doesnt exist之类的错误。这种情况不要盲目删数据先备份再找迁移方案。6.2 连接数据库时提示密码错误或 Access denied这个问题有两种常见原因。第一种是认证插件不匹配。客户端用的是mysql_native_password但服务端要求的是unix_socket或者其他插件。可以登录后查看用户表SELECT user, host, plugin FROM mysql.user;然后按需调整认证插件。第二种是客户端连接时走错了 host。比如你用mysql -u root连接默认以当前系统用户名匹配 host如果不匹配就会出现 access denied。明确指定 host 一般能解决mysql -u root -h 127.0.0.1 -P 3306 -p6.3 磁盘空间被填满导致服务假死这个场景很难排查因为数据库看起来没报错只是所有写入操作都卡住。查看磁盘会发现/var/lib/mysql所在分区已经 100% 占用。常见元凶是 binlog 日志尤其开启log_bin又没有设置过期时间。查看 binlog 占用du -sh /var/lib/mysql/mariadb-bin.*设置自动清理策略在配置文件中加入expire_logs_days 7或者用 SQL 手动清理PURGE BINARY LOGS BEFORE NOW() - INTERVAL 7 DAY;因为 binlog 是数据恢复的重要依据不要直接删文件否则可能导致主从复制中断。6.4 升级版本时的注意事项跨版本升级是风险最高的操作。比如从 10.4 升到 10.11不光是版本跨度还会涉及系统表结构升级。基本流程是# 备份 sudo mariadb-dump --all-databases --single-transaction all_backup.sql # 停止服务 sudo systemctl stop mariadb # 安装新版本 # 启动服务 sudo systemctl start mariadb # 执行升级检查 sudo mariadb-upgrade升级前一定要做全量备份并且先在测试环境跑一遍升级流程。即使官方说明支持直接升级也不建议跳过测试。另外配置文件里的过期参数在新版本里可能被移除启动时会有不认识的参数警告虽不影响启动但建议查一下官方文档对应关系保持配置干净。6.5 忘记 root 密码时的应急方案这个场景我处理过很多次说一个安全环境下可操作的方法。先停掉服务然后以跳过授权表方式启动sudo systemctl stop mariadb sudo mariadbd --skip-grant-tables --skip-networking 此时不需要密码就能进入数据库sudo mariadb -u root然后手动重置密码FLUSH PRIVILEGES; ALTER USER rootlocalhost IDENTIFIED BY 新密码; FLUSH PRIVILEGES;最后重启服务恢复正常模式sudo kill %1 sudo systemctl start mariadb这种操作只应在本地安全环境下进行处理完立即恢复正常认证。7. 我的一些选择建议与长期维护心得接触 MariaDB 这几年我自己形成了一套固定的使用习惯。装新数据库第一件事永远是确认操作系统生命周期和磁盘空间再决定是走系统仓库还是官方仓库。测试环境求新生产环境求稳这个原则一直没变过。如果你只能记住几个关键词我希望是这三个版本兼容性、备份先于操作、端口白名单管理。尤其是版本兼容性数据库升级不像普通软件一旦数据目录升级到新格式再想降级就非常痛苦。另外想提醒的是MariaDB 社区文档质量很高遇到问题先查官方文档很多时候比网上零散文章准确得多。尤其涉及系统表、权限、复制机制时文档里都有详细的说明能少走很多弯路。这篇文章介绍到的安装路径覆盖了个人开发、企业生产、容器化、源码编译几种主流场景核心目标是让你装得稳、用得顺。实际上安装只是数据库运维的起点后续的监控、备份、性能调优才是更漫长的过程。如果你刚装好第一台 MariaDB先把基本的安全配置和备份做了再慢慢深入优化节奏会更舒服。最后分享一个小技巧每次安装后我都会把配置文件、初始化的 SQL 命令、版本信息记到一个统一的操作手册里。这样半年后哪怕机器换了、装的人不在后来者也能照着手册快速复现环境。数据库看似软件问题实际上往往是管理问题把操作规范化比你会不会写复杂 SQL 更影响系统的长期健康。希望这篇内容能让你少踩几个坑。接下来放心去装吧。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
