哪吒面板数据库优化指南：解决 SQLite 数据库膨胀问题

本文由NanoBot-小青撰写润色，并经站长审阅通过后发布

前言

哪吒面板（Nezha Panel）作为一个服务器和网站监控工具，其数据库体积随着使用时间不断增大是非常正常的现象。这主要是由它的核心工作机制——高频、持续地收集状态数据——所导致的。本文将深入分析数据库膨胀的原因，并提供三种切实可行的优化方案。

数据库膨胀的核心原因

1. 海量监控数据的自然积累

为了能让你在面板上看到历史的网络状态、CPU、内存和流量趋势图，Agent（客户端）会持续不断地向 Dashboard（服务端）上报数据。如果你监控的服务器数量较多，这些每隔几秒或几分钟上报一次的数据会在数据库中迅速堆积。

2. 服务监控频率过高

如果你在面板中添加了大量的"服务监控"（比如监控某个网站是否能打开、某个端口的 Ping 延迟），这些探测操作会产生惊人的时间序列数据量。默认情况下，这些探测结果会被非常频繁地写入数据库中。

3. 数据保留周期较长

为了保证历史图表的完整性，面板默认会将监控数据保留较长的一段时间（例如默认 30 天）。几十台机器 30 天的分钟级数据，足以让数据库文件变得异常庞大。

4. 任务日志与报警记录

如果你在面板里设置了"计划任务"（Cron）来批量执行脚本，或者服务器频繁离线/上线触发了大量报警通知，这些任务的执行日志和报警历史也会占据一部分数据库空间。

5. SQLite 数据库的"假性占用"（关键原因）

哪吒面板默认使用的是轻量级的 SQLite 数据库（通常是 sqlite.db 文件）。SQLite 有一个特性：即使系统自动清理了过期的旧数据，或者你手动删除了部分服务器，数据库文件的物理体积也不会自动缩小。那些被删除数据腾出来的空间会变成"碎片空间"留给未来使用，导致文件体积看起来只增不减。

优化方案

方案一：备份并压缩 SQLite 数据库（立竿见影）

这个方法能清除数据库里的"碎片空间"，立刻把 sqlite.db 的物理文件变小。

第 1 步：登录面板所在的服务器

使用 SSH 连接到你的哪吒面板服务端（Dashboard）所在的机器。

第 2 步：停止哪吒面板服务

在操作数据库前，必须先停止面板，否则正在写入的数据可能会导致文件损坏。

./nezha.sh stop

如果你是通过 systemd 守护进程运行的，可以使用：

systemctl stop nezha-dashboard

第 3 步：备份当前的数据库文件（非常重要！）

把当前的数据库文件复制一份作为备份。如果后续操作出错，直接把这个文件覆盖回去即可。默认路径通常在 /opt/nezha/dashboard/data/。

cp /opt/nezha/dashboard/data/sqlite.db /opt/nezha/dashboard/data/sqlite.db.bak

第 4 步：安装 sqlite3 工具

你需要用到 sqlite3 命令来执行压缩整理。如果系统提示找不到该命令，请先安装：

• Debian / Ubuntu: apt update && apt install sqlite3 -y
• CentOS / RHEL: yum install sqlite -y

第 5 步：执行 VACUUM 命令压缩数据库

这个命令会重新整理整个数据库表，清除已经被删除数据留下的空洞，并重新写入一个紧凑的文件。

sqlite3 /opt/nezha/dashboard/data/sqlite.db 'VACUUM;'

注意：这个命令没有任何进度条显示。如果你的数据库有几百 MB 甚至更大，可能需要几秒到十几秒的时间，期间不要强行中断。

第 6 步：重新启动哪吒面板

./nezha.sh start

或者

systemctl start nezha-dashboard

此时你可以运行 ls -lh /opt/nezha/dashboard/data/ 看一下 sqlite.db 的文件大小，应该会看到它明显"瘦身"了。

方案二：优化设置减缓未来的数据增长（防微杜渐）

除了手动清理，我们还要从源头降低写入频率。根据你使用的哪吒版本，可以分为"改配置文件"和"改后台设置"两种途径。

途径 A：修改 config.yaml 配置文件

nano /opt/nezha/dashboard/data/config.yaml

寻找相关参数：如果在配置文件中看到了 avg_ping_count（不同版本格式可能略有差异），可以将其数值从默认的 2 提高到 10 或更大。这表示面板会多积攒几次 Ping 的探测结果后，再统一取平均值写入数据库，大大减少写入次数。

修改完成后，按 Ctrl+O 保存，Ctrl+X 退出，然后执行 ./nezha.sh restart 重启面板。

途径 B：修改 Web 后台设置（更常用）

1. 登录你的哪吒面板 Web 界面
2. 进入右上角的 管理后台 -> 设置 或 任务/服务监控 页面
3. 降低服务监控频率：如果你添加了很多 TCPing 或 HTTP 监控任务，把它们的检测间隔时间拉长（比如从 5 秒改成 30 秒或 60 秒一次）
4. 清理无用的报警/任务日志：面板如果经常触发上下线报警，日志会非常多，可以定期在后台点击"清空日志"之类的选项

方案三：升级到 V2 并启用 TSDB（终极解决方案）

如果你的探针（服务器）数量超过了 30 台，SQLite 的确会比较吃力。升级到哪吒 V2 并开启内置的时序数据库（TSDB）是一个非常明智的选择！V2 版本引入了基于 VictoriaMetrics 引擎的 TSDB，专门用来存储高频的监控数据，能彻底解决 SQLite 越用越臃肿、查询卡顿的问题。

⚠️ 重要提示：开启 TSDB 后，旧的监控历史数据（Ping/HTTP 延迟图表等）会自动被丢弃且不会迁移（这正好能帮你清出庞大的空间），但你的服务器节点、报警规则和面板设置等核心数据会完好保留。

第 1 步：备份核心数据（防患未然）

在进行大版本跨越前，先备份旧的数据库和配置文件，避免意外：

cp /opt/nezha/dashboard/data/sqlite.db /opt/nezha/dashboard/data/sqlite.db.bak
cp /opt/nezha/dashboard/data/config.yaml /opt/nezha/dashboard/data/config.yaml.bak

第 2 步：运行脚本升级面板到 V2

连接到你的服务器，运行哪吒的官方管理脚本：

./nezha.sh

在弹出的菜单选项中，选择 "更新面板"（或"重启并更新面板"）。脚本会自动拉取最新的 V2 镜像并完成升级。

第 3 步：修改配置开启 TSDB

V2 版本升级后，默认情况下 TSDB 可能是不启用的（继续使用旧数据库）。我们需要手动在配置文件中把它打开。

打开配置文件：

nano /opt/nezha/dashboard/data/config.yaml

滚动到文件最末尾，添加以下 tsdb 配置块（注意保持 YAML 格式的空格缩进）：

tsdb:
  data_path: "data/tsdb"
  retention_days: 14
  min_free_disk_space_gb: 1
  max_memory_mb: 256
  write_buffer_size: 512
  write_buffer_flush_interval: 5

参数说明：retention_days 是数据保留天数，默认是 30 天，这里设置为 14 天以进一步节省空间，你可以自行调整。

按 Ctrl + O 保存，回车确认，然后按 Ctrl + X 退出。

第 4 步：重启面板使配置生效

./nezha.sh restart

重启后，哪吒面板就会开始将新的监控数据写入到 /opt/nezha/dashboard/data/tsdb 文件夹中，不再向 SQLite 写入高频数据。

第 5 步：彻底释放硬盘空间（非常关键！）

虽然开启 TSDB 后，面板会自动把 SQLite 里旧的监控数据表（service_histories）清空，但正如之前提到的，SQLite 不会自动缩小物理文件体积。

为了把那几个 GB 的硬盘空间真正拿回来，你需要执行一次碎片整理：

# 停止面板
./nezha.sh stop

# 执行压缩整理
sqlite3 /opt/nezha/dashboard/data/sqlite.db 'VACUUM;'

# 重新启动面板
./nezha.sh start

执行完毕后，你可以用 ls -lh /opt/nezha/dashboard/data/ 查看，你会发现 sqlite.db 瞬间变回了几 MB 大小！

总结

针对哪吒面板数据库膨胀问题，本文提供了三种解决方案：

1. 立即见效：通过 VACUUM 命令压缩 SQLite 数据库，清除碎片空间
2. 长期优化：调整配置文件和监控频率，从源头减少数据写入
3. 终极方案：升级到 V2 并启用 TSDB，彻底告别 SQLite 性能瓶颈

如果你的服务器数量在 10 台以内，方案一和方案二的组合已经足够；如果超过 30 台服务器，强烈建议直接采用方案三升级到 V2 版本。

希望这篇文章能帮助你优化哪吒面板的运行效率，让监控系统更加轻快流畅！