그래픽 클라이언트 · 설치 및 설정 안내

V2Ray 무료 다운로드클라이언트 및 설정

v2rayN 다운로드 사용법 보기
Windows Android macOS Linux

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 구독을 가져온 다음 시스템 프록시, TUN 모드와 라우팅을 설정하면 됩니다.

VLESSVMessTrojanREALITY

운영체제에 맞는 클라이언트 선택

전체 클라이언트 보기 →
Windowsv2rayN데스크톱 버전과 클래식 WPF 버전 중 인터페이스와 실행 환경에 맞게 선택하세요.다운로드로 이동 → macOSv2rayN먼저 칩 종류를 확인한 뒤 Apple Silicon 또는 Intel 설치 파일을 선택하세요.다운로드로 이동 → Androidv2rayNG / v2flyNGv2rayNG를 우선 사용하고, V2Fly 코어가 필요한 경우 대체 클라이언트를 선택하세요.다운로드로 이동 → Linuxv2rayN배포판에 맞는 deb 또는 rpm 패키지를 고르고 CPU 아키텍처도 확인하세요.다운로드로 이동 →

데스크톱 설치: 먼저 아키텍처 확인

운영체제 이름이 같아도 설치 파일이 모두 호환되는 것은 아닙니다. Windows에서는 기기가 x64 소프트웨어를 실행할 수 있는지 확인한 다음 데스크톱 버전과 WPF 버전 중에서 선택하세요. macOS에서는 ‘이 Mac에 관하여’에서 칩 정보를 확인하고, Linux에서는 배포판의 패키지 형식과 CPU 아키텍처를 모두 확인해야 합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고 WPF 버전은 클래식 인터페이스를 유지합니다. 구독, 시스템 프록시, 라우팅 설정은 각 버전의 메뉴에서 찾아야 하므로 오래된 스크린샷만 보고 메뉴가 없다고 판단하지 마세요.

설치 후에는 먼저 기본 창이 정상적으로 열리는지 확인한 다음 네트워크를 설정하세요. 실행 환경 관련 안내가 표시되면 현재 설치 파일의 설명에 따라 필요한 종속 항목을 설치하세요. 시작되지 않는다면 압축을 푼 폴더가 온전한지, 프로그램에 설정 파일을 쓸 권한이 있는지부터 확인하세요. 서버를 가져오기 전이라 목록이 비어 있는 것은 정상이며, 먼저 TUN을 켤 필요는 없습니다.

Android 설치: 먼저 클라이언트 코어 선택

v2rayNG는 Xray 코어를 사용하므로 VLESS, REALITY 등이 필요한 구성에 적합합니다. v2flyNG는 V2Fly 코어를 사용하며, 기존 설정에서 해당 코어를 명시적으로 요구할 때 선택하면 됩니다. 최근 출시된 대부분의 휴대전화는 arm64 패키지를 사용할 수 있습니다. 구형 기기이거나 아키텍처를 모른다면 시스템 정보를 확인하고 다운로드 페이지의 안내를 참고하세요. 필요하면 범용 패키지를 선택할 수 있습니다. 휴대전화 브랜드만으로 아키텍처를 판단하지 말고, 두 클라이언트의 설정 폴더를 서로 덮어쓰지 마세요.

처음 프록시를 시작하면 시스템에서 VPN 연결 권한을 요청합니다. 현재 사용하는 클라이언트가 요청한 것인지 확인한 뒤 진행하세요. 다른 앱이 이미 시스템 VPN 연결을 사용 중이라면 먼저 해당 앱을 중지해야 합니다. 백그라운드에서 계속 연결해야 할 때는 배터리 최적화와 백그라운드 실행 제한도 확인하세요. 이 설정은 프로세스가 종료되는지에 영향을 줄 뿐, 서버 매개변수 오류를 해결하지는 않습니다.

v2rayN · 설정 예시

구독 그룹 설정

별칭일반 구독
구독 주소구독 제공자가 입력
업데이트 사용
프록시를 사용하지 않고 구독 업데이트

구독 그룹 및 업데이트

구독 주소는 서버 설정을 가져오는 경로이지, 가져오기만 하면 자동으로 연결되는 스위치가 아닙니다. ‘구독 그룹 설정’에서 출처를 알아보기 쉬운 별칭으로 지정하고 전체 주소를 입력해 저장한 뒤 구독을 업데이트하세요. 처음 설정할 때 연결이 되지 않는다면 먼저 프록시를 사용하지 않고 업데이트해 볼 수 있습니다. 업데이트가 끝나면 그룹 필터 조건을 확인하고 실제로 사용할 서버를 선택하세요. 공유 링크를 하나씩 붙여 넣는 것보다 그룹을 사용하면 주소 변경을 관리하기 쉽고 여러 출처가 섞이는 것도 막을 수 있습니다. 구독 주소에는 접근 인증 정보가 포함될 수 있으므로 공개 스크린샷에 노출하지 마세요.

이 화면은 설정 예시입니다. 실제 메뉴와 사용 가능한 옵션은 현재 클라이언트 화면을 기준으로 확인하세요.

단계별 설정 보기 →
Project V / V2Fly / Xray

V2Ray 생태계와 클라이언트 선택

먼저 그래픽 인터페이스, 프록시 코어, 서버 설정을 구분한 다음 설치할 프로그램을 선택하세요. 이름이 비슷해도 프로토콜 지원과 설정 형식이 완전히 같은 것은 아닙니다.

Project V: 코어부터 그래픽 인터페이스까지

Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈 소스 생태계이며 V2Ray는 그중 잘 알려진 프로젝트 이름입니다. 흔히 말하는 ‘V2Ray 다운로드’는 실제로 그래픽 인터페이스가 있는 클라이언트를 받는 것을 가리키는 경우가 많습니다. 코어는 연결을 설정하고 프로토콜을 처리하며 라우팅을 수행합니다. 그래픽 클라이언트는 서버 정보를 저장하고 구독을 관리하며 설정을 만들고 코어를 실행합니다. 두 계층을 나눠서 보면 같은 구독도 프로그램마다 가져온 결과가 다를 수 있는 이유를 이해하기 쉽습니다.

v2rayN, v2rayNG, v2flyNG는 같은 프로그램의 이름만 운영체제별로 바꾼 것이 아닙니다. 각기 다른 인터페이스와 설정 저장 방식, 업데이트 주기를 가지고 있습니다. 데스크톱의 시스템 프록시 메뉴를 Android의 VPN 권한 설정에 그대로 적용할 수 없고, Android의 앱별 프록시도 데스크톱 라우팅 규칙과 이름만 같은 기능이 아닙니다. 기기를 바꿀 때는 신뢰할 수 있는 출처의 구독이나 공유 링크를 먼저 옮긴 뒤 새 클라이언트에서 연결 방식을 다시 확인하세요.

‘V2Ray 공식 사이트’를 검색할 때는 코어 프로젝트 자료를 찾는지 그래픽 클라이언트 설치 안내를 찾는지 먼저 확인해야 합니다. 이 사이트에서는 자주 사용하는 클라이언트 다운로드와 한국어 설정 안내를 함께 제공해 설치 파일 선택부터 연결 테스트까지 진행할 수 있습니다. 클라이언트에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 설치는 로컬 도구를 준비하는 단계일 뿐이며, 이후에는 올바른 서버 설정과 사용 권한이 필요합니다.

V2Fly와 Xray: 설정 요구사항부터 확인

V2Fly는 V2Ray 커뮤니티의 유지보수 흐름을 이어가고, Xray는 관련 코드 기반에서 발전해 별도의 기능 방향을 갖추었습니다. 두 프로젝트는 역사적 배경을 공유하지만 프로토콜 구현, 전송 옵션과 설정 필드에는 차이가 있습니다. 인터페이스에 ‘VLESS’가 표시된다는 이유만으로 모든 매개변수를 서로 바꿔 쓸 수 있다고 생각하지 마세요. 클라이언트 이름에 ‘V2Ray’가 있는지만 보고 특정 기능을 지원하는지 판단해서도 안 됩니다.

Android에서 Xray 관련 기능이 필요하면 v2rayNG를 우선 확인하세요. 기존 설정에서 V2Fly를 요구할 때는 v2flyNG를 고려하면 됩니다. 데스크톱에서 v2rayN을 사용하는 경우 현재 설정이 실제로 어떤 코어를 호출하는지, 해당 코어가 서버에서 요구하는 전송 및 보안 매개변수를 지원하는지 확인하세요. 클라이언트가 공유 링크를 인식했다는 사실은 가져오기 과정이 완료되었다는 뜻일 뿐, 대상 코어가 모든 필드를 적용했다는 보장은 아닙니다.

REALITY는 연결 보안과 관련된 설정 방식이며 서버 주소만 바꾸면 사용할 수 있는 범용 스위치가 아닙니다. 서버에서 요구하는 공개 키, 짧은 ID, 서버 이름 등의 항목을 정확히 맞춰야 합니다. 문제를 확인할 때는 먼저 설정 출처를 기준으로 매개변수를 검증한 다음 코어의 지원 여부를 확인하세요. 두 코어 계열과 클라이언트 선택에 관한 자세한 내용은 Xray와 V2Fly 코어의 차이를 참고하세요. 연결에 성공하기도 전에 프로그램을 계속 바꿀 필요는 없습니다.

v2rayN

데스크톱 우선

데스크톱에서 구독, 서버, 라우팅 규칙을 한곳에서 관리하기 좋습니다. 먼저 시스템 프록시로 재현 가능한 테스트 경로를 만든 뒤, 앱 트래픽을 별도로 처리해야 할 때 TUN을 켜세요. 데스크톱 버전과 WPF 버전은 주로 인터페이스와 실행 환경을 기준으로 선택해야 합니다. 둘 중 하나가 모든 연결 문제를 해결해 주는 것은 아닙니다.

설치 폴더를 바꾸거나 업그레이드하기 전에 구독 그룹, 라우팅, 로컬 설정을 백업하세요. 포터블 폴더의 설정과 운영체제의 프록시 상태는 서로 다른 계층이므로 프로그램 파일만 복사해도 완전히 이전되는 것은 아닙니다.

데스크톱 설치 파일 보기

v2rayNG

Android 우선

Xray 코어 기반으로 구독 업데이트, 서버 선택, VPN 권한 설정, 앱별 프록시 기능을 제공합니다. 설정을 가져온 뒤 현재 선택된 항목을 확인하고 연결을 시작하세요. 알림 표시줄에 실행 중이라고 나오더라도 서비스가 시작되었다는 뜻일 뿐이므로 실제 앱에서 의도한 대로 접속되는지 확인해야 합니다.

Wi-Fi와 모바일 네트워크를 전환한 뒤 문제가 생기면 먼저 네트워크 변경과 백그라운드 제한을 확인한 다음 로그를 살펴보세요. 일부 앱에만 프록시를 적용한다면 앱 선택 목록과 포함·제외 모드도 점검해 적용 범위를 반대로 설정하지 않았는지 확인해야 합니다.

Android 추천 클라이언트 보기

v2flyNG

V2Fly 대안

V2Fly 코어가 꼭 필요하고 서버 설정이 호환되는 Android 환경에 적합합니다. 아이콘이나 이름이 비슷해서가 아니라 프로토콜과 설정 요구사항에 따라 선택하세요. 사용 전에 구독 내용의 전송 및 보안 옵션을 확인하고 다른 코어 전용 매개변수가 그대로 적용된다고 가정하지 마세요.

두 Android 클라이언트에 각각 설정을 저장할 수 있지만 연결을 테스트할 때는 VPN 서비스를 하나만 실행하세요. 차이를 비교하려면 같은 네트워크, 같은 서버, 같은 대상을 사용해야 클라이언트와 다른 조건의 영향을 구분할 수 있습니다.

Android 대체 클라이언트 보기

오픈 소스 라이선스와 설정 출처

세 가지 그래픽 클라이언트는 모두 오픈 소스 소프트웨어이며, 각 프로젝트의 라이선스에 따라 코드가 제공됩니다. V2Fly와 Xray의 핵심 코드는 MPL 2.0 라이선스를 사용합니다. 클라이언트, 종속 구성 요소, 포함된 리소스는 각각의 라이선스 안내를 확인해야 합니다. 오픈 소스 라이선스는 코드의 사용, 수정, 배포 조건을 정할 뿐입니다. 구독 서비스도 같은 프로젝트에서 제공된다는 뜻이 아니며, 특정 서버의 운영 주체나 데이터 처리 방식을 추정하는 근거로 사용할 수도 없습니다.

구독 주소에는 보통 접근 인증 정보가 포함되므로 민감 정보로 취급해야 합니다. 문제 해결용 스크린샷을 공유할 때는 전체 구독 주소, 사용자 식별자, 인증 매개변수를 가리세요. 로그에도 서버 도메인과 연결 대상이 포함될 수 있으므로 게시 전에 항목별로 확인해야 합니다. 인증서 검증을 끄도록 요구하는 설정을 발견하면 먼저 시스템 시간, 인증서 도메인, SNI를 확인한 뒤 대응 방법을 결정하세요. 안내를 없애려고 곧바로 검증 수준을 낮추지 마세요.

그래픽 클라이언트는 가져온 설정을 실행하므로 설정 출처와 로컬 권한도 중요합니다. LAN 연결 허용, 가상 네트워크 어댑터 사용, 구독 자동 업데이트 등의 옵션에는 각각 적용 범위가 있습니다. 모든 스위치를 한꺼번에 켜기보다 현재 필요한 기능만 사용하고 변경 이유를 기록하는 편이 관리하기 쉽습니다.

업데이트 방식과 문제 확인 순서

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스와 설정 관리 방식을 바꾸고, 코어 업데이트는 프로토콜 구현과 네트워크 동작에 영향을 줍니다. 구독 업데이트는 원래 주소에서 서버 정보를 다시 가져옵니다. 서버 목록이 비어 있다면 클라이언트를 바로 재설치하지 말고 구독 가져오기와 필터 조건부터 확인하세요. 인터페이스는 열리지만 코어가 시작되지 않는다면 실행 권한, 포트 사용 여부, 코어 로그를 확인해야 합니다.

연결 문제는 순서를 정해 확인하는 것이 좋습니다. 로컬 네트워크 연결을 확인하고, 구독 업데이트가 성공했는지 확인한 뒤, 설정이 완전한 서버 하나를 선택해 일반 프록시를 시작하고 시스템 프록시를 따르는 브라우저로 테스트하세요. 일반 프록시는 되지만 TUN이 안 된다면 가상 네트워크 어댑터, DNS, 라우팅을 중점적으로 확인하세요. 두 방식 모두 안 된다면 서버 상태, 시스템 시간, 인증 매개변수를 먼저 점검해야 합니다. 한 번에 변수 하나만 바꾸고 변경 전후 로그를 남기세요.

업그레이드 전 설정을 백업하고, 업그레이드 후에는 새 기능을 시도하기 전에 기존 연결 경로가 그대로 작동하는지 다시 확인하세요. 오래된 안내와 현재 인터페이스의 메뉴 이름은 다를 수 있으므로 같은 버튼을 억지로 찾기보다 기능을 기준으로 확인하세요. 플랫폼별 작업 절차와 오류 상황별 안내는 클라이언트 설치 종합 안내를 참고하세요. 이미 연결 문제가 발생했다면 연결 문제 해결 항목에서 증상에 따라 범위를 좁혀 보세요.

최근 기술 안내

실제 설정 메뉴를 기준으로 설치 선택, 구독 정리, 인증서 오류 해결 순서를 자세히 설명합니다.

· 문제 해결

TLS 핸드셰이크 및 인증서 오류 해결: 시스템 시간 불일치와 SNI 설정 오류

인증서가 유효하지 않다는 오류와 핸드셰이크 실패는 서로 다른 문제일 수 있습니다. 먼저 시스템 시간을 맞춘 다음 인증서 도메인, SNI, 설정 출처를 확인하세요. 매개변수 오류와 서버 인증서 문제를 구분하고 인증서 검증을 건너뛰면 어떤 확인 절차가 생략되는지 알아보세요.

안내 읽기 →
· 구독 관리

구독 그룹과 서버 필터링: 여러 구독 소스 정리 방법

여러 소스가 한 목록에 섞여 있다면 먼저 그룹 별칭과 업데이트 범위를 정리한 다음 키워드 필터와 중복 제거를 설정하세요. 업데이트 후 목록이 줄거나 선택한 서버가 사라졌을 때 확인할 사항과 일상적인 선택에 영향을 주는 설정을 설명합니다.

안내 읽기 →
전체 글 보기 →