프로젝트 소개

3X-UI는 Xray-core 서버를 배포, 구성 및 모니터링하기 위한 오픈소스 웹 제어판입니다. 원래 X-UI 프로젝트의 향상된 포크로 설명되며, 더 넓은 프로토콜 지원, 클라이언트별 트래픽 회계 및 추가 관리 기능을 제공합니다. README는 개인용으로 사용하기 위한 것이며 프로덕션 또는 불법 목적이 아님을 명시합니다. 프로토콜 및 전송 지원 인바운드 프로토콜에는 VLESS, VMess, Trojan, Shadowsocks, WireGuard, AmneziaWG, TUIC v5, Hysteria2, MTProto, HTTP, SOCKS(Mixed), Dokodemo-door/Tunnel 및 TUN이 포함됩니다. 전송 방식은 TCP(Raw), mKCP, WebSocket, gRPC, HTTPUpgrade 및 XHTTP를 포함하며 TLS, XTLS 및 REALITY 보안을 지원합니다. 폴백(Fallback)을 통해 여러 프로토콜이 하나의 포트를 공유할 수 있습니다. AmneziaWG는 커널 모듈이나 DKMS 없이 사용자 공간 네트워크 스택에서 패널 내부에서 실행되는 것으로 설명됩니다. TUIC v5는 UDP 릴레이 트래픽 측정, 0-RTT 핸드셰이크 및 BBR 혼잡 제어를 갖춘 사이드카로 구현됩니다. MTProto 프록시는 클라이언트별 FakeTLS 비밀, 광고 태그 및 실시간 적용되는 할당량을 지원합니다. 클라이언트 및 트래픽 관리 클라이언트별 기능에는 트래픽 할당량, 만료 날짜, 신뢰할 수 있는 주소 예외가 있는 IP 제한, HWID 장치 제한, 예약된 갱신 주기, 실시간 온라인 상태, 공유 링크, QR 코드 및 구독이 포함됩니다. 트래픽 통계는 인바운드별, 클라이언트별, 아웃바운드별로 추적되며 재설정 제어 기능이 있습니다. Fail2ban 통합은 클라이언트별 IP 제한을 적용합니다. 배포 및 운영 설치는 임의의 자격 증명과 액세스 경로를 생성하는 셸 스크립트를 통해 이루어집니다. x-ui 명령으로 관리 메뉴가 열립니다. cloud-init을 위한 비대화형 설치가 지원되며 자격 증명은 /etc/x-ui/install-result.env에 기록됩니다. 릴리스 자산에는 설치 프로그램과 업데이터가 검증하는 .sha256 합계가 포함됩니다. 지원 운영 체제는 Ubuntu, Debian, Armbian, Fedora, CentOS, RHEL, AlmaLinux, Rocky Linux, Oracle Linux, Amazon Linux, Virtuozzo, Arch, Manjaro, Parch, openSUSE, Alpine 및 Windows이며, amd64, 386, arm64, armv7, armv6, armv5 및 s390x 아키텍처를 지원합니다. 저장소는 SQLite(기본값) 또는 PostgreSQL을 사용할 수 있으며 SQLite에서 PostgreSQL로의 마이그레이션 명령이 문서화되어 있습니다. Docker Compose 배포가 지원되며 선택적 번들 PostgreSQL 프로필이 포함됩니다. 이미지에는 Fail2ban이 번들로 포함되어 있으며 차단을 적용하려면 NET_ADMIN 및 NET_RAW 권한이 필요합니다. 기타 기능 다중 노드 지원을 통해 하나의 패널에서 여러 서버를 관리하고 확장할 수 있으며, 다른 노드로 인바운드를 복제하는 기능도 포함됩니다. 아웃바운드 및 라우팅 기능에는 WARP, NordVPN, PIA, 사용자 지정 라우팅 규칙, 밸런서 간 폴백이 있는 로드 밸런서, 아웃바운드 프록시 체이닝, 규칙 편집기에서 탐색 가능한 geosite/geoip 카테고리가 포함됩니다. 내장 구독 서버는 클라이언트 User-Agent에 따라 선택된 raw, JSON 및 Clash 형식을 출력하며 사용자 지정 페이지 템플릿을 지원합니다. Telegram 및 Discord 봇은 원격 모니터링 및 관리를 제공합니다. RESTful API는 범위가 지정되고 선택적으로 만료되는 토큰과 패널 내 API 참조를 제공합니다. 패널은 PWA로 설치할 수 있습니다. UI는 13개 언어를 지원하며 다크 및 라이트 테마를 제공합니다. 터널 상태 모니터는 URL을 프로브하고 반복 실패 후 xray를 다시 시작할 수 있습니다. 노드 API 토큰은 키링 구성을 통해 저장 시 암호화할 수 있습니다. 전체 환경 변수 참조는 문서에 링크되어 있습니다. 언급된 커뮤니티 도구로는 인바운드, 클라이언트, 패널 설정 및 Xray 구성을 코드로 관리하기 위한 Terraform/OpenTofu 프로바이더와 대시보드, 인바운드, QR 공유가 있는 클라이언트, 노드 및 다중 패널 관리를 위한 네이티브 Android 클라이언트가 있습니다.