Uptime-Kuma v2版本配置外部MariaDB数据库指南

前言

Uptime-Kuma作为一款开源的监控工具，在v2版本中提供了更灵活的数据库配置选项。本文将详细介绍如何为Uptime-Kuma v2配置外部MariaDB数据库，帮助用户实现数据库的分离部署。

准备工作

在开始配置前，请确保已满足以下条件：

1. 已安装并运行MariaDB数据库服务
2. 已创建专用数据库用户并授予相应权限
3. 已备份现有的SQLite数据库数据（如需迁移）

配置方法

Uptime-Kuma v2提供了两种配置外部MariaDB的方式：

方法一：通过Web界面配置

1. 移除现有的kuma.db和db-config.json文件
2. 启动Uptime-Kuma服务
3. 访问Web界面，系统将自动引导至数据库配置页面
4. 填写MariaDB连接信息：
   • 数据库类型：选择MariaDB
   • 主机地址
   • 端口号（默认3306）
   • 用户名
   • 密码
   • 数据库名称

方法二：通过配置文件直接配置

创建或修改db-config.json文件，使用以下JSON格式：

{
    "type": "mariadb",
    "port": 3306,
    "hostname": "数据库服务器地址",
    "username": "数据库用户名",
    "password": "数据库密码",
    "dbName": "数据库名称"
}

注意事项

1. JSON文件必须使用UTF-8编码
2. 所有字段值必须使用双引号
3. 确保配置文件路径正确（通常位于Uptime-Kuma数据目录）
4. 端口号应为数字类型，不要加引号

数据迁移

如需从SQLite迁移到MariaDB：

1. 导出SQLite数据
2. 转换数据格式以适应MariaDB
3. 导入到新建的MariaDB数据库
4. 验证数据完整性

故障排查

若遇到连接问题，可检查：

1. 数据库服务是否正常运行
2. 网络连接是否通畅
3. 用户权限是否足够
4. 防火墙设置是否允许连接

结语

通过将Uptime-Kuma的数据库迁移到外部MariaDB，可以获得更好的性能表现和可扩展性。建议在生产环境中使用此配置方案，特别是当监控目标数量较多时。配置完成后，建议进行全面的功能测试以确保所有监控功能正常工作。