malice/nsrl

!https://raw.githubusercontent.com/malice-plugins/nsrl/master/docs/logo.png

malice-nsrl

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

镜像概述

malice-nsrl是Malice平台的NSRL插件，将NIST NSRL数据库（约5.5GB）转换为仅77.4MB的布隆过滤器（误报率约0.001），实现高效的文件哈希查询，帮助判断文件是否属于已知合法软件。

核心功能

1. 数据库转换：将NSRL数据库转换为轻量布隆过滤器，减少存储和查询成本。
2. 哈希查询：支持MD5和SHA1哈希查询，快速返回文件是否存在于NSRL库中。
3. Web服务：提供NSRL查询的微服务接口。
4. 集成能力：可与ElasticSearch集成存储结果，支持Webhook回调。

使用场景

• 安全分析：辅助***检测，判断文件是否为已知合法软件。
• 合规检查：验证文件是否符合NSRL库中的合法软件标准。
• 自动化工作流：集成到安全扫描 pipeline 中，快速过滤合法文件。

配置说明

依赖

• https://hub.docker.com/r/malice/alpine/

镜像标签

安装步骤

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

使用命令示例

查看帮助

bash
docker run --rm malice/nsrl --help

哈希查询

• MD5查询：

  bash
  docker run --rm malice/nsrl:md5 lookup 829e4805b0e12b383ee09abdc9e2dc3c
  

• SHA1查询：

  bash
  docker run --rm malice/nsrl:sha1 lookup 5a272b7441328e09704b6d7eabdbd51b8858fde4
  

输出格式

• JSON输出示例：

  json
  {
    "nsrl": {
      "found": true,
      "hash": "5A272B7441328E09704B6D7EABDBD51B8858FDE4"
    }
  }
  

• Markdown输出示例：

  markdown
  #### NSRL Database
  - Found :white_check_mark:
  

高级功能

• ElasticSearch集成：将结果写入ElasticSearch（需设置MALICE_ELASTICSEARCH_URL环境变量）。
• Web服务：启动查询微服务：docker run --rm -p 3000:3000 malice/nsrl web。
• Webhook回调：通过--post参数将结果发送到指定Webhook。

文档与支持

• https://github.com/malice-plugins/nsrl/blob/master/docs/elasticsearch.md
• https://github.com/malice-plugins/nsrl/blob/master/docs/web.md
• https://github.com/malice-plugins/nsrl/issues/new

许可证

MIT协议（Copyright © 2015 blacktop）