차단된 IP
—
활성 항목
차단된 도메인
—
활성 항목
화이트리스트 IP
—
활성 항목
화이트리스트 도메인
—
활성 항목
전체 항목
—
활성 블랙리스트 항목
API 호출
—
전체 요청
📋 최근 활동
🔍 빠른 확인
IP 카테고리
🔴 IP 블랙리스트
| IP / CIDR | 카테고리 | 심각도 | 적중 | 비고 | 상태 | 추가됨 | |
|---|---|---|---|---|---|---|---|
🔵 도메인 블랙리스트
| 도메인 | 카테고리 | 심각도 | 적중 | 비고 | 상태 | 추가됨 | |
|---|---|---|---|---|---|---|---|
🟢 IP 화이트리스트
| IP / CIDR | 카테고리 | 심각도 | 비고 | 상태 | 추가됨 | |
|---|---|---|---|---|---|---|
🟢 도메인 화이트리스트
| 도메인 | 카테고리 | 심각도 | 비고 | 상태 | 추가됨 | |
|---|---|---|---|---|---|---|
🔑 API 키 관리
💡 방화벽 통합
방화벽은 다음 방법으로 API에 인증할 수 있습니다:
Authorization 헤더
Authorization: Bearer <api_key>
X-API-Key 헤더
X-API-Key: <api_key>
Curl 예제 — 플랫 목록 조회
curl -H "X-API-Key: <api_key>" \
https://your-server.com/fireguard/api/blacklist/flat
📖 API 문서
기본 URL:
https://your-server.com/fireguard/api/
인증:
X-API-Key: <key>
또는
Authorization: Bearer <key>
📋 감사 로그
🚀 빠른 시작
🔴
블랙리스트
차단할 IP 주소, CIDR 범위, 도메인을 추가합니다. 방화벽은 내보내기 엔드포인트를 통해 주기적으로 목록을 다운로드합니다.
🟢
화이트리스트
화이트리스트 항목은 항상 블랙리스트보다 우선합니다. /api/blacklist/check 엔드포인트는 이 값에 대해 whitelisted: true를 반환합니다.
🔍
빠른 확인
대시보드에서 IP 또는 도메인이 차단됨 / 화이트리스트 / 허용 상태인지 즉시 확인할 수 있습니다.
🔑
API 키
방화벽 또는 통합당 하나의 키를 생성합니다. 키는 한 번만 표시됩니다 — 비밀번호 관리자에 저장하세요.
⬆ 일괄 가져오기
목록 페이지의 ⬆ 가져오기 버튼을 사용하여 .txt 또는 .csv 파일을 업로드합니다. 중복 항목은 자동으로 건너뜁니다.
TXT
# Komment sor — kihagyva 1.2.3.4 45.142.212.100 10.0.0.0/8 185.220.101.0/24
CSV
ip,category,severity,comment 1.2.3.4,malware,9,C2 server 10.0.0.0/8,botnet,7, 45.0.0.1,spam,5,Spam relay
CSV 카테고리: spam, malware, botnet, scanner, tor, vpn, phishing, c2, adware, tracking, other. 심각도: 1–10. 누락된 필드의 기본값: "other" / 5.
📡 API 참조
GET /api/stats를 제외한 모든 엔드포인트는 API 키가 필요합니다. X-API-Key 헤더, Authorization: Bearer, 또는 ?api_key= 쿼리 파라미터로 전달합니다.
인증
X-API-Key: fg_abc123... Authorization: Bearer fg_abc123... ?api_key=fg_abc123...
Check 엔드포인트
POST /api/blacklist/check
{ "value": "1.2.3.4" }
→ blocked: true / false
→ whitelisted: true / false
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/ips |
차단된 IP 목록 (필터링 가능) |
| POST | /api/ips |
블랙리스트에 IP 추가 |
| GET | /api/ips/export |
방화벽용 일반 텍스트 IP 내보내기 |
| GET | /api/domains |
차단된 도메인 목록 |
| POST | /api/domains |
블랙리스트에 도메인 추가 |
| GET | /api/domains/export |
일반 텍스트 도메인 내보내기 |
| GET | /api/whitelistips |
화이트리스트 IP 목록 |
| POST | /api/whitelistips |
화이트리스트에 IP 추가 |
| GET | /api/whitelistips/export |
일반 텍스트 화이트리스트 IP 내보내기 |
| GET | /api/whitelistdomains |
화이트리스트 도메인 목록 |
| POST | /api/whitelistdomains |
화이트리스트에 도메인 추가 |
| POST | /api/import/{lista} |
TXT/CSV 일괄 가져오기 (목록: ip_blacklist | domain_blacklist | ip_whitelist | domain_whitelist) |
| POST | /api/blacklist/check |
차단/화이트리스트 여부 확인 (hit_count 증가) |
| GET | /api/blacklist/flat |
방화벽 가져오기용 전체 블랙리스트 일반 텍스트 |
| GET | /api/stats |
시스템 통계 — 공개, 인증 불필요 |
| GET | /api/audit |
감사 로그 (?type=ip|domain|api_key|whitelist) |
🔥 방화벽 통합
Palo Alto
EDL — External Dynamic List
/api/ips/export?api_key=...
Fortinet FortiGate
External Threat Feed
/api/ips/export?api_key=...
pfSense / OPNsense
URL Table Alias
/api/ips/export?api_key=...
Mikrotik RouterOS
/tool fetch script
/api/ips/export?api_key=...
iptables / ipset
Cron + curl
/api/blacklist/flat?api_key=...
🏷 카테고리
스팸
멀웨어
봇넷
스캐너
Tor 출구 노드
VPN / 프록시
피싱
C2 (명령·제어 서버)
애드웨어
추적
기타
ℹ 정보
🛡️ FireGuard
REST API 및 웹 관리 인터페이스가 있는 자체 호스팅 IP 및 도메인 블랙리스트/화이트리스트 관리자.
버전: v2.2.2
PHP: 8.4.18
라이선스: MIT
PHP: 8.4.18
라이선스: MIT
키보드 단축키
F5 — 현재 페이지 새로고침
ESC — 모달 닫기
? — 도움말 페이지 열기
ESC — 모달 닫기
? — 도움말 페이지 열기