malice/fprot

malice-fprot

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

镜像概述

malice-fprot是基于F-PROT反病毒引擎的Docker插件，用于扫描文件中的***。该镜像已发布至DockerHub，支持与Malice生态系统集成，提供多种输出格式和扩展功能。

核心功能

• 扫描文件是否感染***
• 输出JSON或Markdown格式的扫描结果
• 支持更新病毒定义
• 提供Web服务接口用于远程扫描
• 可将结果存储至ElasticSearch
• 支持通过webhook回调发送扫描结果

使用场景

• 本地文件***检测
• 批量扫描指定目录下的文件
• 集成到安全分析工作流中
• 搭建轻量级反病毒扫描服务

配置说明

安装步骤

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

基础使用

bash
# 扫描EICAR测试文件
docker run --rm docker.xuanyuan.run/malice/fprot EICAR

挂载本地文件夹扫描

bash
# 将本地恶意软件目录挂载到容器内进行扫描
docker run --rm -v /path/to/malware:/malware:ro docker.xuanyuan.run/malice/fprot FILE

命令选项

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

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

Commands:
  update  更新病毒定义
  web     创建F-PROT扫描Web服务
  help    显示命令列表或单个命令帮助

示例输出

JSON格式

json
{
  "f-prot": {
    "infected": true,
    "result": "EICAR_Test_File (exact)",
    "engine": "4.6.5.141",
    "updated": "20170122"
  }
}

Markdown表格格式

F-PROT

扩展文档

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

问题反馈

如发现bug或需要新增功能，请通过https://github.com/malice-plugins/fprot/issues/new%E6%8F%90%E4%BA%A4%E5%8F%8D%E9%A6%88%E3%80%82

版本变更

详见https://github.com/malice-plugins/fprot/blob/master/CHANGELOG.md

贡献指南

欢迎提交Pull Request，提交前请更新https://github.com/malice-plugins/fprot/blob/master/CHANGELOG.md%E3%80%82

许可协议

MIT Copyright (c) 2016 blacktop