Ubuntu24上MySQL安装指南
本文介绍在Ubuntu环境中通过APT包管理器安装mysql-server、MySQL开发包,处理最新版本MySQL自动生成的初始账号密码,包含Ubuntu官方仓库 和MySQL官方仓库两种安装方法,同时讲解密码修改、远程访问配置及常见问题排查。
方法一:使用Ubuntu官方仓库安装
步骤一:更新系统包列表
确保系统包列表为最新状态:
Bash
sudo apt update
sudo apt upgrade -y
步骤二:安装 MySQL Server
通过APT安装MySQL服务器及相关依赖:
Bash
sudo apt install -y mysql-server
步骤三:安装 MySQL 开发包
安装包含头文件和动态库的开发包,用于MySQL相关开发:
Bash
sudo apt install -y libmysqlclient-dev
步骤四:启动并配置 MySQL 服务
- 启动MySQL服务
Bash
sudo systemctl start mysql
- 设置开机自启动
Bash
sudo systemctl enable mysql
- 检查服务运行状态
Bash
sudo systemctl status mysql
正常运行输出示例:
Plain
● mysql.service - MySQL Community Server
Loaded: loaded (/lib/systemd/system/mysql.service; enabled; vendor preset: enabled)
Active: active (running) since ...
步骤五:处理初始自动生成的用户名和密码
最新版本MySQL会为root用户自动生成临时密码,需找到并修改:
- 查找临时密码:临时密码记录在日志文件中,执行命令提取:
Bash
sudo grep 'temporary password' /var/log/mysql/error.log
输出示例:
Plain
[Date Time] [Note] A temporary password is generated for root@localhost: xXxXxXxXxXx
记下输出中的临时密码。
- 运行安全性脚本:官方脚本可提升MySQL安全性并修改初始密码,执行:
Bash
sudo mysql_secure_installation
交互步骤(建议全部选择Y):
Plain
Enter password for user root: # 输入上述临时密码
You must change the password now (y/N)? Y # 立即修改密码
New password: # 设置强密码
Re-enter new password: # 重复强密码
Password updated successfully!
Remove anonymous users? (Y/n) Y # 移除匿名用户
Disallow root login remotely? (Y/n) Y # 禁止root远程登录
Remove test database and access to it? (Y/n) Y # 移除测试数据库
Reload privilege tables now? (Y/n) Y # 重新加载权限表
步骤六:修改root初始密码(手动方法)
若需手动修改密码,按以下步骤操作:
- 登录MySQL
Bash
sudo mysql -u root -p
- 执行密码修改命令(替换
YourNewStrongPassword!为自定义强密码)
SQL
ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourNewStrongPassword!';
FLUSH PRIVILEGES; # 刷新权限使修改生效
#ALTER USER 'root'@'localhost' IDENTIFIED BY 'Cybstar@2026';
- 验证密码:退出后重新登录,确认新密码可用
Bash
exit
sudo mysql -u root -p # 输入新密码登录
忘记root密码的重置方法
- 停止MySQL服务
Bash
sudo systemctl stop mysql
- 以安全模式启动MySQL(跳过权限验证)
Bash
sudo mysqld_safe --skip-grant-tables &
- 免密登录MySQL
Bash
sudo mysql -u root
- 重置密码并刷新权限(替换
YourNewStrongPassword!为新密码)
SQL
FLUSH PRIVILEGES;
ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourNewStrongPassword!';
FLUSH PRIVILEGES;
EXIT;
- 停止安全模式进程并重启MySQL
Bash
sudo killall mysqld
sudo systemctl start mysql
- 用新密码登录验证
Bash
sudo mysql -u root -p
步骤七:验证安装
- 登录MySQL后,执行版本查询命令,确认安装成功:
SQL
SELECT VERSION();
执行后会输出当前MySQL的版本信息。
步骤八:配置防火墙(可选)
若需通过网络访问MySQL,需开放3306端口(UFW防火墙):
- 开放端口(二选一)
Bash
# 方式1:直接允许MySQL服务
sudo ufw allow 'MySQL'
# 方式2:精准允许3306/TCP端口
sudo ufw allow 3306/tcp
- 重新加载防火墙规则
Bash
sudo ufw reload
注意:为提升安全性,建议仅允许受信任的IP地址访问3306端口。
方法二:使用MySQL官方仓库安装最新版本
若需安装MySQL最新版本,使用MySQL官方提供的APT仓库,步骤一至三为专属操作,后续步骤同方法一。
步骤一:下载并添加MySQL APT仓库
- 下载官方APT仓库配置包(建议前往MySQL APT Repository确认最新版本)
Bash
wget https://dev.mysql.com/get/mysql-apt-config_0.8.26-1_all.deb
- 安装配置包,安装中会弹出版本选择界面,选择所需MySQL版本(如8.0)后确认
Bash
sudo dpkg -i mysql-apt-config_0.8.26-1_all.deb
- 更新系统包列表
Bash
sudo apt update
步骤二:安装 MySQL Server
Bash
sudo apt install -y mysql-server
步骤三:安装 MySQL 开发包
Bash
sudo apt install -y libmysqlclient-dev
步骤四至八
参考方法一 的步骤四到步骤八,完成服务启动、密码配置、安全性设置、安装验证和防火墙配置。
附加步骤:配置MySQL远程访问(可选)
若需从远程主机访问MySQL服务器,需完成以下配置(注意:远程访问存在安全风险,建议仅对受信任IP开放):
步骤一:修改MySQL配置文件,允许监听外网
- 编辑配置文件
Bash
sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf
- 找到
bind-address行,将本地监听改为全网监听
Plain
# 原配置
bind-address = 127.0.0.1
# 修改后
bind-address = 0.0.0.0
- 保存并退出(
Ctrl + O保存,Ctrl + X退出)
步骤二:重启MySQL服务使配置生效
Bash
sudo systemctl restart mysql
```### 步骤三:创建远程访问专用用户
**不建议直接使用root用户远程访问**,创建专用用户并授予权限(替换`username`和`password`为自定义账号密码):
1. 登录MySQL
```Bash
sudo mysql -u root -p
- 创建用户并授予所有权限
SQL
CREATE USER 'username'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON *.* TO 'username'@'%' WITH GRANT OPTION;
FLUSH PRIVILEGES;
说明 :%表示允许该用户从任意IP访问,若需限制特定IP,将%替换为具体IP(如192.168.1.100)。
步骤四:配置防火墙开放3306端口
- 开放端口
Bash
sudo ufw allow 3306/tcp
- 限制特定IP访问(推荐,替换
<your_ip_address>为允许的IP)
Bash
sudo ufw allow from <your_ip_address> to any port 3306
- 重新加载防火墙
Bash
sudo ufw reload
常见问题排查
1. 无法启动MySQL服务
- 查看错误日志定位问题
Bash
sudo journalctl -u mysql
- 检查配置文件是否存在语法错误;
- 确认3306端口未被其他服务占用。
2. 无法连接到MySQL服务器
- 检查MySQL服务是否正常运行
Bash
sudo systemctl status mysql
- 确认防火墙已开放3306端口;
- 验证MySQL账号密码正确,且用户有对应访问权限;
- 远程连接需确认
bind-address已改为0.0.0.0,且远程用户权限配置正确。
3. 安装libmysqlclient-dev后仍提示找不到头文件
- 确认开发包安装成功
Bash
dpkg -l | grep libmysqlclient-dev
- 检查头文件路径是否正确(默认路径:
/usr/include/mysql/); - 编译时手动指定头文件和库文件路径,示例:
Bash
# 编译时添加参数
-I/usr/include/mysql -L/usr/lib/mysql
4. 忘记root密码
参考方法一·步骤六中的「忘记root密码的重置方法」,通过安全模式重置密码。