跳转到主要内容

测试脚本

项目包含多个测试脚本来帮助开发和测试：

Note

已移除旧的仓库根目录 pnpm 辅助工具，用于过期调试、SMTP 矩阵测试和 cron 端口检查。请使用应用程序界面（设置 → 备份监控）、经过身份验证的 HTTP API 和针对 cron 服务的 curl，如下面文档所述。

生成测试数据​

pnpm generate-test-data --servers=N

此脚本为多个服务器和备份生成测试备份数据。

--servers=N 参数是 必需的，指定要生成的服务器数量（1-30）。

使用选项 --upload 将生成的数据发送到 /api/upload

pnpm generate-test-data --servers=N --upload
pnpm generate-test-data --servers=N --upload --api-key=YOUR_UPLOAD_KEY

当设置 → API 密钥设为需要密钥时，--api-key 是必需的。脚本在 HTTP 429 时重试一次，因此大型 --upload 运行保持在默认速率限制内。

示例：

# Generate data for 5 servers
pnpm generate-test-data --servers=5

# Generate data for 1 server with upload mode
pnpm generate-test-data --upload --servers=1

# Generate data for all 30 servers
pnpm generate-test-data --servers=30

脚本按 每个服务器 分配 Duplicati 版本（相同的报告字符串写入该服务器的每个备份）：

  • 70–80% 当前版本：使用 configurations.duplicati_versions 中最新的缓存稳定版本（如果可用），否则使用固定的回退版本（2.1.0.5_stable）。
  • 剩余较旧版本：严格之前的稳定版本，以便仪表板徽章比较为过时（黄色）。
  • 直接数据库模式首先清除 configurations，然后恢复或填充版本缓存，使当前/过时比较立即生效。
  • 小数量不能总是落在 70–80%：--servers=1 是 100% 当前版本；--servers=2 或 3 至少保留一个较旧服务器；--servers=6 是 5 个当前版本（83%）。--servers=12（由 pnpm take-screenshots 使用）是 9 个当前版本 / 3 个较旧版本。
  • 当 pnpm take-screenshots 后续将数据集减少到三台服务器时，它保留受保护的过期服务器和 至少一台较旧版本服务器。

Caution

此脚本删除数据库中所有先前数据，并用测试数据替换。 运行此脚本前备份数据库。

过期检查和 cron 连接性（开发）​

运行过期备份检查​

应用运行时：

  • 用户界面（推荐）： 打开 设置 → 备份监控 并使用 测试过期备份。这通过经过身份验证的 POST /api/notifications/check-overdue 运行与计划作业相同的逻辑。

Cron 服务健康状况​

curl http://localhost:8667/health
curl http://localhost:8666/api/cron/health

模拟特定日期或时间​

没有捆绑的 CLI 用于注入模拟的“当前”时间。有关算法和手动测试思路，请参见仓库文件 dev/OVERDUE_DETECTION_ALGORITHM.md 和 src/lib/overdue-backup-checker.ts 中的实现。

验证 CSV 导出​

pnpm validate-csv-export

此脚本验证 CSV 导出功能。它：

  • 测试 CSV 导出生成
  • 验证数据格式和结构
  • 检查导出文件中的数据完整性

在发布前用于确保 CSV 导出正常工作。

临时阻止 NTFY 服务器（用于测试）​

sudo ./scripts/temporary_ntfy.sh_block.sh

此脚本临时阻止到 NTFY 服务器（ntfy.sh）的传出网络访问，以测试通知重试机制。它：

  • 解析 NTFY 服务器的 IP 地址
  • 添加 iptables 规则以阻止传出流量
  • 阻止 10 秒（可配置）
  • 退出时自动移除阻止规则
  • 需要 root 权限（sudo）

Caution

此脚本修改 iptables 规则并需要 root 权限。仅用于测试通知重试机制。

数据库迁移测试​

项目包含用于测试从旧版本迁移到当前版本的数据库迁移脚本。这些脚本确保数据库迁移正确工作并保持数据完整性。

生成迁移测试数据​

./scripts/generate-migration-test-data.sh

此脚本为应用程序的多个历史版本生成测试数据库。它：

  1. 停止并删除任何现有的 Docker 容器
  2. 对于每个版本（v0.4.0、v0.5.0、v0.6.1、0.7.27、0.8.21）：
    • 删除现有数据库文件
    • 创建版本标签文件
    • 启动具有特定版本的 Docker 容器
    • 等待容器就绪
    • 使用 pnpm generate-test-data 生成测试数据
    • 截取带有测试数据的 UI 屏幕截图
    • 停止并删除容器
    • 刷新 WAL 文件并保存数据库模式
    • 将数据库文件复制到 scripts/migration_test_data/

要求：

  • 必须安装并配置 Docker
  • 必须安装 Chromium（通过 Playwright）
  • Docker 操作需要 root/sudo 访问权限
  • Docker 卷 duplistatus_data 必须存在

输出：

  • 数据库文件：scripts/migration_test_data/backups_<VERSION>.db
  • 模式文件：scripts/migration_test_data/backups_<VERSION>.schema
  • 屏幕截图：scripts/migration_test_data/duplistatus_test_data_<VERSION>.png

配置：

  • 服务器数量：通过 SERVERS 变量设置（默认值：3）
  • 数据目录：/var/lib/docker/volumes/duplistatus_data/_data
  • 端口：9666（Docker 容器端口）

Caution

此脚本需要 Docker 并将停止/删除现有容器。它还需要 Docker 操作和文件系统访问的 sudo 权限。如果尚未安装，请先运行 pnpm take-screenshots:install 以安装 Playwright Chromium 浏览器。

Important

此脚本应该只运行一次，因为开发人员可以将数据库文件和屏幕截图直接复制到 scripts/migration_test_data/ 目录。在开发过程中，只需运行 ./scripts/test-migrations.sh 脚本来测试迁移。

测试数据库迁移​

./scripts/test-migrations.sh

此脚本测试从旧版本到当前版本（4.0）的数据库迁移。它：

  1. 对于每个版本（v0.4.0、v0.5.0、v0.6.1、0.7.27、0.8.21）：
    • 创建测试数据库的临时副本
    • 使用 test-migration.ts 运行迁移过程
    • 验证已迁移的数据库结构
    • 检查所需的表和列
    • 验证数据库版本为 4.0
    • 清理临时文件

要求：

  • 测试数据库必须存在于 scripts/migration_test_data/ 中
  • 通过首先运行 generate-migration-test-data.sh 生成

输出：

  • 彩色编码的测试结果（绿色表示通过，红色表示失败）
  • 已通过和失败版本的摘要
  • 失败迁移的详细错误消息
  • 如果所有测试都通过则退出代码为 0，如果有任何失败则为 1

验证内容：

  • 迁移后数据库版本为 4.0
  • 所有必需的表都存在：servers、backups、configurations、users、sessions、audit_log、db_version
  • 每个表中存在必需的列
  • 数据库结构正确

示例输出：

==========================================
Database Migration Test Suite
==========================================

Testing migrations from old versions to version 4.0
Test data directory: /path/to/migration_test_data
Temporary directory: /path/to/migration_test_data/.tmp

----------------------------------------
Testing version: v0.4.0
----------------------------------------
  Copying database file to temporary location...
  Running migration test...
✅ Version v0.4.0: Migration test PASSED

==========================================
Test Summary
==========================================

✅ Passed versions (5):
  ✓ v0.4.0
  ✓ v0.5.0
  ✓ v0.6.1
  ✓ 0.7.27
  ✓ 0.8.21

All migration tests passed!

用法：

# Run all migration tests
./scripts/test-migrations.sh

# Check exit code
echo $?  # 0 = all passed, 1 = some failed

Note

此脚本在内部使用 TypeScript 迁移测试脚本（test-migration.ts）。测试脚本验证迁移后的数据库结构并确保数据完整性。

SMTP 和电子邮件（开发）​

在 设置 → 电子邮件 下配置 SMTP 并使用应用内电子邮件测试和通知流程。以前的 pnpm set-smtp-test-config 和 pnpm test-smtp-connections 辅助脚本已从仓库中移除。

测试 Docker 入口点脚本​

pnpm test-entrypoint

此脚本为本地开发中的 docker-entrypoint.sh 提供测试包装器。它设置环境以测试入口点日志记录功能，并确保日志写入 data/logs/ 以便应用程序可以访问它们。

功能：

  1. 始终构建新版本：自动运行 pnpm build-local 在测试前创建新构建（无需手动先构建）
  2. 构建 cron 服务：确保 cron 服务已构建（dist/cron-service.cjs）
  3. 设置类似 Docker 的结构：创建必要的符号链接和目录结构以模拟 Docker 环境
  4. 运行入口点脚本：使用适当的环境变量执行 docker-entrypoint.sh
  5. 清理：退出时自动删除临时文件

用法：

# Run the test (builds fresh version automatically)
pnpm test-entrypoint

环境变量：

  • PORT=8666 - Next.js 服务器端口（匹配 start-local）
  • CRON_PORT=8667 - cron 服务端口
  • VERSION - 自动设置为 test-YYYYMMDD-HHMMSS 格式

输出：

  • 日志写入到 data/logs/application.log（应用程序可访问）
  • 控制台输出显示入口点脚本执行
  • 按 Ctrl+C 停止并测试日志刷新

要求：

  • 必须从仓库根目录运行脚本（pnpm 自动处理）
  • 脚本自动处理所有先决条件（构建、cron 服务等）

使用案例：

  • 在 Docker 部署前本地测试入口点脚本更改
  • 验证日志轮转和日志功能
  • 测试优雅关闭和信号处理
  • 在本地环境中调试入口点脚本行为

每日摘要验证​

pnpm validate-daily-summary

运行确定性检查，包括每日摘要调度（包含夏令时）、快照聚合（仅最新备份作业）、剩余通知设置清理、孤立备份/服务器行、Markdown 净化、交付分类账声明，以及带自定义模板的模式 4.1 → 4.2 迁移。不发送电子邮件或 NTFY。