TL;DR

이 저장소는 특정 프레임워크의 확장 기능이 아닌 독립형 FastAPI 기반 프록시·구독 관리 패널입니다. Railway에 배포해 사용자와 인바운드를 관리하고 VLESS Reality, WS-TLS, XHTTP 등의 설정과 구독 페이지를 자동 생성합니다. 브라우저 측 IP 스캐너는 사용자의 네트워크에서 후보 IP를 측정하고, 선택적으로 Cloudflare Worker를 배포해 국가별 프록시 IP 라우팅을 구성합니다. 다만 기본 admin 비밀번호와 SECRET_KEY를 직접 교체하고 Cloudflare 토큰과 상태 파일을 보호해야 하므로 공개 서비스에 바로 노출하기보다 운영 보안 설정을 먼저 점검해야 합니다.

핵심 포인트

• 독립형 FastAPI 패널로 Railway에서 사용자·인바운드·구독 설정을 관리합니다. VLESS Reality, WS-TLS, XHTTP와 VMess·Trojan·Shadowsocks 설정을 생성합니다. 프록시 운영에 필요한 계정·트래픽·만료일 관리까지 한 화면에 묶은 구성이 핵심입니다.
• 사용자 한 명에게 여러 인바운드를 연결해 구독에 여러 설정을 넣을 수 있습니다. Cloudflare와 Railway 후보 IP를 브라우저에서 병렬 측정하고 빠른 IP를 최대 10개 저장합니다. 저장된 IP는 WS-TLS의 address에만 적용하고 host와 sni는 패널 도메인으로 유지합니다.
• 선택 사항인 Cloudflare Worker가 사용자 요청을 Worker Domain으로 받아 국가별 프록시 IP로 전달합니다. 패널은 Cloudflare API로 KV namespace와 VLESS WS relay를 배포하고 UUID·트래픽 한도·만료일을 동기화합니다. Railway는 관리와 설정 제공 경로에만 남고 VPN 데이터 경로에는 들어가지 않습니다.
• Python 환경에서는 requirements.txt 설치 후 python main.py로 실행하며 Railway의 PORT와 DATA_DIR을 사용합니다. 기본 로그인 비밀번호는 admin이고 SECRET_KEY도 기본값이므로 배포 직후 둘 다 변경해야 합니다. 상태는 spider_state.json에 저장되며 Xray binary가 Reality 키를 생성하므로 data 디렉터리 보호가 필요합니다.