MariaDB 安装与 WordPress 集成指南

本指南适用于基于 Debian/Ubuntu 的 Linux 发行版，详细介绍了 MariaDB 数据库的安装、配置以及与 WordPress 的集成过程。以下内容经过优化，确保步骤清晰、准确，并提供额外细节以提升用户体验。

安装过程

更新软件包列表

在安装 MariaDB 之前，需确保系统软件包列表为最新版本，以获取最新的软件包和依赖项。运行以下命令：

sudo apt update

提示： 如果需要获取更新的软件源，可以运行 sudo apt upgrade 来更新已安装的软件包，但请注意备份重要数据以防意外。

安装 MariaDB

使用以下命令安装 MariaDB 服务器和客户端组件。服务器提供数据库功能，客户端用于管理数据库：

sudo apt install mariadb-server mariadb-client

安装过程会自动下载并配置 MariaDB 的最新稳定版本（基于您的系统版本，可能为 MariaDB 10.5 或更高版本）。

验证 MariaDB 服务状态

安装完成后，检查 MariaDB 服务是否正常运行，以确保安装成功：

sudo systemctl status mariadb

如果服务正常运行，输出中将包含 active (running) 状态，示例如下：

● mariadb.service - MariaDB 10.5.28 database server
   Loaded: loaded (/lib/systemd/system/mariadb.service; enabled; vendor preset: enabled)
   Active: active (running) since Fri 2025-07-11 12:00:00 UTC; 1min ago

常用服务管理命令：

启动服务：sudo systemctl start mariadb
重启服务：sudo systemctl restart mariadb
设置开机自启：sudo systemctl enable mariadb
停止服务：sudo systemctl stop mariadb

提示： 如果服务未运行，可尝试使用 sudo systemctl start mariadb 启动服务，并检查错误日志以排查问题。

配置 MariaDB

为增强安全性，MariaDB 提供了一个安全配置脚本，用于设置基本安全选项。运行以下命令：

sudo mysql_secure_installation

脚本将引导您完成以下配置步骤：

输入当前 root 密码（初次安装时为空，直接按 Enter）。
设置新的 root 密码（建议使用至少 12 位，包含大小写字母、数字和特殊字符的强密码）。
删除匿名用户（选择 Y，以防止未经授权的访问）。
禁止 root 用户远程登录（选择 Y，以降低远程攻击风险）。
删除测试数据库（选择 Y，移除不必要的默认数据库）。
重新加载权限表（选择 Y，确保更改立即生效）。

注意： 请妥善保存 root 密码，遗忘密码可能需要重置数据库。

访问 MariaDB

完成安全配置后，使用以下命令以 root 用户身份登录 MariaDB 数据库：

sudo mysql -u root -p

系统会提示输入您在 mysql_secure_installation 中设置的 root 密码。输入正确后，您将进入 MariaDB 的命令行界面，提示符为 MariaDB [(none)]>。

与 WordPress 集成

创建 WordPress 数据库

在 MariaDB 命令行中，创建一个专用于 WordPress 的数据库：

CREATE DATABASE wordpress CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

提示： 使用 utf8mb4 字符集和 utf8mb4_unicode_ci 排序规则，确保 WordPress 支持多语言和表情符号。

创建 WordPress 数据库用户

为安全起见，建议为 WordPress 创建一个专用数据库用户，而不是使用 root 账户。执行以下命令：

CREATE USER 'wordpress_user'@'localhost' IDENTIFIED BY 'SecureP@ssw0rd123';
GRANT ALL PRIVILEGES ON wordpress.* TO 'wordpress_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

命令说明：

wordpress_user：自定义的数据库用户名，可根据需要更改。
SecureP@ssw0rd123：用户密码，强烈建议使用复杂密码（示例仅供参考）。
wordpress：之前创建的数据库名称。
GRANT ALL PRIVILEGES：授予用户对 wordpress 数据库的完整操作权限。
FLUSH PRIVILEGES：刷新权限表，确保更改立即生效。
EXIT：退出 MariaDB 命令行。

安全提示： 避免使用简单密码（如 awang），建议使用密码管理器生成并存储强密码。

配置 WordPress 连接 MariaDB

在 WordPress 安装目录中，找到或创建 wp-config.php 文件，添加以下数据库连接信息：

define('DB_NAME', 'wordpress');
define('DB_USER', 'wordpress_user');
define('DB_PASSWORD', 'SecureP@ssw0rd123');
define('DB_HOST', 'localhost');
define('DB_CHARSET', 'utf8mb4');
define('DB_COLLATE', 'utf8mb4_unicode_ci');

确保 DB_NAME、DB_USER 和 DB_PASSWORD 与您在前面步骤中设置的值一致。保存文件后，WordPress 将通过这些配置连接到 MariaDB 数据库。

提示： 如果 wp-config.php 不存在，可以从 wp-config-sample.php 复制并修改。

故障排除

如果在安装或配置过程中遇到问题，可通过查看 MariaDB 的错误日志定位问题原因：

sudo tail -f /var/log/mysql/error.log

常见问题及解决方法：

MariaDB 服务无法启动：检查系统资源（磁盘空间、内存）是否充足，确认 /etc/mysql/ 目录权限是否正确（通常为 mysql:mysql）。
连接被拒绝：验证用户名和密码是否正确，检查 DB_HOST 是否为 localhost 或正确的服务器地址。
WordPress 无法连接数据库：检查 wp-config.php 中的配置项，确保与数据库设置一致，并确认 MariaDB 服务正在运行。
字符编码问题：确保数据库和 WordPress 配置使用相同的字符集（如 utf8mb4）。

提示： 如果问题持续存在，可使用 sudo journalctl -u mariadb 查看详细的服务日志。

总结

通过以上步骤，您已成功在基于 Debian/Ubuntu 的 Linux 系统上安装并配置了 MariaDB，并完成了与 WordPress 的集成。确保定期备份数据库和 WordPress 文件，以防止数据丢失。如果需要进一步优化（如性能调优或高可用性配置），请参考 MariaDB 官方文档或 WordPress 官方支持资源。