树莓派作为轻量级开发板，常被用于搭建个人服务器或物联网项目，而MySQL则是其中最常用的关系型数据库。许多新手在树莓派上安装MySQL时容易遇到依赖缺失、权限配置或版本不匹配的问题。本教程将用最直白的语言，带你一步步完成从系统更新到数据库初始化的全过程，确保你一次成功。
准备环境与系统更新
在安装任何软件之前，先确保你的树莓派运行的是最新版本的Raspberry Pi OS。打开终端，依次输入两条命令。第一条是更新软件源索引，输入sudo apt update并回车；第二条是升级已安装的软件包，输入sudo apt upgrade -y并回车。这两步大概需要几分钟，期间可能会弹出提示按Y确认。等待进度条走完，说明基础环境已经就绪。如果使用的是旧版系统，建议直接使用官方镜像刷写新系统，避免底层库版本冲突导致后续安装失败。另外，树莓派默认的存储卡读写速度较慢，安装大型服务前建议把交换空间临时调大，防止内存不足导致进程卡死。
安装MySQL服务
树莓派默认的软件源里自带了MySQL的服务器端和客户端工具。直接在终端输入sudo apt install mysql-server mysql-client -y即可开始自动下载和安装。整个过程会根据树莓派的型号和网络速度持续一到三分钟。安装过程中屏幕会滚动大量代码信息，不用理会，只需等待最后出现Done字样或回到命令行提示符。注意，现在新版MySQL默认采用插件认证方式登录，不需要手动修改配置文件中的认证插件部分，系统会自动处理最安全的连接方式。如果遇到网络超时，可以更换国内镜像源地址，重新执行安装命令即可。
初始化与安全设置
安装完成后，数据库并不会立刻开放远程访问权限，这是出于安全考虑。首先运行sudo mysql_secure_installation脚本进行初始化。系统会询问是否设置root密码，直接选N跳过，因为树莓派通常通过sudo权限调用mysql。接着它会问是否删除匿名账户，输入Y确认；是否禁用root远程登录，输入Y确认；是否移除测试数据库，输入Y确认；最后是否重新加载权限表，同样输入Y确认。这四步走完后，MySQL的基础安全防线就建立好了。这一步非常关键，能帮你过滤掉绝大多数暴力破解攻击。
配置远程访问与防火墙
如果你需要在电脑或其他设备上连接树莓派里的MySQL，必须修改监听地址。用文本编辑器打开MySQL的主配置文件，输入sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf找到bind-address这一行。默认值通常是127.0.0.1，表示只允许本机访问。将其修改为0.0.0.0，保存并退出。然后重启MySQL服务，输入sudo systemctl restart mysql让配置生效。接下来检查树莓派的防火墙状态，大多数默认开启UFW。运行sudo ufw allow 3306/tcp放行端口，并用sudo ufw enable激活规则。此时外部设备就能通过IP地址加端口号连接数据库了。记得同时在路由器后台做好端口映射，或者直接使用内网穿透工具。
验证安装与日常维护
一切配置妥当后，进行最终测试。在终端输入mysql -u root -p，提示输入密码时直接回车。进入mysql命令行界面后，输入show databases;查看当前数据库列表，如果能顺利显示基础库，说明安装完全成功。平时维护时，可以通过sudo systemctl status mysql查看运行状态，用sudo journalctl -u mysql.service调出错误日志排查问题。定期执行sudo apt update && sudo apt upgrade保持数据库内核补丁同步，能有效防止已知漏洞。树莓派性能有限，生产环境建议控制单表数据量，配合合理的索引设计，就能稳定支撑中小型项目的数据存储需求。遇到卡顿现象时，优先检查CPU温度和内存占用，清理不必要的后台进程即可恢复流畅。
