aptrust/apt_queue_fixity

Fixity Check Queue Service 镜像文档

镜像概述

Fixity Check Queue Service 是一个用于队列化文件以执行完整性校验的服务镜像。该服务提供文件队列管理、校验任务调度及结果记录功能，适用于需要定期或触发式验证文件完整性的场景，确保数据未被篡改或损坏。

核心功能和特性

• 文件队列管理：支持文件添加、优先级排序及队列状态监控
• 多算法支持：集成 MD5、SHA-1、SHA-256 等主流哈希算法
• 任务调度：支持定时校验（如每小时/每天）和触发式校验（文件变更时）
• 结果记录：校验结果可输出至日志文件或外部数据库
• 可配置参数：支持通过环境变量自定义校验间隔、队列容量等

使用场景和适用范围

• 数据备份系统：校验备份文件完整性，确保备份可用
• 档案管理系统：验证长期存储文件未损坏或篡改
• 文件传输验证：文件传输后自动校验完整性
• 内容分发网络：确保节点间文件一致性

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name fixity-queue-service \
  -v /host/path/to/files:/app/files \  # 挂载待校验文件目录
  -v /host/path/to/logs:/app/logs \    # 挂载日志目录
  -e CHECK_INTERVAL=3600 \             # 校验间隔（秒，默认3600）
  -e HASH_ALGORITHM=SHA256 \           # 哈希算法（默认SHA256）
  -e QUEUE_SIZE=1000 \                 # 队列最大容量（默认1000）
  fixity-queue-service:latest

Docker Compose 配置

yaml
version: '3'
services:
  fixity-queue:
    image: fixity-queue-service:latest
    container_name: fixity-queue-service
    volumes:
      - /host/files:/app/files
      - /host/logs:/app/logs
    environment:
      - CHECK_INTERVAL=3600
      - HASH_ALGORITHM=SHA256
      - QUEUE_SIZE=1000
      - LOG_LEVEL=INFO  # 日志级别（DEBUG/INFO/WARN/ERROR）
    restart: unless-stopped

环境变量配置

操作说明

1. 添加文件到队列：将待校验文件放入挂载的 /app/files 目录，服务会自动将文件加入校验队列
2. 查看校验结果：日志文件位于 /app/logs/fixity_check.log，格式包含文件名、校验时间、哈希值、结果状态
3. 手动触发校验：通过容器内命令 fixity-queue trigger <filename> 触发指定文件的立即校验

注意事项

• 确保挂载的文件目录有读写权限
• 大文件校验可能占用较高CPU资源，建议根据服务器配置调整队列大小
• 使用外部数据库时需确保网络连接正常并提前创建数据表结构