핑거프린트 패스가 끝나면 OpenDoor는 사전 열거가 시작되기 전에 간결한 사전 스캔 요약을 출력합니다:```text
Fingerprint result: cms/WordPress (95%)
Web stack: WordPress | PHP | Cloudflare
Security posture: HSTS preload-ready

### pip```bash
python3 -m pip install --upgrade opendoor

Chocolatey 패키지는 커뮤니티 검토가 완료되는 동안 최신 GitHub/PyPI 릴리스보다 지연될 수 있습니다.

### Arch Linux / AUR

OpenDoor은 Arch User Repository에서 사용할 수 있습니다:```bash
yay -S opendoor

### Docker

OpenDoor는 GitHub Container Registry를 통해 공식 프로젝트 Docker 이미지로 제공됩니다.```bash
docker pull ghcr.io/stanislav-web/opendoor:latest
docker run --rm -it ghcr.io/stanislav-web/opendoor:latest --version

### BlackArch Linux

OpenDoor는 BlackArch Linux에서 사용할 수 있습니다:```bash
sudo pacman -Syu
sudo pacman -S opendoor

전체 [설치 가이드](https://opendoor.readthedocs.io/Installation-and-update/)를 참조하세요.

---

## 🚀 빠른 사용법

### 기본 디렉터리 스캔```bash
opendoor --host https://example.com

`--crawl`는 선택적으로 활성화되는 옵션이며 디렉터리 스캔에서만 작동합니다. 이 옵션은 `GET`을 사용하고, 이미 스캔된 응답에서 보수적인 HTML 속성을 추출하며, 동일 출처(same-origin) URL만 유지하고, 무시 대상 확장자를 존중하며, POST 양식과 외부 출처를 건너뜁니다. 그리고 발견된 URL을 일반 결과 버킷을 통해 보고합니다.

### 서브도메인 스캔```bash
opendoor --host example.com --scan subdomains

대상 파일에는 URL, 도메인, IPv4 주소, IPv4 CIDR 블록 및 포괄적 IPv4 범위가 혼합되어 있을 수 있습니다:```text
https://example.com
app.example.com
192.168.1.10
192.168.1.0/24
192.168.1.10-192.168.1.50

동일한 혼합 대상 형식이 STDIN을 통해 지원됩니다.

### 저소음 스캔```bash
opendoor \
  --host https://example.com \
  --method GET \
  --auto-calibrate \
  --include-status 200-299,301,302,403 \
  --exclude-status 404,429,500-599 \
  --exclude-size-range 0-256 \
  --sniff endpoint,secret,shadow,openredirect,malware,skipempty,collation,indexof,file,stacktrace \
  --reports std,json,csv,sarif

유용한 스니퍼는 다음과 같습니다.

| 스니퍼             | 용도                                                                                                                             |
|---------------------|-------------------------------------------------------------------------------------------------------------------------------------|
| `indexof`           | 디렉터리 목록 페이지를 탐지합니다.                                                                                                     |
| `file`              | 알려진 민감한 파일 노출 패턴을 탐지합니다.                                                                                      |
| `collation`         | 오탐을 유발할 수 있는 반복되거나 리디렉션 유사 폴백 응답을 탐지합니다.                                               |
| `skipempty`         | 빈 응답을 건너뜁니다.                                                                                                               |
| `skipsizes=46`      | 정확히 알려진 노이즈 크기의 응답을 건너뜁니다.                                                                                        |
| `skipsizes=46:1024` | 노이즈 크기 범위 내의 응답을 건너뜁니다.                                                                                           |
| `stacktrace`        | 노출된 디버그/런타임 스택 트레이스 및 내부 오류 세부 정보를 탐지합니다.                                                               |
| `secret`            | 보고서 메타데이터를 편집하여 노출 가능성이 있는 API 키, 토큰, 개인 키 및 자격 증명을 탐지합니다.                               |
| `shadow`            | 확인된 `200 OK` 파일류 히트에 대해 `.bak`, `.old` 및 경로 템플릿과 같은 제한된 백업/섀도 변형을 적극적으로 프로브합니다. |
| `openredirect`      | 제어된 마커 URL로 리디렉션 유사 쿼리 매개변수를 적극적으로 검증하고 확인된 오픈 리디렉션 취약점만 보고합니다. |
| `endpoint`          | 이미 가져온 응답에서 클라이언트에 노출된 WebSocket, Socket.IO, SSE/EventSource 및 AJAX 엔드포인트를 수동적으로 탐지합니다.                       |
| `malware`           | 악성 콘텐츠, 웹셸 마커, 주입된 스크립트 또는 난독화된 페이로드 가능성을 탐지합니다.                                       |

본문에 의존하는 스니퍼는 구성된 메서드가 `HEAD`인 경우 내부적으로 `GET`을 자동으로 강제합니다.

자세히 보기: [Sniffers 참조](https://opendoor.readthedocs.io/Sniffers/)

### 원시 요청으로부터의 인증된 스캔```bash
opendoor \
  --raw-request request.txt \
  --scheme https \
  --method GET \
  --auto-calibrate \
  --reports json,html,sqlite,sarif

### 내결함성 스캔

불안정한 대상, 느린 네트워크, 일시적인 WAF 차단, 프록시 불안정 또는 장기 실행 승인 스캔에는 보다 보수적인 런타임 프로필을 사용하십시오.```bash
opendoor \
  --host https://example.com \
  --method GET \
  --timeout 60 \
  --retries 5 \
  --retries-fail-streak 25 \
  --auto-calibrate \
  --waf-detect \
  --waf-guard \
  --session-save session.json \
  --reports std,json,html

활성 스캔 중에 `Ctrl+C`를 한 번 눌러 작업자를 일시 중지한 다음, 계속하려면 `C`를, 중단하려면 `E`를 선택하세요.

### 헤더 및 경로 우회 프로브

승인된 테스트 대상 시스템에서만 사용하세요. 이 기능은 옵트인 방식이며, 통제된 임시 헤더와 안전한 경로 변형을 사용하여 차단된 리소스를 프로브합니다.```bash
opendoor \
  --host https://example.com \
  --method GET \
  --waf-detect \
  --header-bypass \
  --header-bypass-limit 32 \
  --reports std,json,csv,sarif,sqlite

### 프록시 라우팅

단일 명시적 프록시를 사용하세요:```bash
opendoor --host https://example.com --proxy socks5://127.0.0.1:9050

커스텀 순환 프록시 목록 사용:```bash
opendoor --host https://example.com --proxy-list proxies.txt

OpenVPN이 `PATH` 외부에 설치된 경우, 백엔드를 명시적으로 전달하세요:```bash
opendoor \
  --host https://example.com \
  --transport openvpn \
  --transport-profile ./profile.ovpn \
  --transport-bin /opt/homebrew/sbin/openvpn

더 많은 예시:

- [기본 스캔](https://opendoor.readthedocs.io/examples/basic-scans/)
- [배치 스캔](https://opendoor.readthedocs.io/examples/batch-scans/)
- [인증 스캔](https://opendoor.readthedocs.io/examples/authenticated-scans/)
- [WAF 안전 스캔](https://opendoor.readthedocs.io/examples/waf-safe-scans/)
- [헤더 우회 스캔](https://opendoor.readthedocs.io/examples/header-bypass-scans/)
- [VPN 전송 스캔](https://opendoor.readthedocs.io/examples/vpn-transport-scans/)
- [CI/CD 예시](https://opendoor.readthedocs.io/examples/ci-cd/)

---

### 차이 보고서 비교

OpenDoor는 새 스캔을 실행하지 않고 정확히 두 개의 이전/현재 보고서를 비교할 수 있습니다. 두 승인된 스캔 결과 사이에서 무엇이 나타났는지, 사라졌는지, 변경되었는지 확인하려면 이 기능을 사용하세요.

지원되는 입력 쌍은 SQLite-to-SQLite 및 JSON-to-JSON뿐입니다. 혼합 형식, 누락된 파일, 잘못된 보고서 및 지원되지 않는 보고서 유형은 깔끔한 검증 오류와 함께 실패합니다.```bash
opendoor --diff reports/baseline/example.com.sqlite:reports/current/example.com.sqlite --reports std,json
opendoor --diff reports/baseline/example.com.json:reports/current/example.com.json --reports std,json --reports-dir ./diff

GitHub Actions 업로드 예시:```yaml
- name: Upload OpenDoor SARIF
  uses: github/codeql-action/upload-sarif@v3
  with:
    sarif_file: reports/example.com/example.com.sarif
    category: opendoor

테스트 실행:```bash
python -m unittest

빌드 문서:```bash
python3 -m venv .docs-venv
source .docs-venv/bin/activate
python -m pip install -r docs/requirements.txt
python -m mkdocs build --strict

전체 [테스트 가이드](https://opendoor.readthedocs.io/Testing/) 및 [기여 가이드](https://opendoor.readthedocs.io/Contribution/)를 참조하세요.

---

## 🔐 보안 및 비밀 정보 관리

실제 비밀 정보나 개인 전송 프로필을 커밋하지 마세요.

다음을 게시하지 마세요:

- 실제 OpenVPN 프로필;
- WireGuard 개인 키;
- mTLS 클라이언트 인증서 및 개인 키;
- auth-user-pass 파일;
- 쿠키;
- Bearer 토큰;
- 고객 대상 목록;
- 비공개 스캔 보고서;
- 민감한 CI 아티팩트.

자리 표시자 예시만 사용하세요.

---

## ⚖️ 책임 있는 사용

OpenDoor는 보안 테스트 도구입니다.

소유한 시스템 또는 테스트에 대한 명시적 권한이 있는 시스템에만 사용하세요.

WAF 탐지, WAF 안전 스캐닝, 원시 요청 재전송, 전송 프로필 및 Header Injection Bypass 프로브와 같은 기능은 승인된 보안 테스트, 방어적 검증 및 노출 회귀 점검을 위해 설계되었습니다.

이 프로젝트는 승인 없이 제3자 시스템, 조직, 상용 서비스 또는 공공 인프라를 스캔할 권한을 부여하지 않습니다.

---

## 🧾 변경 로그

[CHANGELOG.md](https://github.com/stanislav-web/opendoor/blob/HEAD/CHANGELOG.md) 및 [GitHub Releases](https://github.com/stanislav-web/OpenDoor/releases)를 참조하세요.

---

## 🤝 기여하기

Pull Request를 환영합니다.

기여하기 전에 [기여 가이드](https://opendoor.readthedocs.io/Contribution/)를 읽고 관련 테스트를 실행하세요.
OpenDoor는 코드 기여, 문서 업데이트, 테스트, 이슈 보고, 보안 피드백, 기능 아이디어 및 커뮤니티 검증을 통해 개선됩니다.
프로젝트 개선에 도움을 주신 모든 분께 감사드립니다.

[![Contributors](https://contrib.rocks/image?repo=stanislav-web/OpenDoor)](https://github.com/stanislav-web/OpenDoor/graphs/contributors)

---

## 📄 라이선스

OpenDoor는 GNU General Public License v3.0 하에서만 배포됩니다.

[LICENSE](https://github.com/stanislav-web/opendoor/blob/HEAD/LICENSE)를 참조하세요.

---

## 지원

OpenDoor가 승인된 보안 작업에 도움이 된다면 Giveth를 통해 지속적인 유지보수를 지원할 수 있습니다.

[Giveth에서 OpenDoor 지원하기](https://giveth.io/project/opendoor)

---
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/stanislav-web/OpenDoor) [![License: GPL v3](https://img.shields.io/badge/license-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)