TL;DR

이 프로젝트는 VLESS 터널을 WebSocket과 XHTTP 전송으로 제공하면서 내장 HTTP 프록시, 관리용 웹 대시보드, Telegram 관리봇, 링크별 트래픽·속도·동시 IP 제한과 그룹형 서브 페이지 기능을 결합한 게이트웨이 솔루션이다. 각 링크는 Fingerprint(uTLS), ALPN, 포트와 같은 전송 메타데이터를 통해 접속 특성을 제어하며 대시보드에서는 시간별 트래픽과 실시간 연결 상태를 확인할 수 있다. 서비스 설정과 통계는 x4g_state.json에 디스크에 저장되며 컨테이너 교체 시 보존하려면 DATA_DIR에 외부 Volume을 반드시 마운트해야 한다. Railway 같은 PaaS에 포크 후 Deploy로 빠르게 올릴 수 있고 Telegram 봇을 통해 GUI 접근 없이 원격 관리가 가능한 점이 운영 편의성을 높인다.

핵심 포인트

• WebSocket과 두 가지 XHTTP 모드(xhttp-packet-up, xhttp-stream-up)를 동시에 지원하여 다양한 네트워크 환경에 대응하도록 설계되어 있다.
• 대시보드에서 시간별 트래픽 차트와 실시간 연결 모니터링을 제공하며 Telegram 봇으로 대시보드 접근 없이 구성 관리를 가능하게 한다.
• 링크별로 트래픽, 속도, 동시 IP 제한과 만료일을 설정할 수 있어 구독형 또는 임시 접근 제어를 프로덕션 수준으로 구현할 수 있다.
• 서비스 상태를 x4g_state.json 파일에 저장하고 외부 Volume 연동을 권장하여 컨테이너 기반 배포에서 구성 지속성을 제공한다.