설정 및 관리 기능

시스템 전역 설정과 백업, 권한 관리를 수행합니다.

설정 메뉴는 다음 탭으로 구성됩니다: Global Settings, CAPTCHA, GeoIP, Bot Filter, Security(WAF 자동 차단), SSL / ACME, Maintenance, Backups, System Logs, Filter Subscriptions. (DDNS는 설정이 아닌 인증서 → DDNS 메뉴로 이동했습니다.)

전역 Nginx 설정

전역 설정은 Worker, HTTP, Performance, Compression, SSL, Timeout, Advanced 탭으로 나뉩니다.

기본 설정

압축 설정

• Gzip: 기본 압축 방식
• Brotli: 향상된 압축률
• Zstd: 최신 고성능 압축

DDoS 보호

• 연결 제한 설정
• 요청률 제한
• 버스트 크기 설정

권장 설정 프리셋

전역 설정 상단의 권장 설정 적용 버튼을 누르면 nginx 권장 튜닝값(워커, keepalive, 압축, SSL 등)이 일괄 적용되고 nginx가 즉시 reload됩니다. 초기화 버튼으로 기본값으로 되돌릴 수 있습니다.

Direct IP 접근 제어 (Advanced 탭)

도메인이 아닌 IP로 직접 접근 시 동작을 설정합니다.

Advanced 탭에는 연결 제한·요청률 제한 등 DDoS 보호 설정도 함께 제공됩니다.

시스템 설정

GeoIP 설정 (GeoIP 탭)

GeoIP 데이터베이스는 MaxMind 계정 ID와 라이선스 키를 UI에서 직접 입력하면 앱이 자동으로 다운로드·갱신합니다. (환경 변수 MAXMIND_* 설정이 아니라 GeoIP 탭에 입력하며, 값은 system_settings에 저장됩니다.)

• GeoIP 활성화: 기능 on/off (geoip_enabled)
• MaxMind 계정 ID / 라이선스 키: UI 입력 후 저장 (maxmind_account_id, maxmind_license_key). MaxMind에서 무료 GeoLite2 계정을 생성할 수 있습니다.
• 자동 업데이트: 활성화 시 일/주/월(1d·7d·30d) 주기 선택 (geoip_auto_update, geoip_update_interval)
• 지금 업데이트: 라이선스 키가 있으면 즉시 다운로드 실행
• 상태 카드: Country DB / ASN DB 보유 여부와 마지막 갱신 시각 표시
• 업데이트 이력: 최근 자동/수동 업데이트 기록(상태, 소요 시간, DB 크기) 조회

ACME (Let's Encrypt) 설정 (SSL / ACME 탭)

• 이메일: 인증서 발급용 이메일
• 스테이징 모드: 테스트용 인증서 발급
• 자동 갱신: 30일 전 자동 갱신
• 갱신 체크 간격: 6시간

봇 필터 기본값 (Bot Filter 탭)

새 프록시 호스트 생성 시 기본 적용되는 봇 필터 설정입니다.

• 악성 봇 차단 기본값
• AI 봇 차단 기본값
• 검색엔진 허용 기본값
• SNS 봇 허용 기본값

WAF 자동 차단 설정 (Security 탭)

WAF 이벤트가 일정 횟수 이상 발생하면 해당 IP를 자동 차단합니다.

기타 설정 탭

• CAPTCHA: 챌린지 페이지(자동 검증) 설정
• Maintenance: 점검 모드 설정
• System Logs: 컨테이너/시스템 로그 수집 설정
• Filter Subscriptions: 외부 IP 차단 목록 구독 관리

백업 & 복원 (Backups 탭)

백업 내용

• 설정 파일: 모든 프록시 호스트 설정
• SSL 인증서: Let's Encrypt 및 커스텀 인증서
• 데이터베이스: PostgreSQL 전체 덤프
• Nginx 설정: conf.d 디렉토리 전체

백업 생성

• 수동 백업: 즉시 백업 생성
• 예약 백업: 일정에 따른 자동 백업
• 보관 정책: 최대 백업 수 설정

백업 관리

• 백업 목록: 모든 백업 조회
• 백업 다운로드: 외부 저장을 위한 다운로드
• 백업 삭제: 불필요한 백업 정리
• 백업 통계: 저장 공간 사용량

복원

• 원클릭 복원: 선택한 백업으로 즉시 복원
• 업로드 복원: 외부 백업 파일 업로드 후 복원
• 복원 테스트: 복원 가능 여부 검증

인증 및 보안

2FA, 비밀번호 변경, API 토큰, 언어/폰트 설정은 설정 메뉴 탭이 아니라 우측 상단 사용자 메뉴의 계정 설정(Account Settings) 모달에서 관리합니다. 계정 설정 탭: 정보 / 비밀번호 / 2FA / API 토큰 / 언어·폰트.

JWT 인증

• 무상태(Stateless) 토큰 기반 인증
• 토큰 만료 시간 설정
• 리프레시 토큰 지원

2단계 인증 (2FA)

• TOTP: 시간 기반 일회용 비밀번호
• 백업 코드: 복구용 코드 생성
• QR 코드: 인증 앱 연동

API 토큰 관리

• 세분화된 권한: 리소스별 읽기/쓰기 권한
• IP 제한: 특정 IP에서만 사용 가능
• 만료일: 토큰 유효 기간 설정
• 사용 통계: 토큰별 API 호출 기록

로그인 보안

• Rate Limiting: 로그인 시도 횟수 제한
• IP 추적: 로그인 IP 기록
• 세션 관리: 활성 세션 조회 및 종료

사용자 설정 (계정 설정 모달)

아래 설정은 사용자 메뉴의 계정 설정 모달에서 변경합니다. 테마(라이트/다크)는 상단 바의 토글로 전환합니다.

언어 설정

• 한국어 (ko): 완전한 한국어 지원
• 영어 (en): 완전한 영어 지원
• 브라우저 자동 감지: 브라우저 언어 설정 따름
• 사용자별 설정: 개인 언어 선호 저장

폰트 설정

사용자 취향에 맞는 폰트를 선택할 수 있습니다.

테마 설정

• 라이트 모드: 밝은 배경
• 다크 모드: 어두운 배경
• 시스템 설정: OS 설정 따름