TL;DR

이 레포지토리는 Railway처럼 외부에서 단일 포트만 제공되는 환경에서 nginx 리버스 프록시와 Docker 설정을 결합해 Heimdall(3x-ui 계열) 패널, 서브스크립션, VLESS over WebSocket 인바운드를 하나의 포트로 노출하도록 구성한다. Dockerfile 단계에서 Heimdall을 빌드 시 자동으로 내려받아 이미지를 생성하고 nginx가 포트 3000에서 청취해 내부의 x-ui 서비스(Listen Port 8080)로 경로별 트래픽을 분기한다. 기본 데이터베이스는 SQLite여서 별도 DB 없이 즉시 운영이 가능하며 컨테이너 재배포로 인한 설정 손실을 막기 위해 /etc/x-ui로 Volume 마운트를 권장한다. 기본 로그인은 admin/admin이며 Postgres로 전환하려면 Dockerfile과 start.sh를 수동으로 수정해야 한다.

핵심 포인트

• Railway의 단일 포트 제한을 고려해 패널, 서브스크립션, VLESS/WebSocket을 모두 하나의 포트에서 경로 기반으로 라우팅하는 아키텍처를 제공한다.
• Dockerfile 단계에서 Heimdall을 자동으로 내려받아 이미지를 빌드하도록 구성되어 있어 수동 설치·업데이트 과정을 줄인다.
• 기본 설정으로 SQLite를 사용해 초기 배포와 테스트 환경에서 별도 DB 구성 없이 빠르게 운영할 수 있도록 설계되었으며 필요 시 Postgres로 전환할 수 있다는 점을 명시한다.
• 하나의 외부 포트로 관리 패널, 구독 경로, VLESS/WebSocket 인바운드를 경로 기반으로 분기해 노출한다. nginx reverse proxy가 수신한 요청의 경로를 판별해 내부 서비스로 전달하며 Railway의 Target Port 제한을 회피한다. 이 구조는 별도 포트 할당이 불가능한 호스팅 환경에서 여러 엔드포인트를 운영할 수 있게 한다.