mquery - YARA malware query accelerator (web frontend)

项目说明

mquery: Blazingly fast Yara queries for malware analysts

Ever had trouble searching for malware samples? Mquery is an
analyst-friendly web GUI to look through your digital warehouse.

It can be used to search through terabytes of malware in a blink of an eye:

!mquery web GUI

Under the hood we use our UrsaDB, to
accelerate yara queries with ngrams.

Demo

Public instance will be created soon, stay tuned...

Quickstart

1. Install and start

The easiest way to do this is with docker compose:

The web interface should be a at .


*(For more installation options see the installation manual ).*

2. Add the files

Put some files in the SAMPLES_DIR (by default ./samples in the repository,
configurable with in the .env file).

3. Index your collection

Launch ursacli in docker:

Index the samples with n-grams of your choosing (this may take a while!)

This will scan samples directory for all new files and index them. You can
monitor the progress in the tasks window on the left:


You have to repeat this process every time you want to add new files!

After indexing is over, you will notice new datasets:


This is a good and easy way to start, but if you have a big collection you are
strongly encouraged to read indexing page in the manual.

4. Test it

Now your files should be searchable - insert any Yara rule into the search
window and click Query. Just for demonstration, I' the source code
of this application and tested this Yara rule:


Learn more

See the documentation to learn more. Probably a good idea
if you plan a bigger deployment.

You can also read the hosted here:
cert-polska.github.io/mquery/docs.

Installation

See the
installation instruction.

Contributing

If you want to contribute, see our dedicated
documentation for contributors.

Changelog

Learn how the project has changed by reading our
release log.

Contact

If you have any problems, bugs or feature requests related to mquery, you're
encouraged to create a GitHub issue.

You can chat about this project on Discord:

![]()

If you ha unsuitable for Github or discord, you can email CERT.PL
() directly.

项目信息

开发语言：Python

Star 数：443

技术要点

该项目属于病毒分析方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕YARA malware query accelerator (web frontend)展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。