Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
refinery — 하이 옥탄 트라이지 분석 | Kitploit
도구/GitHubGitHub/binref/refinery
Reverse EngineeringForensicsMalware AnalysisCryptographyUtilities & FrameworksBinary AnalysisThreat Intelligence
GitHubbinref/refinery

refinery

하이 옥탄 트라이지 분석

저장소 보기
867805010시간 38분 전Kitploit 검토 완료
공유

Binary Refinery

[Documentation][docs] [Test Status][tests] [Code Coverage][codecov] [PyPI Version][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][]를 grep하거나, binref 명령을 사용하여 찾아보세요. 실제 동작을 보고 싶다면 [최근 영상][VOD3]을 시청하세요. 그리고 이 readme의 나머지 부분도 읽어보세요.

릴리스 일정

정해진 릴리스 일정은 없지만 릴리스는 매우 자주 이루어지므로 주기적으로 업데이트하는 것을 권장합니다. 버그 수정은 GIT 외부에 문서화되지 않지만, 그 외의 모든 변경 사항(즉, 새로운 기능)은 변경 로그에 문서화됩니다. 특히 영향력이 큰 릴리스에 대한 업데이트는 [Mastodon][]에서 저를 팔로우하세요.

문서

-h 또는 --help 스위치로 유닛을 실행할 때 표시되는 도움말 텍스트가 해당 유닛의 주요 문서입니다. [자동 생성된 문서][docs]에는 최상위 수준의 각 유닛에 대한 해당 출력의 편집본이 포함되어 있을 뿐만 아니라, 툴킷의 세 가지 기본 개념에 대한 명세도 포함되어 있습니다: [프레이밍][frame], [멀티빈 인수][argformats], 그리고 [메타 변수][meta]입니다. 모든 유닛의 설명과 도움말 텍스트에 대한 전문 검색도 제공되는 binref 명령을 통해 명령줄에서 사용할 수 있습니다. 참조 문서가 다소 건조할 수 있다는 점을 인식하여, 일련의 튜토리얼을 제작하기 위한 작업이 진행 중이며, 이를 꼭 확인해 보시길 강력히 권장합니다. 그뿐만 아니라, 아래에 추가 자료(제3자가 제작한 일부 포함)를 모아 두었습니다.

[!NOTE]
Refinery는 아직 알파 단계이며 인터페이스가 때때로 변경될 수 있습니다, 즉, 유닛과 매개변수가 제거되거나 이름이 변경될 수 있습니다. 따라서 오래된 영상과 블로그 게시물의 특정 명령줄이 더 이상 작동하지 않을 수 있습니다.

  • [2021/08] [OALabs][OA]의 배려로 [기능 영상에서 툴킷을 시연][VOD1]할 수 있었습니다. 영상에서 저는 기본적으로 첫 번째 튜토리얼의 내용을 차례로 다룹니다.
  • [2021/11] [Johannes Bader][JB]가 binary refinery로 malspam을 분석하는 것에 관한 멋진 [블로그 게시물][BLOG]을 작성했습니다.
  • [2024/03] [Malware Analysis For Hedgehogs][MH]가 refinery를 사용하여 [XWorm 샘플을 언패킹하는 영상][VOD2]을 만들었습니다.
  • [2024/11] [the CyberYeti][CY]가 [스트림에서 refinery를 발표][VOD3]하도록 저를 초대했습니다.
  • [2025/06] [the CyberYeti][CY]와 함께 [다시 스트림에 출연][VOD4]했는데, 이번 것은 조금 더 날것입니다. 여기서 보이는 모든 버그는 수정되었습니다. 😉

쇼케이스에는 아래 예시 섹션의 샘플과 튜토리얼이 다시 포함됩니다.

라이선스

Binary Refinery는 (c) 2019 Jesko Hüttenhain이며, [3-Clause BSD License][license]에 따라 게시됩니다. 이 저장소에는 전체 라이선스 텍스트 사본도 포함되어 있습니다. 이 라이선스에서 다루지 않는 작업을 하고 싶다면 저자에게 편하게 연락하세요.

경고 및 조언

refinery는 최소 Python 3.11이 필요합니다. 자체 [가상 환경][venv]에 설치하는 것을 권장합니다: 패키지가 많은 의존성을 끌어올 수 있으며, 전역 Python에 설치하면 버전 충돌이 발생하기 쉽습니다. 또한 툴킷이 다수의 새로운 명령을 도입하기 때문에, 일부 시스템에서는 이들 중 일부가 충돌할 가능성이 높으며, 이를 별도의 가상 환경에 유지하는 것이 이를 방지하는 한 가지 방법입니다.

모든 refinery 명령을 항상 셸에서 사용할 수 있도록 하려면(즉, 사용자 지정 가상 환경으로 전환할 필요 없이), 설치에 _접두사_를 선택하는 옵션도 있으며, 이 접두사는 설치되는 모든 명령 심(shim) 앞에 붙습니다. 예를 들어 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를 통해 지정할 수 있습니다. 예를 들어, 다음 명령은 Linux에서 접두사 r.을 사용하여 현재 Python 환경에 refinery를 설치합니다:

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

Windows에서는 다음 명령을 실행해야 합니다:

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

특수 접두사 !를 지정하면 셸 명령이 전혀 생성되지 않으며, 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]를 사용하고 있다면 해당 프로젝트의 [refinery docker 컨테이너][remnux]를 사용할 수 있습니다.

Claude Skill 설치

로컬 멀웨어 분석용 [claude][]가 binary refinery를 사용하도록 가르치고 싶다면 [Binary Refinery Skill][agent]을 확인하세요.

셸 지원

다음은 다양한 셸 환경의 현재 지원 수준을 요약한 것입니다:

ShellPlatformStateComment
BashPosix🔵 양호작성자가 가끔 사용합니다.
CMDWindows🔵 양호작성자가 광범위하게 사용합니다.
PowerShellWindows🟡 합리적[PowerShell 버전이 최소 7.4이면 그냥 작동합니다.][psh1]
ZshPosix🟠 사소한 문제[논의][zsh1]에 따라 [수정][zsh2]이 있습니다.
FishPosix🟠 사소한 문제이슈 [#55][fsh1] 및 논의 [#22][fsh2]를 참조하세요.

다른 셸을 사용 중이며 공유할 피드백이 있다면 알려주세요!

모듈형 종속성

(때로는 큰) 외부 종속성을 가진 매우 상황별 단위가 있습니다. 예를 들어, [stego][]는 이미지 파싱 라이브러리 Pillow가 필요한 단위입니다. 일부 라이브러리는 첫 사용자를 위해 refinery의 설치 시간을 합리적인 수준으로 유지하기 위해 기본적으로 설치되지 않습니다. 해당 단위는 종속성이 누락되었을 때 수행할 작업을 알려줍니다:

$ emit config.png | stego RG
(13:37:00) failure in stego: dependency Pillow is missing; run pip install Pillow

그런 다음 누락된 종속성을 수동으로 설치할 수 있습니다. 누락된 종속성에 신경 쓰고 싶지 않고 긴 refinery 설치 과정을 감수할 수 있다면, 다음과 같이 패키지를 설치할 수 있습니다:

pip install -U binary-refinery[all]

필수 의존성 위에 모든 의존성을 설치합니다. 더 정확히 말하면, 다음과 같은 추가 범주를 사용할 수 있습니다:

이름포함되는 의존성
default합리적인 의존성의 권장 선택, 작성자의 선택
extended가장 모호한 것들만 제외한 확장된 선택
all모든 refinery 유닛에 대한 모든 의존성

이는 오름차순으로 나열되어 있습니다. 즉, extended는 default가 설치하는 모든 것을 설치합니다.

Bleeding Edge

또는 이 저장소를 복제하고 update.sh(Linux) 또는 update.ps1(Windows) 스크립트를 사용하여 로컬 가상 환경에 refinery 패키지를 설치할 수 있습니다. 이 방법의 설치 및 업데이트 과정은 단순히 스크립트를 실행하는 것입니다:

  • 저장소를 가져오고,
  • 가상 환경을 활성화하고,
  • binary-refinery를 제거한 다음,
  • binary-refinery[all]을 설치합니다.

문서 생성

모든 문서를 로컬에서 생성할 수도 있습니다. 그렇게 하려면 run-pdoc3.py 스크립트를 실행하십시오. 이 스크립트는 binary refinery가 Python 패키지로 설치된 환경에서 실행하지 않으면 실패합니다. 실행하려면 run-pdoc3.py의 첫 번째 명령줄 인수로 가상 환경의 경로를 지정해야 하며, 그러면 스크립트가 해당 환경의 인터프리터를 사용하여 자기 자신을 다시 실행합니다. run-pdoc3.py를 실행하기로 확실히 결정했다면, 스크립트가 현재 기본 Python 인터프리터로 실행되도록 강제하는 명령줄 스위치가 있습니다. 이 스크립트는 [pdoc3 패키지][pdoc3]를 설치하고 이를 사용하여 refinery 패키지에 대한 HTML 문서를 생성합니다. 그런 다음 문서는 이 readme 파일 바로 옆의 html 하위 디렉터리에서 찾을 수 있습니다.

도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 궁극의 OSINT 툴킷: 조사 그래프, 신뢰도 점수 산정, 별칭 패밀리, 지도, 타임라인 및 보고서. 49개 모듈, 400개 이상 사이트, API 키 불필요.

    708
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # GhostLock 원탭 실행 앱 (CVE-2026-43499)

    500
  • 3

    ARTEX

    baarai/artex

    LLM 멀티 에이전트 자율 침투 테스트 플랫폼으로, 플래너/워커 에이전트, 자산 및 탐색 그래프, MITM 트래픽 기록, 취약점 재테스트 기능을 제공합니다.

    398
  • 4

    redforge

    cybersecurity91/redforge

    브라우저 측 레드 팀 툴킷으로, 정찰, 페이로드 생성, 자격 증명 공격, 암호화, 인코딩 및 참여 보고를 위한 102개의 오프라인 도구를 제공합니다.

    341
  • 5

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AI 네이티브 사이버보안을 위한 행동 체계—의도가 통제된 실행이 되고, 증거가 운영 메모리가 되며, 모든 운영이 다음 운영을 개선하는 곳.

    259
  • 6

    antifox

    antifox-ai/antifox

    정찰, 공격 표면 탐색, 익스플로잇 검증, 증거 기반 보고서 전달을 수행하는 AI 멀티 에이전트 자율 침투 테스트 플랫폼입니다.

    257

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →