MariaDB 安装与配置指南

一、MariaDB 简介

MariaDB 是 MySQL 的一个开源分支，完全兼容 MySQL 并提供更丰富的功能。它广泛用于 Web 应用（如 WordPress、Drupal）和数据处理场景。安装前请确保：

系统具备管理员权限（如 sudo 权限或 Windows 管理员账户）。
网络通畅（用于下载包或安装程序）。

二、Linux 系统安装（以 Ubuntu/Debian 和 Red Hat/CentOS 为例）

步骤 1：更新软件包列表

安装前先更新系统包索引，确保获取最新版本：

Debian/Ubuntu：
```
sudo apt update
```

Red Hat/CentOS/Fedora：

sudo yum update  # 或 dnf update（新版本 Fedora/CentOS）

步骤 2：安装 MariaDB 服务器

通过包管理器一键安装：

Debian/Ubuntu：
```
sudo apt install mariadb-server
```

Red Hat/CentOS/Fedora：

sudo yum install mariadb-server  # 或 dnf install mariadb-server

步骤 3：安全配置

安装后务必运行安全脚本，设置 root 密码、移除匿名用户并禁用远程 root 登录：

sudo mysql_secure_installation

按提示完成以下配置：

设置强密码（建议长度 ≥12 字符，含数字、大小写字母和符号）。
移除匿名用户（选择 Y）。
禁止 root 远程登录（生产环境必选）。
删除测试数据库（可选）。
重新加载权限表。

步骤 4：启动并验证服务

MariaDB 通常自动启动，手动管理方式如下：

检查状态：
```
sudo systemctl status mariadb
```
启动服务（若未运行）：
```
sudo systemctl start mariadb
```
设置开机自启：
```
sudo systemctl enable mariadb
```

步骤 5：测试连接

使用 root 用户登录验证安装：

mysql -u root -p

输入密码后，若看到 MariaDB [(none)]>提示符，说明安装成功。

三、Windows 系统安装

步骤 1：下载安装程序

访问 MariaDB 下载页面，选择最新 .msi安装包。

步骤 2：运行安装向导

双击 .msi文件，启动安装向导。
接受许可协议，选择安装路径（默认即可）。
设置 root 用户密码（务必使用强密码）。
配置端口（默认 3306）和字符集（建议选 UTF8）。
将 MariaDB 设为系统服务（推荐勾选）。

步骤 3：完成安装

安装后，可通过命令行或工具（如 HeidiSQL）连接。打开命令提示符，输入：

mysql -u root -p

四、安装后必备配置

1. 防火墙设置

若需远程访问，开放默认端口 3306：

Linux（ufw）：
```
sudo ufw allow 3306/tcp
```
Windows：在“防火墙高级设置”中添加入站规则。

2. 配置文件调整

生产环境需编辑配置文件优化性能：

Linux：/etc/mysql/my.cnf
Windows：C:\Program Files\MariaDB\data\my.ini
常见调整项：内存分配、日志路径、字符集。

五、连接测试与基本操作

本地连接示例

使用命令行客户端（参数含义见注释）：

mysql -h localhost -u root -p

-h：主机（默认 localhost）
-u：用户名
-p：提示输入密码（安全建议：勿在命令中直接写密码，如 -p123）。

创建测试数据库

登录后执行：

CREATE DATABASE test_db;
USE test_db;

若成功，说明服务运行正常。

六、常见问题排查（基于官方故障排除指南）

1. 错误 "Can't connect to local server"

原因：服务未启动或配置冲突。
解决：
- 检查服务状态：sudo systemctl status mariadb（Linux）或服务管理器（Windows）。
- 验证配置文件中的 socket 路径是否一致（Linux 下查看 /etc/mysql/my.cnf的 [mysqld]和 [client]部分）。

2. 远程连接被拒绝

原因：默认绑定地址为 127.0.0.1，仅允许本地访问。

解决：

编辑配置文件，将 bind-address改为 0.0.0.0。

创建远程用户：

CREATE USER 'username'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON *.* TO 'username'@'%';
FLUSH PRIVILEGES;

3. 忘记 root 密码

步骤（谨慎操作）：
1. 停止服务：sudo systemctl stop mariadb。
2. 启动并跳过权限检查：mysqld --skip-grant-tables。
3. 无密码登录后重置密码：
```
FLUSH PRIVILEGES;
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('new_password');
```
4. 重启服务。

4. 权限不足错误（如 "Access denied"）

确保用户有对应数据库权限：使用 GRANT命令授权，例如：
```
GRANT SELECT, INSERT ON database_name.* TO 'user'@'host';
```

七、总结

通过本教程，您应已成功安装 MariaDB 并完成基础配置。关键要点：

安全第一：始终设置强密码并运行 mysql_secure_installation。
按需配置：生产环境需调整防火墙和性能参数。
遇到问题时，参考故障排除指南或社区资源。

下一步可学习 SQL 基础或备份策略。如有疑问，欢迎在评论区留言！

版权说明：本教程内容基于 MariaDB 官方文档，采用 CC BY-SA 许可。