直接在 Ubuntu 上装 MySQL 8其实就这么几步。前几天帮一个朋友处理服务器数据库迁移他用的还是 Ubuntu 20.04 的老机器一开始图省事直接apt install mysql-server装完才发现版本是 MySQL 8.0.35但默认密码策略、认证插件和字符集全都没配导致后面接业务系统时一堆坑。我花了一个下午帮他全部理顺顺便把整个过程里踩过的、见过的坑都整理出来这篇文章就按我实际操作的顺序来写适合准备在 Ubuntu 上跑 MySQL 8 的同学直接“抄作业”。你装 MySQL 8 之前最需要先想清楚三件事用哪种方式装、装哪个版本、装完怎么调。这三件事想明白了后面基本不会出大乱子。1. 安装前的环境准备与方案选型1.1 确认系统版本与架构不管你是全新服务器还是已有业务的环境第一步永远是看系统信息。别看这一步简单我见过太多人装完 MySQL 才发现系统版本和安装包不匹配或者架构没选对白折腾一小时。cat /etc/os-release uname -muname -m输出x86_64就是 64 位aarch64就是 ARM 架构。MySQL 官方对 ARM 的支持已经非常成熟但在 Ubuntu 上默认软件源的 MySQL 版本可能不是最新的这点后面会讲到。确认好后顺手看一下系统内存和磁盘free -h df -hMySQL 8 默认的innodb_buffer_pool_size是 128M生产环境建议至少 2G 内存起步如果机器只有 1G后续的配置里必须把缓冲池调低否则 MySQL 启动都费劲。1.2 检查是否已有 MySQL 或 MariaDB 残留Ubuntu 系统有时候会预装 MariaDB 的依赖库或者之前装过 MySQL 但卸载不干净这些都会导致新装的 MySQL 8 启动失败或端口冲突。检查命令如下dpkg -l | grep -E mysql|mariadb ss -lntp | grep 3306如果有输出需要先清理。清理过程中最需要注意的是如果你是生产环境的数据库千万别直接apt remove mariadb-server之类的操作先备份数据再动手。清理残留我一般这么做sudo systemctl stop mysql mariadb sudo apt purge mysql-server mysql-client mysql-common mariadb-server mariadb-client mariadb-common sudo apt autoremove sudo rm -rf /var/lib/mysql /etc/mysql最后一步删除/var/lib/mysql是很多教程没提的。这个目录是 MySQL 的数据目录删除后相当于把所有数据库文件都清了。如果你确定这是一台全新的、不需要保留旧数据的机器那删了干净重启装新版本不会有任何干扰如果里面有数据这步千万别执行后面我会专门讲怎么保留数据升级。1.3 确认 APT 源可用性Ubuntu 默认自带的apt源里就有 MySQL 8.0但版本不一定是最新的。以 Ubuntu 22.04 为例默认源里是8.0.x系列对大部分场景够用但如果你需要最新的小版本修复或特定特性建议直接用 MySQL 官方 APT 源。先确认当前系统默认源可用sudo apt update apt-cache policy mysql-serverapt-cache policy输出里带Candidate: 8.0.x就说明默认源有 MySQL 8。这里有个经验如果只是本地开发、测试环境直接默认源装就行省事如果是生产环境或者需要特定版本往下去用官方源。2. 三种安装方式对比与核心操作2.1 方案一默认 APT 源安装最快既然确认了系统默认源里有 MySQL 8那就先介绍最简单的方式。直接在终端执行sudo apt update sudo apt install mysql-server -y装完后执行mysql --version正常会输出类似mysql Ver 8.0.35-0ubuntu0.22.04.1 for Linux on x86_64说明安装成功。这种方式的优点是快、稳apt 帮你处理了依赖关系适合对版本没有特殊要求的场景。缺点我刚才提过默认源里的版本落后于官方仓库且可能不包含最新性能优化。这种方式装完MySQL 服务会自动启动检查一下sudo systemctl status mysql如果看到active (running)就说明核心安装完成。接下来的初始密码和配置我会在第 3 节统一讲因为这三种方式的初始配置是有些差异的。2.2 方案二MySQL 官方 APT 仓库生产推荐生产环境我给的建议是挂官方源这样能在第一时间拿到 MySQL 8 的最新小版本比如 8.0.36、8.0.37 等尤其是安全补丁这个很重要。步骤也不复杂。先下载并安装官方仓库配置包。官网的下载地址是https://dev.mysql.com/downloads/repo/apt/但我更习惯直接命令行搞定cd /tmp wget https://dev.mysql.com/get/mysql-apt-config_0.8.29-1_all.deb sudo dpkg -i mysql-apt-config_0.8.29-1_all.debdpkg -i执行后会弹出一个蓝底配置界面让你选择要安装的 MySQL 版本。如果你只需要 MySQL Server 8.0把MySQL Server Cluster那一项选成mysql-8.0然后选Ok确定即可。这个界面第一次操作的人可能会懵我分享一个技巧直接在界面上按Tab键切换到Ok回车即可不需要改其他默认选项。配好仓库后更新并安装sudo apt update sudo apt install mysql-server -y官方源装出来的 MySQL 版本号会和默认源不一样我碰到的情况是官方源至少领先默认源一个小版本。而且官方包在安全和性能方面通常有更完整的配置模板。但要注意一点官方 APT 仓库的包在安装过程中会要求你设置 root 密码而 Ubuntu 默认源的包安装时不会弹这个界面这点直接影响首次登录方式后面详细说。2.3 方案三tar 包手动部署不推荐但有必要了解第三种方式是下载官方 tar 包手动部署这种方式最灵活可以放进任意目录、自定义所有路径适合做多实例或对目录结构有特殊要求的场景。但这方式配置繁琐、依赖处理麻烦我个人不推荐新手在生产环境用。如果你确实要用核心步骤如下。首先下载 tar 包wget https://dev.mysql.com/get/Downloads/MySQL-8.0/mysql-8.0.39-linux-glibc2.28-x86_64.tar.xz sudo tar -xvf mysql-8.0.39-linux-glibc2.28-x86_64.tar.xz -C /usr/local/ sudo mv /usr/local/mysql-8.0.39-linux-glibc2.28-x86_64 /usr/local/mysql然后创建 MySQL 用户和组sudo groupadd mysql sudo useradd -r -g mysql -s /bin/false mysql sudo mkdir -p /var/lib/mysql sudo chown -R mysql:mysql /var/lib/mysql初始化数据目录这一步非常关键8.0 的初始化命令和 5.7 完全不同sudo /usr/local/mysql/bin/mysqld --initialize --usermysql --basedir/usr/local/mysql --datadir/var/lib/mysql这条命令执行完会输出一条初始 root 密码类似于[Note] A temporary password is generated for rootlocalhost: kX7s!aP2bQ这个密码只显示一次一定要立刻记下来后面首次登录用。网上很多 5.7 时代的教程让你用mysqld --initialize-insecure来生成空密码8.0 默认不支持空密码初始化除非显式加参数新手照着老教程操作往往会卡在登录这步。最后是启动。tar 包方式安装的 MySQL 默认不会注册 systemd 服务要么手动调用mysqld_safe启动sudo /usr/local/mysql/bin/mysqld_safe --usermysql 要么写一个 systemd 服务单元。这部分篇幅比较长如果你用的是前两种方式装没必要看只有真走到 tar 包这步才需要深入了解。我的观点是能用 apt 就用 apttar 包留给那些有洁癖、非得把所有东西装到指定目录的人。3. 安装后的首次登录、密码配置与安全加固这一节是最容易翻车的部分因为 MySQL 8 的初始密码规则、认证插件机制和 5.7 完全不一样。不管前面用了哪种安装方式装完后都必须走一遍这里的流程。3.1 首次登录与密码修改先说默认源apt install mysql-server装出来的情况。Ubuntu 的 MySQL 8 包默认用的是auth_socket认证插件意思是你用系统 root 用户直接登录 MySQL 的 root 账号时不需要密码。这个设计是为了本地方便但对远程连接和程序访问不友好需要改成caching_sha2_password认证。首次登录sudo mysql进入 MySQL 命令行后先看当前用户认证方式SELECT user, host, plugin FROM mysql.user WHERE userroot;大概率输出里plugin是auth_socket。这时候修改 root 密码并切换认证插件ALTER USER rootlocalhost IDENTIFIED WITH caching_sha2_password BY 你的新密码; FLUSH PRIVILEGES; EXIT;这里有个重要提醒MySQL 8 默认密码策略要求密码至少 8 位并且包含大小写字母、数字和特殊字符。如果你设置简单密码比如123456会直接报ERROR 1819,说密码不满足策略。有些同学想绕开这个策略图省事我建议千万别在生产环境这么干后边数据泄露了追悔莫及。测试环境实在要绕过可以这样临时降低策略级别SET GLOBAL validate_password.policy LOW; SET GLOBAL validate_password.length 4;注意这是validate_password.policy不是 5.7 时代的validate_password_policy两者名字不同8.0 改成了点号格式。如果是官方 APT 源装出来的安装过程中已经让你设过 root 密码了直接登录即可mysql -u root -p然后输入密码不用再走 auth_socket 的改动其他配置照旧。3.2 创建专用账号并授权生产环境我强烈建议不要直接用 root 账号跑业务而是建一个专用账号权限最小化。这是我从一次事故里学到的教训——之前有个项目拿 root 账号给前端连数据库后来前端代码被注入了一条DROP DATABASE整个库没了备份都沒恢复回来。最小权限原则不是说说而已。创建账号并授权的语法CREATE USER app_userlocalhost IDENTIFIED BY 你的强密码; GRANT SELECT, INSERT, UPDATE, DELETE ON app_db.* TO app_userlocalhost; FLUSH PRIVILEGES;如果应用部署在另一台机器上需要把这台机的 IP 换上CREATE USER app_user192.168.10.20 IDENTIFIED BY 你的强密码; GRANT SELECT, INSERT, UPDATE, DELETE ON app_db.* TO app_user192.168.10.20;注意后面的部分写的是客户端来源 IP不是 MySQL 所在服务器的 IP。很多新手搞反了授权后连不上又找不到原因。3.3 远程访问配置MySQL 8 默认只监听本机回环地址127.0.0.1要允许远程连接必须修改配置文件。先找到配置文件位置sudo mysql --help | grep -A 1 Default options输出结果里my.cnf一般在/etc/mysql/my.cnf然后编辑sudo vim /etc/mysql/mysql.conf.d/mysqld.cnf找到这行bind-address 127.0.0.1把它改成bind-address 0.0.0.0然后重启服务sudo systemctl restart mysql这里有个细节要强调修改完后检查一下系统防火墙和云平台安全组。Ubuntu 自带的ufw如果开着要放行 3306 端口sudo ufw allow 3306/tcp如果你用的是阿里云、腾讯云之类的云主机还得在控制台的安全组里加一条入方向规则放行 3306。我帮别人排障时最常遇到的就是MySQL 配置全对、服务正常、本地能连但远程死活连不上最后发现是云平台安全组没放行——这个是排查顺序里最容易忽略的。3.4 使用 mysql_secure_installation 加固MySQL 8 提供了一个安全加固脚本交互式地帮你完成几项基础安全设置。强烈建议装完就执行sudo mysql_secure_installation脚本会依次问这几个问题是否设置验证密码组件VALIDATE PASSWORD COMPONENT选y按需选密码策略级别。是否修改 root 密码如果你已经改过了选n就行。是否删除匿名用户必须y否则局域网能免密试探登录这很危险。是否禁止 root 远程登录生产环境选y。是否删除 test 测试库选y。是否重新加载权限表选y。这几个问题里我认为删除匿名用户是绝对不要省的匿名用户在默认安装里是存在的不删除等于对外开了一个没有密码的账号。测试库虽然风险没那么高但留着也没意义删掉为佳。4. 配置调优与常用运维操作装完、能连上只是第一步真正要让 MySQL 8 稳定高效跑业务还需要按照机器的配置做适配。以下是基于我实际调试经验整理的参数建议。4.1 核心内存参数调整思路MySQL 8 和 5.7 最大的区别之一就是内存管理机制更复杂Buffer Pool、Redo Log、Undo 表空间都更吃资源。以一台 4 核 8G 内存的服务器为例我的建议是innodb_buffer_pool_size 2G innodb_log_file_size 512M innodb_flush_log_at_trx_commit 1 max_connections 200innodb_buffer_pool_size一般是物理内存的 30%~50%8G 内存取 2G~4G 都合理。如果你的服务器还要跑 Web 服务、缓存等宁愿取小一点给其他程序留余量。innodb_log_file_size在 8.0 里可以在线调整但重启生效一般从 48M 的默认值调到 256M~512M 能明显提升写入性能。有些人上来无脑把max_connections调到 1000觉得并发高就得多开连接其实连接数越多系统线程切换和内存占用越严重。我处理过很多次“MySQL 连接数打满”的故障最后发现多半是业务方连接没释放、慢查询堆积导致的不是连接数不够。调参数前先看SHOW PROCESSLIST;看清楚连接都在干什么。4.2 字符集与排序规则MySQL 8 默认字符集是utf8mb4排序规则是utf8mb4_0900_ai_ci比以前的utf8mb4_general_ci更规范。但要注意如果你的老库是从 5.7 迁移上来的字符集可能还是utf8实际是utf8mb3这时候建议改库表字符集否则遇到中文、emoji 等字符可能出现乱码或存不进去。查看当前字符集SHOW VARIABLES LIKE character%;修改库的字符集ALTER DATABASE app_db CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;修改表的字符集ALTER TABLE app_table CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;对已有数据的表做这个操作时会重写整张表表越大耗时越长建议业务低峰期执行。曾经有个项目 5000 万行的日志表我执行ALTER TABLE CONVERT花了将近半小时期间业务写入都堵住了。所以大表改字符集务必提前预估耗时。4.3 systemd 管理 MySQL 的常用命令安装完成后你需要掌握的日常运维命令并不多核心就这几个sudo systemctl start mysql # 启动 sudo systemctl stop mysql # 停止 sudo systemctl restart mysql # 重启 sudo systemctl status mysql # 查看状态 sudo systemctl enable mysql # 设置开机自启Ubuntu 上默认安装的 MySQL 服务名是mysql但偶尔有些版本的服务名是mysqld。如果systemctl status mysql报错说找不到单元就拿mysqld试一下或者用ls /etc/systemd/system | grep mysql找具体的服务名。另外一个实用的技巧是查看错误日志。MySQL 8 的错误日志默认在/var/log/mysql/error.log服务起不来、密码初始化失败、端口被占等问题日志里都会有明确记录。排查顺序永远是先看错误日志再调参数别瞎猜。sudo tail -n 100 /var/log/mysql/error.log5. 常见故障与避坑方案这部分是这篇文章里我倾注最多经验的内容。下面每个坑都来自我亲身经历或者身边同事踩过的现场按发生频率排序。5.1 root 密码忘了怎么办几乎是历史上被问最多的问题。操作步骤分三步sudo systemctl stop mysql然后以跳过授权表的方式启动 MySQLsudo mkdir -p /var/run/mysqld sudo chown mysql:mysql /var/run/mysqld sudo mysqld_safe --skip-grant-tables 或者编辑配置文件/etc/mysql/mysql.conf.d/mysqld.cnf在[mysqld]段下面加一行skip-grant-tables然后systemctl start mysql。我更喜欢用mysqld_safe的方式因为不用改配置文件改完还要记得删掉那行很容易忘。接着进入 MySQLmysql -u root执行修改FLUSH PRIVILEGES; ALTER USER rootlocalhost IDENTIFIED WITH caching_sha2_password BY 新密码; FLUSH PRIVILEGES; EXIT;最后重启 MySQL 恢复正常模式。这里有两个容易翻车的细节第一FLUSH PRIVILEGES必须先执行否则ALTER USER可能报权限不足第二结束之后别忘了把临时加的skip-grant-tables删掉或者把mysqld_safe进程 kill 干净否则数据库处于裸奔状态相当危险。5.2 认证插件导致客户端连不上5.7 时代的认证插件是mysql_native_password默认端口 3306很多旧客户端比如 PHP 5.6、MySQL Connector/J 5.x不支持caching_sha2_password就会报错Authentication plugin caching_sha2_password cannot be loaded解决方案有三种第一升级客户端驱动到支持 MySQL 8 的版本。这是最推荐的方案长期来看必须做。第二兼容性调整把用户的认证插件改回老格式ALTER USER app_user% IDENTIFIED WITH mysql_native_password BY 密码;注意 MySQL 8.0.34 之后的版本实测仍支持mysql_native_password但官方已经在逐步弱化它MySQL 9 彻底移除了。所以这只能当临时方案。第三老项目实在没法升驱动可以在配置文件和启动参数里加上default_authentication_pluginmysql_native_password但该参数在 8.0 高版本里逐渐被废弃建议还是尽早升级应用侧依赖。我常说技术债越早还利息越低认证插件这事就是典型。5.3 安装时卡在dpkg configure界面用官方 APT 源安装时过程中会弹蓝底界面这是 Debconf 在等待输入。如果无人值守或者脚本部署会卡住。解决办法是在命令前面加上环境变量跳过sudo DEBIAN_FRONTENDnoninteractive apt install mysql-server -y这个参数会强制所有安装过程不再弹出交互界面所有配置项用默认值。装完后再手动调整配置适合自动化部署脚本场景。线上环境我觉得用noninteractive是对的防止部署过程中有人误操作。5.4 端口被占用导致启动失败启动 MySQL 时报错bind() failed或者看日志有Address already in use一般是 3306 端口被别的程序占了。先找出占用端口的进程sudo lsof -i :3306 sudo ss -lntp | grep 3306常见的占用情况有两种一种是之前残留的 MySQL 实例没停掉用ps -ef | grep mysql查一下。如果是残留进程直接 kill 掉sudo pkill mysqld sudo systemctl start mysql另一种是另一个数据库服务比如 MariaDB、PostgreSQL 改了端口占用了。这种情况下需要先停掉那个服务或者把 MySQL 的端口改了在配置文件里用port 3307我不建议随便改端口因为很多云安全组和防火墙规则默认只放行 3306改了端口还得一起改防火墙排查面扩大得不偿失。优先解决占用问题。5.5 数据目录权限错误有时候会看到日志报错Cannot open file /var/lib/mysql/ibdata1或者Operating system error number 13这是文件权限不对。一般发生在用 tar 包手动安装时没处理好 owner或者系统里多个 MySQL 版本的残留目录互相干扰。修复方法sudo chown -R mysql:mysql /var/lib/mysql sudo systemctl restart mysql这里有个细节/var/lib/mysql目录里的文件如果权限错了仅 chown 目录本身不够必须加-R同时递归修改子文件。有个同事当时就是漏了-R重启二十多次都失败最后发现权限其实没有彻底改到位。5.6 配置了远程访问但连不上这个问题发生频率极高我单独拎出来讲。按照远程连不上的排查顺序逐项检查排查步骤命令/操作常见原因服务是否运行sudo systemctl status mysql服务没启动监听地址是否改对ss -lntp | grep 3306仍监听 127.0.0.1防火墙是否放行sudo ufw statusufw 拦截云安全组是否放行云控制台查看安全组未配置用户有没有远程权限SELECT user, host FROM mysql.user;host 还是 localhost我遇到的一个真实案例用户改了bind-address重启了服务用ss看到监听地址也变成0.0.0.0了ufw也放行了但远程还是连不上。最后查出来是云平台安全组默认拒绝所有外部访问 3306加了一条放行规则后秒通。这教训是云端环境的网络栈永远比本地多一层别忽略那一层。6. 备份与恢复基础装完数据库、配好业务下一步就是备份策略。没有备份的数据库等于在悬崖边上走钢丝。6.1 用 mysqldump 做逻辑备份最简单的备份工具是mysqldump逻辑备份的意思是导出 SQL 语句而不是直接拷贝数据文件。基础命令mysqldump -u root -p --all-databases /backup/all_databases_$(date %F).sql如果只备份某个库mysqldump -u root -p app_db /backup/app_db_$(date %F).sql恢复也简单mysql -u root -p /backup/app_db_2025-01-01.sql这里有一个关键点mysqldump导出的 SQL 默认不含创建数据库语句恢复前需要先手动建好库mysql -u root -p -e CREATE DATABASE app_db CHARACTER SET utf8mb4如果你希望备份文件里自带CREATE DATABASE语句用mysqldump -u root -p --databases app_db /backup/app_db_$(date %F).sql多一个--databases参数恢复时就不用先建库了。这个细节容易忽略但在恢复紧急故障时能省下几分钟。6.2 使用 cron 定时备份手工备份容易忘我习惯用cron搞一个每天凌晨的自动备份。编辑 crontabcrontab -e加入一行0 2 * * * /usr/bin/mysqldump -u root -p密码 --all-databases /backup/all_$(date \%F).sql 2/backup/error_$(date \%F).log密码直接写在 crontab 里有安全隐患生产环境更稳妥的做法是配置~/.my.cnf内容为[mysqldump] userroot password你的密码然后 crontab 里不用再写账号密码mysqldump会自动读取家目录下的配置文件0 2 * * * /usr/bin/mysqldump --all-databases /backup/all_$(date \%F).sql注意~/.my.cnf的权限必须限制为当前用户可读写否则 mysql 客户端会忽略甚至报警chmod 600 ~/.my.cnf6.3 备份的验证“备份是拿来恢复的不是拿来安慰自己的。”这句话是我自己的座右铭。定期备份之后至少要每季度做一次恢复演练找个测试机器把备份文件导进去确认数据完整可用。我处理过一次事故客户一直坚信有自动备份结果数据库宕机准备恢复时才发现备份脚本因为磁盘满了已经静默失败了一个月最后只能拿一个月前的备份去恢复中间业务数据全丢了。从那以后我把备份验证列为和备份本身同等重要的事情。7. 写在最后的几点经验MySQL 8 在 Ubuntu 上的安装本身并不复杂真正复杂的是安装完之后的配置、权限、安全、备份这些“看不见”的部分。我个人在多次实操当中最深的体会是先想清楚场景再动手装。测试环境怎么方便怎么来生产环境则每一项配置都要有据可依每一步改动都要知道为什么。如果你是从 MySQL 5.7 升上来的老用户对 8.0 的认证插件、密码策略和初始参数变化要有心理准备这些变化本质上都是朝着更安全的方向走的虽然刚开始会觉得不适应但适应之后会发现确实更规范。最后分享一个小技巧装完 MySQL 8 之后别急着立刻扔业务数据进去先用sysbench做一轮简单的读写压测确认当前机器配置下的性能基线。压测结果不仅能验证安装是不是正常还能帮你在将来出现性能问题时有一个对比的基准。sudo apt install sysbench -y sysbench --db-drivermysql --mysql-userroot --mysql-password你的密码 --mysql-host127.0.0.1 --mysql-port3306 --tables10 --table-size100000 oltp_read_write run这个测试跑完后记录一下 TPS、QPS、延迟这几个数字以后数据库变慢了跑同样的压测对比数据就能快速定位是不是配置变更、参数调整引起的问题。这比盲目调优靠谱得多。Ubuntu 上装 MySQL 8 的完整流程到这里就结束了。装库这事一次能成不难难的是遇到问题知道去哪查、为什么这样改。希望这篇文章里的经验能帮你少走弯路。