服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- Linux 磁盘占用可能来自 Nezha SQLite、SQLite journal 和 Docker JSON 日志,不能只看一个大数据库文件。
- 启用 TSDB 后仍需核对当前版本的写入与读取状态;旧 SQLite 不会因此自动证明已迁移或可删除。
- 备份和完整性检查要在了解数据库大小、写入状态和剩余空间后安排;大库 VACUUM 可能需要额外空间。
- 只有确认业务不再读写旧历史、备份可恢复且版本文档支持后,才制定旧库保留或清理计划。
分清数据库增长与其他磁盘占用
Nezha 面板运行时间增长后,历史记录可能让 SQLite 数据库变大;journal 或 WAL 文件也可能在活跃写入时占用空间。若面板运行在 Docker 中,容器 JSON 日志同样会增长。因此看到磁盘不足或数据库写入失败时,先确认根分区及各目录的实际占用,不要直接删除 SQLite 文件、journal、整个容器目录或所有日志。
启用 TSDB 是改变历史数据存储路径的一项配置,不等于旧 SQLite 记录已自动搬迁、压缩或删除。不同 Dashboard 版本对初始化、兼容读取和旧数据保留的行为可能不同,必须按实际运行版本的官方说明核对。服务历史能够展示也不证明之后的新写入已落到预期后端。
只读检查分区、数据库和 Docker JSON 日志
先运行只读检查,分别统计根分区、Nezha 数据目录和 Docker 容器日志。将路径占位符替换成当前实际数据目录;如果 Docker 不使用 json-file 日志驱动,下面的查找结果可能为空。容器路径和文件名可能泄露部署信息,分享前应脱敏。
sqlite3 可用且数据库允许低负载读取时,再查看表清单或做完整性检查。完整性检查可能读遍大型数据库,应预留时间和磁盘 I/O;如果数据库正处于高负载写入,不要在生产高峰执行。
按来源查看磁盘占用
shdf -h /
du -sh /PATH/TO/NEZHA-DATA /var/lib/docker/containers 2>/dev/null
find /var/lib/docker/containers -type f -name '*-json.log' -printf '%s %p\n' 2>/dev/null | sort -nr | head -n 20
stat -c '%s %n' /PATH/TO/NEZHA.sqlite* 2>/dev/null
可选的 SQLite 只读检查
shsqlite3 /PATH/TO/NEZHA.sqlite 'PRAGMA integrity_check;'
sqlite3 /PATH/TO/NEZHA.sqlite 'SELECT name FROM sqlite_master WHERE type="table" ORDER BY name;'
核对 TSDB 是否真正接收新历史
切换存储前,确认当前 Nezha Dashboard 版本、配置文件来源、TSDB 后端地址、认证方式和持久化卷。按同一版本的官方说明完成配置,并保留原 SQLite 文件和配置备份。不要从旧教程复制环境变量或假定容器重建后绑定目录不变;配置名称和迁移流程可能随版本调整。
启用后检查 Dashboard 启动日志、TSDB 服务状态以及新产生的服务历史是否按预期可读。只看配置开关、容器启动或新建目录,不足以证明数据写入正常。若新增历史没有出现、查询报错或认证失败,先停止清理旧库,恢复已备份的配置并按原 SQLite 路径检查服务。
先备份与验证,再考虑 SQLite 压缩或清理
维护数据库前先用应用支持的方式生成一致性备份,并验证备份文件可读、大小合理且可在隔离副本上恢复。运行中的 SQLite 数据库可能伴随 journal/WAL 文件;盲目复制其中一个主文件不能保证得到完整快照。若应用提供受控备份或 SQLite 在线备份机制,按当前版本的正式说明操作。
VACUUM 会重建数据库,可能需要接近数据库大小的额外可用空间,并改变文件布局;它不是应急释放空间命令。删除旧历史、清理 journal 或移除旧数据库前,先确认保留要求、TSDB 新数据完整性、面板是否仍读旧库,以及回滚时是否能恢复原格式。空间不足以完成安全备份时,应先扩容或转移备份位置,不应冒险删除唯一副本。
将 Docker 日志作为独立占用来源处理
如果 Docker JSON 日志是主要占用,先确认具体容器和写入量,再查看 Docker 官方文档支持的日志轮转配置。修改日志驱动或轮转参数通常需要重建容器才生效;安排停机窗口,并保留 compose、容器参数和卷映射备份。不要用 docker system prune 或通配删除容器目录来代替轮转配置。
SQLite journal、应用历史和 Docker stdout/stderr 日志有不同生命周期。调整其中一项,不应覆盖其他数据的保留要求。变更后分别观察文件增长率、容器重启状态、Dashboard 历史查询和磁盘剩余空间;不要只凭一次 df 输出判定容量问题已解决。
完成标准和回退条件
只有确认 Dashboard 可正常写入并读取新历史、数据库完整性检查符合预期、Docker 服务和持久化卷健康、剩余空间稳定,才能关闭容量排查。TSDB 端可用不代表旧 SQLite 已失去用途;旧库的迁移范围和历史保留策略应按具体版本文档与业务要求核验。
若切换后查询失败或历史记录缺失,先停止对旧库的清理,按备份恢复原配置和存储挂载,再检查原 SQLite 服务。TSDB 初始化结果、Dashboard 版本行为和旧库可删除条件未确认时,保留旧数据并记录为待复核。
资料来源
常见问题
启用 TSDB 后可以马上删除 Nezha 的 SQLite 数据库吗?
不可以仅凭配置启用就删除。先确认当前版本的新历史写入、查询、迁移范围和备份恢复,并核对旧库是否仍被读取。
SQLite 文件旁边的 journal/WAL 能直接删除吗?
不能。它们可能参与活跃数据库事务。先确认数据库是否正在运行并按正式备份/维护流程处理,不要直接删文件释放空间。
数据库很大时可以运行 VACUUM 吗?
只有在有足够额外空间、完整备份和维护窗口时才评估。VACUUM 会重建文件,可能需要大量临时空间,不适合磁盘已满时盲目执行。
Docker 日志占空间,能否清空整个容器目录?
不要这样做。确认具体日志驱动和容器后,按 Docker 官方方式配置轮转并在维护窗口应用;不要删除容器数据卷或历史数据库。