ttlequals0/pixelprobe

!https://raw.githubusercontent.com/ttlequals0/PixelProbe/main/static/images/pixelprobe-logo.png

PixelProbe

在损坏文件影响工作前发现它们。PixelProbe使用FFmpeg、ImageMagick和PIL扫描视频、图像和音频库，准确定位损坏文件。

核心功能

• 视频文件扫描：支持MP4、MKV、AVI、MOV、ProRes、MXF等格式，通过FFmpeg深度分析
• 图像验证：支持JPEG、PNG、TIFF、WebP、HEIC及佳能、尼康等品牌的RAW格式
• 音频检查：支持MP3、FLAC、WAV、AAC、DSD、Dolby/DTS等格式
• 总计支持92种音视频和图像格式
• 已测试100万+文件的库及单个50GB以上的文件

提供的功能

• 带明暗主题、移动支持和浏览器内媒体预览的Web UI
• 通过Cron表达式或简单间隔的定时扫描
• 可配置工作线程的并行扫描（推荐10-24线程）
• 实时进度跟踪及预计完成时间
• 带OpenAPI/Swagger文档的REST API
• 多用户认证（基于角色的访问控制和API令牌）
• 趋势分析、PDF/JSON导出及审计日志
• 与Healthcheck.io集成的监控功能

快速开始

1. 创建.env文件：

SECRET_KEY=生成一个长随机字符串
MEDIA_PATH=/path/to/your/media

2. 创建docker-compose.yml：

yaml
services:
  postgres:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: pixelprobe
      POSTGRES_USER: pixelprobe
      POSTGRES_PASSWORD: changeme
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine

  pixelprobe:
    image: ttlequals0/pixelprobe:latest
    environment:
      SECRET_KEY: ${SECRET_KEY}
      POSTGRES_HOST: postgres
      POSTGRES_PASSWORD: changeme
      CELERY_BROKER_URL: redis://redis:6379/0
      CELERY_RESULT_BACKEND: redis://redis:6379/0
      SCAN_PATHS: /media
      MAX_WORKERS: 10
    volumes:
      - ${MEDIA_PATH}:/media:ro
    ports:
      - "5000:5000"
    depends_on:
      - postgres
      - redis

  celery-worker:
    image: ttlequals0/pixelprobe:latest
    command: python celery_worker.py
    environment:
      SECRET_KEY: ${SECRET_KEY}
      POSTGRES_HOST: postgres
      POSTGRES_PASSWORD: changeme
      CELERY_BROKER_URL: redis://redis:6379/0
      CELERY_RESULT_BACKEND: redis://redis:6379/0
      SCAN_PATHS: /media
      MAX_WORKERS: 10
    volumes:
      - ${MEDIA_PATH}:/media:ro
    depends_on:
      - postgres
      - redis

volumes:
  postgres_data:

3. 启动服务：

bash
docker-compose up -d

4. 打开http://localhost:5000，通过首次运行向导创建管理员账户。

架构

包含四个容器，各承担单一任务：

应用和worker共享同一镜像，worker运行python celery_worker.py而非Gunicorn。

环境变量

必需变量

调优变量

调度变量

过滤变量

其他变量

多媒体目录

分别挂载每个目录并在SCAN_PATHS中列出：

yaml
environment:
  SCAN_PATHS: /movies,/tv-shows,/music
volumes:
  - /mnt/movies:/movies:ro
  - /mnt/tv-shows:/tv-shows:ro
  - /mnt/music:/music:ro

用户权限

应用和celery-worker容器必须以同一用户运行，且该用户需对媒体文件有读权限。在两个服务中添加：

yaml
user: "1000:1000"  # 匹配主机用户的UID:GID

链接

• https://github.com/ttlequals0/PixelProbe
• https://github.com/ttlequals0/PixelProbe/tree/main/docs
• https://github.com/ttlequals0/PixelProbe/blob/main/openapi.yaml
• https://github.com/ttlequals0/PixelProbe/blob/main/docs/DOCKER_SETUP.md
• https://github.com/ttlequals0/PixelProbe/blob/main/docs/CONFIGURATION.md
• https://github.com/ttlequals0/PixelProbe/blob/main/CHANGELOG.md

许可证

MIT