Skip to content
KitploitKITPLOIT
ИнструментыЭксплойтыБлог
Log in
Отправить
ИнструментыЭксплойтыБлог
Отправить

Инструменты для хакинга, пентеста и кибербезопасности — ваш арсенал защиты!

Kitploit — это каталог инструментов для хакинга, кибербезопасности и пентестинга. Находите последние обновления проектов для поиска уязвимостей, анализа систем, автоматизации тестирования и усиления вашей безопасности.

ЛентыКонтактыКонфиденциальность© 2026 Kitploit

Каталог инструментов

Категории

Все категории
Loading categories
refinery — Высокооктановый триажный анализ | Kitploit
Инструменты/GitHubGitHub/binref/refinery
Обратная инженерияФорензикаАнализ вредоносных программКриптографияУтилиты и фреймворкиАнализ Бинарных ФайловРазведка угроз
GitHubbinref/refinery

refinery

Высокооктановый триажный анализ

Репозиторий
867805020 ч 7 мин назадПроверено Kitploit
Поделиться

Binary Refinery

[Документация][docs] [Статус тестов][tests] [Покрытие кода][codecov] [Версия PyPI][pypi]

  __     __  High Octane Triage Analysis          __
  ||    _||______ __       __________     _____   ||
  ||    \||___   \__| ____/   ______/___ / ____\  ||
==||=====||  | __/  |/    \  /==|  / __ \   __\===]|
  '======||  |   \  |   |  \_  _| \  ___/|  |     ||
         ||____  /__|___|__/  / |  \____]|  |     ||
=========''====\/=========/  /==|__|=====|__|======'
                         \  /
                          \/

Binary Refinery™ — это набор скриптов на Python, реализующих преобразования бинарных данных, такие как сжатие и шифрование. Мы часто будем называть его просто refinery, что также является именем соответствующего пакета. Скрипты спроектированы так, чтобы исключительно читать входные данные из stdin и записывать выходные данные в stdout. Основная философия заключается в том, что каждый скрипт должен быть единицей в том смысле, что он выполняет одну задачу, а отдельные единицы можно объединять в конвейеры с помощью оператора конвейера | в командной строке для выполнения более сложных задач. Основной фокус проекта — триаж вредоносного ПО, и это попытка реализовать нечто вроде CyberChef в командной строке.

Краткая версия

Создайте виртуальное окружение Python. Вам нужен Python 3.11 или новее. Установите refinery так:

python -m pip install -U pip
python -m pip install -U  --no-cache-dir binary-refinery[extended]

Запускайте юниты с -h, чтобы узнать, как они работают, ищите их через [docs][] или используйте команду binref. Посмотрите [недавнее видео][VOD3], если хотите увидеть это в действии. Но также прочитайте остальную часть этого readme.

График релизов

Графика релизов нет, но релизы выходят очень часто, и рекомендуется периодически обновляться. Исправления ошибок не документируются вне GIT, но все остальные изменения (т.е. новые функции) документируются в changelog. Следите за мной в [Mastodon][], чтобы получать обновления об особо значимых релизах.

Документация

Текст справки, отображаемый при запуске юнита с ключом -h или --help, является его основной документацией. [Автоматически сгенерированная документация][docs] содержит компиляцию этого вывода для каждого юнита верхнего уровня, а также спецификацию трёх фундаментальных концепций инструментария: [фрейминг][frame], [аргументы multibin][argformats] и [метапеременные][meta]. Полнотекстовый поиск по описанию и тексту справки для каждого юнита также доступен в командной строке через предоставляемую команду binref. Признавая тот факт, что справочная документация может быть несколько сухой, ведётся работа по созданию серии руководств; я настоятельно рекомендую с ними ознакомиться. Вдобавок ко всему, ниже я собираю дополнительные ресурсы (включая некоторые, созданные третьими сторонами).

[!NOTE]
Refinery всё ещё находится в альфа-версии, и интерфейс иногда может меняться, т.е. юниты и параметры могут быть удалены или переименованы. Поэтому может случиться, что конкретные командные строки из старых видео и постов в блогах больше не работают.

  • [2021/08] [OALabs][OA] любезно позволили мне [продемонстрировать инструментарий в видео][VOD1]. В видео я по сути прорабатываю содержимое первого руководства.
  • [2021/11] [Johannes Bader][JB] написал потрясающий [пост в блоге][BLOG] об анализе malspam с помощью binary refinery.
  • [2024/03] [Malware Analysis For Hedgehogs][MH] сделали [видео о распаковке образца XWorm][VOD2] с использованием refinery.
  • [2024/11] [the CyberYeti][CY] пригласил меня [на стрим с презентацией refinery][VOD3].
  • [2025/06] Я снова [был на стриме][VOD4] с [the CyberYeti][CY], этот получился немного более сырым. Все баги, которые вы там можете увидеть, были исправлены. 😉

Демонстрации снова включают образцы из раздела примеров ниже и руководства.

Лицензия

Binary Refinery является (c) 2019 Jesko Hüttenhain и публикуется под [3-Clause BSD License][license]. Этот репозиторий также содержит копию полного текста лицензии. Если вы хотите сделать с ним что-то, что не покрывается этой лицензией, пожалуйста, не стесняйтесь связаться с автором.

Предупреждения и советы

Refinery требует как минимум Python 3.11. Рекомендуется устанавливать его в собственное [виртуальное окружение][venv]: Пакет может подтянуть очень много зависимостей, и установка в глобальный Python несколько склонна к конфликтам версий. Кроме того, поскольку инструментарий вводит большое количество новых команд, есть большая вероятность, что некоторые из них будут конфликтовать в некоторых системах, и хранение их в отдельном виртуальном окружении — один из способов это предотвратить.

Если вы хотите, чтобы все команды refinery были доступны в вашей оболочке постоянно (т.е. без необходимости переключаться на пользовательское виртуальное окружение), у вас также есть возможность выбрать префикс для установки, который будет добавлен перед каждым устанавливаемым шимом команды. Например, если вы выберете r. в качестве префикса, то юнит [emit][] будет установлен как команда r.emit. Дополнительное преимущество в том, что вы можете набрать r. и дважды нажать Tab, чтобы получить список всех доступных команд refinery. Однако учтите, что в документации префикс не предполагается, и цель разработки refinery — не конфликтовать в большинстве систем. Автор не использует префикс и предоставляет эту опцию как подстраховку.

Установка

Самый простой способ установить и обновить refinery — через pip. Сначала убедитесь, что вы запускаете последнюю версию:

python -m pip install -U pip

Затем просто установите пакет refinery:

pip install -U --no-cache-dir binary-refinery

Если вы хотите выбрать префикс для всех юнитов, его можно указать через переменную окружения REFINERY_PREFIX. Например, следующая команда установит refinery в текущее окружение Python с префиксом r. в Linux:

REFINERY_PREFIX=r. pip install -U --no-cache-dir binary-refinery

В Windows вам нужно выполнить следующие команды:

set REFINERY_PREFIX=r.
pip install -U --no-cache-dir binary-refinery

Указание специального префикса ! приведёт к тому, что shell-команды вообще не будут созданы, а binary refinery будет установлен только как библиотека. Установите REFINERY_NO_EXTENSIONS=1, чтобы установить без расширений Cython; в этом случае refinery использует (гораздо более медленные) реализации нескольких алгоритмов на чистом Python.

Если вы хотите установить текущую версию refinery HEAD, вы можете повторить все вышеописанные шаги, указав этот репозиторий вместо pip-пакета. Например, следующая команда установит самый последний коммит refinery:

pip install -U --no-cache-dir git+git://github.com/binref/refinery.git

Наконец, если вы используете [REMnux][remnux-main], вы можете воспользоваться их [docker-контейнером refinery][remnux].

Установка Claude Skill

Если вы хотите научить свой локальный инструмент анализа вредоносного ПО [claude][] использовать binary refinery, ознакомьтесь с [Binary Refinery Skill][agent].

Поддержка оболочек

Ниже приведена сводка текущего уровня поддержки различных сред оболочки:

Скачать инструмент

Популярное

Смотреть все →

Откройте для себя самые используемые инструменты нашего сообщества.

Данных о популярности пока нет.

Изучить все инструменты

Просмотрите нашу коллекцию инструментов

Смотреть все инструменты →