MySQL 环境配置教程:CentOS 7 与 Ubuntu 安装指南
在 CentOS 7 和 Ubuntu 系统下安装配置 MySQL 环境的完整步骤。内容包括卸载冲突的 MariaDB 服务、配置官方软件源、安装 MySQL 服务端、初始化 root 密码、优化编码与存储引擎设置,以及开启远程访问权限。通过分步命令指导,帮助开发者解决不同 Linux 发行版下的环境搭建问题,确保数据库正常运行并支持中文及远程连接。

在 CentOS 7 和 Ubuntu 系统下安装配置 MySQL 环境的完整步骤。内容包括卸载冲突的 MariaDB 服务、配置官方软件源、安装 MySQL 服务端、初始化 root 密码、优化编码与存储引擎设置,以及开启远程访问权限。通过分步命令指导,帮助开发者解决不同 Linux 发行版下的环境搭建问题,确保数据库正常运行并支持中文及远程连接。

作为后端开发、数据库学习的入门必备,MySQL 的环境配置是许多开发者面临的第一道关卡。不同 Linux 发行版(如 CentOS 7、Ubuntu)的安装步骤存在差异,且系统自带 MariaDB 的干扰、密码策略限制、中文编码等问题容易引发配置错误。
本文提供 MySQL 环境配置指南,详细拆解 CentOS 7 下的完整安装步骤(从卸载冲突环境到配置优化),并补充了 Ubuntu 系统的安装流程,命令可直接复制使用。
MySQL 被 Oracle 收购后,很多 Linux 发行版会默认预装 MariaDB——它是 MySQL 的分支,语法兼容但底层有差异,会和官方 MySQL 产生端口、配置文件的冲突。因此,安装 MySQL 前必须彻底卸载 MariaDB,这是配置成功的关键第一步。
本文中所有操作优先使用 root 用户执行(普通用户需加 sudo 获取权限),初期学习阶段建议直接用 MySQL root 用户操作,后续熟悉用户管理后再创建普通用户即可。
本次 CentOS 7 环境安装的是 MySQL 5.7 版本(兼容性强、学习常用),全程通过官方 YUM 源安装,稳定无第三方依赖问题。步骤分为卸载冲突环境→配置官方 YUM 源→安装 MySQL→初始化配置→优化设置五大环节。
首先查看系统中是否有 MariaDB 进程在运行,有则立即停止,避免卸载时出现资源占用报错:
# 检查 MariaDB 进程
ps aux | grep mariadb
# 停止 MariaDB 服务
systemctl stop mariadb.service
# 再次检查,确认无相关进程
ps aux | grep mariadb
通过 rpm 命令查询系统中已安装的 MariaDB/MySQL 相关包,然后逐一卸载:
# 查询 MariaDB 安装包
rpm -qa | grep mariadb
# 查询 MySQL 安装包(若有旧版)
rpm -qa | grep mysql
# 卸载 MariaDB(替换为查询到的包名,也可直接批量卸载)
sudo yum remove mariadb -y
# 若有多个包,可直接通配符卸载
sudo yum remove mariadb* mysql* -y
卸载前建议备份 MySQL/MariaDB 的配置文件和数据目录,防止误删重要内容:
# 备份配置文件
cp /etc/my.cnf /etc/my.cnf.bak
# 备份数据存储目录
cp -r /var/lib/mysql /var/lib/mysql.bak
CentOS 7 默认 YUM 源中没有 MySQL 官方包,需要手动添加官方 YUM 源,建议安装和系统版本匹配的 MySQL 版本,避免兼容性问题。
确认 CentOS 7 的具体版本,保证后续下载的 YUM 源和系统匹配:
cat /etc/redhat-release
输出示例:CentOS Linux release 7.8.2003 (Core)
MySQL 官方 YUM 源地址:http://repo.mysql.com/,我们下载 MySQL 5.7 的 CentOS 7 专属 YUM 源包并安装:
# 下载 MySQL 5.7 YUM 源包
wget http://repo.mysql.com/mysql57-community-release-el7-10.noarch.rpm
# 安装 YUM 源(普通用户加 sudo,解决权限问题)
sudo rpm -Uvh mysql57-community-release-el7-10.noarch.rpm
安装后会在 /etc/yum.repos.d/ 目录下生成 mysql-community.repo 和 mysql-community-source.repo 两个文件,验证如下:
# 查看 YUM 源目录,确认出现 MySQL 相关 repo 文件
ls /etc/yum.repos.d/ | grep mysql
确认 MySQL YUM 源可正常识别,执行如下命令查看可安装的 MySQL 包:
yum list | grep mysql
若输出中出现 mysql-community-server 等包,说明 YUM 源配置成功。
通过 YUM 源安装 MySQL 官方服务端和客户端,-y 参数表示自动确认所有安装选项,无需手动回车:
sudo yum install -y mysql-community-server
安装过程中会自动安装依赖包(mysql-community-common、mysql-community-libs、mysql-community-client),耐心等待即可。
常见坑 1:安装时出现秘钥过期报错,提示
GPG Keys are configured as: file:///etc/pki/rpm-gpg/RPM-GPG-KEY-mysql。 解决方案:导入最新的 MySQL 官方秘钥即可,重新执行安装命令即可成功。
# 启动 MySQL 服务
systemctl start mysqld.service
# 设置开机自启(可选,建议开启,避免重启系统后服务失效)
systemctl enable mysqld
# 重载系统服务配置
systemctl daemon-reload
通过进程查询确认 MySQL 服务正常启动:
ps aux | grep mysqld
若输出中出现 /usr/sbin/mysqld 相关进程,说明服务启动成功。
MySQL 5.7 安装后会自动生成临时 root 密码,存放在 /var/log/mysqld.log 日志文件中,必须先通过临时密码登录,再修改为自定义密码,以下提供 3 种登录方法,按顺序尝试即可。
# 从日志中提取临时 root 密码
sudo grep 'temporary password' /var/log/mysqld.log
输出示例:root@localhost: yLMalT:v+5l*(冒号后为临时密码,复制即可)
# 登录 MySQL,输入上述临时密码
mysql -uroot -p
密码策略限制:MySQL 5.7 默认开启密码强度验证,要求密码包含数字、符号、大小写字母,长度至少 8 位,新手可先关闭该策略,再设置简单密码:
-- 关闭密码强度验证策略(0 为最低,1 为中,2 为高)
set global validate_password_policy=0;
-- 设置密码最小长度为 1 位
set global validate_password_length=1;
-- 修改 root 本地登录密码(替换为自己的密码,示例:[email protected])
ALTER USER 'root'@'localhost' IDENTIFIED BY '[email protected]';
-- 刷新权限,使配置生效
FLUSH PRIVILEGES;
执行完成后,退出 MySQL 重新登录即可使用新密码。
若上述命令未提取到临时密码,说明安装的 MySQL 版本无初始密码,直接执行如下命令登录:
mysql -uroot -p
出现密码输入框时直接回车,即可成功登录,后续按方法 1 修改密码即可。
若前两种方法均失败,可通过修改配置文件跳过 MySQL 权限验证,强制登录后重置密码:
# 编辑 MySQL 主配置文件
vim /etc/my.cnf
在 [mysqld] 节点最后添加如下配置,保存并退出(vim 中按 i 编辑,ESC+:wq 保存):
# 跳过 MySQL 权限验证
skip-grant-tables
# 重启 MySQL 服务,使配置生效
systemctl restart mysqld.service
# 直接登录,无需输入密码
mysql -uroot
登录后执行如下 SQL 重置密码,重置后必须删除 skip-grant-tables 配置并重启服务,否则 MySQL 无权限验证,存在安全风险:
-- 切换到 mysql 系统库
USE mysql;
-- 重置 root 密码(替换为自己的密码)
UPDATE user SET authentication_string=PASSWORD('[email protected]') WHERE User='root' AND Host='localhost';
-- 刷新权限
FLUSH PRIVILEGES;
-- 退出 MySQL
exit;
# 编辑配置文件,删除 skip-grant-tables 配置
vim /etc/my.cnf
# 重启 MySQL 服务
systemctl restart mysqld.service
默认的 MySQL 配置存在中文编码乱码、存储引擎未指定等问题,需要修改 /etc/my.cnf 配置文件,优化核心参数,本次配置 UTF-8 编码和 InnoDB 默认存储引擎(MySQL 主流存储引擎,支持事务、行锁)。
# 编辑配置文件
vim /etc/my.cnf
按如下内容修改,保留原有配置,补充缺失项即可:
[mysql]
# 客户端编码(暂不设置,避免 MySQL 汉字回显 bug,可后续根据需求开启)
# default-character-set=utf8
[mysqld]
# MySQL 端口,默认 3306
port=3306
# 数据存储目录
datadir=/var/lib/mysql
# 套接字文件
socket=/var/lib/mysql/mysql.sock
# 禁用符号链接,防止安全风险
symbolic-links=0
# 日志文件路径
log-error=/var/log/mysqld.log
# 进程文件路径
pid-file=/var/run/mysqld/mysqld.pid
# 服务端编码,UTF-8
character-set-server=utf8
# 默认存储引擎 InnoDB
default-storage-engine=innodb
# InnoDB 缓冲池大小,根据服务器内存调整,专用服务器设为内存 70%,普通服务器 10%
# innodb_buffer_pool_size = 128M
修改完成后,重启 MySQL 服务使配置生效:
systemctl restart mysqld.service
原因:终端本身不支持 UTF-8 编码,而非 MySQL 配置问题。
解决方案:检查终端 LANG 环境变量,确保为 UTF-8 编码:
# 查看 LANG 变量
env | grep LANG
若输出不是 LANG=en_US.utf8,则修改终端编码(永久生效需修改 /etc/profile 文件):
# 临时设置 UTF-8 编码
export LANG=en_US.utf8
# 永久设置,编辑 profile 文件
echo "export LANG=en_US.utf8" >> /etc/profile
# 使配置生效
source /etc/profile
排查思路:查看 MySQL 错误日志,定位具体失败原因:
# 查看错误日志最后 100 行
tail -100 /var/log/mysqld.log
常见原因:端口 3306 被占用、数据目录权限不足、配置文件语法错误,对应解决即可。
Ubuntu 系统(以 20.04/22.04 为例)安装 MySQL 和 CentOS 7 差异较大,Ubuntu 使用 apt 包管理器,且默认预装的 MariaDB 处理方式更简单。本次安装 MySQL 8.0 版本(Ubuntu 官方源中主流版本),步骤分为卸载 MariaDB→更新 apt 源→安装 MySQL→初始化配置→远程访问配置。
# 停止 MariaDB 服务
sudo systemctl stop mariadb
# 卸载 MariaDB 所有包
sudo apt remove mariadb-server mariadb-client mariadb-common -y
# 清理残留配置文件
sudo apt autoremove -y
sudo apt clean
Ubuntu 默认 apt 源包含 MySQL 官方包,直接更新源后安装即可,推荐安装 mysql-server(包含服务端 + 客户端 + 依赖):
# 更新 apt 软件源
sudo apt update && sudo apt upgrade -y
# 安装 MySQL 服务
sudo apt install mysql-server -y
安装过程中无需手动设置密码,Ubuntu 的 MySQL 会自动创建 root 用户并采用 auth_socket 认证方式(仅本地 root 用户可登录,无需密码)。
# 查看 MySQL 服务状态
sudo systemctl status mysql
# 设置开机自启
sudo systemctl enable mysql
若输出中显示 active (running),说明服务启动成功。
Ubuntu 安装的 MySQL 默认不允许密码登录,需要先修改认证方式为 mysql_native_password,再设置密码,步骤如下:
# 以 root 身份登录 MySQL(Ubuntu 本地免密)
sudo mysql -uroot
执行如下 SQL 语句,修改 root 密码并更改认证方式:
-- 切换到 mysql 系统库
USE mysql;
-- 修改 root 认证方式为密码认证,设置密码(替换为自己的密码)
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'MySql@123456';
-- 刷新权限
FLUSH PRIVILEGES;
-- 退出 MySQL
exit;
修改完成后,即可通过密码正常登录:
mysql -uroot -p
输入设置的密码,即可成功登录。
Ubuntu 的 MySQL 主配置文件为 /etc/mysql/mysql.conf.d/mysqld.cnf,编辑该文件优化编码和核心参数:
# 编辑配置文件
sudo vim /etc/mysql/mysql.conf.d/mysqld.cnf
在 [mysqld] 节点添加 / 修改如下配置:
# 服务端编码
character-set-server = utf8mb4
# 排序规则
collation-server = utf8mb4_unicode_ci
# 默认存储引擎
default-storage-engine = InnoDB
# 端口
port = 3306
# 允许远程访问(注释掉 bind-address,默认绑定 127.0.0.1,仅本地可访问)
# bind-address = 127.0.0.1
# 编辑客户端配置文件,设置客户端编码
sudo vim /etc/mysql/conf.d/mysql.cnf
在 [mysql] 节点添加:
default-character-set = utf8mb4
修改完成后,重启 MySQL 服务:
sudo systemctl restart mysql
验证编码配置是否生效:
-- 登录 MySQL 后执行
SHOW VARIABLES LIKE '%character%';
SHOW VARIABLES LIKE '%collation%';
若所有编码项均为 utf8mb4,说明配置成功(utf8mb4 是 UTF-8 的超集,支持 emoji 和特殊中文)。
默认情况下 MySQL 仅允许本地访问,若需要在其他机器上连接 Ubuntu 的 MySQL,需完成配置文件修改 + 权限授权 + 防火墙开放三步,前文已注释掉 bind-address,接下来授权远程访问并开放 3306 端口。
mysql -uroot -p
-- 授权 root 用户从任意 IP 访问(%表示任意 IP,可替换为具体 IP,如 192.168.1.100)
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'MySql@123456' WITH GRANT OPTION;
-- 刷新权限
FLUSH PRIVILEGES;
exit;
Ubuntu 默认使用 ufw 防火墙,开放 3306 端口(TCP 协议,MySQL 默认端口):
# 查看防火墙状态
sudo ufw status
# 开放 3306/TCP 端口
sudo ufw allow 3306/tcp
# 重启防火墙
sudo ufw reload
完成后,即可在本地通过 Navicat、DataGrip 等工具,输入 Ubuntu 服务器 IP、3306 端口、root 账号密码连接 MySQL。
MySQL 的环境配置是基础,掌握不同系统的安装方法,能快速适配各种开发环境。后续可以继续学习 MySQL 的用户管理、数据库设计、SQL 语句优化等内容,打好后端开发的数据库基础。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
在线格式化和美化您的 SQL 查询(它支持各种 SQL 方言)。 在线工具,SQL 美化和格式化在线工具,online
解析 INSERT 等受限 SQL,导出为 CSV、JSON、XML、YAML、HTML 表格(见页内语法说明)。 在线工具,SQL转CSV/JSON/XML在线工具,online
CSV 与 JSON/XML/HTML/TSV/SQL 等互转,单页多 Tab。 在线工具,CSV 工具包在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online