TL;DR

X4G는 Railway에 배포해 사용하는 Python 기반 VLESS Gateway 서버로, WebSocket·XHTTP 터널과 HTTP Proxy를 관리 대시보드에서 운영합니다. 링크별로 용량·속도·동시 IP·만료일을 제한하고 QR Code, 일반 구독 링크, 비밀번호가 가능한 구독 그룹 페이지를 생성합니다. 선택적으로 Telegram Bot을 연결해 채팅에서 설정과 그룹을 관리할 수 있습니다. 다만 Railway Volume이 없으면 재배포 때 상태가 사라지고, README의 기본 관리자 비밀번호 X4GKING도 배포 전에 바꿔야 합니다.

핵심 포인트

• X4G는 Railway에 배포하는 standalone VLESS Gateway 웹 서비스입니다. Python으로 WebSocket과 XHTTP 기반 VLESS 터널, HTTP Proxy, 관리 대시보드를 한곳에 묶습니다. 별도 프레임워크나 SDK를 가져다 쓰는 라이브러리보다 바로 배포하는 서버형 도구에 가깝습니다.
• 각 VLESS 링크에 트래픽 용량, Mbps 속도, 동시 IP·사용자 수, 만료일을 따로 설정합니다. 링크를 즉시 활성화하거나 비활성화하고 QR Code와 구독 링크를 생성할 수 있습니다. 여러 설정을 구독 그룹으로 묶으면 상태, 사용량, QR Code를 포함한 공개 페이지를 만들고 비밀번호도 걸 수 있습니다.
• 대시보드는 통계, 시간별 트래픽 그래프, 실시간 연결, 활동 로그와 오류 로그를 관리 화면에 모읍니다. Telegram Bot을 연결하면 웹 패널에 들어가지 않고도 설정 생성, 조회, 삭제, 활성화와 구독 그룹 관리를 수행합니다. Bot 사용에는 TELEGRAM_BOT_TOKEN과 허용된 TELEGRAM_ADMIN_IDS 설정이 필요합니다.
• 서비스 상태는 x4g_state.json에 저장되지만 Railway의 DATA_DIR에 영구 Volume을 연결하지 않으면 컨테이너 교체 때 설정과 사용량이 사라집니다. README에 ADMIN_PASSWORD 기본값이 X4GKING으로 적혀 있어 배포 직후 관리자 비밀번호 변경이 필요합니다. 연결 포트도 실제 도메인과 서비스에서 열려 있어야 하므로 Railway 배포 환경을 직접 점검해야 합니다.