malice/avg

malice-avg

![Circle CI]([] ![License]([]

Malice AVG反病毒插件

本仓库包含avg的Dockerfile。

镜像概述

malice/avg是基于Debian系统的Docker镜像，集成AVG反病毒引擎，作为Malice平台的插件，提供文件病毒扫描能力，支持多种输出格式和集成方式，帮助用户快速检测文件是否感染***。

核心功能

• 扫描文件是否感染病毒，返回感染状态、病毒名称、引擎版本等信息
• 支持JSON和Markdown格式输出结果
• 可将扫描结果存储到ElasticSearch
• 提供Web服务接口，方便集成到其他系统
• 支持通过回调通知将结果发送到指定端点
• 可更新病毒定义库

使用场景

• 安全分析人员快速扫描可疑文件
• 集成到安全工作流中，自动化检测***文件
• 作为微服务提供病毒扫描接口
• 存储扫描结果用于后续分析

配置说明

依赖

• https://index.docker.io/_/debian/

安装

1. 安装Docker
2. 拉取镜像：docker pull malice/avg

基本使用

扫描EICAR测试文件

bash
docker run --rm malice/avg EICAR

扫描本地文件（挂载目录）

bash
docker run --rm -v /path/to/your/malware:/malware:ro malice/avg FILE_NAME

命令参数说明

bash
Usage: avg [OPTIONS] COMMAND [arg...]

Options:
  --verbose, -V          详细输出
  --elasticsearch value  ElasticSearch地址（用于存储结果）[$MALICE_ELASTICSEARCH_URL]
  --table, -t            以Markdown表格形式输出
  --callback, -c         将结果POST到Malice webhook [$MALICE_ENDPOINT]
  --proxy, -x            代理设置（用于webhook）[$MALICE_PROXY]
  --timeout value        插件超时时间（秒，默认120）[$MALICE_TIMEOUT]
  --help, -h             显示帮助
  --version, -v          打印版本

Commands:
  update  更新病毒定义库
  web     创建AVG扫描Web服务
  help    显示命令列表或帮助信息

示例输出

JSON格式

json
{
  "avg": {
    "infected": true,
    "result": "Virus identified EICAR_Test",
    "engine": "13.0.3114",
    "database": "4477/13807",
    "updated": "20170121"
  }
}

Markdown表格格式

AVG

扩展文档

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

问题反馈

发现bug或需要更多功能？请https://github.com/malice-plugins/avg/issues/new%E3%80%82

待办事项

• 添加可配置的重试次数

变更日志

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

贡献

https://github.com/malice-plugins/avg/graphs/contributors%EF%BC%8C%E6%AC%A2%E8%BF%8E%E6%8F%90%E4%BA%A4Pull Request并更新CHANGELOG.md。

许可证

MIT Copyright (c) 2016 blacktop