---

## 🚀 빠른 시작

### 방법 1: 한 줄 명령으로 배포 (권장)

사전 빌드된 Docker 이미지를 사용하여 코드를 클론할 필요 없이 한 줄 명령으로 실행할 수 있습니다:```bash
curl -fsSL https://raw.githubusercontent.com/lintsinghua/DeepAudit/v3.0.0/docker-compose.prod.yml | docker compose -f - up -d

<details>
<summary>수동으로 이미지 가져오기 (별도로 가져오려면) (펼쳐보기)</summary>```bash
# 前端镜像
docker pull ghcr.nju.edu.cn/lintsinghua/deepaudit-frontend:latest

# 后端镜像
docker pull ghcr.nju.edu.cn/lintsinghua/deepaudit-backend:latest

# 沙箱镜像
docker pull ghcr.nju.edu.cn/lintsinghua/deepaudit-sandbox:latest

> 처음 시작하면 자동으로 샌드박스 이미지가 빌드되며 몇 분 정도 소요될 수 있습니다.

---

## 🔧 소스 코드 개발 가이드

개발자가 2차 개발 및 디버깅에 적합합니다.

### 환경 요구 사항
- Python 3.11+
- Node.js 20+
- PostgreSQL 15+
- Docker (샌드박스용)


### 1. 수동으로 데이터베이스 시작```bash
docker compose up -d redis db adminer

### 3. 프론트엔드 시작```bash
cd frontend
# 配置环境
cp .env.example .env

pnpm install
pnpm dev

---

## 🤖 Multi-Agent 스마트 감사

### 지원되는 취약점 유형

<table>
<tr>
<td>

| 취약점 유형 | 설명 |
|---------|------|
| `sql_injection` | SQL 인젝션 |
| `xss` | 크로스 사이트 스크립팅 |
| `command_injection` | 명령 인젝션 |
| `path_traversal` | 경로 탐색 |
| `ssrf` | 서버 측 요청 위조 |
| `xxe` | XML 외부 엔티티 인젝션 |

</td>
<td>

| 취약점 유형 | 설명 |
|---------|------|
| `insecure_deserialization` | 안전하지 않은 역직렬화 |
| `hardcoded_secret` | 하드코딩된 비밀키 |
| `weak_crypto` | 취약한 암호화 알고리즘 |
| `authentication_bypass` | 인증 우회 |
| `authorization_bypass` | 권한 부여 우회 |
| `idor` | 안전하지 않은 직접 객체 참조 |

</td>
</tr>
</table>

> 📖 자세한 문서는 **[Agent 감사 가이드](https://github.com/lintsinghua/deepaudit/blob/v3.0.0/docs/AGENT_AUDIT.md)** 를 확인하세요

---

## 🔌 지원되는 LLM 플랫폼

<table>
<tr>
<td align="center" width="33%">
<h3>🌍 글로벌 플랫폼</h3>
<p>
OpenAI GPT-4o / GPT-4<br/>
Claude 3.5 Sonnet / Opus<br/>
Google Gemini Pro<br/>
DeepSeek V3
</p>
</td>
<td align="center" width="33%">
<h3>🇨🇳 중국 내 플랫폼</h3>
<p>
통의첸원 Qwen<br/>
지푸 GLM-4<br/>
Moonshot Kimi<br/>
문심일언 · MiniMax · 두바오
</p>
</td>
<td align="center" width="33%">
<h3>🏠 로컬 배포</h3>
<p>
<strong>Ollama</strong><br/>
Llama3 · Qwen2.5 · CodeLlama<br/>
DeepSeek-Coder · Codestral<br/>
<em>코드가 내부 네트워크를 벗어나지 않음</em>
</p>
</td>
</tr>
</table>

💡 API 중계 서버 지원, 네트워크 접근 문제 해결 | 자세한 설정 → [LLM 플랫폼 지원](https://github.com/lintsinghua/deepaudit/blob/v3.0.0/docs/LLM_PROVIDERS.md)

---

## 🎯 기능 매트릭스

| 기능 | 설명 | 모드 |
|------|------|------|
| 🤖 **Agent 심층 감사** | Multi-Agent 협업, 자체 감사 전략 수립 | Agent |
| 🧠 **RAG 지식 강화** | 코드 의미 이해, CWE/CVE 지식 베이스 검색 | Agent |
| 🔒 **샌드박스 PoC 검증** | Docker 격리 실행, 취약점 유효성 검증 | Agent |
| 🗂️ **프로젝트 관리** | GitHub/GitLab/Gitea 가져오기, ZIP 업로드, 10+ 언어 지원 | 일반 |
| ⚡ **즉시 분석** | 코드 조각 초 단위 분석, 붙여넣기 즉시 사용 | 일반 |
| 🔍 **5차원 검사** | 버그 · 보안 · 성능 · 스타일 · 유지보수성 | 일반 |
| 💡 **What-Why-How** | 정확한 위치 + 원인 설명 + 수정 제안 | 일반 |
| 📋 **감사 규칙** | 내장 OWASP Top 10, 사용자 정의 규칙 세트 지원 | 일반 |
| 📝 **프롬프트 템플릿** | 시각적 관리, 중국어/영어 이중 언어 지원 | 일반 |
| 📊 **보고서 내보내기** | PDF / Markdown / JSON 원클릭 내보내기 | 일반 |
| ⚙️ **런타임 설정** | 브라우저에서 LLM 설정, 서비스 재시작 불필요 | 일반 |

## 🦖 로드맵

지속적으로 발전 중이며, 앞으로 더 많은 언어와 더 강력한 Agent 기능을 지원할 예정입니다.

- [x] 기본 정적 분석, Semgrep 통합
- [x] RAG 지식 베이스 도입, Docker 보안 샌드박스 지원
- [x] **Multi-Agent 협업 아키텍처** (현재)
- [ ] 더 현실적인 모의 서비스 환경 지원, 더 실제적인 취약점 검증 프로세스 수행
- [ ] 샌드박스를 function_call에서 최적화하여 안정적인 MCP 서비스로 통합
- [ ] **자동 수정 (Auto-Fix)**: Agent가 직접 PR을 제출하여 취약점 수정
- [ ] **증분 PR 감사**: PR 변경 사항 지속 추적, 지능형 취약점 분석, CI/CD 프로세스 통합
- [ ] **RAG 최적화**: 사용자 정의 지식 베이스 지원

---

## 🤝 기여 및 커뮤니티

### 기여 가이드
기여를 환영합니다! Issue, PR 또는 문서 개선 모두 환영합니다.
자세한 내용은 [CONTRIBUTING.md](https://github.com/lintsinghua/deepaudit/blob/v3.0.0/CONTRIBUTING.md)를 참조하세요.

### 📬 작성자 연락처

<div align="center">

**여러분의 소중한 의견을 기다립니다! 기술적인 질문, 기능 제안, 협업 등 무엇이든 편하게 연락 주세요~**
(플랫폼 맞춤 제작, 코드 감사 서비스, 기술 컨설팅, 협업 문의 등은 이메일로 연락 부탁드립니다)
| 연락처 | |
|:---:|:---:|
| 📧 **이메일** | **[email protected]** |
| 🐙 **GitHub** | [@lintsinghua](https://github.com/lintsinghua) |

</div>

## 📄 라이선스

이 프로젝트는 [AGPL-3.0 License](https://github.com/lintsinghua/deepaudit/blob/v3.0.0/LICENSE) 하에 오픈소스로 제공됩니다.

## 📈 프로젝트 인기

<a href="https://star-history.com/#lintsinghua/DeepAudit&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=lintsinghua/DeepAudit&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=lintsinghua/DeepAudit&type=Date" />
   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=lintsinghua/DeepAudit&amp;type=Date" />
 </picture>
</a>

---

<div align="center">
  <strong>Made with ❤️ by <a href="https://github.com/lintsinghua">lintsinghua</a></strong>
</div>

---

## 감사의 말

다음 오픈소스 프로젝트의 지원에 감사드립니다:

[FastAPI](https://fastapi.tiangolo.com/) · [LangChain](https://langchain.com/) · [LangGraph](https://langchain-ai.github.io/langgraph/) · [ChromaDB](https://www.trychroma.com/) · [LiteLLM](https://litellm.ai/) · [Tree-sitter](https://tree-sitter.github.io/) · [Kunlun-M](https://github.com/LoRexxar/Kunlun-M) · [Strix](https://github.com/usestrix/strix) · [React](https://react.dev/) · [Vite](https://vitejs.dev/) · [Radix UI](https://www.radix-ui.com/) · [TailwindCSS](https://tailwindcss.com/) · [shadcn/ui](https://ui.shadcn.com/)

---

## ⚠️ 중요 보안 고지

### 법적 준수 고지
1. **권한 없는 취약점 테스트, 침투 테스트 또는 보안 평가를 금지**합니다
2. 본 프로젝트는 사이버 보안 학술 연구, 교육 및 학습 목적으로만 제공됩니다
3. 본 프로젝트를 불법 목적이나 권한 없는 보안 테스트에 사용하는 것을 엄격히 금지합니다

### 취약점 신고 책임
1. 보안 취약점 발견 시 적법한 경로를 통해 신고하시기 바랍니다
2. 발견된 취약점을 불법 활동에 이용하는 것을 엄격히 금지합니다
3. 국가 사이버 보안 법규를 준수하고 사이버 공간의 보안을 유지합니다

### 사용 제한
- 권한이 있는 환경에서 교육 및 연구 목적으로만 사용 가능
- 권한 없는 시스템에 대한 보안 테스트 금지
- 사용자는 자신의 행동에 대한 모든 법적 책임을 부담합니다

### 면책 조항
작성자는 본 프로젝트 사용으로 인해 발생하는 직간접적 손해에 대해 책임을 지지 않으며, 사용자는 자신의 행동에 대한 모든 법적 책임을 부담합니다.

---

## 📖 상세 보안 정책

설치 정책, 면책 조항, 코드 개인정보, API 사용 보안 및 취약점 보고에 대한 자세한 내용은 [DISCLAIMER.md](https://github.com/lintsinghua/deepaudit/blob/v3.0.0/DISCLAIMER.md) 및 [SECURITY.md](https://github.com/lintsinghua/deepaudit/blob/v3.0.0/SECURITY.md) 파일을 참조하세요.

### 빠른 참조
- **코드 개인정보 경고**: 코드가 선택한 LLM 서비스 제공업체의 서버로 전송됩니다
- **민감 코드 처리**: 민감 코드는 로컬 모델을 사용하여 처리
- **규정 준수 요구사항**: 데이터 보호 및 개인정보 보호 법규 준수
- **취약점 보고**: 보안 문제 발견 시 적법한 경로를 통해 신고