clamav-mock Docker镜像文档

镜像概述

clamav-mock是一个用于模拟ClamAV（开源防病毒软件）行为的Docker容器，旨在为开发、测试环境提供轻量级的防病毒软件模拟服务。该镜像基于GitHub项目obabec/clamav-mock构建，可模拟ClamAV的核心功能和响应，无需部署真实的ClamAV环境。

核心功能与特性

• 模拟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的基础功能，复杂特性（如病毒库更新）可能未完全实现
• 详细配置和高级用法请参考***源代码仓库：obabec/clamav-mock