简介MariaDB 10.6.8 linux-systemd x86_64 压缩包提供了一套可直接部署的数据库管理系统适用于需要在 Linux 服务器上搭建、迁移或替换 MySQL 的开发者与运维人员。作为 MySQL 的高兼容分支它保留相同的 API 和命令行体验并采用 XtraDB 等存储引擎让替换成本大幅降低。整体约 328MB共 20162 个文件除 mariadbd、mysql、mysqldump 等核心程序外还包含大量 test 与 result 测试用例及预期结果、cnf 配置文件、h 头文件等便于理解默认参数和验证数据库行为同时附带安装、备份、安全初始化等脚本。已有 994 人学习使用。该压缩包内置覆盖多场景的测试集与二进制日志样例支持从快速部署、兼容性验证到数据同步排查的完整流程对有经验的使用者还能通过配置样例与测试文件深入理解 MariaDB 的目录结构、存储引擎差异和服务初始化逻辑是一份兼具生产价值与学习价值的完整资源。1. 这份 mariadb-10.6.8 tar.gz 包能部署也能当 binlog 标本库mariadb-10.6.8-linux-systemd-x86_64.tar.gz 是个解压就能跑的二进制包适合 Linux 服务器没有外网、装不了 yum/apt 源、又必须跑 MySQL 兼容业务的场景。但它真正值钱的不是安装包本身而是包内附带的一批 binlog 样本文件——有 MySQL 4.1 时代的旧格式、有 bug 复现现场、有 relay log 和事务日志。这意味着你下载的其实是一个「可部署的 MariaDB binlog 格式标本库」。对 DBA 和运维来说可以离线完成部署同时还能拿它练手 binlog 解析与崩溃恢复。MariaDB 是 MySQL 创始人主导的分支API 和命令行完全兼容 MySQL从 MySQL 迁移过来的团队不需要改任何习惯。这篇笔记从部署讲到 systemd 接管最后落到 binlog 版本兼容的坑。2. MariaDB 二进制包部署从解压到给 root 设置密码的完整步骤2.1 解压前的环境检查二进制包虽然免编译但 MariaDB 在运行前对系统库有硬依赖。我一般先做三个检查glibc 版本、libaio 是否存在、是否已有 mysql 用户。缺 libaio 是二进制包部署最常见的第一道坎很多新手在 systemd 启动阶段才翻车其实前置检查就能拦住。# 检查 glibc10.6.8 要求 glibc 版本别太老 ldd --version | head -1 # 检查 libaioDebian/Ubuntu 系 dpkg -l | grep libaio # 或 RHEL/CentOS 系 rpm -qa | grep libaio # 检查是否有 mysql 用户没有就建一个 id mysql || useradd -r -s /sbin/nologin mysql这里useradd -r创建的是系统账户-s /sbin/nologin表示禁止登录mysql 主进程只以这个身份运行即使被入侵也拿不到 shell。libaio 是异步 IO 库InnoDB/XtraDB 写数据时依赖它缺少的话 mariadbd 会在启动时报libaio.so.1: cannot open shared object file。如果系统里没有 libaio用yum install libaio或apt install libaio1补上不需要联网的环境就从安装光盘里找 rpm 包。2.2 解压与数据目录初始化tar.gz 包解压到 /usr/local 是最常见的做法。包名里的linux-systemd意味着这个版本的二进制编译时带了 systemd 插件可以用Typenotify方式让 systemd 感知数据库就绪状态这是后续第 3 章的基础也和用源码包自己编的行为有区别。mkdir -p /usr/local/mariadb tar -zxf mariadb-10.6.8-linux-systemd-x86_64.tar.gz \ -C /usr/local/mariadb --strip-components1 # 创建独立数据目录不要把数据放在安装目录里 mkdir -p /data/mysql /data/binlog chown -R mysql:mysql /data/mysql /data/binlog # 初始化系统库 /usr/local/mariadb/scripts/mariadb-install-db \ --usermysql \ --datadir/data/mysql \ --basedir/usr/local/mariadb \ --auth-root-authentication-methodnormal--strip-components1会剥掉压缩包内顶层目录名直接展开到 /usr/local/mariadb 下避免出现 /usr/local/mariadb/mariadb-10.6.8-... 这种双重路径。初始化这一步才是真正的关键它负责创建 mysql 系统库、生成默认的 root 账号和权限表。10.6.8 版本初始化时默认 root 用的是 unix_socket 认证——也就是说只有本机 root 用户通过 socket 文件登录才免密TCP 连接走不进来。--auth-root-authentication-methodnormal则改用传统密码方式适合你需要远程管理的场景。如果你沿用默认的 unix_socket后面用 127.0.0.1 连库会一直被拒。2.3 启动、改配置与 root 密码初始化完成后先写一个精简的 my.cnf把 basedir、datadir、socket 都显式固定。二进制包自带的 my.cnf 模板在 etc/ 目录下但我习惯自己写一份干净的避免模板里的注释参数干扰排查[mysqld] basedir/usr/local/mariadb datadir/data/mysql socket/run/mariadb/mariadb.sock pid-file/run/mariadb/mariadb.pid log-error/data/mysql/error.log server-id1 binlog_formatROW log_bin/data/binlog/mariadb-bin expire_logs_days7这里把 log_bin 指到了独立目录方便后面拿第 6 章的恢复演练练手。binlog_formatROW是 10.6 的相对稳妥选择5.5 时代默认的 STATEMENT 格式在主从复制遇到不确定性 SQL 时容易产生主从不一致ROW 牺牲一点 binlog 空间换正确性。expire_logs_days7是按天清理过期 binlog生产环境建议按你自己的备份策略调。# 前台启动确认没有报错 /usr/local/mariadb/bin/mariadbd \ --defaults-file/etc/my.cnf \ --usermysql # 等 3~5 秒后确认进程存活 /usr/local/mariadb/bin/mariadb-admin ping # 给 root 设置密码若初始化时用了 unix_socket 认证则用 socket 登录后改 /usr/local/mariadb/bin/mysql -uroot -S /run/mariadb/mariadb.sock \ -e ALTER USER rootlocalhost IDENTIFIED BY NewPassw0rd;如果你初始化时用的默认 unix_socket此时必须带-S /run/mariadb/mariadb.sock走 socket 连进去否则 TCP 根本连不上。设置密码之后用mysql -uroot -pNewPassw0rd -h127.0.0.1 -P3306验证 TCP 链路是否工作。注意 10.6 的mariadb-admin ping就是原 mysqladmin ping 的改名版MariaDB 把客户端工具统一改前缀了老 MySQL 命令习惯要切换过来。这一步翻车最频繁的是 socket 路径不一致——my.cnf 里写 /run/mariadb/mariadb.sock但/run/mariadb目录没创建启动直接失败这个坑在第 5 章单独展开。3. 把 MariaDB 交给 systemd 管理unit 文件、Typenotify 与日志排查3.1 为什么不用 mysqld_safe 而用 systemd二进制包自带的启动脚本是mysqld_safe它在后台拉起 mariadbd 并监控进程崩溃后自动重启。这功能在 systemd 面前已经过时了systemd 可以做到崩溃自动拉起、开机自启、统一日志、权限隔离。特别是这个包名自带linux-systemd说明编译期就启用了 systemd 集成插件能用Typenotify让数据文件加载完成后才报告服务就绪而不是盲目 sleep 几秒再判断存活。我见过不少线上环境同时开着 mysqld_safe 和 systemd 的 Restart进程一旦 OOM两边同时拉产生孤儿进程这是个很经典的双管理翻车现场。所以建议只用 systemd 一个管理者。3.2 unit 文件怎么写把以下内容写到 /etc/systemd/system/mariadb.service注意几个容易写错的点RuntimeDirectorymariadb让 systemd 自动创建 /run/mariadb 并赋予 mysql 写权限这条能避免 90% 的 socket 目录报错PrivateTmptrue不影响 MariaDB 数据目录ProtectSystemfull会让 /usr、/boot、/etc 变成只读因为数据都在 /data/mysql所以业务不受影响。[Unit] DescriptionMariaDB 10.6.8 database server Afternetwork.target [Service] Typenotify Usermysql Groupmysql RuntimeDirectorymariadb ExecStart/usr/local/mariadb/bin/mariadbd \ --defaults-file/etc/my.cnf ExecStartPre/usr/local/mariadb/scripts/mariadb-install-db \ --usermysql --datadir/data/mysql --skip-test-db ExecReload/bin/kill -HUP $MAINPID TimeoutSec300 PrivateTmptrue ProtectSystemfull NoNewPrivilegestrue [Install] WantedBymulti-user.targetExecStartPre里保留了mariadb-install-db它具备幂等性检测到 /data/mysql 下已有系统库就会直接退出不会重复初始化。如果你已经手动初始化过这条命令就相当于一次快速自检不是必要的但留着能让新环境直接拉到可用状态。Typenotify要求 mariadbd 启动时通过 sd_notify 主动上报 READY1如果进程真正就绪前 systemd 就收到退出信号服务会被标记为失败——所以 datadir 权限不对时报错信息会直接出现在 systemd 状态里排错路径清晰很多。systemctl daemon-reload systemctl enable --now mariadb.service systemctl status mariadb.serviceenable --now等价于先 enable 开机自启、再立刻 start。执行完 status 应该看到Active: active (running)。如果状态里显示failed (Result: exit-code)不要急着重启先看日志再决定。3.3 日志怎么看systemd 接管后日志统一走 journald和以前 error log 分散在文件里不同。看日志有两种组合拳# 实时跟踪启动过程排查启动崩溃 journalctl -u mariadb.service -f --no-pager # 只看最近一次启动的错误含 stderr 输出 journalctl -u mariadb.service -n 200 --no-pager关键判断点日志里如果出现ERROR: Failed to open log通常就是 /data/mysql 或 /data/binlog 目录的属主不是 mysql如果出现Cant create/write to file /run/mariadb/mariadb.sock十有八九是 my.cnf 里 socket 路径和 RuntimeDirectory 对不上或者你手动建了 /run/mariadb 但属主是 root。另外注意 mariadbd 的 stderr 输出和 error log 内容可能重复别看到重复行就以为有多个进程在打架先用systemctl status里的 PID 确认进程唯一。日志出现READY1说明 notify 阶段已经过了如果卡在这一步之前优先怀疑数据文件损坏、磁盘满和权限。4. binlog 样本包解读4.1 旧格式、8.0 兼容边界与解析脚本4.1 包内文件清单每个文件代表一个现场解压后你会看到一批名字很长的 binlog它们不是装饰品。按文件名可以分成四类老版本格式验证binlog_old_version_4_1、mariadb-5.5-binlog、bug 复现用例bug11747416、bug16266、bug33029、复现特定场景的截取片段mysql-8.0.13-stm-temporal-round-binlog、以及通用事务日志binlog_transaction。简单梳理如下文件名场景推断使用价值binlog_old_version_4_1.000001MySQL 4.1 时代旧格式 binlog验证 mysqlbinlog 对老格式的兼容边界mariadb-5.5-binlog.000001MariaDB/MySQL 5.5 版本生成的日志排查从 5.5 升级到 10.6 的回放问题mdev6020-mysql-bin.000001MariaDB bug 跟踪系统编号 MDEV-6020 的复现现场学习官方如何构造最小复现集bug11747416_32228_binlog.000001Oracle MySQL bug 编号 11747416 的触发日志对比两种 bug 编号体系的差异bug33029-slave-relay-bin.000001从库 relay log 形态的日志主从复制链路排查样本binlog_transaction.000001多事务混合的 binlog事务边界与 event 组合的练习素材mysql-8.0.13-stm-temporal-round-binlog.000001MySQL 8.0.13 statement 格式下 temporal 字段处理差异演示跨大版本读 binlog 的兼容性坑bug16266.000001编号 16266 的复现日志练习按 event 类型定位问题这批文件对生产最大的意义是别等线上出问题才去补 binlog 知识。特别是mysql-8.0.13那个文件它直接点出一个事实——MariaDB 10.6 的 mysqlbinlog 解析 MySQL 8.0 的 binlog 并不完美两者 event 类型号有重叠和偏移。下文第 4.3 小节会演示遇到这种情况时工具会怎么表现。4.2 用 hexdump 快速识别 binlog 格式版本拿到一个陌生 binlog先别急着上 mysqlbinlog用十六进制看一眼文件头。所有 MySQL 系 binlog 的 magic 是固定的四个字节fe 62 69 6e即\xfe binmagic 之后的部分才区分格式版本。我习惯写一个小脚本批量探一遍把包内文件全部过筛#!/bin/bash # 快速 probe输出文件头 magic 与首个 event 类型字节 for f in ./*.000001 ./*binlog*; do [ -f $f ] || continue magic$(xxd -p -l 4 $f) evt$(xxd -p -l 1 -s 8 $f) echo $f magic$magic first_event_type0x$evt done解释一下输出magicfe62696e是所有 binlog 的身份证不是这个值说明文件被截断或者根本不是 binlog。offset 8 处是第一个事件的事件类型字节MySQL 5.0 之后的 v4 格式第一个事件固定是 FORMAT_DESCRIPTION_EVENT事件类型号是 0x0f15。如果你在这里看到 0x00、0x04 之类说明格式版本更早或者是事件的标志位被解析错位了。这个脚本的价值在于它能在 30 秒内告诉你哪些文件可以直接交给 mysqlbinlog、哪些需要--force-read才能读完。对binlog_old_version_4_1.000001来说文件名里的 4_1 指的是 MySQL 4.1那个时代的 binlog 还没有 FORMAT_DESCRIPTION_EVENT所以 probe 结果大概率不是 0x0f。此时不要慌继续用 mysqlbinlog 的--force-read模式去读才是正路下一小节细讲。4.3 mysqlbinlog 解析三个关键参数解析这些样本文件我一般用下面这条命令参数顺序也值得关注/usr/local/mariadb/bin/mysqlbinlog \ --no-defaults \ --force-read \ --base64-outputDECODE-ROWS \ -v \ --start-datetime2023-01-01 00:00:00 \ binlog_old_version_4_1.000001 replay.sql--no-defaults防止读取本机 my.cnf 里的 binlog 相关配置干扰工具行为--force-read让解析器在遇到未知 event 类型时跳过而不是中断旧格式 binlog 事件类型号在 10.6 工具里已经有部分废弃不加这个参数会卡在第一个不识别的 event 上--base64-outputDECODE-ROWS配合-v把 ROW 格式的二进制变更翻译成可读的伪 SQL不然你看到的全是### INSERT注解加一堆十六进制。--start-datetime是时间断点用于只回放指定时段的事务恢复场景里可以配合第 6 章的断点定位使用。命令执行后重点看两类输出一类是正常的 SQL 语句和行变更注释另一类是WARNING: The range of the next event这种提示说明该 event 已经超出工具解析范围。如果你的目的是完整恢复某个时间点出现这类 WARNING 时必须停下来人工核对后续 event 是否关键如果只是练手直接用head -50 replay.sql看开头部分能不能正常展开。跨版本解析还有一个玄学点同一个 binlog 用 MariaDB 自带的 mysqlbinlog 和用 MySQL 官方 mysqlbinlog 读结果可能不一致。判断标准以你实际要部署的库为准不要拿两个工具的输出做 diff 后强行选一个——它们的 event 类型映射根本就不是一张表。4.4 MySQL 8.0 binlog 在 MariaDB 下的兼容边界mysql-8.0.13-stm-temporal-round-binlog.000001这个文件名指向的正是 8.0.13 版本在 statement 模式下 temporal 字段取整差异。用 10.6 的 mysqlbinlog 读它时最常出现的现象是解析到一半抛出未知事件类型错误。原因在于 MySQL 8.0 的 binlog 里新增了格式描述扩展且校验机制的 binlog_checksum 默认是 CRC32而 MariaDB 10.6 的解析器虽然也支持 CRC32但事件类型编号空间与 MySQL 8.0 存在冲突遇到 8.0 私有事件时无法正确识别长度后续所有字节解析全部错位。这种情况下不要试图让 mysqlbinlog 强吃完整文件。实用思路是把该文件当作「负样本」它验证了你不能用 MariaDB 自带工具直接解析 MySQL 8.0 的 binlog 做恢复。跨大版本恢复应该走逻辑导出mysqldump 或准备 MySQL 8 官方工具链而不是物理 binlog 直接灌。这一条在第 5 章的避坑清单里再展开一次因为它属于高频翻车点。5. 避坑清单五个高频异常与排查路径5.1 启动了但 socket 文件一直不出现现象systemctl start mariadb 显示 active但mysql -uroot报Cant connect to local server through socket /run/mariadb/mariadb.sockps 里却能看见 mariadbd 进程。原因两种常见情况。第一种my.cnf 里 socket 路径写的是/tmp/mariadb.sock而客户端默认找/run/mariadb/mariadb.sock两者不一致导致连接错位第二种/run/mariadb目录在系统重启后被清空而 systemd unit 里没写RuntimeDirectorymariadbmariadbd 启动时发现目录不存在自己默默换到编译期默认路径去了。解决统一 socket 路径。在 my.cnf 的[mysqld]段把 socket 显式写到/run/mariadb/mariadb.sock客户端连接时也强制指定-S /run/mariadb/mariadb.sock然后确认 unit 文件里有RuntimeDirectorymariadb最后systemctl daemon-reload systemctl restart mariadb。从那以后我每改一次 socket 配置都会同时查这三个位置。5.2 mariadb-install-db 报错但错误信息不明确现象初始化时控制台输出一闪而过只留下一段日志文件路径打开日志看到ERROR: Failed to open file或Permission denied这类信息。原因二进制包解压后文件属主是 root如果直接用 root 执行 mariadb-install-db 且没有把 datadir 属主改成 mysql初始化进程写不进去。另一种常见原因是 data 目录路径带空格或软链接脚本解析时把路径拆断了。解决先chown -R mysql:mysql /data/mysql再执行初始化。如果还报错用strace -f -e tracefile跟踪脚本到底卡在哪个 open 系统调用上这是定位这类权限类问题的通用底牌。注意 10.6 的 mariadb-install-db 脚本本身不会自动创建 datadir你必须先 mkdir 再给权顺序反了就会在最后一步栽跟头。5.3 主从复制中断在 binlog 版本不一致现象从库 IO 线程正常SQL 线程报错Could not execute Update_rows event ... Unknown system variable rbr_exec_mode或Event is not a valid event。原因master 是 MySQL 5.5/4.1 生成的老 binlog格式版本和事件类型在 10.6 的解析器里已经部分失效。特别是老版本 STATEMENT 格式里的隐式事务提交标识和新的 binlog 事件编号对不上。解决升级路径要先确认 master 的 binlog 格式版本。用第 4.2 小节的 probe 脚本测一遍老格式文件不要直接灌给 10.6 的复制链路。务实做法是老库先逻辑迁移到同版本实例再逐级升到 10.6binlog 只保留最近 24 小时的增量。如果回放老文件只是做数据恢复务必在测试库上先跑通--force-readDECODE-ROWS组合别在生产从库直接试。5.4 mysqlbinlog 解析 8.0 文件时中途报 event 长度错误现象解析mysql-8.0.13-stm-temporal-round-binlog.000001时输出正常 SQL 几十行后突然报错提示某个 event 的 event_size 值超出文件剩余长度。原因MySQL 8.0 的 binlog 在 FORMAT_DESCRIPTION_EVENT 里声明了额外的校验和字段MariaDB 10.6 的解析器按自己的 event_type 长度表推算读到了错误的边界整个事件流后续全乱。文件本身没坏——是解析器的格式字典不对。解决不要把 8.0 binlog 交给 MariaDB 的 mysqlbinlog 做正式解析这是工具链固有的边界。按第 4.4 节的做法跨版本恢复走 dump 管线。如果非要看内容用 8.0 官方自带的 mysqlbinlog 读勾选--read-from-remote-server或直接本机解析。记住这个教训名字里带 mysql-8.0.13 的样本是用来验证边界在哪里的不是硬啃用的。5.5 设置 root 密码后 socket 登录仍然免密现象执行完第 2 章的 ALTER USER 设置了密码用mysql -uroot -p输入密码能进但mysql -uroot不带密码也能直接登进去。原因10.6 的 mariadb-install-db 默认把 rootlocalhost 的认证插件设成了 unix_socket。ALTER USER 设置密码后插件依然是 unix_socket这导致 socket 连接直接走系统用户验证密码形同虚设TCP 连接才需要密码。解决明确你的安全边界。如果只要密码认证改掉认证插件/usr/local/mariadb/bin/mysql -uroot -S /run/mariadb/mariadb.sock EOF ALTER USER rootlocalhost IDENTIFIED VIA mysql_native_password USING PASSWORD(NewPassw0rd); FLUSH PRIVILEGES; EOF如果是内网且只有本机 root 能碰 socket保留 unix_socket 反而更安全——这是设计行为不是 bug。我对这个坑的评价是MariaDB 默认配置偏内网安全如果你拿它接公网业务必须走完插件切换这一步否则等于没设密码。热词「给 mariadb root 设置密码」背后一半的搜索流量都是被这个设计搞懵的。6. 收尾技巧用 mysqlbinlog 断点回放与格式预检拿到未知 binlog 后的第一件事不是直接回放而是先做一次格式预检。我常用的命令组合是先把整个文件扫一遍确认 event 类型、时间跨度和事务边界再决定怎么切分回放# 预检确认时间跨度与事务起止 /usr/local/mariadb/bin/mysqlbinlog --no-defaults --force-read \ binlog_transaction.000001 | grep -E ^(# at|#20) | head -20 # 断点回放只恢复指定位置区间 /usr/local/mariadb/bin/mysqlbinlog --no-defaults --force-read \ --start-position1234 --stop-position5678 \ binlog_transaction.000001 cut.sql--start-position和--stop-position的边界值是字节偏移需要看预检输出里每个# at标注的位置。一个常见错误是把#190101 10:00:00这类注释行和 position 搞混position 指的是该 event 在文件中的起始字节数不是时间。如果只想按时间恢复就改用--start-datetime和--stop-datetime但注意时间边界包含的是 event 的写入时间事务可能跨边界恢复后会是一个不完整事务需要用--stop-never配合主从链路或手工判断事务终点。做增量恢复演练时我坚持一个习惯恢复前先建一个带 general_log 的沙箱实例把回放 SQL 全部灌进去观察有没有事务被截断、外键失败、重复主键。binlog 回放是黑匣子光看 exit code 看不出语义错误general_log 能看到每一条真实下发的语句。从那次在测试库直接回放 8.0 binlog 翻车之后我拿到任何陌生 binlog 都是先跑格式预检再进沙箱确认无误后才碰正式环境。这个流程帮我挡下了至少三次版本兼容事故希望帮到你。本文还有配套的精品资源点击获取