Rizin Notebook

리진을 이용한 바이너리 분석용 노트북입니다. 바이너리별로 노트, 명령어, 스크립트를 체계적으로 관리합니다.

rizin 0.7.0 이상이 필요합니다.

기능

각 노트북 페이지는 하나의 바이너리에 연결됩니다. 바이너리 자체, SHA-256 해시, 그리고 셀(cell) 목록을 저장합니다:

명령어 셀 - rizin 명령어와 그 출력
스크립트 셀 - rizin 파이프에 대해 서버에서 실행되는 JavaScript 스니펫
마크다운 셀 - 자유 형식의 노트

페이지는 ~/.rizin-notebook/ 디렉토리에 개별 .rznb 파일(SQLite 데이터베이스)로 저장됩니다. 단일 독립 파일로 내보내거나 가져올 수 있습니다.

구성 요소

Go 서버 (rizin-notebook) - 메인 애플리케이션. 웹 UI를 제공하고, protobuf + JSON REST API를 노출하며, 모든 것을 페이지별 .rznb SQLite 파일에 저장합니다.
rizin-notebook-plugin - rizin 코어 플러그인 (C). rizin에 NB 명령어를 추가하여 rizin 셸에서 노트북과 상호작용할 수 있습니다.
cutter-notebook-plugin - Cutter 플러그인 (C++/Qt6). Cutter에 플러그인 -> 노트북 도크와 메뉴를 추가합니다.

플러그인은 선택 사항입니다. Go 서버는 브라우저만으로 독립 실행됩니다.

호환성 참고

Go 서버는 플랫폼 독립적입니다. 플러그인은 빌드 시 사용된 Rizin 버전에 의존합니다.

독립 실행형 rizin과 Cutter가 서로 다른 Rizin 버전을 포함하고 있다면, 각각에 대해 rz_notebook을 한 번씩 빌드하세요. 두 빌드 모두 동일한 서버와 통신하고 동일한 .rznb 데이터를 공유할 수 있습니다.

간단한 규칙:

하나의 서버
사용 중인 Rizin 버전당 하나의 rz_notebook 빌드
Cutter 도크를 원한다면 하나의 Cutter 플러그인

스크린샷

프로젝트 스크린샷은 docs/images/ 디렉토리에 정리되어 있습니다.

웹 UI

그림 1. 홈페이지 보기 (셀 및 범위 기반 검색, 여러 모드 지원) Rizin 노트북 설정 페이지

그림 2. 환경 설정, 키보드 단축키, 서버 측 동작을 위한 설정 페이지 노트북 웹 UI의 Rizin 명령어 자동 완성 제안

그림 3. 웹 콘솔의 명령어 자동 완성으로 Rizin 명령어를 빠르게 찾고 완성할 수 있습니다. 노트북 웹 UI의 명령어 검색 및 도움말 모달

그림 4. 명령어 설명과 인자를 탐색하기 위한 내장 명령어 도움말 및 검색 모달

플러그인 통합

그림 5. Rizin 코어 플러그인 통합으로 Rizin 셸에서 직접 노트북 상호작용 가능 Cutter 플러그인 통합 스크린샷 1

그림 6. Cutter 인터페이스 내에서 노트북 경험을 보여주는 Cutter 플러그인 통합 보기 Cutter 플러그인 통합 스크린샷 2

그림 7. 가능한 노트북 사용법을 보여주는 추가 Cutter 플러그인 워크플로 보기

서버 빌드

go build -o rizin-notebook .

릴리스 빌드 시 버전 문자열을 포함하려면:

go build -ldflags "-X main.NBVERSION=$(git rev-parse --short HEAD)" -o rizin-notebook .

실행

./rizin-notebook

기본적으로 http://127.0.0.1:8000/에서 열립니다.

플래그:

-bind 127.0.0.1:8000    address and port to listen on
-root /                  URL path prefix
-notebook /path/to/data  data directory (default: ~/.rizin-notebook)
-debug-assets /path      load templates from disk instead of embedded
-debug                   enable HTTP request logs

파이프 실행에 사용되는 rizin 바이너리 경로를 재정의하려면 RIZIN_PATH를 설정하세요.

rizin 플러그인 빌드

rizin-notebook-plugin/README.md를 참조하세요.

Cutter 플러그인 빌드

cutter-notebook-plugin/README.md를 참조하세요.

Cutter가 자체 내장 Rizin을 포함하는 경우, Cutter가 로드하는 rz_notebook 플러그인은 동일한 번들 Rizin 버전에 대해 빌드되어야 합니다.

데이터 저장

각 페이지는 데이터 디렉토리에 있는 .rznb 파일입니다. SQLite 데이터베이스이며 다음을 포함합니다:

페이지 메타데이터 (제목, 원본 파일명, 바이너리 저장 키, SHA-256 해시)
셀 (유형, 내용, 출력, 타임스탬프)
바이너리 blob 자체
페이지별 설정 (키/값)

서버는 모든 페이지에 걸친 빠른 목록을 위해 catalog.db 인덱스를 유지합니다.

첫 실행 시 서버는 기존 단일 notebook.db 형식의 페이지를 자동으로 페이지별 .rznb 레이아웃으로 마이그레이션합니다.

API

모든 NB 플러그인 명령어는 protobuf API(Content-Type: application/x-protobuf)를 사용합니다. 스키마는 proto/notebook.proto에 있습니다.

Cutter 플러그인과 브라우저 UI는 /api/v1/json/...의 병렬 JSON API를 사용합니다.

rizin-notebook

인기