클라이언트 · 프로토콜 · 한국어 가이드

V2Ray 공식 가이드클라이언트 다운로드 및 설정 안내

오픈 소스 클라이언트부터 구독 가져오기까지, 플랫폼별 프로토콜 및 트래픽 분할 설정을 알아보세요.

프로토콜VMess / VLESS 커널Xray / V2Fly
프로젝트 생태계Project V 커널 계열V2Fly · Xray 관리 방식GUI 및 구독 그룹

클라이언트 설정
프로토콜부터 트래픽 분할까지

먼저 프로토콜, 전송 방식, 커널의 차이를 파악한 다음 구독과 라우팅을 설정하세요. 아래 화면은 설정 예시이며, 실제 메뉴는 설치한 클라이언트에 따라 다를 수 있습니다.

프로토콜 안내서 보기
서버 프로토콜
VMess인증 및 암호화
VLESS보안 전송과 함께 사용
Trojan일반적으로 TLS 사용
Shadowsocks암호화 방식 확인

프로토콜 유형에 따라 클라이언트와 서버가 데이터를 주고받는 방식이 달라집니다. 이름만 바꾼다고 프로토콜이 전환되는 것은 아닙니다. VMess, VLESS, Trojan, Shadowsocks는 각각 필요한 인증 정보와 보안 계층이 다르며, 전송 방식으로는 TCP, WebSocket, gRPC 등을 사용할 수 있습니다. 공유 링크를 가져온 뒤에는 주소, 포트, 프로토콜을 먼저 확인하고 TLS, 서버 이름, 전송 경로도 살펴보세요. GUI 클라이언트에서는 관련 항목을 한곳에서 확인할 수 있습니다. 실제로 해당 조합을 사용할 수 있는지는 커널의 지원 여부와 서버 설정에 달려 있습니다.

설정은 세 단계로 나눠 볼 수 있습니다. 클라이언트는 구독과 인터페이스 옵션을 관리하고, 커널은 프로토콜과 라우팅을 처리하며, 운영체제는 어떤 트래픽이 로컬 프록시로 전달될지 결정합니다. 서버 목록에 항목이 보이는 것은 설정을 읽었다는 의미일 뿐입니다. 사용할 서버를 선택하고 필요한 앱에서 해당 연결을 이용하도록 해야 합니다. 이 세 단계를 나눠 확인하면 구독, 프로토콜, 시스템 모드를 한꺼번에 바꾸는 것보다 문제를 쉽게 찾을 수 있습니다.

처음 사용할 때는 가져온 전송 설정을 그대로 둔 채 재현 가능한 접속 테스트를 한 번 진행한 뒤 라우팅 규칙을 단계적으로 추가하세요. 화면에 표시되는 지연 시간 테스트만으로 전체 속도를 판단하지 마세요. 테스트 방식, 대상 주소, DNS 경로에 따라 결과가 달라질 수 있습니다. 문제가 생기면 클라이언트, 커널, 실행 모드, 오류 유형을 기록하세요. 구체적인 설정과 사용 방법은 설치 및 연결 안내를 참고하세요.

운영체제에 맞는 설치 파일 선택

데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 먼저 살펴보고 V2Fly 생태계의 설정이 필요하다면 v2flyNG를 고려하세요. 설치 파일의 아키텍처는 기기와 일치해야 합니다.

Windows

v2rayN 추천

다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 받을 수 있습니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 창 구성과 사용 흐름을 유지합니다. 먼저 운영체제 아키텍처에 맞는 파일을 선택하고 실행 환경 요구 사항을 확인하세요. 파일 이름에 ‘데스크톱’이 들어 있다는 이유만으로 오래된 기기에 더 적합하다고 판단하지 마세요.

실행한 뒤 구독 또는 공유 링크를 가져오고, 활성 서버를 지정한 다음 시스템 프록시나 필요한 트래픽 처리 방식을 선택하세요. 시스템 프록시는 시스템 프록시 설정을 따르는 앱에 주로 적용되며 모든 프로그램이 해당 연결을 사용하는 것은 아닙니다. 특정 프로그램에서 연결이 직접 이루어진다면 클라이언트를 재설치하기보다 해당 프로그램의 프록시 설정을 먼저 확인하세요.

macOS

v2rayN

먼저 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel은 x64에 해당합니다. 다운로드 페이지에서 두 버전을 따로 제공합니다. 칩에 맞는 설치 파일을 선택하면 호환성 계층에 대한 의존을 줄이고 아키텍처 문제를 네트워크나 구독 오류로 오인하는 일을 피할 수 있습니다.

처음 실행할 때 시스템 안내에 따라 앱 접근 권한을 설정하세요. 구독을 가져온 뒤 활성 서버와 시스템 프록시 상태를 확인하고 브라우저에서 접속을 테스트하세요. 브라우저는 연결되지만 다른 앱이 연결되지 않는다면 해당 앱이 시스템 프록시를 사용하는지 확인하세요. 기존 설정을 옮길 때는 원본 파일을 보관하고 로컬 경로, 포트, 플랫폼별 옵션을 특히 주의해서 살펴보세요.

Android

v2rayNG / v2flyNG

v2rayNG는 Xray 커널을 사용하는 안드로이드 클라이언트로 먼저 고려할 만한 선택지입니다. v2flyNG는 V2Fly 커널을 사용하며 해당 생태계의 설정이 필요한 경우에 적합합니다. 두 클라이언트 모두 arm64 버전과 범용 버전을 제공합니다. 최근 출시된 일반적인 기기라면 보통 arm64를 선택하면 됩니다. 아키텍처를 모른다면 기기 정보를 확인하거나 범용 버전을 선택하세요.

설치한 뒤 구독을 가져와 서버 목록을 업데이트하고 사용할 항목을 선택한 다음 연결하세요. VPN 모드를 처음 실행할 때는 시스템 권한이 필요하며, VPN 서비스를 사용하는 다른 앱과 동시에 실행할 수 없는 경우도 있습니다. 화면을 잠근 뒤 연결이 끊기면 백그라운드 실행과 배터리 최적화를 확인하세요. 특정 앱에서만 문제가 생긴다면 앱별 프록시와 우회 모드의 선택 방향을 살펴보세요.

Linux

v2rayN

배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 뒤 x64와 arm64를 구분하세요. 패키지 형식은 설치 및 관리 방식에, 아키텍처는 프로그램의 실행 가능 여부에 영향을 주므로 둘 다 맞아야 합니다. 데스크톱 클라이언트에는 그래픽 환경도 필요합니다. 서버 환경과 일반 데스크톱 세션은 사용 조건이 다르므로 기기의 용도를 먼저 확인하세요.

설치 후 GUI에서 구독과 서버를 관리할 수 있습니다. 시스템 프록시가 적용되는 범위는 데스크톱 환경과 앱 구현에 따라 다릅니다. 더 높은 권한이 필요한 트래픽 처리 방식을 켜기 전에 권한 안내와 라우팅 변경 내용을 확인하세요. 브라우저와 명령줄 도구의 동작이 다르다면 각각의 프록시 설정을 살펴보세요. 데스크톱의 스위치 하나가 모든 프로세스를 제어한다고 가정하지 마세요.

클라이언트에 바로 사용할 수 있는 서버가 포함되어 있는 것은 아닙니다. 연결에 필요한 주소, 인증 정보, 전송 설정은 직접 관리하는 서버나 신뢰할 수 있는 설정 출처에서 제공됩니다. 설치를 마친 뒤에도 유효한 설정을 가져와야 합니다. 구독 주소만 있다면 먼저 업데이트해야 서버 목록에서 사용할 항목을 선택할 수 있습니다. 공유 링크, 구독 콘텐츠, 네이티브 설정 파일은 형식이 서로 다르므로 가져오기 전에 맞는 메뉴를 확인하세요.

클라이언트 전체 보기 →

오픈 소스 생태계와 커널 선택

V2Ray는 생태계를 이해하는 출발점입니다. 클라이언트 이름, 커널 계열, 프로토콜 유형은 각각 구분해야 합니다. 오픈 소스라고 해서 출처를 알 수 없는 설정을 무조건 가져와도 된다는 뜻은 아닙니다.

PROJECT V

프로젝트, 커널, 인터페이스

프로젝트 배경
Project V · V2Ray
커널 계열
V2Fly · Xray
데스크톱 클라이언트
v2rayN
안드로이드 클라이언트
v2rayNG · v2flyNG

프로토콜 이름은 통신 방식을, 클라이언트 이름은 관리 도구를 가리킵니다. 표기가 비슷하더라도 기능 범위가 같은 것은 아닙니다.

커널과 프로토콜의 관계 알아보기 →

Project V와 V2Ray의 배경

Project V는 조합 가능한 프록시 도구를 중심으로 발전했으며, V2Ray는 인바운드, 아웃바운드, 라우팅, 전송 등의 기능을 설정 모델로 구성합니다. 일반 사용자가 처음부터 전체 설정 파일을 익힐 필요는 없습니다. GUI 클라이언트가 자주 쓰는 작업을 선택하고 편집할 수 있는 설정으로 제공합니다. 이 배경을 알면 ‘클라이언트 다운로드’와 ‘프로토콜 선택’이 서로 다른 단계라는 점을 이해하기 쉽습니다. 하나의 인터페이스에서 여러 프로토콜을 관리할 수 있고, 같은 프로토콜도 서로 다른 커널에서 구현될 수 있습니다.

이 페이지에서는 V2Ray를 생태계를 찾는 키워드로 사용하며, 실제 설치 대상은 v2rayN, v2rayNG, v2flyNG입니다. 각 클라이언트의 업데이트 주기와 지원 범위는 다르므로 이름이 비슷하다는 이유로 기능도 같다고 보면 안 됩니다. 인터페이스가 업데이트되면 안내에 나온 메뉴 이름이 달라질 수 있습니다. 이름이 다를 때는 같은 기능을 찾아 안내된 작업 목적과 일치하는지 확인하세요.

V2Fly와 Xray의 공통점과 분기

V2Fly 커뮤니티는 V2Ray 커널을 발전시켜 왔고, Xray는 관련 코드 기반에서 분기해 발전했습니다. 두 커널은 인바운드, 아웃바운드, 규칙에 따른 출구 선택 등 여러 개념을 공유하지만 추가 기능이 모두 같은 것은 아닙니다. VLESS, REALITY 또는 특정 전송 조합을 사용한다면 실제 커널의 지원 여부를 반드시 확인하세요. REALITY는 보안 전송과 관련된 메커니즘이며, VMess와 나란히 놓고 독립적으로 교체할 수 있는 완전한 프록시 프로토콜로 단순화해서는 안 됩니다.

커널을 선택할 때는 먼저 사용 중인 설정에 필요한 기능을 확인한 다음 클라이언트에서 해당 항목을 올바르게 설정할 수 있는지 살펴보세요. 한 커널에서 작동하던 설정이 다른 커널에서 실패한다면 클라이언트의 우열을 탓하기보다 프로토콜 매개변수, 전송 옵션, DNS, 라우팅 동작을 비교하는 것이 좋습니다. 커널마다 기본 동작이 달라 연결 결과가 바뀔 수 있으므로 전환 전에 되돌릴 수 있도록 기존 설정을 보관하세요.

세 클라이언트의 오픈 소스와 라이선스

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 클라이언트입니다. 인터페이스와 설정 관리 방식을 살펴보며 기능이 커널과 어떻게 연동되는지 확인할 수 있습니다. v2rayN과 v2rayNG 프로젝트는 GPL-3.0 라이선스를 사용하며, v2flyNG의 라이선스는 해당 배포본에 포함된 문서를 확인해야 합니다. V2Ray 및 Xray 커널 본체는 MPL-2.0을 사용합니다. 클라이언트, 커널, 포함된 구성 요소의 라이선스는 서로 다를 수 있으므로 재배포하거나 수정할 때 각각의 조건을 확인하세요.

일상적인 사용에서 오픈 소스는 구현을 살펴보고 문제를 추적할 기반을 제공하지만, 기기 권한과 설정 출처, 시스템 환경은 별도로 확인해야 합니다. 외부 설정을 가져오기 전에는 필요하지 않은 DNS, 라우팅, 리스너 설정이 포함되어 있지 않은지 살펴보세요. 로그를 공유할 때는 문제 해결에 필요한 내용만 남기고 구독 주소, 인증 정보, 개인 기기를 식별할 수 있는 정보를 숨기세요.

클라이언트 업데이트와 커널 업데이트 구분하기

인터페이스 업데이트는 구독 파싱, 설치 과정, 시스템 호환성을 개선할 수 있고, 커널 업데이트는 프로토콜 지원과 실행 동작에 영향을 줄 수 있습니다. 클라이언트 업데이트가 있다고 해서 모든 커널 기능이 바뀌는 것은 아닙니다. 반대로 설정에 새로운 기능이 필요하다면 클라이언트의 외관이 같은지만 봐서는 안 됩니다. 다운로드 페이지에서 설치 파일을 제공합니다. 홈페이지에는 출시 번호를 고정해 표시하지 않아 정적인 안내를 실시간 배포 기록으로 오해하지 않도록 했습니다.

업데이트 전에 필요한 설정을 내보내고 현재 실행 모드, 구독 그룹, 사용자 지정 규칙을 기록하세요. 업데이트 후에는 ‘실행되는가, 구독을 읽는가, 연결되는가, 트래픽 분할이 예상대로 작동하는가’ 순서로 확인하세요. 특정 유형의 접속만 영향을 받는다면 규칙과 주소 확인 경로를 먼저 살펴보세요. 변경 사항을 나눠 검증하면 인터페이스 문제, 서버 변경, 로컬 네트워크 변경을 하나의 오류로 혼동하는 일을 줄일 수 있습니다.

사용 환경을 고려한 프로토콜 성능 비교

VMess와 VLESS는 설계상 장단점이 다르지만, 프로토콜 이름만으로 처리량이 높거나 배터리를 덜 소모한다고 단정할 수는 없습니다. 실제 성능은 서버 부하, 전송 캡슐화 방식, 네트워크 왕복 시간, 암호화 구현, 기기 상태에도 영향을 받습니다. 모바일 기기는 백그라운드 제한과 네트워크 전환의 영향도 받습니다. 먼저 설정과의 호환성을 확인한 다음 동일한 네트워크와 대상, 비슷한 시간대에 비교하세요. 한 번의 지연 시간 결과로 전체 연결 품질을 판단하지 마세요.

처음 사용하는 경우 다운로드 페이지에서 클라이언트를 고르고 안내에 따라 구독을 가져온 뒤 연결을 확인하세요. 프로토콜을 바꾸거나 트래픽 분할을 조정하려면 프로토콜 안내서를 이어서 읽어보세요. 연결은 되지만 접속이 불안정하다면 ‘모든 요청 실패’, ‘특정 도메인만 실패’, ‘화면을 잠근 뒤 끊김’으로 증상을 나눠 자주 묻는 질문에서 해당 점검 방법을 찾아보세요. 문제 범위를 구체적으로 좁히는 편이 반복해서 재설치하는 것보다 도움이 됩니다.

클라이언트와 구독 가이드

클라이언트 선택부터 구독 형식, 안드로이드 작동 방식까지 궁금한 주제를 이어서 읽어보세요.

글 전체 보기 →

설정 안내를 읽을 때는 설명하는 항목이 클라이언트 옵션인지 커널 설정인지 먼저 확인하세요. 이름이 같은 옵션도 도구에 따라 메뉴 위치가 다를 수 있으며, 가져오기 형식은 클라이언트의 파싱 기능에 따라 제한될 수 있습니다. 구독 정보에는 연결에 필요한 인증 정보가 포함될 수 있으므로 공개 게시판에 그대로 붙여 넣지 마세요. 문의할 때는 오류 증상과 작업 순서를 설명하면 됩니다. 예시가 필요하다면 민감한 정보부터 삭제하세요.