ed1s0nz/cyberstrikeaiAI 네이티브 사이버보안을 위한 행동 체계—의도가 통제된 실행이 되고, 증거가 운영 메모리가 되며, 모든 운영이 다음 운영을 개선하는 곳.
<div align="center">
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/logo.png" alt="CyberStrikeAI Logo" width="200" >
</div>
# CyberStrikeAI
[中文](https://github.com/ed1s0nz/cyberstrikeai/blob/main/README_CN.md) | [English](https://github.com/ed1s0nz/cyberstrikeai/blob/main/README.md)
**AI 네이티브 사이버보안을 위한 행동 시스템—의도는 통제된 실행이 되고, 증거는 운영 기억이 되며, 모든 작업은 다음 작업을 개선한다.**
CyberStrikeAI는 계획, 실행, 인간 감독, 증거, 리플레이를 하나의 감사 가능한 워크스페이스에서 연결한다. Go로 구축되었으며, Eino 기반 에이전트, MCP 네이티브 도구, RAG 지식, 시각적 워크플로, 그리고 승인된 보안 운영을 위한 공격 체인 모델링 및 분석을 결합한다.
**여기서 시작하세요:** [빠른 시작](#quick-start-one-command-deployment) · [문서](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/README.md) · [보안 강화](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md)
> [!IMPORTANT]
> CyberStrikeAI는 본인이 소유하거나 명시적으로 테스트 권한을 부여받은 시스템에서만 사용하세요. 공유 또는 프로덕션 환경의 경우, 고위험 도구, WebShell 또는 C2 기능을 활성화하기 전에 [보안 모델](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-model.md)과 [강화 가이드](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md)를 검토하세요.
## 인터페이스 및 통합 미리보기
<div align="center">
### 시스템 대시보드 개요
<table>
<tr>
<td width="50%" align="center">
<strong>라이트 모드</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/dashboard.png" alt="System Dashboard (Light)" width="100%">
</td>
<td width="50%" align="center">
<strong>다크 모드</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/dark.png" alt="System Dashboard (Dark)" width="100%">
</td>
</tr>
</table>
*대시보드는 시스템 런타임 상태, 보안 취약점, 도구 사용 및 지식 베이스에 대한 포괄적인 개요를 제공하여 사용자가 플랫폼의 핵심 기능과 현재 상태를 빠르게 파악할 수 있도록 돕습니다.*
<details>
<summary><strong>더 많은 인터페이스 스크린샷</strong></summary>
### 핵심 기능 개요
<table>
<tr>
<td width="33.33%" align="center">
<strong>웹 콘솔</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/web-console.png" alt="Web Console" width="100%">
</td>
<td width="33.33%" align="center">
<strong>작업 관리</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/task-management.png" alt="Task Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>취약점 관리</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/vulnerability-management.png" alt="Vulnerability Management" width="100%">
</td>
</tr>
<tr>
<td width="33.33%" align="center">
<strong>WebShell 관리</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/webshell-management.png" alt="WebShell Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>MCP 관리</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/mcp-management.png" alt="MCP management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>지식 베이스</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/knowledge-base.png" alt="Knowledge Base" width="100%">
</td>
</tr>
<tr>
<td width="33.33%" align="center">
<strong>스킬 관리</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/skills.png" alt="Skills Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>에이전트 관리</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/agent-management.png" alt="Agent Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>역할 관리</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/role-management.png" alt="Role Management" width="100%">
</td>
</tr>
<tr>
<td width="33.33%" align="center">
<strong>시스템 설정</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/settings.png" alt="System settings" width="100%">
</td>
<td width="33.33%" align="center">
<strong>MCP stdio 모드</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/mcp-stdio2.png" alt="MCP stdio mode" width="100%">
</td>
<td width="33.33%" align="center">
<strong>Burp Suite 플러그인</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/plugins.png" alt="Burp Suite plugin" width="100%">
</td>
</tr>
</table>
</details>
</div>
## 주요 특징
### 에이전트 및 오케스트레이션
- 🤖 **에이전트 실행**은 자연어 의도를 통제되고 감사 가능한 보안 작업으로 변환합니다.
- 🧩 **Eino 오케스트레이션**은 단일 에이전트 실행과 Deep, Plan-Execute, Supervisor 멀티 에이전트 모드를 지원합니다.
- 🔀 **그래프 워크플로**는 에이전트, 도구, 조건, 승인 및 출력을 재사용 가능한 흐름으로 결합합니다.
- 🎭 **역할 기반 테스트**는 일반적인 보안 시나리오에 맞춘 집중 프롬프트와 도구 정책을 제공합니다.
### 도구 및 지식
- 🧰 **보안 도구**는 사용자 정의 확장 및 역할 범위 접근이 가능한 100개 이상의 엄선된 YAML 레시피를 포함합니다.
- 🔌 **MCP 통합**은 HTTP, stdio, SSE, 외부 페더레이션 및 동적 도구 검색을 지원합니다.
- ⏱️ **복원력 있는 도구 실행**은 차단형 MCP/도구 호출을 워커에서 실행하며, 제한된 에이전트 대기, 재개 가능한 `execution_id` 폴링, 취소, 서버별 서킷 브레이커, 동시성 제한 및 통합 출력 상한을 제공합니다.
- 🎯 **에이전트 스킬**은 표준 Skill 레이아웃을 따르며 점진적이고 온디맨드 방식의 로딩을 지원합니다.
- 📚 **지식 베이스**는 쿼리 재작성, 벡터 검색, 리랭킹 및 결과 후처리를 결합합니다.
- 🖼️ **비전 분석**은 스크린샷, 캡차 및 UI에 별도의 비전 모델을 사용하며 텍스트 요약만 유지합니다.
### 거버넌스 및 감사
- 🧑⚖️ **휴먼 인 더 루프**는 승인 모드, 도구 허용 목록, 감사 에이전트 검토 및 추적 가능한 결정을 제공합니다.
- 🛡️ **호출 차단**은 Security 아래에서 MCP 실행 전 구성 가능한 정규식 검사, 알림 템플릿 및 드라이 런을 제공하며, 정부 도메인 보호가 기본적으로 활성화됩니다. [도구 호출 차단](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/tool-call-guard.md)을 참조하세요.
- 🔐 **플랫폼 RBAC**은 다중 사용자, 시스템 및 사용자 정의 역할, 범위 지정 권한, 소유권 및 명시적 할당을 지원합니다.
- 🔒 **보안 및 감사**는 인증된 접근, 감사 로그, SQLite 지속성 및 운영 증거 보존을 제공합니다.
- 📄 **결과 거버넌스**는 에이전트가 본 것과 동일한 상한이 적용된 도구 결과를 저장하고, 재개 경로를 과대한 과거 출력으로부터 보호하며, 대용량 상세 보기에 대한 UI 안전장치를 추가합니다. [도구 실행 거버넌스](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/tool-execution-governance.md)를 참조하세요.
### 보안 운영
- 📁 **대화 관리**는 고정, 이름 변경 및 일괄 정리를 제공합니다.
- 📂 **프로젝트 및 공격 체인**은 세션 간 사실, 위험 점수, 그래프 뷰 및 단계별 리플레이를 연결합니다.
- 🗂️ **자산 관리**는 도메인, IP 주소, 포트 및 서비스를 정규화하고 중복 제거합니다. XLSX/CSV 가져오기 및 내보내기, 고급 필터 및 저장된 뷰, 소유권 및 비즈니스 메타데이터, 페이지 간 일괄 유지보수 및 중복 병합을 지원하며, 스캔 범위, 연결된 취약점 및 위험 상태를 추적합니다. [자산 관리 가이드](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/asset-management.md)를 참조하세요.
- 🛡️ **취약점 관리**는 심각도 분류, 수명 주기 추적, 필터링 및 통계를 제공합니다.
- 📋 **일괄 작업**은 대기열 실행, 편집, 상태 추적 및 결과 보존을 제공합니다.
- 📱 **챗봇**은 개인 WeChat, WeCom, DingTalk, Lark, Telegram, Slack, Discord 및 QQ Bot을 연결합니다.
### 승인된 보안 운영
- 🐚 **WebShell 관리**는 연결 관리, 가상 터미널, 파일 작업 및 AI 지원 워크플로를 제공합니다.
- 📡 **내장 C2**는 리스너, 암호화된 비콘, 세션, 작업 대기열, 페이로드 헬퍼 및 라이브 이벤트를 제공합니다.
> WebShell, C2 및 기타 고위험 기능은 본인이 소유하거나 명시적으로 테스트 권한을 부여받은 시스템을 위한 것입니다. [보안 모델](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-model.md)과 [강화 가이드](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md)를 참조하세요.
## 플러그인
CyberStrikeAI는 `plugins/` 아래에 선택적 통합을 포함합니다.
- **Burp Suite 확장**: `plugins/burp-suite/cyberstrikeai-burp-extension/`
빌드 출력: `plugins/burp-suite/cyberstrikeai-burp-extension/dist/cyberstrikeai-burp-extension.jar`
문서: `plugins/burp-suite/cyberstrikeai-burp-extension/README.md`
- **브라우저 확장 (Chrome / Edge)**: `plugins/browser-extension/cyberstrikeai-browser-extension/`
DevTools에서 네트워크 트래픽을 캡처하여 AI 지원 보안 테스트를 위해 CyberStrikeAI로 전송합니다—Burp 플러그인과 정렬됩니다.
설치: `chrome://extensions/` → Load unpacked → F12 → **CyberStrikeAI** 탭
패키지 출력: `plugins/browser-extension/cyberstrikeai-browser-extension/dist/cyberstrikeai-browser-extension.zip`
문서: `plugins/browser-extension/cyberstrikeai-browser-extension/README.md` / `README.zh-CN.md`
## 도구 개요
CyberStrikeAI는 전체 킬 체인을 아우르는 100개 이상의 엄선된 도구와 함께 제공됩니다:
<details>
<summary><strong>전체 도구 카테고리 보기</strong></summary>
- **네트워크 스캐너** – nmap, masscan, rustscan, arp-scan, nbtscan
- **웹 및 앱 스캐너** – sqlmap, nikto, dirb, gobuster, feroxbuster, ffuf, httpx
- **취약점 스캐너** – nuclei, wpscan, wafw00f, dalfox, xsser
- **서브도메인 열거** – subfinder, amass, findomain, dnsenum, fierce
- **네트워크 공간 검색 엔진** – fofa_search, zoomeye_search, quake_search, shodan_search
- **API 보안** – graphql-scanner, arjun, api-fuzzer, api-schema-analyzer
- **컨테이너 보안** – trivy, clair, docker-bench-security, kube-bench, kube-hunter
- **클라우드 보안** – prowler, scout-suite, cloudmapper, pacu, terrascan, checkov
- **바이너리 분석** – gdb, radare2, ghidra, objdump, strings, binwalk
- **익스플로잇** – metasploit, msfvenom, pwntools, ropper, ropgadget
- **비밀번호 크래킹** – hashcat, john, hashpump
- **포렌식** – volatility, volatility3, foremost, steghide, exiftool
- **포스트 익스플로잇** – linpeas, winpeas, mimikatz, bloodhound, impacket, responder
- **CTF 유틸리티** – stegsolve, zsteg, hash-identifier, fcrackzip, pdfcrack, cyberchef
- **시스템 헬퍼** – exec, create-file, delete-file, list-files, modify-file
</details>
도구 정의, 사용자 정의 및 사용 참고 사항은 [tools/README_EN.md](https://github.com/ed1s0nz/cyberstrikeai/blob/main/tools/README_EN.md)를 참조하세요.
## 기본 사용법
### 빠른 시작 (원 커맨드 배포)
**사전 요구 사항:**
- Go 1.25+ ([설치](https://go.dev/dl/); `go.mod`에서 요구)
- Python 3.10+ ([설치](https://www.python.org/downloads/))
**원 커맨드 배포:**
```bash
git clone https://github.com/Ed1s0nZ/CyberStrikeAI.git
cd CyberStrikeAI
chmod +x run.sh && ./run.sh
```
`run.sh` 스크립트는 자동으로 다음을 수행합니다:
- ✅ Go 및 Python 환경 확인 및 검증
- ✅ Python 가상 환경 생성
- ✅ Python 의존성 설치
- ✅ Go 의존성 다운로드
- ✅ 프로젝트 빌드
- ✅ 서버 시작
**시작 확인:**
1. 터미널에 `● ONLINE`과 실제 Web UI URL이 표시되는지 확인합니다.
2. 해당 URL을 엽니다. 기본 HTTPS 모드에서는 로컬 자체 서명 인증서를 사용하므로 브라우저 경고를 한 번 수락합니다.
3. 새로 설치한 경우 `ADMIN SETUP REQUIRED` 아래에 표시된 일회성 `admin` 비밀번호를 저장하고, 로그인한 뒤 즉시 변경합니다.
**네트워킹 기본값:** `run.sh`는 **`--https`**와 저장소의 **`config.yaml`**로 서버를 시작합니다(로컬 자체 서명 TLS, 다수의 동시 스트림에 더 적합). 일반 HTTP를 사용하려면 **`./run.sh --http`**를 사용하세요. 프로덕션에서는 **`config.yaml`**에 **`server.tls_cert_path`** / **`server.tls_key_path`**를 설정하세요(해당 파일의 주석 참조). 수동 실행 시에는 **`--https`** 또는 **`CYBERSTRIKE_HTTPS=1`**을 추가하세요. **`-config`**가 잘못된 경우 바이너리는 stderr에 짧은 사용법 힌트를 출력합니다.
**최초 설정:**
1. **AI 채널 구성** (최초 사용 전 필수)
- 실행 후 **`https://127.0.0.1:8080/`** (또는 **`https://localhost:8080/`**; **8080**을 `config.yaml`의 `server.port`로 교체)을 열고 자체 서명 인증서 경고를 한 번 수락합니다. `./run.sh --http`를 사용한 경우 **`http://`**를 대신 사용하세요.
- `System Settings` → `Basic Settings` → `AI Channel Configuration`으로 이동하여 채널을 추가하거나 편집한 뒤 provider, Base URL, API key, model, token limits를 입력합니다. **Save changes**를 클릭합니다. 왼쪽 채널 목록에서는 기본값 설정, 복사, 삭제, 일괄 프로브를 지원합니다.
```yaml
ai:
default_channel: openai-main
channels:
openai-main:
name: OpenAI Main
provider: openai_compatible
api_key: "${OPENAI_API_KEY}"
base_url: "https://api.openai.com/v1" # or https://api.deepseek.com/v1
model: "gpt-4o" # or deepseek-chat, qwen3-max, etc.
max_total_tokens: 120000
max_completion_tokens: 16384
```
- 또는 실행 전에 `config.yaml`을 직접 편집합니다. `ai.default_channel`은 새 대화와 채널을 명시적으로 선택하지 않은 작업에 사용되며, 채팅 페이지에서도 세션별로 저장된 채널을 선택할 수 있습니다.
2. **로그인** - 최초 시작 시 콘솔에 자동 생성된 초기 `admin` 비밀번호가 출력됩니다. **Platform permissions → User management**에서 계정을 생성하세요
3. **보안 도구 설치 (선택 사항)** - 필요에 따라 `tools/`에서 도구를 설치하세요. 누락된 도구는 런타임에 건너뛰거나 대체됩니다. 일반적인 예:
**macOS (Homebrew):**
```bash
brew install nmap masscan sqlmap nikto gobuster ffuf hydra hashcat nuclei subfinder
```
**Linux (Kali / Debian / Ubuntu):**
```bash
sudo apt update
sudo apt install -y nmap masscan sqlmap nikto gobuster hydra hashcat john binwalk
# On some distros, install ffuf/nuclei/subfinder via go install or upstream docs
```
전체 목록은 `tools/` 디렉터리를 참조하세요. 설치 세부 사항은 각 도구의 공식 문서를 참조하세요.
**대체 실행 방법:**
```bash
# Direct Go run (set up env yourself); add --https to match run.sh defaults
go run ./cmd/server --https
# Manual build
go build -o cyberstrike-ai ./cmd/server
./cyberstrike-ai --https
```
서버 로그에 `client sent an HTTP request to an HTTPS server`가 표시되면, 클라이언트가 TLS 전용 포트에서 여전히 **`http://`**를 사용하고 있는 것입니다—URL을 **`https://`**로 변경하세요.
**참고:** Python 가상 환경(`venv/`)은 `run.sh`에 의해 자동으로 생성되고 관리됩니다. Python이 필요한 도구(예: `api-fuzzer`, `http-framework-test` 등)는 이 환경을 자동으로 사용합니다.
### 업그레이드 및 호환성
**플랫폼 자체의 원클릭 업데이트를 우선 사용하세요** (콘솔 System settings -> One-click update, 또는
`./cyberstrike-ai -update` / `-check-update` / `-update-rollback`): 이는
**업데이트 소스 저장소**의 기본 브랜치(기본값은 공식 저장소이며, 설정 하나로 자신의 포크나 미러를 가리킬 수 있음)의 최신 커밋을 가져와 fast-forward하고, 재빌드한 뒤 바이너리를 원자적으로 교체하며,
`roles/skills/tools/agents/data/config.yaml`을 그대로 유지하고(결과에는 유지된 모든 파일 이름이 나열되며, `config.yaml`의 `version` 필드만 새 코드에 맞춰 동기화되어 헤더 배지가 이와 일치함), 소스가 로컬에서 수정되었거나 로컬 이력이 분기된 경우에는 덮어쓰지 않고 거부합니다.
[배포 가이드](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/deployment.md)를 참조하세요.
`upgrade.sh`도 여전히 작동합니다: 이 디렉터리가 git 작업 트리인 경우 위 명령을 감싼 얇은 셸일 뿐이며, 비 git(tarball) 설치만 예전의 "GitHub Release를 다운로드하여 rsync로 복사" 경로로 폴백합니다. 이 경우 소스 저장소는 `--repo owner/name` 또는 `GITHUB_REPO`에서 가져오며, 내장 기본값은 둘 다 주어지지 않았을 때만 적용됩니다(저장소 이름을 명시한 경고와 함께).
업데이트 소스는 하나의 설정으로, `config.yaml`의 `update` 섹션에 있는 저장소 주소이거나 콘솔 페이지에서 바로 지정할 수 있습니다—공식 저장소, 자신의 포크, 또는 다른 사람의 포크. Release 아카이브에서 압축을 푼 설치(git 없음)도 같은 페이지에서 미리 보고 연결할 수 있으며, 그 이후로는 원클릭으로 업데이트됩니다.
**CyberStrikeAI 업그레이드 스크립트:**
1. (최초 1회) 스크립트 활성화: `chmod +x upgrade.sh`
2. 업그레이드 실행: `./upgrade.sh` (선택적 플래그: `--check`, `--tag vX.Y.Z`, `--repo owner/name`, `--no-venv`, `--yes`). 로컬 `tools/`, `roles/`, `skills/`, `agents/`는 항상 보존됩니다.
3. 스크립트는 `config.yaml`과 `data/`를 백업하고, 코드를 업그레이드한 뒤, `config.yaml`의 `version`을 갱신하고 서버를 재시작합니다.
권장 원라이너:
`chmod +x upgrade.sh && ./upgrade.sh --yes`
문제가 발생하면: git 작업 트리 안에서는 `./cyberstrike-ai -update-rollback`을 실행하세요(해당 업데이트 전에 보관된 커밋과 바이너리로 되돌림). tarball 설치의 경우 `.upgrade-backup/`에서 복원하거나(`data/`와 `config.yaml`을 수동으로 다시 복사) `./run.sh`를 다시 실행하세요.
요구 사항 / 팁 (tarball 경로에만 해당):
* Release 패키지를 다운로드하려면 `curl` 또는 `wget`이 필요합니다.
* 안전한 코드 동기화를 위해 `rsync`가 권장/필수입니다.
* GitHub API의 속도 제한에 걸리면 `./upgrade.sh`를 실행하기 전에 `export GITHUB_TOKEN="..."`을 설정하세요.
⚠️ **업그레이드 전:** 구성, 데이터베이스, API 변경 사항에 대해 대상 릴리스 노트를 검토하세요. 패치 업그레이드에도 백업이 필요합니다. 버전 번호만으로는 호환성이 보장되지 않습니다.
## 구성
[`config.example.yaml`](https://github.com/ed1s0nz/cyberstrikeai/blob/main/config.example.yaml)을 권위 있는 구성 템플릿으로 사용하고, 환경에 필요한 값만 복사하세요. 최소한 서버와 하나의 AI 채널을 구성해야 합니다:
```yaml
server:
host: "127.0.0.1"
port: 8080
ai:
default_channel: openai-main
channels:
openai-main:
provider: openai_compatible
api_key: "${OPENAI_API_KEY}"
base_url: "https://api.openai.com/v1"
model: "your-model"
```
`openai`는 하위 호환성을 유지하는 런타임 필드입니다. 새로운 모델 설정은 `ai.channels`에서 관리하세요. 실제 자격 증명을 커밋하지 마세요. 서비스를 localhost 외부에 노출하기 전에 [구성 참조](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration.md), [권장 프로필](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration-profiles.md), [보안 강화 가이드](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md)를 검토하세요.
## 관련 문서
- **신규 사용자:** [배포](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/deployment.md) → [구성](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration.md) → [문제 해결](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/troubleshooting.md)
- **운영자:** [구성 프로필](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration-profiles.md) → [보안 강화](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) → [런북](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/runbooks.md)
- **통합 개발자:** [API 참조](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/api-reference.md) → [API 레시피](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/api-recipes.md) → [MCP 페더레이션](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/mcp-federation.md)
- **기여자:** [개발자 가이드](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/developer-guide.md) → [테스트](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/testing.md) → [기여](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/contributing-guide.md)
- **모든 주제:** [영어 문서](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/README.md) · [이중 언어 문서 색인](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/README.md)
## 프로젝트 구조
```
CyberStrikeAI/
├── cmd/ # Server, MCP stdio entrypoints, tooling
├── internal/ # Agent, MCP core, handlers, C2 (`internal/c2`), security executor
├── web/ # Static SPA + templates
├── tools/ # YAML tool recipes (100+ examples provided)
├── roles/ # Role configurations (12+ predefined security testing roles)
├── skills/ # Agent Skills dirs (SKILL.md + optional files; demo: cyberstrike-eino-demo)
├── agents/ # Multi-agent Markdown (orchestrator.md + sub-agent *.md)
├── docs/ # Topic docs (deployment, config, security, API, knowledge base, C2, WebShell, etc.)
├── images/ # Docs screenshots & diagrams
├── config.yaml # Runtime configuration
├── run.sh # Convenience launcher
└── README*.md
```
## 기본 사용 예시
```
Scan open ports on 192.168.1.1
Perform a comprehensive port scan on 192.168.1.1 focusing on 80,443,22
Check if https://example.com/page?id=1 is vulnerable to SQL injection
Scan https://example.com for hidden directories and outdated software
Enumerate subdomains for example.com, then run nuclei against the results
```
## 고급 플레이북
```
Load the recon-engagement template, run amass/subfinder, then brute-force dirs on every live host.
Use external Burp-based MCP server for authenticated traffic replay, then pass findings back for graphing.
Compress the 5 MB nuclei report, summarize critical CVEs, and attach the artifact to the conversation.
Build an attack chain for the latest engagement and export the node list with severity >= high.
```
## 404Starlink
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/404StarLinkLogo.png" width="30%">
CyberStrikeAI가 [404Starlink](https://github.com/knownsec/404StarLink)에 합류했습니다
## TCH 최상위 지능형 침투 테스트 프로젝트
<div align="left">
<a href="https://zc.tencent.com/competition/competitionHackathon?code=cha004" target="_blank">
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/tch.png" alt="TCH Top-Ranked Intelligent Pentest Project" width="30%">
</a>
</div>
---
## 커뮤니티 및 지원
- [Discord](https://discord.gg/8PjVCMu8Zw)에서 커뮤니티에 참여하세요.
<details>
<summary><strong>WeCom 그룹</strong></summary>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/main/images/wecom-group-cyberstrikeai-qr.png" alt="CyberStrikeAI WeCom group QR code" width="280">
</details>
## 라이선스
CyberStrikeAI는 Apache License 2.0에 따라 라이선스가 부여됩니다.
자세한 내용은 [LICENSE](https://github.com/ed1s0nz/cyberstrikeai/blob/main/LICENSE) 파일을 참조하세요.
---
## ⚠️ 면책 조항
**이 도구는 교육 및 승인된 테스트 목적으로만 사용해야 합니다!**
CyberStrikeAI는 보안 연구원, 침투 테스터 및 IT 전문가가 **명시적 승인**을 받아 보안 평가 및 취약점 연구를 수행할 수 있도록 지원하도록 설계된 전문 보안 테스트 플랫폼입니다.
**이 도구를 사용함으로써 귀하는 다음에 동의하게 됩니다:**
- 명확한 서면 승인이 있는 시스템에서만 이 도구를 사용할 것
- 모든 관련 법률, 규정 및 윤리 기준을 준수할 것
- 모든 무단 사용 또는 오용에 대한 전적인 책임을 질 것
- 불법적이거나 악의적인 목적으로 이 도구를 사용하지 않을 것
**개발자는 어떠한 오용에 대해서도 책임지지 않습니다!** 귀하의 사용이 현지 법률 및 규정을 준수하는지 확인하고, 대상 시스템 소유자로부터 명시적 승인을 받았는지 확인하십시오.
취약점 보고 및 배포 강화 지침은 [SECURITY.md](https://github.com/ed1s0nz/cyberstrikeai/blob/main/SECURITY.md)를 참조하세요.
---
도움이 필요하거나 기여하고 싶으신가요? 이슈나 PR을 열어주세요—커뮤니티 도구 추가를 환영합니다!