**모든 기기가 보호됩니다:** 휴대폰, 태블릿, 노트북, 스마트 TV, 게임 콘솔, IoT 기기, 게스트까지 모든 것이 보호됩니다. 필요에 따라 개별 기기는 [우회](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/CONFIGURATION.md#vpn-bypass-routing)하여 직접 WAN에 접근할 수 있습니다.

---

## 왜 Mullvad QUIC 또는 WireGuard 앱을 그냥 사용하지 않나요?

좋은 질문입니다. Mullvad의 QUIC 터널과 WireGuard 앱은 개별 기기 보호에 뛰어납니다. 각 접근 방식이 적합한 경우는 다음과 같습니다.

### VPN 앱이 더 나은 경우:
- 1-2개의 기기만 보호하면 되는 경우
- 자주 여행하며 다양한 네트워크를 사용하는 경우
- 앱별 분할 터널링이 필요한 경우
- 제어권이 없는 네트워크에 있는 경우

### 네트워크 수준 VPN이 더 나은 경우:
- 많은 기기(특히 VPN 앱을 실행할 수 없는 기기)가 있는 경우
- 가정 전체를 '설정하고 잊어버리는' 보호를 원하는 경우
- 스마트 홈/IoT 기기를 보호해야 하는 경우
- **실제로 작동하는 킬 스위치**가 필요한 경우 (아래에서 자세히 설명)
- VPN 차단/심층 패킷 검사(DPI)가 있는 지역에 있는 경우

### 킬 스위치 문제

대부분의 사람들이 모르는 사실이 있습니다: **VPN 앱의 킬 스위치는 종종 실패합니다.**

VPN 앱이 충돌하거나 연결이 끊어지거나, 연결이 끊어졌다가 다시 연결되기 사이의 순간에 트래픽이 ISP로 유출될 수 있습니다. 앱 기반 킬 스위치는 이를 방지하려고 하지만 애플리케이션 수준에서 작동합니다. 앱 자체가 충돌하면 킬 스위치도 함께 죽습니다.

**이 스택은 방화벽 기반 킬 스위치를 구현합니다:**```
Normal Operation:
  Device → Privacy Router → VPN Tunnel → Internet ✓

VPN Down (App-based kill switch):
  Device → [App crashed] → ISP sees traffic ✗

VPN Down (This stack):
  Device → Privacy Router → [No route exists] → Traffic blocked ✓

LAN의 트래픽은 **오직** VPN 영역으로만 갈 수 있습니다. LAN에서 WAN으로의 전달 규칙이 없습니다. 이것은 우회될 수 있는 "block" 규칙이 아닙니다 - 라우트가 존재하지 않을 뿐입니다.

### 라우팅 테이블```bash
# When VPN is UP:
default dev awg0           # All traffic → VPN tunnel
1.2.3.4 via 192.168.1.1    # VPN server → WAN (exception)

# When VPN is DOWN:
# No default route exists
# Traffic has nowhere to go = blocked

> **🤖 어떤 것을 선택해야 할지 모르시겠어요?** AI 에이전트가 설정을 평가하고 최적의 옵션을 추천해 드립니다. [AGENTS.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/AGENTS.md)를 가리키면 배포 과정을 안내해 드립니다.

### 설치 개요

**옵션 A 및 B (OpenWrt)의 경우:**
1. 장치에 OpenWrt 설치
2. AmneziaWG (또는 WireGuard) 설치
3. 네트워크 인터페이스 구성
4. 방화벽 킬 스위치 설정
5. DNS용 AdGuard Home 배포
6. 자동 복구를 위한 워치독 설치
7. 네트워크 전환

**자세한 지침:** [docs/DEPLOYMENT.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/DEPLOYMENT.md)

**옵션 C (Docker)의 경우:** 컨테이너별 설정은 [docker/README.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docker/README.md)를 참조하세요.

---

## 문서

| 문서 | 설명 |
|----------|-------------|
| [ARCHITECTURE.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/ARCHITECTURE.md) | 시스템 설계, 구성 요소, 보안 모델 |
| [HOW-IT-WORKS.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/HOW-IT-WORKS.md) | 모든 구성 요소에 대한 심층 기술 분석 |
| [DEPLOYMENT.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/DEPLOYMENT.md) | 단계별 설치 가이드 |
| [docker/README.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docker/README.md) | Docker 배포 (고급 사용자) |
| [CONFIGURATION.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/CONFIGURATION.md) | 전체 구성 참조 |
| [OPTIONAL_ADDONS.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/OPTIONAL_ADDONS.md) | AdGuard Home, BanIP 및 기타 보안 추가 기능 |
| [TROUBLESHOOTING.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/TROUBLESHOOTING.md) | 일반적인 문제 및 해결 방법 |

---

## 네트워크 다이어그램```
                                    INTERNET
                                        │
                            ┌───────────┴───────────┐
                            │     VPN Provider      │
                            │   (Mullvad/IVPN/etc)  │
                            └───────────┬───────────┘
                                        │
                              Encrypted WireGuard
                                     Tunnel
                                        │
┌───────────────────────────────────────┼───────────────────────────────────────┐
│ YOUR HOME                             │                                       │
│                                       │                                       │
│    ┌──────────┐              ┌────────┴────────┐              ┌──────────┐   │
│    │   ISP    │    WAN       │                 │    LAN       │  WiFi    │   │
│    │  MODEM   │─────────────▶│ PRIVACY ROUTER  │─────────────▶│  ROUTER  │   │
│    │          │  (Untrusted) │                 │  (Protected) │          │   │
│    └──────────┘              │  ┌───────────┐  │              └────┬─────┘   │
│                              │  │ AdGuard   │  │                   │         │
│                              │  │ DNS + Ads │  │                   │         │
│                              │  └───────────┘  │              ┌────┴─────┐   │
│                              │  ┌───────────┐  │              │ DEVICES  │   │
│                              │  │ Kill      │  │              │          │   │
│                              │  │ Switch    │  │              │ Phone    │   │
│                              │  └───────────┘  │              │ Laptop   │   │
│                              │  ┌───────────┐  │              │ Smart TV │   │
│                              │  │ Watchdog  │  │              │ Console  │   │
│                              │  │ Recovery  │  │              │ IoT      │   │
│                              │  └───────────┘  │              └──────────┘   │
│                              └─────────────────┘                             │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

Traffic Flow:
  Device → WiFi Router → Privacy Router → VPN Tunnel → VPN Server → Internet
                              │
                    DNS: AdGuard (DoH) ─────────────▶ VPN Provider DNS

Kill Switch:
  If VPN down → No route to internet → All traffic blocked (not leaked)

> **이 스택은 WireGuard/AmneziaWG에 중점을 둡니다.** VLESS, XRay 또는 기타 고급 프로토콜의 경우 사용자는 전용 솔루션을 조사하거나 XRay를 포함한 여러 프로토콜을 지원하는 [Amnezia VPN](https://amnezia.org) 실행을 고려해야 합니다.

---

## 하드웨어 권장 사항

> **최소 요구 사항:** 1GB RAM, 이중 네트워크 인터페이스(내장 + USB), OpenWrt 지원. 권장: AdGuard Home DNS 필터링을 위한 2GB+ RAM.

### 예산 (~$50-80)
- Raspberry Pi 4 (2GB+) 및 USB 이더넷 어댑터
- GL.iNet 여행용 라우터 (일부는 OpenWrt 실행)

### 권장 (~$100-150)
- Raspberry Pi 5 및 USB 3.0 이더넷
- Zimaboard 또는 유사 x86 SBC

### 성능 (~$150-300)
- 이중 NIC를 갖춘 미니 PC (Intel N150 시스템)
- Protectli Vault 또는 유사 제품

### 홈랩 / 엔터프라이즈
- 기존 하이퍼바이저(Proxmox, ESXi, Hyper-V)의 가상 머신
- 전용 x86 방화벽 어플라이언스

---

## 보안 고려 사항

### 이 스택이 보호하는 대상
- ISP 트래픽 모니터링 및 로깅
- 네트워크 수준 광고 추적
- DNS 하이재킹 및 모니터링
- IP 기반 지리적 위치
- 트래픽 상관 분석 (좋은 OpSec과 결합 시)
- DPI를 통한 VPN 차단 (AmneziaWG 사용 시)

### 이 스택이 보호하지 않는 대상
- 브라우저 핑거프린팅
- 로그인된 계정 추적 (Google, Facebook 등)
- 기기의 악성코드
- 네트워크에 대한 물리적 접근
- 손상된 VPN 제공업체

### OpSec 권장 사항
- 개인정보 보호 중심 브라우저 사용 (Firefox, Brave)
- 개인정보를 존중하는 검색 엔진 사용
- 필요하지 않을 때 추적 서비스에서 로그아웃
- 분리된 신원 고려
- 기기 업데이트 유지

---

## AI 지원 설정

복잡한 배포나 문제 해결을 위해 AI 코딩 에이전트에 이 **전체 저장소**에 대한 접근 권한과 라우터에 대한 SSH 접근 권한을 부여하세요 (방법을 모른다면 에이전트에게 안내를 요청하세요).

**권장:** 이 스택은 [Claude Code](https://claude.com/claude-code)를 통해 **Claude Opus 4.6**을 사용하여 개발, 테스트 및 배포되었습니다. 최상의 결과를 위해 셸 명령을 실행하고 네트워크 구성을 이해할 수 있는 유능한 프론티어 모델을 사용하세요:

- **Claude Opus 4.6 / Sonnet 4.6** (Anthropic) - 이 구현에 사용됨
- **GPT-5.4** (OpenAI)
- **Gemini 3.1** (Google)

**에이전트가 할 수 있는 작업:**
- **네트워크 감사** - 현재 설정을 조사하고 요구 사항 식별
- **안내 구성** - 특정 IP, 키, 선호도에 맞는 구성 생성
- **자동 문제 해결** - 라우팅, 방화벽, DNS 문제를 실시간으로 진단
- **스크립트 기반 배포** - 승인 후 설치 단계 실행

**빠른 시작:**
1. 이 저장소를 클론하거나 에이전트에 GitHub 접근 권한 부여
2. 에이전트를 **[AGENTS.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/AGENTS.md)** 로 안내 - 전체 운영 프레임워크 포함
3. 대상 기기에 SSH 자격 증명 제공
4. 에이전트가 감사, 계획 및 배포 안내를 수행하도록 함

에이전트 지침에는 진단 명령, 검증 테스트, 오류 복구 절차 및 안전 규칙이 포함됩니다. 이 저장소의 모든 구성은 매개변수화되어 있으며 에이전트 친화적입니다.

---

## 관련 프로젝트

이 스택은 훌륭한 오픈소스 작업을 기반으로 합니다.

| 프로젝트 | 설명 |
|---------|-------------|
| [amnezia-vpn/amneziawg-linux-kernel-module](https://github.com/amnezia-vpn/amneziawg-linux-kernel-module) | AmneziaWG 커널 모듈 |
| [amnezia-vpn/amneziawg-tools](https://github.com/amnezia-vpn/amneziawg-tools) | AmneziaWG 사용자 공간 도구 |
| [Slava-Shchipunov/awg-openwrt](https://github.com/Slava-Shchipunov/awg-openwrt) | OpenWrt용 사전 빌드 AmneziaWG 패키지 |
| [wgtunnel/wgtunnel](https://github.com/wgtunnel/wgtunnel) | WireGuard 터널 관리 |

---

## 라이선스

MIT 라이선스 - 자세한 내용은 [LICENSE](https://github.com/yoloshii/privacy-first-network/blob/HEAD/LICENSE)를 참조하세요.

---

## 감사의 말

- [OpenWrt 프로젝트](https://openwrt.org/) - 기반
- [AmneziaWG](https://github.com/amnezia-vpn/amneziawg-tools) - DPI 우회
- [AdGuard Home](https://adguard.com/adguard-home.html) - DNS 필터링
- [WireGuard](https://www.wireguard.com/) - 현대적인 VPN 프로토콜

---

## FAQ

**Q: 인터넷 속도가 느려지나요?**
A: 영향이 미미합니다. WireGuard는 매우 효율적입니다. 대부분의 사용자는 5% 미만의 속도 저하를 경험합니다. 주요 요인은 VPN 제공업체의 서버 품질입니다.

**Q: 여전히 로컬 네트워크 장치에 접근할 수 있나요?**
A: 네. LAN 트래픽은 로컬에 유지되며 VPN을 통과하지 않습니다.

**Q: 프라이버시 라우터가 고장나면 어떻게 되나요?**
A: 수리되거나 우회될 때까지 네트워크가 인터넷에 연결되지 않습니다. 이는 버그가 아닌 기능입니다 - 보호되지 않은 트래픽 누출을 방지합니다.

**Q: 특정 장치를 VPN에서 제외할 수 있나요?**
A: 네, 추가 구성으로 가능합니다. 특정 IP를 WAN으로 직접 라우팅하는 방화벽 규칙을 만들 수 있습니다. [CONFIGURATION.md](https://github.com/yoloshii/privacy-first-network/blob/HEAD/docs/CONFIGURATION.md)를 참조하세요.

**Q: IPv6에서도 작동하나요?**
A: 누출을 방지하기 위해 IPv6가 비활성화됩니다. 대부분의 VPN 제공업체는 아직 IPv6를 제대로 지원하지 않습니다.

**Q: 제 ISP가 제가 VPN을 사용하는 것을 볼 수 있나요?**
A: 표준 WireGuard를 사용하면 ISP가 VPN과 유사한 트래픽을 볼 수 있습니다. AmneziaWG 난독화를 사용하면 트래픽이 무작위 노이즈로 나타납니다.

**Q: 연령 확인 프라이버시 문제에 어떻게 도움이 되나요?**
A: VPN은 트래픽을 암호화된 터널을 통해 라우팅하여 ISP가 방문하는 사이트를 로깅하지 못하게 합니다. 이는 **프라이버시 도구**입니다 - 제3자 연령 확인 서비스가 사이트 간의 브라우징 활동을 상호 연관시키거나 행동 프로필을 구축하는 것을 차단합니다. 플랫폼과의 실제 연령 확인은 귀하와 해당 플랫폼 간에만 이루어지며 ISP나 데이터 브로커와 공유되지 않습니다. 특정 규정 준수 질문은 현지 법률을 참조하세요.

**Q: 호주 소셜 미디어 금지 조치가 시행된 후에도 작동하나요?**
A: 이 스택은 네트워크 트래픽을 ISP 로깅으로부터 보호하고 모든 기기에 프라이버시를 제공합니다. 2025년 12월 호주 법안은 주로 플랫폼 측 확인에 영향을 미칩니다. VPN은 플랫폼 수준 요구 사항과 관계없이 ISP가 방문하는 사이트를 볼 수 없도록 보장합니다.

**Q: 합법인가요?**
A: VPN 사용은 영국, 호주, 미국, EU를 포함한 대부분의 서구 국가에서 합법입니다. 이 스택은 HTTPS와 유사한 프라이버시 도구입니다 - 트래픽을 암호화합니다. VPN을 사용하여 해당 지역에서 이용 가능한 콘텐츠에 접근하는 것은 일반적으로 합법입니다. 항상 현지 법률을 확인하세요.

---

*전체 네트워크를 보호하세요. 설정하고 잊어버리세요.*