데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 먼저 운영체제를 확인하고 CPU 아키텍처를 맞춘 뒤, 설치 후 안내에 따라 구독을 가져오고 프록시를 설정해 연결을 확인하세요.
WINDOWS / X64
같은 클라이언트, 두 가지 데스크톱 인터페이스. 처음 설치한다면 Desktop을 권장합니다.
차세대 크로스 플랫폼 UI를 제공합니다. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 경우에 적합합니다.
Windows WPF 인터페이스를 사용하는 클래식 버전입니다. 기존 레이아웃과 메뉴, 설정 위치에 익숙하다면 계속 이 버전을 사용해도 좋습니다.
두 다운로드 모두 ZIP 파일입니다. 다운로드 후 압축을 완전히 풀고 안에 있는 설치 프로그램을 실행하세요. 압축 프로그램의 미리보기에서 바로 실행하지 마세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 운영체제 및 아키텍처 | 이 페이지의 Windows 설치 파일은 모두 x64입니다. ‘설정 → 시스템 → 정보’에서 시스템 종류와 프로세서 정보를 확인하세요. |
| 실행 환경 | 최소 운영체제 및 런타임 요구 사항은 설치 프로그램의 안내를 따르세요. .NET 데스크톱 런타임이 필요하다는 메시지가 표시되면 아키텍처에 맞는 런타임을 설치하세요. 이름이 비슷하다는 이유만으로 선택하지 마세요. |
| 설치 위치 | 현재 계정에 쓰기 권한이 있는 폴더를 사용하세요. 먼저 압축을 완전히 풀고, 임시 압축 해제 폴더에 설정을 저장하지 마세요. |
| 첫 실행 | 먼저 설정을 가져와 로컬 프록시를 확인하세요. TUN에는 추가 권한이 필요할 수 있으므로 첫 실행부터 활성화할 필요는 없습니다. |
Desktop과 WPF의 주요 차이는 인터페이스 체계이며, 서버 설정이 필요 없다는 뜻은 아닙니다. 두 버전 모두 유효한 서버 정보를 불러와야 하고 구독 주소도 직접 준비해야 합니다. 기존 클라이언트로 연결이 잘 된다면 인터페이스가 바뀐다는 이유만으로 서둘러 옮길 필요는 없습니다. 먼저 설정을 저장한 뒤 한 버전을 시험해 보면 설정 손실로 인한 문제 해결 부담을 줄일 수 있습니다.
설치 후 실행하자마자 종료된다면 압축을 풀지 않은 파일이 있는지 먼저 확인한 다음 런타임 안내, 폴더 쓰기 권한, 보안 프로그램의 차단 기록을 살펴보세요. 같은 수신 포트를 테스트하려고 클라이언트 두 개를 동시에 실행하지 마세요. 두 번째 프로그램이 포트 충돌로 프록시를 시작하지 못할 수 있습니다. 자세한 점검 순서는 자주 묻는 질문을 확인하세요.
MACOS / APPLE SILICON · INTEL
구입 연도로 아키텍처를 추측하지 말고 ‘이 Mac에 관하여’에서 칩을 확인하세요.
‘칩’ 항목에 Apple M 시리즈가 표시되면 이 패키지를 선택하세요. 시스템 아키텍처에 맞는 앱을 사용하면 변환 환경에 따른 차이를 줄일 수 있습니다.
‘프로세서’ 항목에 Intel이 표시되면 이 패키지를 선택하세요. 다운로드한 디스크 이미지를 열고 앱을 ‘응용 프로그램’으로 복사하세요.
복사가 끝나면 ‘응용 프로그램’에서 실행하세요. 마운트된 DMG에서 계속 실행하지 마세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 프로세서 | Apple M 시리즈는 arm64, Intel은 x64에 해당합니다. Apple 메뉴의 ‘이 Mac에 관하여’에서 확인하세요. |
| 운영체제 호환성 | 최소 운영체제 버전은 앱 요구 사항과 시스템에 표시되는 안내를 확인하세요. 아키텍처가 맞더라도 구형 시스템에서 실행된다는 보장은 없습니다. |
| 설치 위치 | 앱을 ‘응용 프로그램’으로 옮긴 다음 디스크 이미지를 꺼내세요. 개인 설정은 백업해 두세요. |
| 네트워크 권한 | 시스템 안내에 따라 프록시 또는 네트워크 관련 권한을 허용하세요. 일반 프록시 연결을 확인한 뒤 TUN에 필요한 추가 권한을 설정하세요. |
처음 열 때 개발자를 확인할 수 없다는 안내가 표시되면 다운로드 출처와 앱 이름을 먼저 확인한 다음 ‘시스템 설정 → 개인정보 보호 및 보안’에서 이번 차단을 해제할 수 있는지 살펴보세요. 해당 앱에 필요한 권한만 허용하고, 클라이언트 하나를 실행하려고 시스템 보안 기능 전체를 끄지 마세요. 앱이 손상되었다는 안내가 명확히 표시되면 무시하지 말고 다시 다운로드한 뒤 아키텍처를 확인하세요.
실행 후 메뉴 막대나 기본 창에서 시스템 프록시 상태를 먼저 확인하세요. 브라우저의 프록시 사용 여부는 시스템 프록시 설정과 브라우저 자체 옵션에 따라 달라집니다. 명령줄 프로그램은 프록시 환경 변수를 따로 설정해야 할 수도 있습니다. 한 번에 설정 하나만 바꾸면 앱 설치, 권한, 프록시 적용 중 어디에서 문제가 생겼는지 파악하기 쉽습니다. 자세한 절차는 macOS 설치 및 권한 안내를 확인하세요.
ANDROID / ARM64 · UNIVERSAL
v2rayNG를 우선 사용하고, V2Fly 설정이 필요한 경우에만 v2flyNG를 고려하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 기기에서 해당 아키텍처를 지원하는 운영체제를 실행해야 하며, 오래된 모델은 제조사 사양을 먼저 확인하세요.
기기 아키텍처를 모른다면 범용 버전을 시도해 보세요. 여러 아키텍처 구성 요소를 포함하지만 최소 운영체제 버전 등 설치 요구 사항을 우회하지는 못합니다.
Xray 설정이 필요한 Android 환경에 적합합니다. 가져온 뒤에도 전송 방식, TLS, 서버 설정을 확인하세요.
V2Fly 코어가 필요하고 휴대전화가 arm64인 것을 확인한 사용자에게 적합합니다. 평소 연결에 사용하기 전 설정 지원 범위를 확인하세요.
아키텍처를 확인하지 못한 기기용입니다. 범용 패키지는 여러 아키텍처를 지원할 뿐, 두 코어의 설정 필드가 자동으로 호환되게 하지는 않습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 패키지 형식 | APK 설치 파일입니다. 브라우저나 파일 관리자에 ‘알 수 없는 앱 설치’ 권한을 허용해야 할 수 있습니다. |
| CPU 아키텍처 | 일반적인 스마트폰은 arm64를 우선 선택하세요. 확인하기 어렵다면 기기 사양을 찾아보거나 범용 버전을 시도하세요. |
| 시스템 요구 사항 | 설치 프로그램의 호환성 안내를 따르세요. 범용 버전도 운영체제 버전, 서명, 기기 정책의 제한을 받습니다. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 요청을 허용하세요. 일반적으로 같은 VPN 채널을 사용하는 다른 앱과 동시에 연결할 수 없습니다. |
설치 권한은 앱을 다운로드한 출처별로 따로 부여합니다. 예를 들어 브라우저에서 APK를 다운로드한 뒤 파일 관리자에서 열면 파일 관리자에 설치 권한을 요청할 수 있습니다. 설치를 마친 후에는 더 이상 필요하지 않은 출처의 권한을 해제해도 됩니다. 패키지를 분석할 수 없다는 오류가 표시되면 구독을 바꾸기 전에 다운로드가 완료됐는지와 운영체제 버전이 요구 사항을 충족하는지 확인한 다음 아키텍처 선택을 점검하세요.
v2rayNG와 v2flyNG는 별개의 앱이며, 하나의 설치 파일에서 기능을 간소화하거나 확장한 버전이 아닙니다. 코어 계열이 다르므로 특정 프로토콜과 전송 기능의 지원 범위도 달라집니다. 대체 클라이언트를 시험할 때는 기존 연결을 끊고 각 앱에서 설정을 따로 가져와 확인하세요. 시스템 VPN 채널을 서로 차지하지 않도록 주의하세요. 연결이 정상이라면 화면이 잠긴 뒤 앱이 중지되지 않도록 백그라운드 배터리 설정도 확인하세요.
LINUX / DEB · RPM
배포판의 패키지 형식을 확인한 다음 x64 또는 arm64를 선택하세요.
Debian, Ubuntu 및 파생 배포판은 보통 이 형식을 사용합니다. 파일을 두 번 클릭해 시스템 소프트웨어 설치 프로그램으로 종속성을 처리하고 설치하세요.
arm64 기기: deb 다운로드 →Fedora, openSUSE 등 RPM 패키지 관리 체계를 사용하는 배포판에서는 이 패키지를 확인하고 종속성이 현재 환경과 맞는지 살펴보세요.
arm64 기기: rpm 다운로드 →amd64와 x86_64는 모두 x64 아키텍처를 뜻하고, aarch64는 arm64에 해당합니다. 파일 확장자만으로 호환성을 판단할 수는 없습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 Linux 데스크톱 세션이 필요합니다. 여기서 제공하는 것은 그래픽 클라이언트이며 서버 백그라운드 서비스용 설치 패키지가 아닙니다. |
| 패키지 관리 체계 | 배포판에서 제공하는 소프트웨어 설치 프로그램을 사용하세요. deb와 rpm은 확장자를 바꾸거나 강제로 변환해 함께 설치할 수 없습니다. |
| CPU 아키텍처 | 시스템에 x86_64가 표시되면 x64, aarch64가 표시되면 arm64를 선택하세요. 시스템 아키텍처와 프로세서가 일치하는지 확인하세요. |
| 종속성 및 권한 | 종속성은 패키지 관리자의 안내에 따라 설치하세요. 앱 설치에 필요한 권한과 TUN 실행에 필요한 권한은 별도로 처리해야 합니다. |
RPM을 사용하는 배포판끼리도 시스템 라이브러리 버전, 데스크톱 구성 요소, 패키지 종속성이 달라 호환성 문제가 발생할 수 있습니다. 종속성을 충족할 수 없다는 오류가 나오면 설치 프로그램의 전체 오류 내용을 보관하고 배포판 버전과 아키텍처를 확인한 뒤 해결하세요. 종속성을 무시하고 강제로 설치하거나 다른 배포판의 시스템 라이브러리를 복사하지 마세요.
설치 후 앱 메뉴에서 v2rayN을 실행하고 로컬 수신과 일반 프록시로 설정을 먼저 확인하세요. Linux 데스크톱의 시스템 프록시는 해당 설정을 따르는 앱에만 적용되며, 터미널 도구에는 자동으로 적용되지 않을 수 있습니다. TUN은 가상 네트워크 인터페이스, 라우팅, 권한과 관련되므로 일반 프록시 연결을 확인한 뒤 별도로 설정하는 것이 좋습니다. 설정 필드의 의미는 V2Ray 설정 파일 참고 자료에서 확인하세요.
다운로드 전에는 운영체제 이름, 시스템 아키텍처, 기존 설정 보존 여부만 확인하면 됩니다. 설치 파일 이름으로 플랫폼과 아키텍처를 구분할 수 있지만, 연결 가능 여부는 클라이언트가 지원하는 설정과 서버 측 매개변수에 달려 있습니다. 프로토콜 이름만 보고 운영체제용 설치 파일을 바꾸지 마세요. 현재 설정에 필요한 코어 기능을 파악한 다음 맞는 클라이언트를 선택하세요.
설치가 끝나도 바로 연결할 수 있는 것은 아닙니다. 이 페이지에서는 프로그램을 제공하며, 구독 주소와 공유 링크 또는 설정 파일은 직접 확보하고 사용 권한을 확인해야 합니다. 구독에 접속 정보가 포함될 수 있으니 전체 주소가 보이는 화면을 공개하거나 포럼 게시물, 문제 해결 로그에 올리지 마세요.
현재 로컬 수신 포트, 라우팅 모드, DNS 설정과 시스템 프록시 또는 TUN 사용 여부를 먼저 기록하세요. 클라이언트의 기능을 이용해 설정을 내보내거나, 종료한 뒤 실제로 사용하는 데이터 폴더를 백업하세요. 운영체제와 인터페이스 버전에 따라 데이터 위치가 다를 수 있으므로 모든 플랫폼에서 설정이 설치 폴더에 있다고 가정하지 마세요. 백업을 저장한 뒤 기존 프로그램과 트레이 프로세스를 종료해 업그레이드 중 파일이 사용되지 않도록 하세요.
업그레이드 후 처음 실행하면 구독 그룹과 사용자 지정 규칙이 남아 있는지 확인한 다음 수신 포트를 점검하세요. 목록이 비어 있더라도 백업을 바로 덮어쓰지 말고 다른 설치본을 실행했는지, 계정을 바꿨는지, 데이터 폴더가 달라졌는지 먼저 확인하세요. 설정을 복원할 때도 현재 파일의 복사본을 보관하면 형식이 맞지 않을 때 기존 설정으로 되돌릴 수 있습니다.
브라우저는 접속되는데 다른 프로그램은 연결되지 않는다면 노드를 바꾸기 전에 해당 프로그램이 시스템 프록시를 사용하는지 확인하세요. 반대로 명령줄 테스트가 성공해도 브라우저가 같은 프록시 설정을 사용한다는 뜻은 아닙니다. 처음 문제를 해결할 때는 서버 하나, 앱 하나, 프록시 모드 하나만 정해 두고 설정을 하나씩 변경하세요. 여러 연결 제어 기능을 동시에 켜는 것보다 원인을 쉽게 찾을 수 있습니다.
설치 및 구독 가져오기 전체 안내 보기 →