obabec/clamav-mock

clamav-mock Docker镜像文档

镜像概述

clamav-mock是一个用于模拟ClamAV（开源防病毒软件）行为的Docker容器，旨在为开发、测试环境提供轻量级的防病毒软件模拟服务。该镜像基于GitHub项目https://github.com/obabec/clamav-mock%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%8F%AF%E6%A8%A1%E6%8B%9FClamAV%E7%9A%84%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E5%92%8C%E5%93%8D%E5%BA%94%EF%BC%8C%E6%97%A0%E9%9C%80%E9%83%A8%E7%BD%B2%E7%9C%9F%E5%AE%9E%E7%9A%84ClamAV%E7%8E%AF%E5%A2%83%E3%80%82

核心功能与特性

• 模拟ClamAV扫描行为：支持模拟病毒扫描结果，包括"检测到病毒"（FOUND）和"未检测到病毒"（NOT_FOUND）两种核心响应
• 命令行工具模拟：模拟clamscan、clamdscan等ClamAV命令行工具的基本行为和输出格式
• clamd服务模拟：模拟ClamAV后台服务（clamd）的TCP接口（默认端口3310），支持客户端连接和扫描请求
• 自定义响应配置：可通过环境变量或配置文件自定义扫描结果、响应延迟等参数
• 轻量级设计：基于精简基础镜像，容器体积小，启动速度快，适合集成到CI/CD流程

使用场景

• 应用开发测试：开发需要与ClamAV集成的应用时，模拟防病毒扫描场景，验证应用在病毒检测/未检测时的处理逻辑
• CI/CD流程集成：在持续集成环境中测试防病毒相关功能，无需依赖真实的ClamAV服务或病毒库
• 培训与演示：在教学或演示场景中模拟防病毒软件的工作流程，避免使用真实病毒样本的安全风险
• 兼容性测试：验证应用对ClamAV命令行工具或clamd服务接口的兼容性，无需配置真实环境

使用方法

基本使用（命令行模拟）

通过docker run启动容器，直接模拟clamscan命令行为：

bash
# 模拟"检测到病毒"的扫描结果
docker run --rm obabec/clamav-mock clamscan --mock-result=FOUND /path/to/test/file

# 模拟"未检测到病毒"的扫描结果
docker run --rm obabec/clamav-mock clamscan --mock-result=NOT_FOUND /path/to/test/file

模拟clamd服务（后台模式）

启动容器并暴露ClamAV默认服务端口（3310），模拟clamd服务：

bash
# 启动模拟clamd服务，默认监听3310端口
docker run -d -p 3310:3310 --name clamav-mock obabec/clamav-mock clamd

# 从主机测试连接（需安装clamd客户端工具）
echo PING | nc localhost 3310  # 应返回"PONG"

自定义配置

通过环境变量自定义容器行为：

示例：启动带延迟的模拟服务，默认返回"检测到病毒"：

bash
docker run -d -p 3310:3310 \
  -e MOCK_SCAN_RESULT=FOUND \
  -e MOCK_DELAY=1000 \
  --name clamav-mock obabec/clamav-mock clamd

docker-compose集成

在docker-compose.yml中集成到应用测试环境：

yaml
version: '3'
services:
  app:
    build: .
    depends_on:
      - clamav-mock
    environment:
      - CLAMAV_HOST=clamav-mock
      - CLAMAV_PORT=3310

  clamav-mock:
    image: obabec/clamav-mock
    ports:
      - "3310:3310"
    environment:
      - MOCK_SCAN_RESULT=FOUND  # 模拟环境中默认返回"检测到病毒"
    command: clamd

注意事项

• 该镜像仅用于开发、测试和演示，不得用于生产环境
• 不提供真实的病毒检测能力，所有扫描结果均为模拟生成
• 命令行参数和服务接口仅模拟ClamAV的基础功能，复杂特性（如病毒库更新）可能未完全实现
• 详细配置和高级用法请参考官方源代码仓库：https://github.com/obabec/clamav-mock