malice/clamav

malice-clamav

https://circleci.com/gh/malice-plugins/clamav.png?style=shield](https://circleci.com/gh/malice-plugins/clamav) http://img.shields.io/:license-mit-blue.svg]([***] https://img.shields.io/docker/stars/malice/clamav.svg](https://hub.docker.com/r/malice/clamav/) https://img.shields.io/docker/pulls/malice/clamav.svg](https://hub.docker.com/r/malice/clamav/) https://img.shields.io/badge/docker%20image-205MB-blue.svg](https://hub.docker.com/r/malice/clamav/)

镜像概述

本镜像包含ClamAV反病毒软件的Docker化版本，是Malice插件生态的一部分，用于扫描文件中的***并输出结构化结果，支持集成到安全工作流中。

核心功能

1. 检测文件是否感染***
2. 返回详细结果（感染状态、病毒签名、引擎版本等）
3. 支持JSON/Markdown表格等输出格式
4. 可将结果发送至webhook或存储到Elasticsearch
5. 提供病毒库更新命令和扫描微服务功能

使用场景

• 安全研究人员扫描***样本
• 自动化安全工作流中的文件检测环节
• 搭建本地/云端文件扫描服务
• 快速验证文件安全性

配置说明

安装步骤

1. 安装Docker环境
2. 拉取镜像：docker pull malice/clamav

基础使用

扫描EICAR测试文件：

bash
docker run --rm malice/clamav EICAR

扫描本地文件（挂载目录到容器/malware路径）：

bash
docker run --rm -v /本地文件路径:/malware:ro malice/clamav 目标文件名

命令选项

• --verbose, -V：输出详细日志
• --table, -t：以Markdown表格格式输出结果
• --callback, -c：将结果POST到指定webhook（需设置$MALICE_ENDPOINT环境变量）
• --elasticsearch value：存储结果到Elasticsearch（需设置$MALICE_ELASTICSEARCH_URL）
• --timeout value：设置扫描超时时间（默认60秒）

子命令

• update：更新病毒定义库
• web：启动ClamAV扫描微服务
• help：查看子命令帮助

示例输出

JSON格式

json
{
  "clamav": {
    "infected": true,
    "result": "Eicar-Test-Signature",
    "engine": "0.99.2",
    "known": "5630857",
    "updated": "20170123",
    "error": ""
  }
}

Markdown表格格式

---

ClamAV

---

扩展文档

• https://github.com/malice-plugins/clamav/blob/master/docs/elasticsearch.md
• https://github.com/malice-plugins/clamav/blob/master/docs/web.md
• https://github.com/malice-plugins/clamav/blob/master/docs/callback.md
• https://github.com/malice-plugins/clamav/blob/master/docs/update.md

问题反馈

如有功能需求或bug，请在https://github.com/malice-plugins/clamav/issues/new%E6%8F%90%E4%BA%A4issue%E3%80%82

变更日志

查看https://github.com/malice-plugins/clamav/blob/master/CHANGELOG.md

贡献

欢迎提交Pull Request，提交前请更新CHANGELOG.md。

许可证

MIT许可证，版权所有(c) 2016 blacktop