1월 19, 2026가이드
Marzban 패널로 VLESS 프록시 설치하는 방법
Marzban 패널을 사용하여 VLESS 프록시를 설정하는 완전한 단계별 가이드 - 다중 프로토콜 지원을 갖춘 현대적이고 사용자 친화적인 관리 인터페이스.

Marzban은 Xray 프록시 서버를 관리하기 위한 강력하고 현대적인 웹 기반 패널입니다. 다른 패널과 달리 Marzban은 직관적인 인터페이스, 다중 관리자 지원 및 포괄적인 사용자 관리 기능을 제공합니다. 이 가이드는 안전하고 검열에 저항하는 인터넷 접속을 위해 Hiddence VPS에서 Marzban을 사용하여 VLESS 프록시를 설정하는 방법을 보여줍니다.
Marzban이란 무엇인가요?
Marzban은 Xray-core를 위해 특별히 구축된 오픈 소스, 텔레그램 통합 프록시 관리 패널입니다. 프록시 사용자 생성 및 관리, 트래픽 모니터링, 구독 처리에 대한 깔끔하고 현대적인 대시보드를 제공합니다. Marzban은 VLESS, VMess, Trojan 및 Shadowsocks 프로토콜을 지원합니다.
왜 Marzban을 선택해야 할까요?
- 현대적인 웹 인터페이스: 모든 브라우저에서 접근 가능한 깔끔하고 반응형 대시보드
- 다중 관리자 지원: 다양한 권한을 가진 여러 관리자 계정 생성
- 사용자 관리: 프록시 사용자의 쉬운 생성, 수정 및 삭제
- 트래픽 모니터링: 사용자별 실시간 통계 및 사용량 추적
- 구독 링크: 클라이언트용 구독 URL 자동 생성
- 텔레그램 봇: 사용자 관리 및 알림을 위한 내장 봇
- 다중 프로토콜: VLESS, VMess, Trojan 및 Shadowsocks 지원
- Docker 기반: Docker를 사용한 쉬운 설치 및 업데이트
전제 조건
- Ubuntu 22.04 또는 24.04가 설치된 새로운 VPS(Hiddence VPS 권장)
- 서버에 대한 루트 또는 sudo 접근 권한
- 서버 IP를 가리키는 도메인 이름(선택 사항이지만 TLS에 권장)
- 기본 명령줄 지식
1단계: 서버 준비
먼저 시스템을 업데이트하고 Docker를 설치하세요(Marzban은 Docker 컨테이너에서 실행됩니다):
bash
# 시스템 업데이트
apt update && apt upgrade -y
# Docker 설치
curl -fsSL https://get.docker.com | sh
# Docker Compose 설치
apt install docker-compose -y
# Docker 설치 확인
docker --version
docker-compose --version2단계: Marzban 설치
공식 설치 스크립트를 사용하여 Marzban을 다운로드하고 설치하세요:
bash
# Marzban 디렉토리 생성
mkdir -p /opt/marzban
cd /opt/marzban
# docker-compose 파일 다운로드
wget -O docker-compose.yml https://raw.githubusercontent.com/Gozargah/Marzban/master/docker-compose.yml
# 구성용 .env 파일 생성
wget -O .env https://raw.githubusercontent.com/Gozargah/Marzban/master/.env.example
# 관리자 자격 증명을 설정하기 위해 .env 편집
nano .env
# SUDO_USERNAME 및 SUDO_PASSWORD 설정
# Marzban 시작
docker-compose up -d
# 실행 중인지 확인
docker-compose ps3단계: Marzban 대시보드 접속
브라우저를 열고 포트 8000에서 서버의 IP 주소로 이동하세요:
- URL: http://YOUR_SERVER_IP:8000
- .env 파일에서 설정한 사용자 이름과 비밀번호로 로그인
- 사용자, 설정 및 통계 옵션이 있는 Marzban 대시보드가 표시됩니다
- 중요: 첫 로그인 후 즉시 기본 관리자 비밀번호를 변경하세요
4단계: VLESS 인바운드 구성
Marzban에서 VLESS 프로토콜을 설정하세요:
- 대시보드에서 'Core Settings' 또는 'Inbounds'로 이동
- 다음 설정으로 새로운 VLESS 인바운드 추가:
- 포트: 443(TLS용) 또는 사용 가능한 모든 포트
- 프로토콜: VLESS
- 네트워크: TCP 또는 WS(WebSocket)
- 보안: TLS(도메인 사용 시) 또는 Reality
- Reality 사용 시 SNI를 www.microsoft.com과 같은 인기 사이트로 구성
- 인바운드 구성을 저장하세요
5단계: 사용자 생성 및 링크 생성
프록시 사용자를 추가하고 연결 링크를 가져오세요:
- 대시보드에서 'Add User' 버튼 클릭
- 사용자 이름, 트래픽 제한 및 만료 날짜 설정
- 생성한 VLESS 인바운드 선택
- 사용자를 생성하려면 'Create' 클릭
- 구독 링크 또는 QR 코드 복사
- 링크를 VLESS 클라이언트(v2rayN, v2rayNG, Hiddify 등)로 가져오기
- 프록시를 활성화하여 연결 테스트
Marzban 베스트 프랙티스
- 쉬운 사용자 관리를 위해 텔레그램 봇 통합 활성화
- 안전한 대시보드 접속을 위해 SSL 인증서 설정(Nginx 리버스 프록시 사용)
- 정기적으로 Marzban 데이터베이스 백업(/opt/marzban/db.sqlite3)
- 남용을 방지하기 위해 사용자 트래픽 모니터링
- 최대 검열 저항을 위해 Reality 프로토콜 사용
- Marzban 업데이트 유지: docker-compose pull && docker-compose up -d
- 필요한 포트(443, 8000)만 허용하도록 방화벽 구성
- 관리자 계정에 강력한 비밀번호 사용