v2rayN
Windows x64 · ZIP 설치 파일
Desktop은 최신 크로스 플랫폼 인터페이스를 사용하는 데스크톱판이고, WPF는 기존 인터페이스를 유지하는 안정판입니다. 처음 설치한다면 Desktop으로 시작하세요. 업그레이드 후에도 익숙한 인터페이스를 계속 사용하고 싶다면 WPF를 선택하면 됩니다.
운영체제를 먼저 선택한 다음 CPU 아키텍처와 설치 파일 형식에 맞춰 다운로드하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 권장합니다.
다른 기기에 설치할 파일을 받는 경우 해당 기기의 시스템 정보를 기준으로 선택하세요.
Windows x64 · ZIP 설치 파일
Desktop은 최신 크로스 플랫폼 인터페이스를 사용하는 데스크톱판이고, WPF는 기존 인터페이스를 유지하는 안정판입니다. 처음 설치한다면 Desktop으로 시작하세요. 업그레이드 후에도 익숙한 인터페이스를 계속 사용하고 싶다면 WPF를 선택하면 됩니다.
| 확인 항목 | 시스템 요구 사항 및 선택 기준 |
|---|---|
| 시스템 및 아키텍처 | Windows 10/11 x64용입니다. 「설정 → 시스템 → 정보」에서 시스템 종류를 확인해 x64 기반 프로세서인지 확인하세요. |
| 파일 형식 | ZIP 파일을 완전히 압축 해제한 다음 압축 해제된 폴더에서 설치 프로그램을 실행하세요. |
| 실행 조건 | 설치 프로그램에서 실행 구성 요소가 없다고 알리면 안내에 따라 필요한 버전과 아키텍처를 확인하세요. |
회사나 기관에서 관리하는 PC라면 먼저 관리자에게 설치 권한을 확인하세요. 일반 설치와 이후 TUN 활성화는 별개이므로 다운로드하거나 구독을 가져오기 위해 미리 권한을 높일 필요는 없습니다.
macOS 데스크톱판 · DMG
Apple 메뉴에서 「이 Mac에 관하여」를 여세요. 칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon판을, 프로세서 항목에 Intel이 표시되면 Intel판을 사용하세요. 두 패키지는 서로 다른 칩에 맞는 것이므로 모두 다운로드할 필요는 없습니다.
| 확인 항목 | 시스템 요구 사항 및 선택 기준 |
|---|---|
| 아키텍처 | Apple 칩은 arm64, Intel 프로세서는 x64에 해당합니다. |
| 시스템 버전 | 「이 Mac에 관하여」에서 버전을 확인하세요. 시스템에서 앱에 더 높은 버전이 필요하다고 안내한다면 아키텍처를 바꿔도 해결되지 않습니다. |
| 설치 위치 | DMG를 열고 앱을 「응용 프로그램」으로 드래그한 다음 해당 폴더에서 실행하세요. |
복사가 끝나면 디스크 이미지를 추출해도 됩니다. 실행되지 않는다면 칩 아키텍처 불일치, 시스템 버전 부족, 권한 안내 중 무엇이 원인인지 먼저 구분하세요. 모든 팝업을 같은 문제로 취급하지 마세요.
Xray 코어 · APK
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 고려할 수 있습니다. 최종적으로는 시스템이 arm64-v8a를 지원하는지 확인하세요. 일부 기기는 64비트 프로세서를 탑재했어도 32비트 시스템을 실행하므로, 이런 경우에는 범용판을 선택해야 합니다.
v2fly 코어 · APK
v2fly 코어에 맞는 설정을 이미 사용 중이라면 이 클라이언트를 선택할 수 있습니다. 두 Android 앱은 서로의 업그레이드 패키지가 아닙니다. 전환하기 전에 구독의 프로토콜과 전송 설정을 새 클라이언트에서 인식할 수 있는지 확인하세요.
| 확인 항목 | 시스템 요구 사항 및 선택 기준 |
|---|---|
| 아키텍처 | 시스템이 arm64-v8a를 지원하면 arm64를 선택하고, 확인하기 어렵다면 범용판을 선택하세요. |
| 시스템 버전 | 「설정 → 휴대전화 정보」에서 Android 버전을 확인하세요. 설치 프로그램에서 시스템 버전이 너무 낮다고 안내하는 경우 같은 버전의 설치 파일에서 아키텍처만 바꿔도 해결되지 않습니다. |
| 설치 권한 | APK를 여는 브라우저나 파일 관리자에 별도로 권한을 허용해야 할 수 있습니다. 출처를 확인한 뒤 허용 여부를 결정하고, 설치가 끝나면 권한을 취소할 수 있습니다. |
Linux 데스크톱판 · deb / rpm
먼저 배포판에 맞는 패키지 형식을 고른 다음 현재 시스템의 아키텍처에 맞는 파일을 선택하세요. rpm 파일명의 el10은 빌드 대상이며, rpm을 사용하는 모든 배포판에 필요한 의존성이 있다는 뜻은 아닙니다.
| 확인 항목 | 시스템 요구 사항 및 선택 기준 |
|---|---|
| 패키지 형식 | Debian 및 Ubuntu 계열은 보통 deb를 사용합니다. rpm 기반 시스템에서는 배포판과 패키지의 빌드 대상을 별도로 확인하세요. |
| 아키텍처 | 터미널에서 uname -m을 실행하세요. x86_64는 x64, aarch64는 arm64에 해당합니다. |
| 데스크톱 환경 | 이 페이지에서 제공하는 것은 그래픽 클라이언트입니다. 데스크톱 앱을 실행할 수 있어야 하며, 필요한 의존성은 시스템 패키지 관리자가 충족해야 합니다. |
패키지 관리자에서 의존성 버전이 맞지 않는다고 알리면 의존성 이름과 배포판 버전을 기록하세요. 의존성 검사를 강제로 무시하거나 파일 확장자만 바꿔 패키지 형식을 전환하지 마세요.
같은 클라이언트 이름으로 여러 패키지가 제공된다고 해서 서로 바꿔 쓸 수 있는 것은 아닙니다. 시스템에 따라 열 수 있는 설치 파일 형식이 달라지고, 아키텍처에 따라 대상 기기에서 프로그램을 실행할 수 있는지가 결정됩니다. 배포판과 의존성은 패키지 관리자가 설치를 완료할 수 있는지를 좌우합니다. 예를 들어 x64와 arm64 모두 시스템 설정에서 「64비트」로 표시될 수 있으므로 비트 수만 확인해서는 부족합니다. Linux에서 파일명의 amd64와 x86_64는 같은 계열의 아키텍처를 뜻하며, 특정 프로세서 브랜드로 제한된다는 뜻은 아닙니다.
가상 머신에 설치할 때는 호스트가 아니라 가상 머신에 표시된 시스템과 아키텍처를 확인하세요. 기존 PC에서 새 PC로 옮길 때도 마찬가지입니다. 기존 PC에서 실행되던 설치 파일이 새 PC에 맞지 않을 수 있지만, 구독 주소는 새 클라이언트에서 다시 가져올 수 있는 경우가 많습니다. 설치 프로그램에서 시스템 버전이나 의존성이 맞지 않는다고 명확히 안내하면 같은 패키지를 반복해서 다운로드해도 해결되지 않습니다. 먼저 안내 문구를 그대로 기록한 뒤 시스템을 업그레이드할지, 호환되는 패키지를 사용할지 결정하세요.
현재 클라이언트에서 구독 그룹 이름, 활성 서버, 라우팅 모드를 기록하세요. 사용자 지정 DNS를 사용하거나 로컬 수신 포트를 변경했다면 이 내용도 함께 적어 두세요. 클라이언트에 내보내기 기능이 있다면 내보낸 파일을 앱 디렉터리 밖에 저장하세요. 앱을 삭제하면서 데이터가 함께 제거되더라도 백업을 보관할 수 있습니다. 구독 주소에는 액세스 정보가 포함될 수 있으므로 안전한 위치에 보관하고, 문제를 해결할 때 전체 링크를 공개 게시물이나 스크린샷에 올리지 마세요.
구독을 다시 추가하면 서버가 제공하는 목록은 다시 가져올 수 있는 경우가 많지만, 직접 추가한 서버나 이전에 선택한 라우팅 모드, 로컬 덮어쓰기 항목까지 복구된다고 보장할 수는 없습니다. 각각 따로 백업하세요. 구독은 출처를 기록하고, 수동 설정은 내보낸 파일이나 다시 구성할 수 있는 설정 기록으로 보관하면 됩니다. 다른 클라이언트로 바꿀 때는 호환되는 구독을 먼저 가져온 뒤 해당 앱 전용 옵션을 다시 설정하세요. 앱 데이터 디렉터리 전체를 다른 앱에 그대로 복사하는 것은 권장하지 않습니다.
처음 실행한 뒤 기본 창이 열리는지 확인하고 서버 목록과 구독 그룹이 예상한 대로 표시되는지 살펴보세요. 새로 설치한 앱에서 목록이 비어 있는 것은 정상입니다. 기존 설정이 있는데 항목이 보이지 않으면 목록 필터를 해제하고 현재 그룹과 실행 중인 클라이언트가 맞는지 확인하세요. 설치가 완료되어도 구독이 업데이트된 것은 아니며 시스템 프록시가 적용된 것도 아닙니다. 단계를 나눠 진행하면 문제 발생 지점을 더 쉽게 찾을 수 있습니다.
데스크톱에서 버전을 전환할 때는 기존 창을 닫은 뒤 시스템 트레이에 남은 프로세스도 종료됐는지 확인하세요. 두 클라이언트가 동시에 실행되면 같은 포트를 사용하려 하거나 시스템 프록시 설정을 차례로 변경할 수 있습니다. 휴대전화에서 처음 연결할 때 VPN 연결 요청이 표시되면 알림에 나온 앱 이름을 확인하세요. 기존 클라이언트가 연결 중이라면 먼저 연결을 끊고 새 클라이언트로 전환해 확인하세요. 기본 연결이 정상적으로 작동한 다음 라우팅, DNS, TUN을 조정하면 됩니다.
패키지 선택, 설치, 설정 중 어느 단계에서 문제가 발생했는지 먼저 확인한 뒤 해당 안내에 따라 해결하세요.
아니요. 처음 설치한다면 Desktop판을 선택하면 됩니다. 기존 WPF 인터페이스에 익숙하다면 클래식판을 계속 사용해도 됩니다. 전환하기 전에 설정을 저장하고, 테스트할 때는 기존 클라이언트를 종료하세요. 두 프로그램이 로컬 포트를 함께 사용하거나 시스템 프록시 설정을 중복으로 변경할 수 있습니다.
arm64 패키지는 arm64-v8a를 지원하는 시스템에 적합합니다. 범용 패키지는 앱 빌드에 포함된 여러 아키텍처를 지원하므로 대체로 용량이 더 큽니다. 기기의 아키텍처를 모르겠다면 범용 패키지를 선택하세요. 범용 패키지로도 낮은 시스템 버전이나 서명 충돌 문제는 해결되지 않습니다.
카드에 표시된 버전 번호는 릴리스 목록의 버전 항목이며, 패키지 이름과 동시에 갱신되지 않을 수 있습니다. 앱 이름, 플랫폼, 아키텍처를 먼저 확인하세요. 다운로드한 패키지가 예상한 버전과 다르면 기존 설치를 덮어쓰지 말고 목록이 갱신된 뒤 다시 확인하세요.
같은 앱을 정상적으로 덮어 설치하면 대체로 앱 데이터가 유지되지만, 삭제 후 재설치하거나 다른 클라이언트로 바꾸거나 설정 디렉터리를 변경하면 유지된다고 장담할 수 없습니다. 업데이트 전에 내보낼 수 있는 설정을 백업하고 구독 그룹과 라우팅 설정도 따로 기록하세요. 설치 후에는 연결을 시작하기 전에 목록을 확인하세요.
v2rayN에서는 「구독 그룹」에서 구독을 추가하고 업데이트합니다. v2rayNG에서는 사이드바의 구독 그룹 설정으로 이동한 다음 목록으로 돌아와 구독을 업데이트하세요. 클라이언트를 다운로드해도 구독이 제공되는 것은 아닙니다. 구독 주소는 서비스 제공업체나 관리자에게 문의하세요.