운영체제를 선택한 다음 CPU 아키텍처와 설치 형식을 고르세요.
데스크톱에서는 v2rayN을 사용하세요. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 선택하고, V2Fly 코어가 필요하면 v2flyNG를 선택하세요. 세 클라이언트 모두 무료 오픈 소스 소프트웨어이며, 설치 후 유효한 구독 또는 노드 설정을 가져와야 합니다.
설치 파일은 프로그램을 제공하고, 구독은 연결 설정을 제공합니다.
다운로드 전에 기기 정보를 확인하세요. 설치 후 구독 그룹을 추가하고 노드 목록을 업데이트한 다음 라우팅과 프록시 모드를 설정합니다. 구독 URL을 다운로드 버튼에 입력하거나 설치 파일 URL을 노드 가져오기에 사용하지 마세요. 클라이언트 버전과 코어 기능, 노드 설정이 서로 호환되어야 합니다.
사용 중인 기기를 선택하고 해당 클라이언트와 시스템 요구 사항을 확인하세요.
설치 파일 링크는 최신 릴리스 목록을 참조합니다. 페이지의 버전 정보는 클라이언트를 식별하기 위한 것이며 실제 파일 이름은 다운로드 링크에서 확인하세요.
Desktop은 차세대 크로스 플랫폼 UI로, 처음 설치하거나 데스크톱 환경을 일관되게 사용하고 싶은 경우에 적합합니다. WPF는 익숙한 Windows 창 방식을 유지하는 클래식 버전입니다. 선호하는 UI를 기준으로 선택하세요. 같은 구독을 가져오기 위해 두 버전을 모두 설치할 필요는 없습니다.
차세대 크로스 플랫폼 UI입니다. 처음 사용하는 경우 이 버전으로 시작해 보세요. ZIP 파일을 다운로드한 뒤 압축을 완전히 풀고 설치 프로그램을 실행하세요.
클래식 Windows UI입니다. 기존 사용 방식에 익숙한 경우 적합합니다. 이전 버전에서 옮긴다면 먼저 구독 그룹과 사용자 지정 규칙을 백업하세요.
| 확인 항목 | 선택 기준 | 확인 위치 또는 조치 방법 |
|---|---|---|
| 프로세서 및 시스템 | 이 페이지의 두 다운로드 항목은 모두 x64 패키지입니다 | 설정 → 시스템 → 정보에서 시스템 종류를 확인하세요. 다른 아키텍처라면 이 페이지의 x64 패키지를 사용하지 마세요. |
| 시스템 버전 | 보안 업데이트를 계속 제공하는 Windows 10 또는 11 환경에서 사용하는 것을 권장합니다 | 최소 요구 사항은 최신 릴리스 노트와 설치 프로그램의 검사 결과를 기준으로 확인하세요. 구형 시스템에는 필요한 인터페이스가 없을 수 있습니다. |
| 런타임 종속성 | 필요한 런타임 환경이 패키지에 포함되어 있는지에 따라 달라집니다 | .NET 데스크톱 런타임이 없다는 안내가 표시되면 오류 메시지에 맞는 주 버전과 x64 아키텍처를 설치하세요 |
| 파일 쓰기 및 권한 | 설정 디렉터리에 쓰기 권한이 있어야 합니다. 일반적인 연결에는 기본 권한을 사용하세요. | TUN 또는 서비스 기능에는 추가 권한이 필요할 수 있습니다. 시작 문제를 모두 권한 부족 탓으로 돌리지 마세요. |
다운로드가 끝나면 파일 탐색기에서 저장 폴더를 열고 ‘모두 압축 풀기’를 선택하세요. 압축 파일 내부에서 바로 프로그램을 실행하지 마세요. 설치 프로그램을 실행할 때 설치 위치를 확인하세요. 이전 버전으로 되돌릴 수 있도록 유지하려면 두 버전의 설정 디렉터리를 함께 사용하지 않도록 주의하세요. 설치가 끝나면 먼저 메인 창을 열어 설정을 정상적으로 읽는지 확인한 뒤 구독을 가져오세요.
실행 직후 종료된다면 먼저 시스템 안내와 클라이언트 로그를 확인하세요. 런타임 누락, 설정 파일 읽기 실패, 디렉터리 쓰기 차단은 서로 다른 문제이므로 해결 방법도 다릅니다. Windows의 시스템 프록시와 TUN은 별개의 기능입니다. 처음 연결할 때는 시스템 프록시로 노드를 확인한 뒤, 앱별 트래픽 처리 범위를 고려해 TUN 사용 여부를 결정하세요.
Apple 메뉴 → 이 Mac에 관하여를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple M 시리즈가 표시되면 Apple Silicon을, Intel이 표시되면 Intel을 선택합니다. macOS 버전이나 기기 구매 연도만으로 칩 아키텍처를 판단할 수 없습니다.
Apple M 시리즈 칩용입니다. 아키텍처 변환으로 인한 문제 변수를 줄이려면 기기의 기본 아키텍처에 맞는 설치 파일을 선택하세요.
Intel 프로세서가 탑재된 Mac용입니다. 파일 이름의 64는 이 항목이 x64 아키텍처라는 뜻이며 arm64 패키지를 대신할 수 있다는 의미는 아닙니다.
| 확인 항목 | 선택 기준 | 확인 위치 또는 조치 방법 |
|---|---|---|
| CPU 아키텍처 | Apple Silicon은 arm64, Intel은 x64를 선택하세요 | Apple 메뉴 → 이 Mac에 관하여 → 칩 또는 프로세서 |
| 시스템 환경 | 현재 릴리스 패키지의 최소 macOS 요구 사항을 충족해야 합니다 | 이 Mac에 관하여에서 시스템 버전을 확인하세요. 오래된 시스템은 UI 또는 네트워크 구성 요소에 필요한 기능을 지원하지 않을 수 있습니다. |
| 설치 위치 | 앱을 응용 프로그램 폴더로 복사하세요 | 복사가 끝난 뒤 실행하세요. 읽기 전용 디스크 이미지에서 계속 실행하지 마세요. |
| 시스템 권한 | 선택한 네트워크 모드에 필요한 권한을 허용하세요 | 최초 실행 권한과 네트워크 구성 요소 권한은 별도로 처리하세요. 시스템 설정의 ‘개인정보 보호 및 보안’ 안내를 확인하세요. |
다운로드한 DMG를 열고 이미지 창의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 복사하세요. 그런 다음 해당 폴더에서 실행합니다. 앱이 디스크 이미지에서 실행되지 않는 것을 확인한 뒤 이미지 연결을 해제할 수 있습니다. 시스템에서 실행을 차단하면 다운로드 출처와 아키텍처를 먼저 확인하고 ‘개인정보 보호 및 보안’의 구체적인 안내를 읽으세요. 앱 하나를 실행하기 위해 시스템 보안 기능 전체를 끄지 마세요.
데스크톱 클라이언트의 시스템 프록시 설정은 해당 설정을 따르는 앱에 영향을 줍니다. 모든 프로그램이 같은 연결 경로를 사용하는 것은 아닙니다. 구독을 가져온 뒤 노드를 선택하고 기본 라우팅 또는 설정을 이해하는 모드로 테스트하세요. 특정 앱이 계속 직접 연결된다면 설치 파일을 바꾸기보다 앱의 프록시 지원 여부와 자체 설정을 확인하세요.
Xray 코어를 사용하며 GUI에서 구독, 공유 링크, QR 코드를 가져올 수 있습니다. Xray 노드 기능이 필요한 경우 v2rayNG를 우선 선택하세요. VLESS, REALITY 등의 설정 사용 가능 여부는 현재 클라이언트 코어와 서버 설정의 호환성에 따라 달라집니다.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 사용합니다. 프로세서 사양만 보지 말고 시스템이 64비트 앱을 지원하는지도 확인하세요.
기기 아키텍처를 확인하기 어려울 때 선택할 수 있습니다. 단일 아키텍처 패키지보다 용량이 큰 편이며, 시스템 버전과 앱 설치 조건을 충족해야 합니다.
V2Fly 코어 환경이 필요한 경우 이 클라이언트를 선택하세요. v2rayNG와의 핵심 차이는 코어 계열이며 설치 파일 확장자가 아닙니다. UI가 비슷하다고 해서 두 클라이언트가 같은 프로토콜 필드와 보안 옵션을 지원한다고 가정하지 마세요.
아키텍처를 확인하기 어려울 때 선택할 수 있습니다. 설치 후 구독을 직접 추가하고 노드의 전송 및 보안 설정도 확인해야 합니다.
| 확인 항목 | 선택 기준 | 확인 위치 또는 조치 방법 |
|---|---|---|
| 앱 아키텍처 | 64비트 시스템이면 arm64를 우선 선택하고, 불분명하면 범용 버전을 선택하세요 | 기기 시스템 정보를 확인하세요. 최신 프로세서라도 시스템이 일부 아키텍처만 지원할 수 있습니다. |
| 시스템 버전 | 현재 APK에 명시된 최소 Android 버전을 충족해야 합니다 | 설정 → 휴대전화 정보에서 확인하세요. 설치 프로그램에 호환되지 않는다는 안내가 표시되면 먼저 버전 요구 사항을 확인하세요. |
| 설치 권한 | 현재 사용 중인 브라우저 또는 파일 관리자의 앱 설치를 허용하세요 | 실제로 사용하는 출처에만 권한을 허용하고, 설치가 끝나면 필요에 따라 해제할 수 있습니다 |
| 연결 권한 | 첫 연결 시 시스템 VPN 권한 요청을 확인하세요 | 다른 VPN 앱이 같은 인터페이스를 사용 중일 수 있으므로 테스트 전에 현재 연결을 확인하세요 |
다운로드한 APK를 알림 창이나 파일 관리자에서 열고 설치 프로그램에 표시되는 앱 이름과 업데이트 안내를 확인하세요. 서명 충돌 메시지가 표시되면 바로 삭제 후 재설치하지 마세요. 기존 설정을 내보내고 다른 서명 경로에서 받은 앱인지 확인한 다음 이전 방법을 결정하세요. 앱을 삭제하면 일반적으로 로컬 데이터도 함께 삭제됩니다.
처음 연결을 누르면 시스템에 VPN 연결 요청이 표시됩니다. 이 권한을 허용하면 클라이언트가 기기의 트래픽을 처리할 수 있지만, 노드가 실제로 작동한다는 뜻은 아닙니다. 연결된 뒤 실제 접속을 확인하세요. 백그라운드로 전환할 때 자주 끊긴다면 절전 정책, 백그라운드 실행 제한, 네트워크 전환 상태를 확인하세요. 처음부터 모든 배터리 관리 기능을 끄지는 마세요.
배포판에서 deb와 rpm 중 어떤 형식을 사용하는지 확인한 다음 x64 또는 arm64를 선택하세요. 아래의 기본 다운로드 항목은 x64용입니다. arm64 기기는 카드 하단의 해당 형식 링크를 사용하세요. 패키지 관리 방식과 CPU 아키텍처는 별개의 조건이므로 둘 다 맞춰야 합니다.
deb 패키지 관리 방식을 사용하는 배포판용입니다. 파일 이름의 amd64는 x64 아키텍처를 가리키며 특정 프로세서 브랜드만을 뜻하지 않습니다.
rpm 패키지 관리 방식을 사용하고 종속성이 호환되는 배포판용입니다. 패키지 이름에 빌드 대상이 표시되어 있으므로 설치 전에 종속성 안내를 확인하세요.
| 확인 항목 | 선택 기준 | 확인 위치 또는 조치 방법 |
|---|---|---|
| 패키지 관리 방식 | Debian 및 Ubuntu 계열은 보통 deb, Fedora 및 RHEL 계열은 보통 rpm을 선택합니다 | 파생 배포판에서도 사용 중인 설치 프로그램이 해당 패키지 형식을 지원하는지 확인하세요 |
| CPU 아키텍처 | x86_64 / amd64는 x64, aarch64는 arm64를 선택하세요 | 시스템 설정의 정보 페이지나 하드웨어 정보를 확인하세요. 배포판 이름만으로 판단하지 마세요. |
| 데스크톱 환경 및 종속성 | 그래픽 데스크톱이 설치되어 있고 현재 패키지의 런타임 종속성을 충족해야 합니다 | 먼저 소프트웨어 설치 프로그램에서 종속성을 확인하세요. 누락되거나 충돌하는 항목을 무시하도록 강제하지 마세요. |
| 네트워크 권한 | 시스템 프록시와 TUN은 권한 요구 사항이 다릅니다 | 일반 모드에서 먼저 연결을 확인하세요. TUN이 필요하면 클라이언트 안내에 따라 권한을 처리하세요. |
파일 관리자에서 다운로드한 설치 파일을 열고 배포판의 소프트웨어 설치 프로그램으로 설치하세요. 종속성이 부족하다는 안내가 표시되면 배포판 버전과 소프트웨어 저장소 상태를 먼저 확인하세요. rpm의 이름을 deb로 바꾸거나 강제 설치로 오류를 우회하지 마세요. 파일 확장자를 바꿔도 패키지 형식이 변환되거나 필요한 시스템 구성 요소가 추가되지는 않습니다.
설치가 끝나면 앱 메뉴에서 v2rayN을 실행하세요. Linux 데스크톱 환경마다 시스템 프록시를 읽는 방식이 다르므로 브라우저, 데스크톱 앱, 백그라운드 프로세스가 같은 설정을 따르지 않을 수 있습니다. 먼저 시스템 프록시를 명시적으로 지원하는 앱으로 테스트하고, 이후 앱별 프록시 설정을 조정하세요. 더 많은 트래픽을 처리해야 하는 경우에만 TUN 모드를 검토하세요.
먼저 프로그램이 실행되는지 확인한 다음 구독, 라우팅, 연결을 차례로 설정하세요.
v2rayN에서 ‘구독 그룹 설정’을 열고 그룹을 추가한 다음 비고와 ‘선택 주소 (URL)’를 입력하세요. 저장 후 구독 업데이트를 실행합니다. 그룹 이름은 로컬 분류에만 사용되며 서버 계정에는 영향을 주지 않습니다. 구독 URL의 매개변수는 그대로 유지하세요. 쿼리 매개변수를 삭제하면 업데이트에 실패할 수 있습니다.
v2rayNG에서 구독 그룹 설정을 열어 주소를 추가한 뒤 구독을 업데이트하세요. 단일 공유 링크를 받은 경우에는 해당 가져오기 기능을 사용하고 구독 주소로 취급하지 마세요. 노드 목록에 표시된다는 것은 설정을 불러왔다는 뜻일 뿐, 연결 가능 여부는 별도로 테스트해야 합니다.
구독 가져오기 방법 보기노드를 선택한 뒤 동작을 이해할 수 있는 라우팅 설정으로 먼저 테스트하세요. 시스템 프록시는 시스템 설정을 따르는 앱에 주로 적용됩니다. TUN은 더 많은 트래픽을 처리하지만 추가 권한과 라우팅, DNS 동작이 관련됩니다. 처음 설정할 때 코어, DNS, 규칙을 한꺼번에 바꾸지 마세요. 문제가 생겨도 원인을 찾기 어려워집니다.
연결한 뒤 클라이언트 로그를 확인하고 실제 접속을 테스트하세요. 지연 시간은 특정 방식으로 측정한 결과일 뿐 다운로드 속도나 모든 앱의 사용 가능 여부를 나타내지는 않습니다. 일부 주소에 문제가 있으면 노드, DNS, 분할 라우팅 규칙 중 어디에 원인이 있는지 먼저 확인한 뒤 해당 설정을 조정하세요.
분할 라우팅 설정 안내 보기설치 단계별로 문제를 확인하고 설정 오류와 설치 파일 문제를 구분하세요.
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop을 권장합니다. 기존의 클래식한 창 방식에 익숙하다면 WPF를 선택하세요. 두 버전 모두 x64 설치 파일이며, 구독과 노드 설정은 서버 구성에 맞춰 입력해야 합니다. UI를 바꾸기 전에는 설정을 백업하고, 두 버전이 동시에 시스템 프록시를 제어하지 않도록 하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 최종 선택은 시스템에서 지원하는 앱 아키텍처에 따라야 합니다. 기기가 64비트 시스템인지 확인한 뒤 arm64를 선택하세요. 아키텍처를 확인하기 어렵거나 설치 파일이 호환되지 않는다는 안내가 표시되면 범용 버전을 사용해 볼 수 있습니다. 범용 버전은 여러 아키텍처를 포함해 파일 크기가 더 큰 편입니다.
Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈 칩이면 Apple Silicon을, Intel 프로세서면 Intel을 선택합니다. macOS 버전이나 기기 외관, 구매 연도로 아키텍처를 추측하지 마세요.
배포판의 패키지 관리 방식에 맞춰 선택하세요. Debian, Ubuntu 및 관련 배포판은 보통 deb를, Fedora, RHEL 및 관련 배포판은 보통 rpm을 사용합니다. x64 또는 arm64 아키텍처도 맞춰야 합니다. 같은 패키지 형식이라도 모든 배포판 버전에서 실행에 필요한 종속성이 충족되는 것은 아닙니다.
클라이언트는 설정을 읽고 연결을 구성하지만, 설치 파일에는 개인 구독이나 노드가 포함되어 있지 않습니다. 유효한 구독 URL 또는 공유 링크를 준비해 구독 그룹 설정에 추가하고 업데이트한 뒤 노드를 선택하세요. 구독 URL에는 접속 인증 정보가 포함될 수 있으므로 공개 스크린샷이나 로그에 노출하지 마세요.
먼저 클라이언트의 백업 또는 내보내기 기능으로 설정을 보관하세요. 구독 그룹, 라우팅 모드, DNS 설정, 사용자 지정 규칙을 기록한 다음 기존 클라이언트를 종료합니다. 업데이트 후 설정을 정상적으로 읽는지 확인하고 구독 업데이트와 실제 연결을 테스트하세요. 백업에 민감한 설정이 포함될 수 있으므로 안전한 위치에 보관하세요.