rordi/docker-antivirus

rordi/docker-antivirus

反病毒与反***软件微服务 Docker 容器

rordi/docker-antivirus 是一个以 Docker 微服务形式运行的病毒和***软件扫描器。它通过 inotify 监控预定义卷的文件写入事件，对每个新写入的文件调用 clamscan 进行扫描，不使用内存消耗较大的 ClamAV 守护进程。

注意事项

• 由于 ClamAV 签名下载限制，同一 IP 地址每小时只能构建一次镜像
• 容器空闲时内存消耗约为 10 MB
• 镜像由 Dietrich Rordorf（Ediqo）维护
• 初始 Dockerfile 为 IWF 准备
• 可通过 https://github.com/rordi/docker-antivirus 参与项目贡献

版本 2

• 发布于 2017 年 11 月 6 日
• 使用 supervisord 作为主命令，生成 inotify 和 cron 子进程
• 重构资产文件夹结构，减少镜像层数

版本 1

• 发布于 2017 年 1 月 19 日
• 首个稳定版本

核心功能与特性

• 基于 Linux Malware Detect (LMD) 和 ClamAV 扫描引擎
• 监控指定目录的文件写入事件并自动触发扫描
• 每小时自动更新 LMD 和 ClamAV 病毒签名
• 低内存消耗（空闲时约 10 MB）
• 支持文件分类存储：待扫描文件、扫描正常文件、感染文件报告
• 可选邮件告警功能，检测到病毒时发送通知

使用场景与适用范围

• Web 应用文件上传前扫描
• 服务器文件定期安全检查
• 作为微服务集成到现有文件处理流程
• 需要低资源消耗的轻量级病毒扫描场景

详细使用方法

快速开始

从 https://github.com/rordi/docker-antivirus 复制 docker-compose.yml 文件到本地，执行以下命令启动：

bash
docker-compose up -d

所需卷挂载

运行时需提供以下卷挂载（例如在 docker-compose 文件中）：

• /data/av/queue：待扫描文件存放目录
• /data/av/ok：扫描后正常文件存放目录
• /data/av/nok：感染文件报告存放目录

可选挂载隔离文件目录（便于其他容器处理隔离文件）：

• /data/av/quarantine：隔离文件存放目录

Docker 拉取与运行

1. 拉取镜像（latest 标签对应 master 分支，dev 标签对应开发分支）：

   bash
   docker pull rordi/docker-antivirus:latest
   

2. 运行容器（最后一个参数为可选***地址，用于启用病毒检测邮件告警）：

   bash
   docker run -tid --name docker-antivirus rordi/docker-antivirus [email@example.net]
   

Docker 构建与运行

1. 构建镜像：克隆仓库并进入根目录，执行构建命令：

   bash
   git clone https://github.com/rordi/docker-antivirus.git
   cd docker-antivirus
   docker build -t docker-antivirus .
   

2. 运行构建的镜像（可选***地址启用邮件告警）：

   bash
   docker run -tid --name docker-antivirus docker-antivirus:latest [email@example.net]
   

测试方法

使用 EICAR 测试文件 进行扫描测试。（注意：需手动创建文件并复制***页面中的测试内容）

docker-compose 配置示例

以下是集成到现有网络的 docker-compose 配置示例。替换 "yournetworkid" 为实际网络 ID，取消注释 "command" 可启用邮件告警，确保本地 ./data/av/... 目录存在或修改路径：

yaml
docker-av:
  image: rordi/docker-antivirus
  container_name: docker-av
  # 取消注释并设置***地址以接收病毒检测邮件告警
  #command:
  # - /usr/local/install_alerts.sh ***
  volumes:
    - ./data/queue:/data/av/queue
    - ./data/ok:/data/av/ok
    - ./data/nok:/data/av/nok
  networks:
    - yournetworkid