v2rayN
추천Windows x64 설치 파일입니다. Desktop은 최신 크로스 플랫폼 UI를 제공하고, WPF는 익숙한 데스크톱 조작 방식을 유지하는 클래식 버전입니다.
V2Ray 클라이언트 다운로드
v2rayN 데스크톱 클라이언트와 v2rayNG·v2flyNG Android 클라이언트를 제공합니다. 운영체제를 선택한 다음 CPU 아키텍처를 확인하세요.
평생 무료
오픈 소스
그래픽 인터페이스 설정
플랫폼 선택
설치 후 설정 방법 →
운영체제에 맞는 설치 파일 선택
Windows 설치 준비
Windows에서 “설정 → 시스템 → 정보”를 열어 시스템 종류를 확인하고, 기기가 x64 프로세서를 사용하는지 확인하세요. 이 페이지의 설치 파일은 x64용이므로 기기 외관만 보고 아키텍처를 판단하면 안 됩니다. 다운로드한 ZIP 파일을 쓰기 가능한 폴더에 압축 해제한 뒤 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요.
Desktop과 WPF는 주로 UI 기술과 조작 방식이 다를 뿐, 서로 다른 연결 경로를 사용하는 것은 아닙니다. 처음 실행할 때 실행 환경 안내가 나타나면 프로그램이 안내하는 종속 구성 요소를 설치하세요. 브라우저에서만 연결되지 않는 경우에는 설정과 프록시 상태를 먼저 확인하고, 모든 연결 문제를 설치 파일 탓으로 돌리지 마세요.
| 확인 항목 | 설치 전 확인 |
|---|---|
| 운영체제 및 아키텍처 | Windows x64. 구체적인 운영체제 버전과 실행 환경은 현재 패키지의 안내를 확인하세요. |
| 폴더 권한 | 압축 해제 및 설치 폴더에 쓰기 권한이 있는지 확인하고, 설정·로그·업데이트에 필요한 공간을 확보하세요. |
| 첫 실행 | 일반적인 프록시 설정에는 보통 관리자 권한이 필요하지 않습니다. TUN을 사용하는 경우에는 별도로 권한 요구 사항을 확인하세요. |
서버를 가져온 뒤 상태 표시줄에서 “시스템 프록시 자동 설정”을 선택하면 시스템 프록시를 따르는 앱의 요청이 클라이언트로 전달됩니다. 이 설정은 전체 라우팅과 다릅니다. 요청이 들어온 뒤에는 라우팅 규칙에 따라 직접 연결, 프록시 연결 또는 차단 여부가 결정됩니다. 처음 연결을 확인할 때는 시스템 프록시, TUN, 사용자 지정 규칙을 동시에 변경하지 말고 한 가지 연결 방식만 사용하세요.
v2rayN
macOSApple 메뉴에서 “이 Mac에 관하여”를 여세요. Apple 칩 모델이 표시되면 Apple Silicon을, Intel 프로세서가 표시되면 Intel을 선택하세요.
macOS 설치 준비
칩에 맞는 DMG를 다운로드해 디스크 이미지를 연 다음, 앱을 “응용 프로그램” 폴더로 복사하고 그 폴더에서 실행하세요. 임시로 마운트한 디스크 이미지에서 계속 실행하면 이후 업데이트, 경로 권한, 설정 위치가 예상과 달라질 수 있습니다. 다른 기기로 옮길 때는 대상 기기의 칩을 다시 확인하세요. 이전 Mac의 패키지 종류를 그대로 사용할 필요는 없습니다.
시스템 보안 안내가 표시되면 먼저 내용을 읽고 다운로드 출처와 선택한 파일이 맞는지 확인한 다음, 시스템에서 제공하는 앱 허용 절차를 따르세요. 프로그램을 실행하기 위해 시스템 보안 기능 전체를 끄지 마세요. 실행에 성공한 뒤에는 서버 설정, 코어 로그, 시스템 프록시를 각각 확인하세요. 설치 완료와 연결 성공은 서로 다른 단계입니다.
| 확인 항목 | 설치 전 확인 |
|---|---|
| 프로세서 | Apple Silicon은 arm64, Intel은 x64를 선택하세요. |
| 운영체제 호환성 | 현재 설치 파일의 최소 운영체제 요구 사항과 실행 시 안내를 확인하세요. |
| 네트워크 설정 | 시스템 프록시를 사용하기 전에 현재 네트워크 서비스와 기존 프록시 설정을 확인하세요. |
다른 프록시 프로그램을 사용했다면 먼저 종료하고 남아 있는 프록시 설정을 확인하세요. 사용을 마칠 때는 클라이언트에서 시스템 프록시를 해제한 뒤 정상 종료하세요. 앱을 바로 삭제해도 시스템의 프록시 주소가 자동으로 복구되는 것은 아닙니다. 브라우저는 정상 작동하지만 다른 앱이 연결되지 않는다면 해당 앱이 시스템 프록시를 따르는지 확인하세요.
v2rayNG
추천Xray 코어를 사용하는 Android 그래픽 클라이언트입니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 되지만, 실제 지원 아키텍처를 기기에서 확인하세요.
v2flyNG
대안 · V2Fly 코어V2Fly 코어와의 호환성이 필요한 설정에 적합합니다. 선택 전에 프로토콜, 전송 방식, 설정 항목을 확인하세요. 모든 문제를 해결하기 위해 클라이언트부터 바꾸는 것은 적절하지 않습니다.
Android 설치 및 권한
APK를 열면 브라우저나 파일 관리자가 앱 설치를 허용하도록 요청할 수 있습니다. 이번 설치에 사용할 앱에만 필요한 권한을 부여하고, 설치 후에는 시스템 설정에서 변경할 수 있습니다. 설치에 실패하면 먼저 시스템 안내를 확인하세요. 아키텍처 불일치, 낮은 운영체제 버전, 저장 공간 부족, 서명 충돌은 각각 원인이 다르므로 따로 해결해야 합니다. 같은 파일을 반복해서 다운로드해도 보통 문제가 해결되지 않습니다.
| 확인 항목 | 설치 전 확인 |
|---|---|
| 기기 아키텍처 | 대부분의 기기는 arm64를 우선 선택하세요. 확인하기 어렵다면 범용 버전을 사용하세요. |
| 설치 권한 | 현재 파일 출처의 앱 설치를 허용하고 시스템의 호환성 안내를 확인하세요. |
| 연결 권한 | 처음 연결할 때 시스템 안내에 따라 VPN 권한을 허용하세요. |
| 백그라운드 실행 | 연결이 자주 끊기면 배터리 최적화, 백그라운드 제한, 다른 VPN 앱을 확인하세요. |
가져온 뒤에는 설정 하나를 선택하고 연결하세요. Android는 보통 시스템 VPN 인터페이스로 트래픽을 처리하며, 동일한 사용자 환경에서는 활성 VPN 서비스를 하나만 사용할 수 있습니다. VPN 인터페이스를 사용하는 다른 도구와 충돌할 수 있습니다. 연결 후 일부 앱에서만 문제가 생기면 앱별 분할 규칙을 확인하고 전체 설정을 바로 삭제하지 마세요.
v2rayNG와 v2flyNG는 서로 다른 코어를 사용하므로 모든 최신 프로토콜과 확장 설정을 함께 지원한다고 볼 수 없습니다. 예를 들어 설정에 REALITY가 포함되어 있다면 선택한 클라이언트와 코어의 지원 여부를 먼저 확인하세요. 기존 앱의 업데이트 파일 서명이 일치하지 않으면 백업한 다음 이전 방법을 결정하세요. 개인 설정이 사라질 수 있으므로 바로 삭제하지 마세요.
v2rayN
Linux 데스크톱배포판의 패키지 관리 방식에 맞춰 deb 또는 rpm을 선택하세요. 아래 기본 다운로드는 x64용이며, arm64 기기는 작은 링크에서 해당 패키지를 선택하세요.
Linux 패키지 형식 및 데스크톱 환경
패키지 형식과 CPU 아키텍처는 별개의 조건입니다. deb를 사용하는 시스템도 arm64일 수 있고, rpm을 사용하는 시스템도 x64일 수 있습니다. 먼저 시스템 정보에서 배포판과 아키텍처를 확인한 뒤 해당 파일을 선택하세요. 패키지 이름의 amd64와 x86_64는 일반적으로 x64를, arm64와 aarch64는 ARM 64비트 아키텍처를 뜻합니다.
배포판에서 제공하는 소프트웨어 설치 프로그램으로 파일을 열고 종속성 확인 결과를 살펴보세요. 확장자가 같아도 모든 배포판에서 설치할 수 있는 것은 아닙니다. 패키지에 필요한 시스템 라이브러리 버전과 데스크톱 구성 요소도 충족해야 합니다. 종속성 충돌이 발생하면 무시하고 강제로 설치하지 말고 현재 시스템과 릴리스 패키지의 호환성을 먼저 확인하세요.
| 확인 항목 | 설치 전 확인 |
|---|---|
| 패키지 관리 방식 | 배포판에 맞는 deb 또는 rpm을 선택하고 설치 방식을 섞어 사용하지 마세요. |
| CPU 아키텍처 | x64는 amd64 또는 x86_64, arm64는 aarch64에 해당합니다. |
| 실행 환경 | 그래픽 데스크톱과 현재 패키지의 종속성이 필요합니다. 순수 터미널 서버용 설치 패키지가 아닙니다. |
| 프록시 연결 | 데스크톱 환경과 대상 앱이 프록시 설정을 읽는 방식을 확인하세요. |
데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다릅니다. 일부 앱은 자체 프록시 설정만 읽고, 터미널 프로그램도 데스크톱 프록시를 자동으로 사용하지 않을 수 있습니다. 브라우저는 되지만 다른 프로그램이 연결되지 않는다면 먼저 앱의 연결 방식을 확인한 뒤 라우팅을 살펴보세요. 시스템 프록시와 TUN은 권한과 적용 범위가 다르므로 각각 확인해야 합니다.
설치 후
증상별 문제 해결 가이드 →
설정 가져오기 및 첫 연결 확인
구독 가져오기 및 서버 선택
v2rayN의 “구독 그룹”에서 구독 주소를 입력하고 저장한 다음 구독을 업데이트하세요. v2rayNG에서는 메뉴에서 클립보드의 공유 링크를 가져오거나 구독 설정을 추가한 뒤 업데이트할 수 있습니다. 메뉴 이름은 버전에 따라 달라질 수 있지만, 주소 저장, 설정 가져오기, 사용할 서버 선택 순서로 진행하면 됩니다.
구독 업데이트에 실패하면 먼저 주소가 완전하고 유효한지, 앞뒤에 불필요한 공백이 없는지 확인하세요. 그런 다음 직접 가져오기와 프록시를 통한 가져오기를 구분해 시도하세요. 클라이언트에 사용할 수 있는 프록시가 아직 없는데 프록시를 통해 업데이트하면 문제가 반복될 수 있습니다. 그룹을 계속 삭제하지 말고 오류 메시지를 기록한 뒤 가져오기 방식을 바꿔 보세요.
공유 링크와 일반 JSON은 서로 다른 가져오기 형식입니다. 일반 공유 링크는 해당 가져오기 메뉴에서 처리하고, 전체 JSON은 클라이언트와 코어의 호환성을 확인하세요. 백업 파일을 공유하거나 문제를 설명할 때는 구독 주소, 사용자 식별자, 인증 정보를 가리세요.
앱 연결 및 로그 확인
데스크톱에서는 사용할 서버를 선택한 뒤 코어 로그에 시작 메시지가 표시되는지 확인하고 시스템 프록시를 설정하세요. Android는 처음 연결할 때 VPN 권한을 허용하고 시스템의 연결 상태를 확인합니다. 테스트할 웹사이트를 열고 로그에 해당 대상에 대한 연결이 기록되는지 살펴보세요.
라우팅 모드는 클라이언트에 들어온 요청을 처리하는 방식을 정합니다. “중국 본토 우회(Whitelist)”와 “전역(Global)”은 시스템 프록시를 켜는 설정을 대신하지 않습니다. 로그에 대상 요청이 없다면 앱의 트래픽이 프록시로 들어오는지 확인하세요. 요청은 있지만 연결에 실패한다면 서버 매개변수, 네트워크 연결 가능 여부, DNS를 점검하세요.
기본 연결을 확인한 뒤 사용자 지정 라우팅, 앱별 분할 또는 TUN 설정을 추가하세요. 한 번에 한 종류의 설정만 변경하고 이전 설정을 보관하면 로그를 바탕으로 어떤 변경이 결과에 영향을 줬는지 파악하기 쉽습니다. 자세한 방법은 사용 가이드를 참고하세요.
설치 파일 선택 및 업데이트 FAQ
클라이언트를 다운로드하면 바로 연결할 수 있나요?
설치 파일에는 클라이언트 프로그램만 포함되며, 바로 사용할 수 있는 서버 설정은 제공되지 않습니다. 사용할 권한이 있는 구독 주소나 공유 링크를 준비해 가져온 뒤, 서버를 선택하고 연결을 시작하세요. 이어서 시스템 프록시 설정이나 Android VPN 권한을 확인하면 됩니다.
Windows Desktop과 클래식 WPF 버전 중 무엇을 선택해야 하나요?
Desktop은 최신 크로스 플랫폼 UI를 사용해 새로 설치하거나 여러 데스크톱 운영체제에서 사용하기 좋습니다. WPF는 익숙한 창 구성과 사용 흐름을 선호하는 사용자에게 적합한 클래식 안정 버전입니다. 두 버전 모두 올바른 서버 설정이 필요하며, UI 차이가 연결 품질 차이를 의미하지는 않습니다.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 실제로는 기기에서 지원하는 앱 아키텍처를 기준으로 선택하세요. 아키텍처를 확인하기 어렵다면 범용 버전을 선택할 수 있습니다. 설치 파일이 호환되지 않는다는 안내가 나오면 운영체제 버전, 저장 공간, 기존 앱의 서명도 확인하세요.
클라이언트를 업데이트하기 전에 무엇을 보관해야 하나요?
구독 그룹, 개인 서버 설정, 사용자 지정 라우팅과 주요 설정을 먼저 백업하고, 현재 사용 중인 앱과 설치 방식도 기록해 두세요. 설정에는 개인 구독 주소나 인증 정보가 포함될 수 있으므로 안전한 위치에 백업해야 합니다. 업데이트 후에는 그룹, 활성 서버, 라우팅 모드를 확인하세요.
설치했는데 브라우저에서 웹페이지가 열리지 않습니다. 다시 다운로드해야 하나요?
먼저 로그에서 코어가 시작됐는지 확인한 다음 서버 설정과 시스템 프록시를 점검하세요. 데스크톱에서는 시스템 프록시 자동 설정이 적용됐는지, Android에서는 VPN 권한과 연결 상태를 확인하면 됩니다. 프로그램이 정상적으로 실행된다면 반복해서 재설치하기보다 연결 과정을 따라 원인을 찾으세요.
페이지에 표시된 버전과 설치 파일 이름이 다르면 무엇을 기준으로 봐야 하나요?
버전 표기와 다운로드 링크는 릴리스 목록의 서로 다른 항목을 참조하므로 갱신 시점이 다를 수 있습니다. 페이지의 버전은 참고용이며, 실제 패키지 버전은 다운로드 파일 이름과 설치 후 앱에 표시되는 버전을 기준으로 확인하세요. 다운로드 주소의 숫자를 바꿔 다른 버전을 추측하지 마세요.
세 클라이언트의 설정 기능을 비교하려면 클라이언트 비교를 확인하세요. 연결 후 나타나는 구체적인 증상은 자주 묻는 질문에서 찾아볼 수 있습니다.