Termux 环境下 MariaDB 初始化与远程访问实践全记录

在全栈开发与服务器运维的日常实践中，移动端环境的服务部署始终是容易被忽略但极具价值的场景。近期在 Termux 中完成 MariaDB 初始化、后台启动配置及远程访问打通的全过程，恰好印证了移动端轻量服务器搭建的核心逻辑。以下将完整复盘整个操作流程、遇到的问题及解决方案，还原从环境准备到服务可用的全链路过程。

一、MariaDB 初始化完成，基础环境就绪

本次操作的核心目标是在 Termux 中完成 MariaDB 的初始化配置，为后续移动端数据库应用开发与远程调用奠定基础。执行初始化命令后，终端输出了完整的初始化流程日志，核心信息如下：

Initializing mysql data directory...
Installing MariaDB/MySQL system tables in '/data/data/com.termux/files/usr/var/lib/mysql' ...
2026-04-13 21:15:17 0 [Warning] failed to retrieve the MAC address
OK

To start mariadbd at boot time you have to copy
support-files/mariadb.service to the right place for your system

日志明确提示两点关键信息：一是 MAC 地址获取失败的警告，该警告不影响数据库核心功能初始化；二是开机自启的配置指引，需将 support-files/mariadb.service 复制到系统对应目录，为后续自启配置埋下伏笔。同时，日志附带了 root 用户密码设置的核心指令，明确后续需通过 /data/data/com.termux/files/usr/bin/mariadb-secure-installation 完成密码设置、测试数据库删除及匿名用户清理等安全配置。

二、启动服务与密码设置：从基础启动到权限配置

初始化完成后，首要步骤是启动 MariaDB 服务并完成 root 用户安全配置，这是数据库可用的基础前提。

1. 服务启动的初步尝试与问题暴露

最初执行启动命令时，选择了常规的启动方式，随后通过命令测试连接：

mariadb -u root -p -e "SHOW VARIABLES LIKE 'bind_address'"

但首次执行即报错：

ERROR 2002 (HY000): Can't connect to local server through socket '/data/data/com.termux/files/usr/var/lib/mysql/mysql.sock' (2)

该报错的核心原因是服务未成功启动，socket 文件未生成。结合日志排查发现，启动过程中存在参数不兼容问题 - 后续验证中， --daemonize 参数在 Termux 环境的 MariaDB 中完全不支持，使用该参数启动会直接导致服务终止，报错信息明确显示 unknown option '--daemonize' ，这也印证了移动端环境与标准 Linux 服务器配置的差异，需针对性调整启动方式。

2. 正确的服务启动与密码配置流程

针对启动失败问题，调整启动策略并完成密码配置，具体流程如下：

• 第一步：强制清理残留进程，解决进程冲突问题

  pkill -9 mariadbd
  pkill -9 mariadbd-safe
  rm -f /data/data/com.termux/files/usr/var/lib/mysql/mysql.sock*
  rm -rf /data/data/com.termux/files/usr/var/lib/mysql/*.pid

• 第二步：采用 Termux 兼容的后台启动方式

  nohup mariadbd-safe --datadir='/data/data/com.termux/files/usr/var/lib/mysql' > /dev/null 2>&1 &

该命令通过 nohup 实现后台运行，避免终端关闭导致服务终止，同时重定向日志到空设备，保持终端输出简洁。

• 第三步：root 用户安全配置 新开 Termux 窗口执行安全配置脚本，按照提示完成密码设置、删除测试数据库、移除匿名用户等操作，这是保障数据库安全的核心步骤。
• 第四步：验证连接与远程配置基础 执行登录命令测试本地连接，成功进入数据库命令行后，通过 SHOW VARIABLES LIKE 'bind_address' 查看默认监听地址，初始状态为本地监听，为后续远程访问配置做好准备。

三、远程访问配置：打通移动端与局域网的连接通道

完成本地服务可用后，实现远程访问是本次操作的核心目标，需从配置文件修改、用户授权两方面入手。

1. 配置文件修改，开放监听地址

编辑用户级配置文件 ~/.my.cnf （该文件优先级高于系统全局配置 /data/data/com.termux/files/usr/etc/my.cnf ），添加监听地址配置：

[mysqld]
bind-address = 0.0.0.0
port = 3306

修改后保存退出，该配置允许数据库监听所有 IP 地址的访问请求，为远程连接提供基础。

2. 用户授权，开启远程访问权限

默认情况下，root 用户仅允许本地登录，需通过授权命令开放远程访问权限。首次尝试创建用户时执行：

create user 'root'@'%' identified by '998SoHo?44J11';

但报错 ERROR 1396 (HY000): Operation CREATE USER failed for 'root'@'%' ，原因是 root@% 用户已存在，无需重复创建。因此调整为授权命令，直接完成权限与密码配置：

GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY '998SoHo?44J11' WITH GRANT OPTION;
FLUSH PRIVILEGES;

该命令实现两个核心功能：一是为 root@% 用户授予所有数据库的全部权限，二是设置密码并刷新权限生效。

3. 重启服务与远程连接验证

完成配置修改与授权后，重启 MariaDB 服务使配置生效：

pkill -9 mariadbd mariadbd-safe && nohup mariadbd-safe > /dev/null 2>&1 &

随后查看手机局域网 IP 地址，通过 ifconfig 命令获取，例如 192.168.1.105 ，即可在电脑、其他手机等设备上使用远程连接工具（Navicat、DBeaver 等）连接，连接信息为：IP 为手机局域网 IP、端口 3306、用户 root、密码为配置的 998SoHo?44J11 。验证连接后，再次执行 SHOW VARIABLES LIKE 'bind_address' ，确认监听地址为 0.0.0.0 ，即远程访问配置成功。

四、特殊场景处理：空密码登录与配置文件定位

在配置过程中，遇到空密码登录的特殊需求，需针对性处理；同时，配置文件的准确位置是保障配置生效的关键，需明确不同配置文件的优先级与路径。

1. 空密码登录的修复方案

当需要设置空密码登录时，直接空密码登录会报错，原因是旧密码缓存未清理。修复流程如下：

• 第一步：关闭数据库服务

  pkill -9 mariadbd
  pkill -9 mariadbd-safe

• 第二步：无权限模式启动，跳过权限验证

  mysqld_safe --skip-grant-tables --skip-networking &

• 第三步：无密码进入数据库，清空密码

  mariadb -u root mysql

执行 SQL 命令：

  FLUSH PRIVILEGES;
  ALTER USER 'root'@'localhost' IDENTIFIED BY '';
  ALTER USER 'root'@'%' IDENTIFIED BY '';
  FLUSH PRIVILEGES;
  exit

• 第四步：正常重启服务，完成空密码配置

  pkill -9 mariadbd
  nohup mariadbd-safe > /dev/null 2>&1 &

此时即可通过 mariadb -u root 空密码本地登录，远程连接也可留空密码访问。

2. 配置文件位置与加载顺序

Termux 环境中，MariaDB 的配置文件存在多个路径，需明确优先级与加载顺序：

• 用户级配置文件（优先级最高）： ~/.my.cnf ，实际完整路径为 /data/data/com.termux/files/home/.my.cnf
• 系统全局配置文件： /data/data/com.termux/files/usr/etc/my.cnf
• 配置目录： /data/data/com.termux/files/usr/etc/my.cnf.d/

可通过以下命令查看实际加载的配置文件顺序，确保配置生效：

mariadbd --help --verbose | grep -A 1 "Default options"

输出示例：

Default options are read from the following files in the given order:
/etc/my.cnf ~/.my.cnf

该命令能精准反映配置文件的加载优先级，避免因配置文件路径错误导致配置不生效。

五、总结与核心要点

本次 Termux 环境 MariaDB 搭建与远程访问的全流程，核心要点可归纳为以下几点：

1. 初始化阶段，MAC 地址获取警告不影响核心功能，重点关注密码设置与自启配置指引。
2. 服务启动需适配 Termux 环境，避免使用 --daemonize 等不兼容参数，优先采用 nohup 实现后台启动。
3. 远程访问配置需完成两步核心操作：修改配置文件开放监听地址、授权 root@% 用户权限，同时注意避免重复创建用户。
4. 空密码登录需通过无权限模式启动清理旧密码，配置文件的优先级与路径需精准掌握。
5. 进程清理与 socket 文件删除是解决启动失败的关键步骤，每次配置修改后需重启服务使配置生效。

移动端轻量服务器的搭建，本质上是标准服务器配置与移动端环境特性的结合，本次操作中遇到的参数兼容、权限配置、配置文件优先级等问题，均是全栈开发中跨环境部署的典型场景。完整复盘整个流程，既能为移动端数据库应用开发提供可参考的实践案例，也能为后续服务器运维与环境适配积累经验。