MariaDB 教程 / 在 Ubuntu 24.04 上安装并验证服务与认证
在 Ubuntu 上,可以通过 APT 安装 MariaDB 服务器和客户端,再检查服务及管理员连接。本文所述的新环境通常使用 Unix 套接字认证进行本机管理,因此这条安装路径并不要求一开始就设置 root 数据库密码。管理员的套接字连接与练习账号的 TCP 密码连接需要分别验证。
确认系统与已有安装
下列步骤面向使用 systemd、能够访问软件源的 Ubuntu 24.04 LTS 新环境,并要求当前操作系统账号可以使用 sudo。sudo 用于以所需的管理权限执行操作,不能把数据库账号与操作系统账号混为一谈。MariaDB 的服务器与客户端概念说明了连接程序、服务器以及数据库之间的区别。安装前先读取当前环境:
cat /etc/os-release
command -v mariadb
systemctl status mariadb --no-pager
第一条命令确认发行版,第二条查找 mariadb 客户端程序,第三条检查数据库服务。新机器尚无该命令或服务时,缺失提示并不意外。如果发现已有服务器,先确认用途、数据和配置;现有业务实例不属于可以重新初始化的空白练习环境。
安装发行版软件包并检查服务状态
sudo apt update
apt-cache policy mariadb-server
sudo apt install mariadb-server mariadb-client
apt update 更新软件源索引;apt-cache policy 显示候选包版本和来源;apt install 安装服务器与客户端。Ubuntu 软件源的版本可能不同于 MariaDB 官网下载的版本。完成入门 SQL 练习不必为了追求相同版本号而另外添加供应商软件源。不同安装方式可以参照MariaDB 官方安装指南。
确认安装前阅读将要安装的软件包列表。依赖中出现 Galera 相关软件包,并不代表必须配置数据库集群。安装完成后分别检查客户端和服务:
mariadb --version
systemctl is-active mariadb
systemctl is-enabled mariadb
is-active 返回 active,表示服务现在正在运行;is-enabled 返回 enabled,表示服务已设置为开机启动。这是两个不同状态,不能用其中一个替代另一个。如果新建的练习服务处于停止状态,启动它:
sudo systemctl start mariadb
如果希望重启电脑后自动启动这个服务,再明确启用开机启动:
sudo systemctl enable mariadb
不要对尚未确认用途的已有实例套用启动或开机启动设置。安装命令结束后仍需检查服务结果,不能仅根据包已经安装就推断进程正常运行。
通过本机套接字建立管理员连接
在本文所述的新安装环境中,使用本机 Unix 套接字及操作系统管理员权限连接:
sudo mariadb --protocol=socket
进入 MariaDB 客户端后执行下面的 SQL,而不是继续在操作系统终端中输入:
SELECT VERSION() AS server_version;
SELECT USER() AS connection_user, CURRENT_USER() AS privilege_account;
SELECT 1 + 1 AS result;
server_version 显示实际连接的服务器版本;connection_user 与 privilege_account 分别显示连接身份和匹配到的权限账号;result 应为 2。Unix 套接字认证可以根据本机进程的操作系统身份授权,而不要求额外输入 root 数据库密码。因此 sudo mariadb 能够连接,并不代表通过 TCP 用空 root 密码也能连接。
MariaDB 从 10.4 起的认证说明解释了默认账号和认证插件的行为。已有系统可能采用其他配置,不应只为了让 Ubuntu 看起来与密码认证的 Windows 示例一致,就重置已经确认可用的管理员认证方式。
按实际环境判断可选安全配置
若要使用初始安全配置工具,先在交互式客户端输入 EXIT; 退出,再在操作系统终端运行:
sudo mariadb-secure-installation
该工具提供初始清理和配置选项,提问顺序、措辞会随版本与软件包变化。阅读每个问题,保留刚刚验证成功的认证方式,不要照抄一组与当前环境无关的固定回答。
| 问题或操作 | 判断依据 |
|---|---|
| 当前 root 密码 | 采用套接字认证的新环境可能没有需要输入的 root 密码 |
| 切换为套接字认证 | 先确认当前是否已经使用此方式 |
| 更改 root 密码 | 没有明确原因时,不替换已正常工作的认证配置 |
| 删除匿名账号 | 新练习环境不需要匿名账号时,可清理这些账号 |
| 禁止 root 远程登录 | 本练习将管理员访问保留在本机 |
| 删除 test 数据库 | 只针对无用的安装测试数据库;它不是 shopcourse |
工具不能替你判断自己正在修改哪个实例。电脑上已有业务数据库时,应先评估清理选项的影响,不能直接将它当成全新安装。下一步创建账号的前提,是能够用已知的管理员方式正常连接。
创建 TCP 练习账号并确认身份
使用 sudo mariadb --protocol=socket 重新进入管理员连接,先检查是否存在同名账号:
SELECT User, Host FROM mysql.user WHERE User = 'course_user';
发现已有账号时核对 Host 和用途,不要直接覆盖。确认需要新建教程账号后,将下面的密码占位符替换为自己选择的强密码,再执行:
CREATE USER 'course_user'@'127.0.0.1'
IDENTIFIED BY 'CHANGE_THIS_TO_YOUR_OWN_PASSWORD';
GRANT ALL PRIVILEGES ON shopcourse.*
TO 'course_user'@'127.0.0.1';
SHOW GRANTS FOR 'course_user'@'127.0.0.1';
账号的主机部分属于身份标识。下方显式 TCP 命令使用 course_user@127.0.0.1,不能把其他 Host 的同名账号视为完全等价。授权限定在 shopcourse.*,不涉及所有数据库,也不授予转授权能力。可以在 shopcourse 建立前授权,但 GRANT 本身不会创建该数据库。CREATE USER 与 GRANT 完成后立即生效,不需要额外执行 FLUSH PRIVILEGES。规则详见 CREATE USER 账号说明与 GRANT 权限说明。
输入 EXIT; 退出管理员客户端,在操作系统终端执行连接命令:
mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
输入练习账号的密码。这里的 127.0.0.1 和 --protocol=tcp 明确指定 TCP 路径;若实例用了其他端口,替换 --port。连接后执行:
SELECT CURRENT_USER() AS privilege_account;
预期 privilege_account 为 course_user@127.0.0.1。后续 SQL 练习使用这个账号,不再使用 root。管理员套接字连接成功但 TCP 练习账号认证失败时,应检查这个账号的密码、主机部分和连接端口,而不是据此修改 root 的认证方式。
读取日志并谨慎撤销配置修改
启动失败时先查看服务状态和最近的日志消息:
systemctl status mariadb --no-pager
sudo journalctl -u mariadb -n 80 --no-pager
- 连接被拒绝或无法连接:检查服务是否正在运行、端口是否一致,以及当前使用 TCP 还是套接字。
- Access denied:核对实际账号、Host、密码及认证方式。
- 版本与预期不同:分别比较 apt-cache policy 的候选包、mariadb --version 的客户端版本和连接内 SELECT VERSION() 的服务器版本。
软件包配置通常位于 /etc/mysql/mariadb.conf.d/,但仍应确认当前实例实际读取的配置文件。编辑前备份该文件,每次只改一项并只重启对应练习实例;修改失败时恢复原文件后重新验证。停止服务可用 sudo systemctl stop mariadb,取消开机启动可用 sudo systemctl disable mariadb,两者都不会删除数据库。清除软件包或移除数据目录不是普通的连接修复方法。




