v2rayN
추천두 설치 파일 모두 x64용입니다. 실행 환경 요구 사항은 설치 프로그램과 최신 릴리스 안내를 확인하세요. 구성 요소가 없다는 메시지가 표시되면 구성 요소 이름부터 기록하고 프로그램 폴더의 파일을 임의로 바꾸지 마세요.
v2rayN 데스크톱 / v2rayNG 및 v2flyNG Android
운영체제를 선택한 뒤 프로세서와 설치 형식을 확인하세요. 설치 파일은 그래픽 클라이언트를 제공하며, 구독·노드·라우팅은 사용 환경에 맞게 설정해야 합니다.
v2rayN · x64 · 데스크톱 및 클래식 WPF 버전
두 설치 파일 모두 x64용입니다. 실행 환경 요구 사항은 설치 프로그램과 최신 릴리스 안내를 확인하세요. 구성 요소가 없다는 메시지가 표시되면 구성 요소 이름부터 기록하고 프로그램 폴더의 파일을 임의로 바꾸지 마세요.
| 확인 항목 | 선택 및 요구 사항 | 확인 위치 |
|---|---|---|
| 프로세서 아키텍처 | 이 페이지의 두 패키지는 모두 x64입니다 | 설정 → 시스템 → 시스템 정보에서 시스템 종류 확인 |
| 시스템 호환성 | 현재 릴리스의 요구 사항을 충족하는 지원 대상 Windows 환경 사용 | 시스템 버전과 설치 프로그램의 호환성 안내 확인 |
| 설치 및 폴더 | 압축을 모두 풀고 설정을 저장할 수 있는 위치 확보 | 압축 해제 완료 여부, 디스크 여유 공간, 폴더 권한 확인 |
| 프록시 권한 | 시스템 프록시와 TUN은 필요한 권한이 다릅니다 | 일반 프록시부터 확인하고 TUN을 사용할 때 필요한 권한을 점검하세요 |
처음 실행한 뒤 설정을 가져와 노드를 테스트하고, 그다음 시스템 프록시를 활성화할지 결정하세요. 시스템 프록시가 모든 프로그램의 연결을 자동으로 처리하는 것은 아닙니다. 일부 앱은 자체 네트워크 설정을 사용합니다. 브라우저는 접속되지만 특정 앱만 실패한다면 설치 파일을 계속 바꾸기보다 해당 앱의 프록시 설정을 확인하세요. TUN이 필요하면 관련 설정 안내를 먼저 읽고 기존 가상 네트워크 어댑터나 네트워크 도구가 트래픽을 동시에 처리하지 않도록 하세요.
v2rayN · 칩에 맞는 DMG 선택
DMG를 열고 창의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기세요. 처음 실행할 때 시스템 보안 경고가 표시되면 다운로드 출처를 확인한 뒤 시스템이 안내하는 앱 열기 절차를 따르세요. 시스템 보안 기능 전체를 비활성화하는 것은 권장하지 않습니다.
| 확인 항목 | 선택 및 요구 사항 | 확인 위치 |
|---|---|---|
| 칩 종류 | Apple Silicon은 arm64, Intel은 x64 선택 | 시스템 메뉴 → 이 Mac에 관하여 |
| 시스템 버전 | 현재 릴리스 패키지의 호환성 요건 충족 | 이 Mac에 관하여 및 앱 실행 안내 |
| 설치 위치 | DMG는 디스크 이미지이며 안내에 따라 앱을 복사해 설치합니다 | Finder의 ‘응용 프로그램’ 폴더 |
| 네트워크 권한 | 선택한 프록시 모드에 필요한 권한 허용 | 클라이언트 안내 및 시스템 네트워크 설정 |
디스크 이미지에서 바로 실행하는 경우와 응용 프로그램 폴더에 복사한 뒤 실행하는 경우에는 경로와 권한이 다르게 동작할 수 있습니다. 복사를 마친 뒤 디스크 이미지에서 실행 중인 프로세스를 종료하고 응용 프로그램 폴더에서 여는 것을 권장합니다. 구독을 가져온 뒤 연결을 테스트하세요. 시스템 프록시를 활성화했다면 현재 네트워크 서비스의 프록시 설정이 예상대로 바뀌었는지 확인하세요. 사용을 마칠 때는 클라이언트에서 프록시 상태를 복원한 뒤 프로그램을 종료하면 설정 문제와 네트워크 문제를 구분하기 쉽습니다.
먼저 v2rayNG를 선택하고 기존 설정에 따라 v2flyNG를 고려하세요
REALITY 등을 사용하는 설정은 노드 매개변수가 클라이언트에 포함된 코어와 맞는지 확인하세요. 프로토콜 이름이 같더라도 전송 및 보안 매개변수를 모두 생략할 수 있는 것은 아닙니다.
선택 기준은 앱 이름이 아니라 기존 설정과 코어의 호환성입니다. Xray 전용 기능이 필요한 설정이라면 v2rayNG에서 지원 여부를 확인하세요.
| 확인 항목 | 선택 및 요구 사항 | 확인 방법 |
|---|---|---|
| 앱 아키텍처 | arm64 우선, 확인하기 어려우면 범용 버전 선택 | 기기에서 지원하는 앱 아키텍처 기준 |
| 시스템 호환성 | 선택한 APK의 시스템 요구 사항 충족 | 설치 프로그램의 호환성 안내 확인 |
| 설치 권한 | 현재 다운로드 도구가 앱을 설치하도록 허용 | 시스템 안내에 따라 해당 출처에만 권한 허용 |
| 연결 권한 | 처음 연결할 때 VPN 연결 요청 확인 필요 | 같은 종류의 연결을 점유하는 다른 앱을 종료한 뒤 다시 시도 |
다운로드가 끝나면 시스템 파일 관리자에서 APK를 열고 앱 이름을 확인한 뒤 설치하세요. 업데이트 설치에 실패하면 먼저 전체 오류 메시지를 기록하세요. 서명 불일치, 버전 다운그레이드, 저장 공간 부족, 아키텍처 불일치는 서로 다른 문제입니다. 오류를 무시하려고 바로 앱을 삭제하지 마세요. 삭제하면 설정도 함께 지워질 수 있습니다. 백그라운드에서 연결이 자주 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 먼저 확인하세요. 이런 설정은 지속 실행에 영향을 주므로 노드 자체의 연결 품질과 구분해야 합니다.
v2rayN · 배포판의 패키지 형식에 맞춰 선택
amd64와 x86_64는 대체로 이 페이지의 x64에 해당하고, aarch64는 대체로 arm64에 해당합니다. 아키텍처와 패키지 형식은 각각 확인해야 하며 파일 확장자만으로 호환 여부를 판단할 수 없습니다.
| 확인 항목 | 선택 및 요구 사항 | 확인 위치 |
|---|---|---|
| 패키지 관리 체계 | 배포판에 맞춰 deb 또는 rpm 선택 | 시스템 소프트웨어 관리자 및 배포판 안내 |
| 프로세서 아키텍처 | x64와 arm64를 구분해 선택 | 시스템 정보 패널의 하드웨어 또는 프로세서 정보 |
| 실행 환경 | 호환되는 그래픽 데스크톱 및 실행 의존성 필요 | 설치 프로그램의 의존성 확인 결과와 앱 실행 안내 |
| 프록시 적용 범위 | 데스크톱 환경과 앱에 따라 프록시 동작이 다를 수 있습니다 | 시스템 네트워크 설정 및 대상 앱 설정 |
설치가 완료되면 앱 메뉴에서 클라이언트를 실행하고 설정을 가져오세요. Linux 데스크톱 환경마다 시스템 프록시 구현 방식이 다를 수 있으며, 브라우저·터미널·독립 실행 앱이 서로 다른 프록시 설정을 읽기도 합니다. 먼저 클라이언트에서 노드 연결이 정상인지 확인한 뒤 대상 앱이 해당 프록시 설정을 사용하는지 살펴보세요. TUN을 사용할 계획이라면 권한과 라우팅 변경을 먼저 확인하세요. 항목별로 설정하는 대신 전체 그래픽 세션을 관리자 권한으로 실행하지 마세요.
설치 성공 여부, 설정 사용 가능 여부, 트래픽의 프록시 경유 여부를 나눠 확인하세요. 각각 검증하면 문제를 더 쉽게 찾을 수 있습니다.
이미 클라이언트를 사용 중이라면 먼저 구독과 노드를 내보내고 사용자 지정 라우팅, DNS, 로컬 수신 포트, 프록시 모드를 기록하세요. 백업 파일에 인증 정보가 포함될 수 있으므로 안전한 로컬 위치에 보관하세요. 다른 앱으로 설정을 옮길 때는 양쪽에서 지원하는 공유 링크나 설정 형식을 우선 사용하고 프로그램 폴더 전체를 그대로 복사하지 마세요.
설치가 끝났다고 바로 연결할 수 있는 것은 아닙니다. 합법적으로 확보한 구독이나 설정을 클라이언트에 가져와 업데이트한 뒤 사용할 서버를 지정하세요. 구독 업데이트에 실패하면 오류 내용을 먼저 읽고 링크가 완전한지, 만료되었는지, 네트워크에 연결할 수 있는지 확인하세요. 구문 분석 실패를 설치 버전 문제로 단정하지 마세요.
먼저 클라이언트 연결 테스트를 진행한 뒤 필요한 프록시 모드를 활성화하고 대상 앱에서 접속 결과와 외부 IP를 확인하세요. TCP 포트에 연결된다는 사실만으로는 일부 구간의 통신만 확인할 수 있으며 전체 요청 테스트를 대신하지 못합니다. 처음 문제를 확인할 때는 사용자 지정 규칙을 줄이고 한 번에 하나씩만 변경하세요. 변경 전후 로그도 보관하세요.
v2rayN, v2rayNG, v2flyNG는 설정 관리, 연결 제어, 실행 상태 표시 등을 담당하는 그래픽 클라이언트입니다. Project V 생태계의 V2Fly와 Xray는 서로 다른 코어 계열입니다. 프로토콜, 전송 방식, 보안 기능의 지원 여부는 클라이언트에 통합된 코어와 구체적인 버전에 따라 달라집니다. 앱 이름이 비슷해도 설정 필드가 모두 호환되는 것은 아닙니다. 클라이언트를 고르기 전에 파일 크기만 볼 것이 아니라 기존 노드의 요구 사항을 먼저 확인하는 것이 좋습니다.
이 페이지는 운영체제별로 다운로드 경로를 정리했으며, 카드에 표시된 목록 버전과 다운로드 대상은 릴리스 목록을 기준으로 관리합니다. 목록 버전과 파일 이름은 서로 다른 릴리스 정보에서 가져올 수 있으므로 숫자만 보고 덮어 설치할 수 있는지 판단하지 마세요. 대상 파일 이름, 설치 프로그램에 표시된 앱 정보, 기기에 실제 설치된 결과를 각각 확인해야 합니다. 설치 프로그램에서 다운그레이드나 호환성 문제를 알리면 기존 앱과 설정을 보존하고 원인을 확인한 뒤 다음 단계를 결정하세요.
클라이언트 업데이트와 구독 업데이트는 별개입니다. 클라이언트 업데이트는 프로그램과 통합 기능을 바꾸고, 구독 업데이트는 노드 목록과 관련 매개변수를 새로 고칩니다. 클라이언트를 업데이트해도 만료된 구독이 자동으로 복구되거나 노드 이용 기간이 연장되지는 않습니다. 반대로 구독이 정상적으로 갱신되더라도 노드의 모든 전송 매개변수와 로컬 프록시 모드가 올바르다는 뜻은 아닙니다. 업데이트할 때마다 실행, 가져오기, 연결 테스트, 프록시 적용 확인, 정상 종료까지 한 번씩 점검하세요.
시스템에서 권장하는 앱 위치와 설치 절차를 따르세요. 읽기 전용 폴더, 임시 폴더, 자동 정리되는 다운로드 캐시에 프로그램을 두지 마세요. 일반 시스템 프록시와 TUN은 필요한 권한이 다르므로 문제를 확인한다는 이유로 클라이언트 전체에 계속 높은 권한을 부여하지 마세요. 먼저 필요한 최소 권한으로 기본 연결을 확인하고 선택한 모드에 따라 추가 권한을 허용하면 권한 문제와 설정 문제가 서로 영향을 주는 일을 줄일 수 있습니다.
두 클라이언트를 처음 비교할 때는 하나를 종료한 다음 다른 하나를 실행하세요. 여러 프로그램이 시스템 프록시를 동시에 변경하거나 같은 포트를 사용하거나 가상 네트워크 인터페이스를 함께 제어하면 테스트 결과를 신뢰하기 어렵습니다. 종료하기 전에 클라이언트 화면에서 프록시 상태를 복원하세요. 종료 후 일반 웹페이지에도 접속할 수 없다면 재설치부터 하지 말고 시스템이 이미 종료된 로컬 포트를 가리키고 있지 않은지 확인한 뒤 네트워크를 점검하세요.
설치 파일에는 사용할 수 있는 노드나 구독이 포함되어 있지 않습니다. 설치 후 직접 확보하고 사용할 권한이 있는 구독 URL, 공유 링크 또는 설정 파일을 가져온 다음 구독을 업데이트하고 사용할 서버를 선택해 연결을 확인하세요. 구독 URL이나 설정에 포함된 인증 정보를 공개적으로 공유하지 마세요.
데스크톱 버전은 최신 크로스 플랫폼 인터페이스를 사용하므로 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 경우에 적합합니다. 클래식 WPF 버전은 Windows 기본 인터페이스 기술을 사용하는 안정적인 클래식 버전입니다. 두 버전 모두 설정을 가져와야 합니다. 전환하기 전에 필요한 설정을 내보내고, 처음 연결을 확인할 때는 클라이언트 하나만 실행하세요.
2015년 이후 출시된 주류 스마트폰에서는 대체로 arm64를 우선 선택하면 됩니다. 다만 실제로 지원하는 앱 아키텍처를 기준으로 선택하세요. 범용 버전은 여러 아키텍처를 포함해 기기의 아키텍처를 확인하기 어렵거나 전용 패키지 설치에 실패했을 때 시도할 수 있습니다. 범용 버전을 사용해도 같은 노드의 속도가 빨라지지는 않습니다. 계속 설치되지 않으면 시스템 호환성, 여유 공간, 기존 앱의 서명을 확인하세요.
같은 앱을 일반적인 방식으로 덮어 설치하면 대개 데이터가 유지되지만, 백업을 대신할 수는 없습니다. 업데이트 전에 클라이언트의 내보내기 기능으로 구독, 노드, 사용자 지정 라우팅을 저장하고 로컬 포트, 프록시 모드, DNS 설정도 기록해 두세요. 다른 클라이언트나 인터페이스 버전으로 전환하거나 앱을 삭제한 뒤 다시 설치할 때는 설정이 자동으로 이전된다고 가정하지 마세요.
먼저 구독이 정상적으로 업데이트되었는지, 유효한 노드를 선택했는지 확인한 다음 시스템 시간, 노드 매개변수, 클라이언트 로그를 살펴보세요. 데스크톱에서는 필요에 따라 시스템 프록시나 TUN 모드가 활성화되어 있는지 확인하고, 모바일에서는 VPN 연결 권한을 허용했는지와 다른 앱이 연결을 점유하고 있지 않은지 확인하세요. 설정은 한 번에 하나씩만 바꾸고 연결 테스트와 외부 IP로 결과를 확인하세요.