v2rayN
Windows · x64 7.24.1
Desktop 버전은 최신 크로스 플랫폼 UI를 사용합니다. 클래식 WPF 버전은 기존 조작 방식과 레이아웃을 유지합니다. 처음 설치한다면 Desktop 버전을, 기존 인터페이스에 익숙하다면 WPF 버전을 선택하세요.
ZIP 파일을 다운로드한 뒤 먼저 압축을 완전히 푸세요. 압축 파일 미리보기 창에서 설치 프로그램을 바로 실행하지 마세요.
클라이언트 설치 파일 / 플랫폼·아키텍처
V2Ray 다운로드
먼저 운영체제를 고른 다음 칩 아키텍처를 확인하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장합니다.
운영체제에 맞는 설치 파일 선택
다운로드 항목은 운영체제별로 나뉘어 있습니다. 플랫폼을 전환해도 페이지 주소에 해당 위치가 저장되어 다음에 바로 열 수 있습니다.
Windows 설치 파일
같은 클라이언트, 두 가지 인터페이스. 아래 파일은 모두 x64 설치 패키지입니다.
Windows 설치 및 첫 실행
실행 중인 이전 클라이언트를 종료하고 시스템 트레이 아이콘도 사라졌는지 확인한 뒤 다운로드 파일의 압축을 푸세요. 설치 프로그램이 시스템 위치에 파일을 기록해야 할 때는 시스템 안내에 따라 권한을 허용하면 됩니다. 일반적인 구독 가져오기를 위해 클라이언트를 항상 관리자 권한으로 실행할 필요는 없습니다. 보안 경고가 표시되면 프로그램 출처와 다운로드한 파일을 확인하고, 설치를 위해 시스템 보호 기능 전체를 끄지 마세요.
Desktop 버전과 WPF 버전은 메뉴 위치가 다를 수 있지만, 구독 그룹, 구독 업데이트, 시스템 프록시는 첫 설정에서 공통으로 확인해야 합니다. 인터페이스를 바꾸기 전에 기존 설정을 저장하고, 이전 후 라우팅, 사용자 지정 DNS, 로컬 리스닝 설정을 확인하세요. 두 인터페이스 버전을 동시에 실행해 같은 포트를 사용하거나 두 클라이언트가 번갈아 시스템 프록시를 변경하지 않도록 하세요.
메인 화면이 열린다고 연결이 완료된 것은 아닙니다. 먼저 구독 그룹을 추가하고 업데이트를 실행해 설정 목록이 나타나는지 확인한 다음 사용할 항목을 선택하세요. 이어서 시스템 프록시와 라우팅 모드를 설정하고 실제 웹페이지에 접속해 확인합니다. 로그에 포트 충돌이 표시되면 재설치부터 하지 말고 실행 중인 클라이언트 프로세스를 확인하세요.
macOS 설치 파일
“이 Mac에 관하여”에서 칩 정보를 확인한 다음 Apple Silicon 또는 Intel용을 선택하세요.
v2rayN
macOS · DMG 7.24.1
“이 Mac에 관하여”에 Apple 칩이 표시되면 Apple Silicon, 즉 arm64를 선택하세요. Intel 프로세서가 표시되면 Intel, 즉 x64를 선택하면 됩니다. 구입 연도로 칩 정보를 대신 판단하지 마세요.
DMG를 연 뒤 앱을 “응용 프로그램” 폴더에 복사하고 실행하세요. 업데이트 전에는 이전 프로세스를 종료해 디스크 이미지에 있는 임시 복사본을 계속 사용하지 않도록 하세요.
macOS 설치 및 권한 설정
다운로드한 디스크 이미지를 열고 앱을 “응용 프로그램” 폴더에 복사하세요. 복사가 끝나면 디스크 이미지를 추출한 뒤 “응용 프로그램” 폴더에서 앱을 실행하면 됩니다. 그래야 업데이트 시 한 복사본만 교체되고 다른 복사본이 계속 실행되는 일을 방지할 수 있습니다. 이전에 설치한 적이 있다면 메뉴 막대에 남아 있는 기존 프로세스를 종료한 뒤 교체 안내를 확인하세요.
처음 실행할 때 시스템 보안 경고가 표시되면 안내를 끝까지 읽고 파일 출처를 확인한 다음 “시스템 설정 → 개인정보 보호 및 보안”에서 제공되는 방법을 따르세요. 시스템 버전에 따라 버튼 이름과 위치가 다를 수 있습니다. 실행 실패가 모두 권한 문제인 것은 아닙니다. 아키텍처 불일치, 시스템 버전 미지원, 앱 복사 미완료 여부도 각각 확인하세요.
설치 후 구독을 가져와 설정을 선택한 다음 클라이언트가 시스템 프록시를 제어하도록 할지 결정하세요. 시스템 프록시는 관련 시스템 설정을 따르는 앱에만 영향을 주며, 모든 트래픽이 같은 경로를 사용한다는 뜻은 아닙니다. 클라이언트를 종료한 뒤에도 다른 앱에서 인터넷이 안 된다면 시스템 네트워크 설정에 프록시 항목이 남아 있는지 확인하고 사용 방식에 맞게 복구하세요.
Android 설치 파일
v2rayNG를 우선 권장합니다. 기존 V2Fly 설정을 사용해야 한다면 v2flyNG를 고려하세요.
v2rayNG
Android · Xray 코어 2.2.6
스마트폰에서 구독을 가져오고 설정을 선택해 프록시 연결을 설정할 수 있습니다. 2015년 이후 출시된 일반적인 스마트폰은 arm64를 우선 선택하세요. 기기에서 지원하는 앱 아키텍처를 모르겠다면 범용 버전을 고려할 수 있습니다.
페이지의 버전 표기와 패키지 파일 이름은 업데이트 시점이 다를 수 있습니다. 여기 표시된 목록 버전은 2.2.6이며, 현재 다운로드 파일 이름에는 2.3.11이 표시되어 있습니다. 실제 설치 버전은 클라이언트에서 확인하세요.
v2flyNG
Android · V2Fly 코어 1.10.31
V2Fly 코어 설정을 계속 사용해야 하는 경우에 적합합니다. 선택하기 전에 구독의 프로토콜과 전송 설정을 확인하세요. v2rayNG와 기능 및 설정 항목이 모두 같다고 가정하지 마세요.
클라이언트를 바꾸기 전에 기존 구독 주소를 보관하고 앱별 프록시 및 DNS 설정을 별도로 기록하세요. 이 설정은 구독과 함께 이전되지 않을 수 있습니다.
Android 시스템 및 설치 요구 사항
| 항목 | 확인 항목 |
|---|---|
| arm64 | arm64-v8a 앱을 지원하는 기기에서 사용할 수 있습니다. 프로세서의 홍보용 이름만으로 판단하면 안 됩니다. |
| 범용 버전 | 여러 아키텍처를 포함해 기기 아키텍처를 모를 때 적합합니다. 단, 앱의 시스템 요구 사항은 충족해야 합니다. |
| 설치 권한 | 시스템에서 요청하면 APK를 여는 브라우저 또는 파일 관리자에 앱 설치 권한을 허용하세요. |
| 연결 권한 | 처음 연결을 시작할 때 시스템의 VPN 연결 요청을 확인하고 허용하세요. |
APK를 다운로드한 뒤 브라우저의 다운로드 기록이나 파일 관리자에서 여세요. 설치 권한은 모든 앱에 일괄 허용하는 것이 아니라 실제로 파일을 여는 앱에 부여하는 것이 일반적입니다. 설치가 끝나면 필요에 따라 해당 권한을 해제할 수 있습니다. 파싱 오류가 표시되면 다운로드 완료 여부, 아키텍처 호환성, 현재 패키지의 시스템 버전 요구 사항을 먼저 확인하세요.
처음 연결을 설정할 때 시스템에서 VPN 연결을 만들도록 요청합니다. 이는 Android 클라이언트가 트래픽을 처리하는 방식이며, 별도의 시스템 기능을 구매해야 한다는 뜻은 아닙니다. 같은 시스템 연결 통로를 사용하는 다른 앱이 연결 중이면 먼저 연결을 끊고 현재 클라이언트를 시작하세요. 구독 가져오기와 연결 권한 허용은 별개의 작업이므로 하나를 완료해도 다른 작업이 자동으로 끝나지 않습니다.
화면이 꺼진 뒤 연결이 끊기면 백그라운드 실행과 배터리 관리 제한을 확인하세요. 처음부터 모든 절전 설정을 끌 필요는 없습니다. 기기마다 메뉴 이름이 다르므로 클라이언트의 백그라운드 실행을 허용한 뒤 개선되는지 살펴보세요. 앱별 프록시, 라우팅, DNS는 하나씩 조정해 여러 설정을 한 번에 바꿔 원인을 파악하기 어려워지는 일을 피하세요.
Linux 설치 파일
먼저 배포판이 deb 또는 rpm을 사용하는지 확인하고 x64 또는 arm64 아키텍처를 확인하세요.
v2rayN
Linux · 그래픽 데스크톱 7.24.1
Debian 및 Ubuntu 계열은 보통 deb를, RPM 패키지 관리 체계를 사용하는 배포판은 rpm을 선택합니다. 아래 기본 다운로드는 x64용이며 arm64 기기는 아래의 해당 항목을 이용하세요.
arm64 기기용 설치 파일
배포판의 소프트웨어 설치 프로그램으로 설치 파일을 여세요. 패키지 형식이 같아도 모든 배포판 버전에서 필요한 의존성을 지원하는 것은 아닙니다.
Linux 설치 및 데스크톱 프록시 설정
파일 관리자에서 해당 설치 파일을 열어 시스템 소프트웨어 설치 프로그램으로 설치하세요. 파일이 설치 프로그램이 아닌 아카이브 도구와 연결되어 있다면 “다른 프로그램으로 열기”에서 소프트웨어 설치 앱을 선택하세요. 설치 중 필요한 권한은 시스템 앱 위치에 파일을 기록하기 위한 것입니다. 평소에는 일반 데스크톱 사용자로 클라이언트를 실행해 설정 파일을 관리자만 쓸 수 있는 상태로 만들지 마세요.
rpm 파일 이름의 배포판 빌드 표시는 현재 시스템 환경과 함께 판단해야 합니다. “rpm 지원”만으로 호환성을 단정할 수 없습니다. 설치 프로그램에서 의존성이 부족하거나 런타임 라이브러리 버전이 낮다고 안내하면 해당 배포판의 패키지 안내를 먼저 확인하세요. 시스템 기본 라이브러리를 교체해 억지로 실행하지 마세요. deb 패키지도 같은 원칙에 따라 시스템 요구 사항을 확인한 후 설치하세요.
처음 실행한 뒤 구독을 가져오고 설정을 선택한 다음 데스크톱 환경의 네트워크 프록시 설정을 확인하세요. 데스크톱 환경마다 시스템 프록시 처리 방식이 다르며, 일부 앱은 자체 프록시 설정을 사용합니다. 브라우저에서는 접속되지만 다른 앱에서 실패한다면 설치 파일 문제로 단정하지 말고 해당 앱이 시스템 프록시를 따르는지 확인하세요.
설치 전후 확인 목록
설치 파일은 클라이언트를 설치하는 데 사용됩니다. 구독, 프록시 모드, 연결 확인은 클라이언트에서 별도로 진행해야 합니다.
기존 설정 먼저 저장
이미 클라이언트를 사용 중이라면 구독 그룹, 업데이트 방식, 라우팅 모드, 사용자 지정 DNS를 기록해 두세요. 클라이언트에 백업 또는 내보내기 기능이 있다면 화면 안내에 따라 저장하세요. 구독에는 보통 서버 설정만 포함되므로 구독 주소만 복사하는 것으로 모든 로컬 설정이 이전되지는 않습니다.
파일이 사용 중이거나 백그라운드 프로세스가 이전 버전으로 실행되는 일을 막기 위해 업데이트 전에 기존 클라이언트를 종료하세요. 업데이트 후 설정이 유지됐는지 확인하고 연결을 테스트하세요. 이전이 완료됐는지 확인하기 전에 기존 설정 디렉터리를 삭제하지 마세요. 전체 백업을 공개된 위치에 업로드하지도 마세요.
클라이언트와 구독 구분하기
v2rayN, v2rayNG, v2flyNG는 설정을 읽어 사용하는 도구입니다. 클라이언트를 다운로드해도 구독이나 사용 가능한 설정이 자동으로 만들어지지 않습니다. 유효한 구독 주소를 준비한 뒤 클라이언트의 구독 그룹에 저장하고 업데이트하세요. 설정을 가져온 뒤 그중 하나를 선택해야 다음 연결 단계로 넘어갈 수 있습니다.
구독 업데이트에 실패하면 주소가 완전한지, 만료되지 않았는지, 현재 업데이트 방식으로 구독 서버에 접속할 수 있는지 먼저 확인하세요. 설치 파일과 구독 주소는 용도가 다르므로 설치 파일 다운로드 링크를 구독 주소 입력란에 붙여 넣지 마세요.
설치 후 진행 순서
구독 가져오기 → 그룹 업데이트 → 설정 선택 → 프록시 모드 설정 → 실제 접속 확인
클라이언트, 코어, 설정 호환성
설정 사용 가능 여부를 판단하려면 클라이언트 인터페이스와 코어의 기능을 함께 확인해야 합니다. 소프트웨어 이름만 비교해서는 알 수 없습니다.
인터페이스는 관리하고 코어는 연결합니다
Project V는 관련 오픈 소스 프록시 생태계의 중요한 출발점이며, V2Fly와 Xray는 서로 다른 코어 개발 방향을 이어가고 있습니다. 그래픽 클라이언트는 구독 관리, 설정 선택, 프록시 설정을 한곳에서 처리하지만 실제 연결 기능은 사용 중인 코어와 지원 프로토콜에 따라 달라집니다.
v2rayN은 데스크톱에서 설정을 관리하며, Android 클라이언트 v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 모두 오픈 소스이지만 메뉴, 설정 항목, 지원 범위가 완전히 같다는 뜻은 아닙니다. 설치 파일은 운영체제와 아키텍처를 기준으로 고르고, 설정은 프로토콜과 코어를 기준으로 확인하세요.
구독을 가져올 수 있어도 모든 설정이 호환되는 것은 아닙니다
클라이언트가 구독 형식을 읽었다는 것은 파싱이 완료됐다는 뜻일 뿐입니다. 각 설정의 프로토콜, 전송 방식, 보안 계층, 확장 매개변수는 현재 코어에서 지원되어야 하며 서버 설정과도 일치해야 합니다. 특히 코어 계열이 다른 클라이언트로 옮길 때는 모르는 항목을 삭제하며 무작정 시도하지 마세요.
지원하지 않는 설정 유형이 있다면 구독 안내와 클라이언트의 코어 설정을 먼저 확인한 뒤 업데이트하거나 다른 설정을 사용할지 결정하세요. VMess, VLESS, Trojan, Shadowsocks, REALITY의 차이를 알아보려면 프로토콜 안내를 참고하세요. 별도의 코어 설치 파일을 찾을 필요는 없습니다.
프로토콜 및 코어 선택 안내 보기 →다운로드 및 설치 자주 묻는 질문
먼저 설치 파일을 확인한 다음 설정을 살펴보세요. 아래 항목을 펼쳐 답변을 확인할 수 있습니다.
Windows 데스크톱 버전과 클래식 WPF 버전, 무엇을 선택할까요?
처음 설치한다면 최신 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 선택해 보세요. 클래식 WPF 버전은 기존 Windows 인터페이스를 유지하므로 익숙한 환경을 선호하는 사용자에게 적합합니다. 두 버전 모두 유효한 구독을 직접 가져와야 합니다. 이전하기 전 설정을 백업하고, 두 클라이언트가 동시에 시스템 프록시를 제어하지 않도록 하세요.
Android arm64 버전과 범용 버전은 무엇이 다른가요?
2015년 이후 출시된 일반적인 스마트폰은 arm64를 우선 선택하면 됩니다. 단, 기기에서 지원하는 앱 아키텍처를 확인하세요. 범용 버전은 여러 아키텍처를 포함하므로 아키텍처를 모르거나 arm64 패키지가 호환되지 않을 때 시도할 수 있습니다. 범용 버전이라고 연결 속도가 더 빠르거나 Android 버전 요구 사항을 피할 수 있는 것은 아닙니다.
클라이언트를 다운로드하면 구독도 자동으로 추가되나요?
아니요. 클라이언트는 설정을 읽고 사용하는 프로그램이며, 구독 주소는 별도로 준비해야 합니다. 설치 후 구독 그룹 설정에 주소를 저장하고 구독을 업데이트하세요. 다운로드가 완료되거나 클라이언트가 실행된 것만으로 연결을 사용할 수 있는 것은 아닙니다.
페이지에 표시된 버전과 설치 파일 이름이 다르면 어떻게 하나요?
버전 표기와 설치 파일 링크는 목록의 서로 다른 항목에서 가져오므로 업데이트 시점에 차이가 날 수 있습니다. 먼저 다운로드 항목의 클라이언트, 운영체제, 아키텍처가 맞는지 확인한 다음 실제 설치 파일과 클라이언트 내부의 버전 정보를 확인하세요. 페이지의 버전 표기만으로 기존 설치와 같은 릴리스인지 판단하지 마세요.
클라이언트를 업데이트하기 전에 이전 버전을 삭제해야 하나요?
설치 프로그램과 현재 버전의 업데이트 안내에 따라 진행하고 기존 데이터를 바로 삭제하지 마세요. 업데이트 전에 클라이언트를 종료하고 구독 그룹, 라우팅, 사용자 지정 설정을 백업하세요. 인터페이스 유형이나 코어 계열을 바꾸려면 먼저 설정 호환성을 확인한 뒤 이전 여부를 결정하세요.
설치했는데 웹페이지가 열리지 않으면 무엇부터 확인해야 하나요?
먼저 구독을 업데이트해 사용 가능한 설정이 표시되는지, 그중 하나를 선택했는지 확인하세요. 데스크톱에서는 시스템 프록시가 켜져 있는지, Android에서는 VPN 연결 요청을 허용했는지 확인합니다. 이어서 라우팅 모드, 시스템 시간, 클라이언트 로그를 살펴보세요. 원인을 찾는 대신 반복해서 재설치하지 마세요.