如何在树莓派上快速完成MySQL环境搭建树莓派数据库环境搭建及性能优化配置-mysql教程-PHP中文网

直接装 mariadb-server 是正确选择，因其是 mysql 的完全兼容替代品，性能更轻量、维护更活跃，且树莓派官方系统已默认提供；需优化配置、启用远程访问并考虑 sd 卡 io 限制。

如何在树莓派上快速完成mysql环境搭建树莓派数据库环境搭建及性能优化配置

直接装 `mysql-server` 还是改用 `mariadb-server`？

树莓派官方系统（Raspberry Pi OS）从 Debian 11 开始，默认源里已移除 Oracle MySQL，apt install mysql-server 实际安装的是 MariaDB 的兼容包（即 mariadb-server）。强行找旧版 MySQL 二进制或编译安装，反而容易出依赖冲突、ARM 架构适配问题，且无必要。

MariaDB 是 MySQL 的 drop-in 替代品，语法、协议、客户端工具（如 mysql 命令）完全兼容，树莓派上性能更轻量、维护更活跃。所以——直接装 mariadb-server 就是对的。

sudo apt update && sudo apt install mariadb-server
装完自动启动并启用开机自启，无需额外操作
首次使用前务必运行 sudo mysql_secure_installation：禁用匿名用户、禁止 root 远程登录、删除 test 数据库、刷新权限

树莓派默认配置太“保守”，不调根本跑不快

MariaDB 默认配置面向通用 x86 服务器，对树莓派（尤其 4GB/8GB RAM 的型号）来说，innodb_buffer_pool_size 默认仅 128MB，连可用内存的 1/32 都不到，查询稍复杂就频繁刷盘，IO 成瓶颈。

编辑配置文件：sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf，在 [mysqld] 段下调整关键项：

innodb_buffer_pool_size = 1G（4GB 内存机型）或 2G（8GB 机型），不超过物理内存的 50%，留足给系统和应用
innodb_log_file_size = 256M：增大日志文件提升写吞吐，但首次设置需先停服务、删旧日志（/var/lib/mysql/ib_logfile*）、再重启
query_cache_type = 0：MariaDB 10.6+ 已弃用查询缓存，设为 0 避免额外开销
tmp_table_size 和 max_heap_table_size 设为 64M：避免大 GROUP BY 或排序时掉到磁盘临时表

改完执行 sudo systemctl restart mariadb，用 sudo mysql -e "SHOW VARIABLES LIKE 'innodb_buffer_pool_size';" 确认生效。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

远程访问连不上？重点查三个地方

树莓派默认绑定 127.0.0.1，外部设备 ping 得通但连不上 MySQL，不是防火墙问题就是这三处没动：

修改 bind-address：在 50-server.cnf 的 [mysqld] 段改为 bind-address = 0.0.0.0（或指定内网 IP，如 192.168.1.100）
创建远程用户：不能只用 root@localhost，得显式授权，例如 CREATE USER 'piuser'@'192.168.1.%' IDENTIFIED BY 'strongpass'; GRANT ALL ON *.* TO 'piuser'@'192.168.1.%'; FLUSH PRIVILEGES;
检查系统防火墙：sudo ufw status，若启用则加规则 sudo ufw allow 3306

注意：树莓派若接家用路由器，通常无需额外端口映射；但若用手机热点或某些校园网，可能被 NAT 或 ACL 拦截，此时优先走内网直连测试。

SD 卡寿命和 IO 延迟比你想象中更敏感

树莓派数据库长期写入，瓶颈不在 CPU 或内存，而在 SD 卡的随机写性能和擦写寿命。默认日志、数据目录全在 /var/lib/mysql（即系统 SD 卡分区），频繁小写会加速卡老化，且 sync_binlog=1（默认）导致每次事务都强制刷盘，延迟飙升。

两个务实方案：

把数据目录迁移到 USB 3.0 SSD：格式化为 ext4，挂载到 /mnt/ssd/mysql，然后修改 datadir 和 innodb_log_group_home_dir 指向新路径，再 chown -R mysql:mysql /mnt/ssd/mysql，最后重启服务
若只能用 SD 卡，至少关掉双写缓冲：innodb_doublewrite = 0（仅限非关键数据场景，断电可能丢页），并设 sync_binlog = 0（牺牲部分安全性换响应速度）

真正影响体验的，往往不是“能不能跑”，而是“一写就卡两秒”。这点在做传感器数据采集或 Web 后台时特别明显，别等 SD 卡突然变砖才想起看 dmesg | grep mmc 有没有 I/O timeout 报错。