直接安装 mariadb-server 即可，树莓派官方系统从 Debian 11 起已将 mysql-server 设为指向 mariadb-server 的虚拟包，语法、协议、工具完全兼容；远程连接需注释 /etc/mysql/mariadb.conf.d/50-server.cnf 中 bind-address 并重启服务；推荐用 mysql_secure_installation 配置安全选项，避免手动设密码引发认证插件问题。
直接装 mariadb-server 就行，别折腾 Oracle MySQL —— 树莓派官方系统（Raspberry Pi OS）从 Debian 11 起已移除原版 mysql-server 包，apt install mysql-server 实际安装的就是 mariadb-server 的兼容包。硬要装旧版 MySQL，大概率遇到 ARM 架构适配失败、依赖冲突或启动报错。
为什么 apt install mysql-server 装的是 MariaDB？
这不是“偷换概念”，而是 Debian 和 Raspberry Pi OS 的明确策略：Oracle MySQL 不再被上游维护为自由软件首选，MariaDB 成为默认 drop-in 替代品。执行该命令时，APT 会自动解析为 mariadb-server 并提示你确认安装 mariadb-server-10.x。所有客户端工具（如 mysql 命令）、协议、SQL 语法、权限模型完全一致，应用层无需任何修改。
常见错误现象：
- 执行
sudo apt install mysql-server后提示 “Package mysql-server is a virtual package”，接着列出推荐安装的mariadb-server - 装完运行
mysql --version显示Ver 15.1 Distrib 10.11.x-MariaDB，而非 MySQL 官方版本号
远程连不上？十有八九是 bind-address 没改
MariaDB 默认只监听 127.0.0.1，这是安全设计，但也是新手最常卡住的地方。树莓派上配置文件位置和旧版 MySQL 不同，别去改 /etc/mysql/my.cnf（可能不存在或不生效）。
正确做法：
- 编辑
/etc/mysql/mariadb.conf.d/50-server.cnf - 找到
bind-address = 127.0.0.1这一行，把它注释掉（前面加#）或改为bind-address = 0.0.0.0 - 保存后必须重启服务：
sudo systemctl restart mariadb，仅 reload 不生效 - 验证是否监听全网卡：
sudo ss -tlnp | grep :3306，输出中应含*:3306或0.0.0.0:3306
注意：改完配置不重启、或改错文件路径（比如误改了 50-client.cnf），都会导致远程连接持续报错 ERROR 2003 (HY000): Can't connect to MySQL server 或 Connection refused。
用 mysql_secure_installation 配置比手动设密码更可靠
不要用 sudo mysqladmin -u root password xxx 这种老方法——它在新版本 MariaDB 中已被弃用，且无法处理认证插件（如 unix_socket）导致的 root 登录失败问题。
标准流程：
- 安装完立即运行：
sudo mysql_secure_installation - 第 1 步“Enter current password for root”直接回车（初始为空）
- 第 2 步选
Y设置 root 密码；第 4 步“Disallow root login remotely?”建议选N（否则后续还得手动授权） - 该脚本会自动禁用匿名用户、删除 test 库、重载权限表——比手写
FLUSH PRIVILEGES更完整
如果已跳过这步，又遇到 Access denied for user 'root'@'localhost'，说明 root 用户被绑定了 unix_socket 插件。此时需先用 sudo mysql -u root（不加 -p）登录，再执行：
UPDATE mysql.user SET plugin='mysql_native_password' WHERE User='root';<br>FLUSH PRIVILEGES;
Docker 方案看似方便，但对树莓派属于高开销冗余
虽然 docker run -d --name=mysql jsurf/rpi-mariadb 能跑起来，但它在树莓派上带来三重负担：
- 额外一层容器运行时（
containerd+runc）吃内存，4GB 版本尚可，1GB 版本极易 OOM - SD 卡 I/O 叠加：宿主系统 → Docker overlay2 → MariaDB 数据目录，延迟更高
- 配置调试链路变长：容器内改配置 → 重启容器 → 宿主网络策略 → 端口映射，任一环节出错都难定位
除非你已有成熟 Docker 编排习惯、或需多版本隔离，否则原生 apt install mariadb-server 是唯一推荐路径。Docker 镜像的 jsurf/rpi-mariadb 已多年未更新，ARM64 兼容性存疑。
真正容易被忽略的点：SD 卡寿命。MariaDB 默认日志刷盘频繁，树莓派长时间运行务必在 /etc/mysql/mariadb.conf.d/50-server.cnf 中添加：
[mysqld]<br>innodb_flush_log_at_trx_commit = 2<br>sync_binlog = 0
这能大幅降低写入放大，代价是极端断电下最多丢失 1 秒事务——对多数树莓派应用场景（如传感器数据缓存、本地 Web 后端）完全可接受。
