CLIENT SHELF / 설치 파일 선택
운영체제를 선택한 다음 CPU 아키텍처를 확인하세요. 데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 우선 추천하며 v2flyNG도 선택할 수 있습니다.
세 클라이언트 모두 무료 오픈 소스 소프트웨어입니다. 설치 파일은 그래픽 인터페이스와 연결 기능을 제공하며, 구독 주소와 서버 정보, 라우팅 규칙은 별도로 준비해야 합니다. 아래 다운로드 링크는 플랫폼별로 구분되어 있어 설정 가져오기와 프로그램 다운로드를 한 단계로 혼동하지 않도록 구성했습니다.
WINDOWS / x64
Desktop과 WPF는 같은 클라이언트의 서로 다른 인터페이스 버전입니다. 둘 중 하나만 설치해 여러 인스턴스가 동시에 시스템 프록시를 변경하지 않도록 하세요.
Desktop 버전은 차세대 크로스 플랫폼 UI를 사용합니다. 클래식 WPF 버전은 Windows 데스크톱 인터페이스를 사용하며, 익숙한 조작 방식을 선호할 때 선택할 수 있는 안정적인 버전입니다.
두 링크 모두 ZIP 배포 파일입니다. 압축을 별도 폴더에 완전히 푼 뒤, 폴더 안의 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 처음 실행한 후 시스템 트레이에서 프로그램 상태를 확인해 클라이언트가 정상적으로 시작됐는지 확인한 다음 구독과 프록시 모드를 설정하세요.
Desktop과 WPF는 인터페이스와 메뉴 이름, 설정 저장 방식이 다를 수 있습니다. 기존 설정을 옮겨야 한다면 클라이언트에서 제공하는 백업 또는 내보내기 기능을 먼저 사용하세요. 다른 버전의 설정 폴더를 그대로 덮어쓰지 마세요. 시스템에서 실행 구성 요소가 없다는 안내가 표시되면 설치 파일의 안내에 따라 조치하고, 서버를 반복해서 바꾸지는 마세요.
| 확인 항목 | 요구 사항 및 조치 |
|---|---|
| CPU 아키텍처 | 이 페이지의 두 설치 파일은 모두 x64입니다. ‘설정 → 시스템 → 시스템 정보’에서 시스템 종류를 확인하고 아키텍처가 맞는지 먼저 확인하세요. |
| 시스템 및 종속성 | 최소 운영체제 버전, 실행 구성 요소 및 드라이버 요구 사항은 선택한 설치 파일의 설명과 설치 안내를 확인하세요. |
| 설치 위치 | 현재 계정에서 쓸 수 있는 별도 폴더를 선택하세요. 업그레이드하기 전에 기존 인스턴스를 종료하고 설정을 백업해 두세요. |
| 연결 모드 | 시스템 프록시와 TUN은 필요한 권한이 다릅니다. 먼저 시스템 프록시로 기본 연결을 확인한 다음 실제 필요에 따라 다른 모드를 사용하세요. |
다운로드 후 설정 가져오기는 v2rayN 사용 가이드 →에서 확인하세요.
MACOS / arm64 · x64
‘Apple 메뉴 → 이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon과 Intel에 맞는 DMG 설치 파일을 사용해야 합니다.
칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon용을, Intel 프로세서가 표시되면 Intel용을 선택하세요. 컴퓨터 외관이나 구입 연도가 아니라 칩에 맞춰 선택해야 합니다.
DMG를 연 뒤 앱을 ‘응용 프로그램’ 폴더로 드래그하고 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 클라이언트를 계속 실행하면 이미지 꺼내기, 업데이트, 권한 처리에 문제가 생길 수 있습니다. 앱을 옮기고 종료한 다음 설치 디스크 이미지를 꺼낼 수 있습니다.
처음 실행할 때 개발자를 확인할 수 없다는 안내가 표시되면 설치 파일의 출처와 형식을 확인한 뒤 시스템에서 안내하는 ‘개인정보 보호 및 보안’ 경로에 따라 처리하세요. 시스템 프록시 권한과 네트워크 확장 권한은 별개입니다. 현재 모드에 필요한 권한만 허용하세요. 업그레이드 후 연결에 문제가 생기면 기존 권한이 유지되는지 먼저 확인하세요.
| 확인 항목 | 요구 사항 및 조치 |
|---|---|
| Apple Silicon | ‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되면 arm64 DMG를 선택하세요. |
| Intel | ‘이 Mac에 관하여’에 Intel 프로세서가 표시되면 x64 DMG를 선택하세요. |
| 시스템 호환성 | 최소 macOS 버전은 현재 설치 파일의 안내를 확인하세요. 실행할 수 없다면 시스템에 표시된 오류 메시지를 그대로 기록해 두세요. |
| 권한 및 설치 위치 | 앱을 ‘응용 프로그램’ 폴더에 넣고, 처음 실행할 때 필요에 따라 시스템 프록시 및 네트워크 권한을 설정하세요. |
권한 설정 경로는 macOS 설치 및 권한 안내 →를 확인하세요.
ANDROID / arm64 · universal
먼저 사용할 코어 계열을 정한 다음 아키텍처를 선택하세요. 2015년 이후 출시된 일반적인 휴대전화는 arm64를 우선 선택하되, 설치 전에 시스템이 해당 아키텍처를 지원하는지 확인하세요.
Android에서 우선 추천하는 다운로드입니다. Xray 코어를 사용하며, 지원하는 프로토콜, 전송 방식 및 보안 설정은 패키지에 포함된 코어 버전과 클라이언트 인터페이스에 따라 달라집니다.
arm64 설치 파일은 기기가 해당 아키텍처를 지원할 때 사용할 수 있습니다. 기기의 아키텍처를 확인하기 어렵다면 여러 아키텍처를 포함한 범용 버전을 선택하세요. 범용 버전도 모든 운영체제 버전과 호환되는 것은 아닙니다. 설치 프로그램에서 패키지를 분석할 수 없다는 오류가 표시되면 먼저 다운로드가 완료됐는지 확인한 다음 시스템 호환성과 아키텍처를 살펴보세요. 파일 확장자를 바꿔 설치하려고 하지 마세요.
처음 연결을 시작하면 Android에서 VPN 연결 권한을 요청합니다. 이 권한은 로컬 네트워크 트래픽을 처리하는 통로를 만들기 위한 것이며 구독이 유효하다는 뜻은 아닙니다. 설정을 가져와 서버를 선택하고 연결한 뒤 로그와 실제 접속 결과를 확인하세요. 기기에 설치된 다른 VPN 앱이 현재 연결과 충돌할 수 있습니다.
v2fly 코어를 사용하는 대안 클라이언트입니다. 기존 설정이 V2Fly의 동작에 의존하거나 코어별 차이를 비교할 필요가 있을 때 선택하세요.
v2rayNG와 v2flyNG는 이름만 다른 동일한 설치 파일이 아닙니다. 설정에 사용하는 프로토콜, 전송 방식 및 보안 옵션을 각각 확인해야 하며, 구독을 가져올 수 있다고 해서 모든 항목이 지원되는 것은 아닙니다. REALITY 같은 기능을 사용하려면 먼저 해당 코어의 실제 지원 여부를 확인하세요.
클라이언트를 바꾸기 전에 기존 라우팅 모드, DNS 설정, 앱별 프록시 적용 범위를 기록하세요. 다른 클라이언트를 시험할 때는 기존 연결을 중지해 두 앱이 시스템 VPN 통로를 놓고 충돌하지 않도록 하세요. 두 앱의 설정은 서로 공유되지 않으므로 구독을 가져온 뒤 현재 선택된 설정을 다시 확인해야 합니다.
| 확인 항목 | 요구 사항 및 조치 |
|---|---|
| CPU 아키텍처 | 대부분의 경우 arm64를 우선 선택하세요. 기기의 지원 여부를 확인하기 어렵다면 범용 버전을 고려하고 설치 안내를 확인하세요. |
| 운영체제 버전 | 최소 운영체제 요구 사항은 해당 APK 안내를 확인하세요. 범용 버전도 운영체제 버전 제한을 우회하지는 않습니다. |
| 설치 출처 | APK를 설치할 때 시스템 안내에 따라 현재 브라우저나 파일 관리자의 앱 설치를 허용하세요. 설치가 끝나면 해당 권한을 다시 해제할 수 있습니다. |
| 백그라운드 실행 | 앱을 전환한 뒤 연결이 끊긴다면 클라이언트를 다시 설치하기 전에 배터리 최적화와 백그라운드 제한을 확인하세요. |
처음 사용한다면 v2rayNG 사용 가이드 →를 참고하세요.
LINUX / deb · rpm
먼저 배포판에서 사용하는 패키지 형식을 확인한 다음 시스템 아키텍처를 선택하세요. deb와 rpm은 기능이 다른 버전이 아니며 서로 대신 사용할 수 없습니다.
일반적인 x64 데스크톱 환경에서는 아래 기본 다운로드 중 하나를 선택하세요. Debian 계열 배포판은 보통 deb, RPM 계열 배포판은 rpm을 사용합니다. 구체적인 종속성 및 호환성은 패키지 관리자로 확인하세요.
패키지 이름의 amd64와 x86_64는 보통 x64에 해당하고, arm64와 aarch64는 ARM 64비트에 해당합니다. 기기 제조사만 보고 아키텍처를 추측하거나 패키지 이름을 바꿔 호환 대상을 변경하지 마세요. 그래픽 패키지 설치 프로그램에서 종속성, 아키텍처 또는 패키지 형식 오류가 표시되면 안내 내용을 먼저 확인하세요.
배포판의 소프트웨어 설치 도구로 해당 패키지를 열고 종속성 확인을 마친 뒤 설치하세요. 패키지 이름에 포함된 배포판 표시는 같은 형식의 모든 시스템에서 실행된다는 뜻이 아닙니다. 종속성을 충족할 수 없다면 시스템과 패키지의 호환성을 먼저 확인하세요. 종속성을 무시하도록 강제하거나 시스템 기본 라이브러리를 교체하지 마세요.
실행 후 데스크톱 환경에서 시스템 프록시 설정을 사용할 수 있는지 확인하세요. 일부 앱은 데스크톱의 프록시 설정을 읽지 않으므로 앱 안에서 주소와 포트를 직접 지정해야 할 수 있습니다. TUN 모드는 권한 및 라우팅 제어와 관련되므로 일반 프록시 연결을 먼저 확인한 뒤 현재 클라이언트의 지원 여부에 따라 사용하세요.
| 확인 항목 | 요구 사항 및 조치 |
|---|---|
| 패키지 형식 | 배포판에 맞게 deb 또는 rpm을 선택하고 해당 소프트웨어 설치 도구로 종속성을 처리하세요. |
| 시스템 아키텍처 | x64는 amd64 또는 x86_64 패키지를, ARM 64비트는 arm64 또는 aarch64 패키지를 사용하세요. |
| 데스크톱 및 종속성 | 그래픽 클라이언트 다운로드입니다. 데스크톱 실행 환경, 시스템 라이브러리 및 최소 시스템 요구 사항은 설치 파일의 안내를 확인하세요. |
| 권한 및 네트워크 | 먼저 일반 계정으로 실행해 기본 프록시 연결을 확인하세요. TUN 또는 시스템 라우팅을 사용할 때 필요한 권한을 허용하면 됩니다. |
설정 항목 설명은 V2Ray 설정 참고 →를 확인하세요.
INSTALL → IMPORT → CONNECT
설치 성공, 설정 읽기, 연결 성공은 각각 별도로 확인해야 합니다. 순서대로 진행하면 불필요한 재다운로드와 재설치를 줄일 수 있습니다.
처음 설치했다면 클라이언트가 정상적으로 열리는지, 로그에 코어 시작 오류가 있는지 먼저 확인하세요. 기존 클라이언트가 설치된 기기라면 로컬 포트 충돌을 막기 위해 이전 인스턴스를 먼저 종료해야 합니다. 설치 실패는 시스템이나 패키지 문제, 시작 실패는 클라이언트·설정·실행 환경 문제일 수 있습니다. 실제 접속에 실패할 때 노드, 라우팅, DNS를 확인하세요. 세 가지 상황을 구분해 기록하면 모든 설정을 무작정 바꾸는 것보다 원인을 찾기 쉽습니다.
클라이언트의 구독 관리 또는 가져오기 메뉴에 사용 권한이 있는 주소를 입력하고 저장한 뒤 업데이트를 실행하세요. 목록에서 사용할 설정을 선택합니다. 구독 주소에는 계정 정보가 포함될 수 있으므로 로그인 정보처럼 관리하고 공개 스크린샷이나 문의 내용에 붙여 넣지 마세요. 연결 정보를 직접 입력할 때는 프로토콜, 주소, 포트, 전송 방식, 보안 설정이 서버와 일치해야 합니다. 클라이언트는 설치 과정에서 이 정보를 자동으로 채우지 않습니다. 사용자 지정 규칙이 있다면 새 설정을 시험하기 전에 기존 설정을 복사해 두세요.
데스크톱에서는 시스템 프록시 모드부터 시작하고, Android에서는 시스템 안내에 따라 VPN 연결을 허용하세요. 연결한 뒤 실제로 사용할 앱으로 접속을 확인하면서 클라이언트 로그도 살펴보세요. 브라우저가 작동해도 모든 프로그램이 프록시를 사용하는 것은 아니며, 테스트 도구의 결과만으로 앱 접속을 판단할 수 없습니다. 도메인 이름을 확인할 수 없다면 DNS를, 직접 연결되거나 차단된다면 라우팅 순서를, 핸드셰이크 오류가 발생한다면 연결 정보와 시스템 시간을 확인하세요.
PACKAGE / UPDATE NOTES
업그레이드 전에 구독 그룹, 사용자 지정 라우팅, DNS 설정, 로컬 포트 정보를 백업하세요. 클라이언트에서 내보내기를 지원하면 먼저 사용하고, 구독 정보가 포함된 백업 파일은 안전하게 보관하세요. 새 버전이 정상적으로 작동하는지 확인하기 전에는 기존 설정을 삭제하지 마세요. 서로 다른 인터페이스 버전이 같은 설정 폴더를 함께 사용할 수 있다고 가정하지 마세요. 업그레이드 후 기존 설정이 불러와졌는지 확인하고 시스템 프록시와 네트워크 권한을 점검한 다음 연결을 테스트하세요.
카드의 버전 표시는 버전 목록의 배포 필드를 읽고, 설치 파일 링크는 플랫폼별로 따로 처리합니다. 업데이트 배포 중에는 표시된 버전과 파일 이름이 잠시 맞지 않을 수 있습니다. 다른 패키지를 찾으려고 URL이나 파일 이름을 직접 바꾸지 마세요. 실제 설치된 버전은 클라이언트의 ‘정보’ 또는 버전 정보에서 확인할 수 있습니다. 다운로드 문제를 기록할 때는 파일 이름과 오류 메시지만 남기고, 점검 자료를 공유하기 전에 구독 주소, 서버 로그인 정보, 개인 폴더 경로를 가리세요.
v2rayNG와 v2flyNG는 서로 다른 코어 계열을 사용하며, 데스크톱 클라이언트의 코어 선택도 필요한 기능을 기준으로 판단해야 합니다. 코어를 바꾸는 것이 모든 연결 문제의 해결책은 아닙니다. 특히 프로토콜 이름이 같다고 보안 설정과 전송 항목까지 모두 호환된다고 단정할 수 없습니다. 지원 항목을 비교하려면 먼저 Xray와 V2Fly 코어 차이를 읽고 클라이언트나 코어를 바꿀지 결정하세요.
클라이언트는 설정을 읽고 연결을 구성하지만, 설치 파일만으로 서버 설정이 제공되지는 않습니다. 설치 후 사용 권한이 있는 구독 주소나 연결 정보를 준비해 가져온 다음, 설정을 선택하고 현재 환경에 맞는 프록시 모드를 사용하세요. 구독 주소에는 로그인 정보가 포함될 수 있으니 공개하지 마세요.
먼저 시스템 정보에서 CPU 아키텍처를 확인한 뒤 설치 파일을 선택하세요. Apple Silicon Mac은 macOS arm64, Intel Mac은 x64를 사용합니다. Linux는 시스템 아키텍처에 따라 x64 또는 arm64를 선택하세요. 2015년 이후 출시된 일반적인 Android 휴대전화는 arm64를 우선 선택하되, 시스템 지원 여부를 확인해야 합니다. 아키텍처를 확인하기 어렵다면 범용 버전을 고려하세요.
보통 한 가지 버전만 선택하면 됩니다. Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF는 기존 방식의 안정적인 버전입니다. 인터페이스 버전을 바꾸기 전에 설정을 백업하고, 두 인스턴스가 동시에 시스템 프록시를 제어하거나 같은 로컬 포트를 사용하지 않도록 하세요. 인터페이스와 설정 저장 위치는 버전에 따라 다를 수 있습니다.
먼저 브라우저의 다운로드 기록에서 다운로드가 완료됐는지 확인한 다음, 파일 확장자와 운영체제가 맞는지 살펴보세요. Windows용 ZIP은 압축을 풀어야 하고, Android용 APK는 현재 설치 출처의 앱 설치를 허용해야 합니다. macOS용 DMG는 마운트한 뒤 앱을 응용 프로그램 폴더로 옮기세요. 그래도 문제가 해결되지 않으면 시스템에 표시된 오류 메시지를 기록하고 설치 안내에 따라 확인하세요.
클라이언트에서 지원하는 내보내기 또는 백업 기능으로 구독 그룹, 사용자 지정 라우팅, DNS 설정, 로컬 포트 정보를 보관하고 백업 파일을 안전하게 저장하세요. 기존 인스턴스를 종료한 뒤 업그레이드하고, 완료 후 기존 설정을 읽을 수 있는지 확인한 다음 시스템 프록시, 네트워크 권한, 구독 업데이트 상태를 점검하세요. 복구 방법을 확인하기 전에는 기존 설정 폴더를 삭제하지 마세요.
버전 표시는 버전 목록의 latest 필드에서 가져오고, 다운로드 링크는 해당 플랫폼의 download 필드에서 가져옵니다. 업데이트가 배포되는 동안 두 정보가 일시적으로 맞지 않을 수 있습니다. 파일 이름을 바꿔 다른 설치 파일을 추측하지 마세요. 설치 후 클라이언트의 정보 또는 버전 화면에서 실제 버전을 확인하고 해당 패키지 안내에 따라 업데이트 여부를 결정하세요.