데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요.
운영체제와 아키텍처를 확인한 뒤 구독을 가져오고 프록시를 설정하세요.
CLIENT SHELF
플랫폼을 전환해 해당 다운로드 항목을 확인하세요. 패키지 형식과 프로세서 아키텍처가 모두 맞아야 합니다. 클라이언트가 실행되더라도 구독과 프록시 설정까지 완료된 것은 아닙니다.
차세대 크로스 플랫폼 UI입니다. 처음 설치하거나 통일된 데스크톱 인터페이스를 원하는 경우 우선 선택하세요.
v2rayN 다운로드 · Desktop 버전 Windows x64 · ZIP 설치 파일안정적인 클래식 인터페이스를 유지합니다. 기존 메뉴, 트레이 조작, 설정 배치에 익숙한 사용자는 계속 이 버전을 선택할 수 있습니다.
v2rayN 다운로드 · WPF 버전 Windows x64 · ZIP 설치 파일| 확인 항목 | 선택 기준 |
|---|---|
| 시스템 환경 | 지원이 계속되는 Windows 10 / 11 사용을 권장합니다. 구체적인 호환성은 해당 릴리스 안내와 설치 메시지를 확인하세요. |
| 프로세서 아키텍처 | 이 페이지의 Windows 다운로드는 x64입니다. 「설정 → 시스템 → 정보」에서 시스템 종류를 확인하세요. |
| 패키지 형식 | ZIP 파일은 먼저 전체 폴더에 압축을 푼 다음 설치 프로그램을 실행하세요. 압축 프로그램 창에서 바로 실행하지 마세요. |
| 권한 및 실행 환경 | 설치 프로그램 안내에 따라 필요한 실행 환경을 설치하세요. TUN을 사용하려면 관리자 권한이 필요할 수 있습니다. |
다운로드한 뒤 실행 중인 이전 클라이언트를 종료하세요. 작업 표시줄 알림 영역에 프로그램이 계속 실행 중인지도 확인해야 합니다. 압축 파일을 완전히 풀고 설치 프로그램을 실행한 다음 안내에 따라 설치하세요. 프로그램 파일 하나만 압축 파일에서 꺼내 실행하면 같은 폴더에 있어야 할 종속 파일이 누락될 수 있습니다. 인터페이스는 열리지만 코어가 바로 종료된다면 로그 창에서 처음 나타난 명확한 오류를 확인한 뒤 포트 충돌이나 실행 환경 누락 여부를 살펴보세요.
Desktop 버전과 WPF 버전의 차이는 주로 인터페이스와 조작 방식에 있습니다. 네트워크 문제를 해결하는 일반적인 방법으로 인터페이스 버전을 바꾸지는 마세요. 처음 설정할 때는 클라이언트를 하나만 실행해 두 버전이 동시에 시스템 프록시를 변경하지 않도록 하세요. 구독을 갱신한 뒤 서버 목록에서 서버를 선택하고 트레이 메뉴에서 「시스템 프록시 자동 설정」을 선택하세요. 더 많은 앱의 트래픽을 처리해야 한다면 TUN 모드를 별도로 테스트하세요.
「이 Mac에 관하여」에 M 시리즈 칩이 표시되면 현재 프로세서 아키텍처에 맞는 arm64를 선택하세요.
v2rayN 다운로드 · arm64 Apple Silicon · DMG 설치 파일「이 Mac에 관하여」에 Intel 프로세서가 표시되면 x64를 선택하세요. arm64 설치 파일과 혼용하지 마세요.
v2rayN 다운로드 · Intel x64 Intel · DMG 설치 파일| 확인 항목 | 선택 기준 |
|---|---|
| 운영체제 버전 | 지원이 계속되는 macOS를 사용하세요. 최소 버전 요구 사항은 해당 릴리스 안내와 시스템 설치 메시지를 확인하세요. |
| 칩 종류 | 시스템 메뉴 → 이 Mac에 관하여: M 시리즈 칩은 arm64, Intel 프로세서는 x64를 선택하세요. |
| 설치 위치 | DMG를 연 다음 앱을 「응용 프로그램」으로 옮기고 해당 위치에서 실행하세요. |
| 네트워크 권한 | 시스템 프록시 및 TUN 관련 권한은 시스템 안내에 따라 허용하고, 처음 권한을 부여한 뒤 프록시 상태를 확인하세요. |
먼저 시스템 메뉴에서 「이 Mac에 관하여」를 열어 칩 종류를 확인한 다음 해당 DMG를 다운로드하세요. 디스크 이미지를 열고 앱을 「응용 프로그램」으로 복사한 뒤 복사가 끝나면 실행하세요. 디스크 이미지에서 바로 실행하면 업데이트 위치와 실제 사용 위치가 달라질 수 있어, 나중에 문제를 확인할 때 어떤 프로그램이 실행 중인지 파악하기 어렵습니다. 설치가 끝나면 디스크 이미지를 추출해도 됩니다.
처음 실행할 때 시스템이 앱을 차단하면 「시스템 설정 → 개인정보 보호 및 보안」에 표시된 안내를 먼저 읽고 다운로드 출처와 앱을 확인한 뒤 계속 진행할지 결정하세요. 앱 하나를 실행하기 위해 시스템 보안 기능 전체를 끄지 마세요. 클라이언트에서 구독을 가져오고 선택한 서버를 테스트하세요. 브라우저에서 여전히 프록시가 작동하지 않으면 시스템 네트워크 설정의 프록시 주소와 포트가 클라이언트의 로컬 수신 정보와 일치하는지 확인하세요.
절전 모드에서 복귀하거나 네트워크를 전환한 뒤 연결이 끊기면 클라이언트가 계속 실행 중인지 먼저 확인하고 프록시와 TUN 상태를 살펴보세요. 클라이언트를 종료하기 전에 시스템 프록시를 해제하면 중지된 로컬 포트를 계속 참조하는 일을 방지할 수 있습니다. 버전에 따라 메뉴 위치는 달라질 수 있지만 항목의 의미와 확인 순서는 같습니다.
2015년 이후 출시된 대부분의 스마트폰에 우선 권장합니다. 최종적으로는 기기에서 실제로 지원하는 앱 아키텍처를 확인하세요.
v2rayNG 다운로드 · arm64 arm64-v8a · APK 설치 파일기기 아키텍처를 모를 때 선택하세요. 여러 아키텍처를 지원하며 파일 크기는 단일 아키텍처 설치 파일보다 큰 편입니다.
v2rayNG 다운로드 · 범용 버전 Universal · APK 설치 파일
V2Fly 코어가 필요한 설정에 적합합니다. 설치 전에 서버 프로토콜이 해당 코어와 호환되는지 확인하세요.
v2flyNG 다운로드 · arm64 arm64-v8a · APK 설치 파일더 많은 아키텍처를 지원해야 할 때 선택하세요. 패키지 아키텍처는 설치 호환성에 영향을 주지만 서버 설정 요구 사항은 바꾸지 않습니다.
v2flyNG 다운로드 · 범용 버전 Universal · APK 설치 파일| 확인 항목 | 선택 기준 |
|---|---|
| 운영체제 버전 | 설치 프로그램에 표시된 최소 Android 버전과 해당 릴리스 안내를 기준으로 확인하세요. |
| 앱 아키텍처 | 대부분의 기기에서는 arm64를 우선 선택하세요. 아키텍처를 모르거나 불일치 메시지가 표시되면 범용 버전을 선택하세요. |
| 설치 권한 | APK를 실제로 여는 브라우저나 파일 관리자에만 「알 수 없는 앱 설치」 권한을 허용하세요. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 요청을 승인하세요. 동시에 다른 VPN 앱이 연결을 사용하지 않도록 하세요. |
APK를 다운로드한 다음 다운로드 목록이나 파일 관리자에서 여세요. 시스템에서 설치 출처 권한을 요청하면 해당 앱의 권한 화면에서 허용한 뒤 설치 프로그램으로 돌아가 계속 진행하세요. 설치가 끝나면 필요에 따라 해당 출처의 설치 권한을 다시 해제할 수 있습니다. 「앱이 설치되지 않았습니다」라는 메시지가 표시되면 아키텍처 불일치, 낮은 시스템 버전 또는 기존 앱과의 서명 차이가 있는지 먼저 확인하세요. 같은 파일을 반복해서 다운로드하지 마세요.
기존 구독과 사용자 지정 규칙이 있다면 이전 앱을 바로 삭제하지 마세요. 먼저 앱의 내보내기 또는 백업 기능으로 설정을 저장한 뒤 재설치가 필요한지 판단하세요. v2rayNG와 v2flyNG는 코어가 다르므로 이름이 비슷하다는 이유만으로 모든 프로토콜과 필드가 호환된다고 볼 수 없습니다. VLESS, REALITY 등의 설정은 선택한 클라이언트와 현재 코어의 지원 여부를 먼저 확인하고, 일반적으로 v2rayNG부터 테스트하는 것이 좋습니다.
설정을 가져온 뒤 처음 연결하면 시스템 VPN 권한 요청이 표시됩니다. 이 권한은 기기에서 트래픽을 전달하는 통로를 만드는 데 사용되며 구독이 유효하다는 뜻은 아닙니다. 연결 스위치를 켠 뒤 실제 접속을 테스트해야 합니다. 화면을 잠근 뒤 연결이 자주 끊기면 해당 클라이언트의 배터리 최적화, 백그라운드 실행 및 네트워크 제한을 확인하세요. 설정을 변경한 뒤 다시 화면을 잠가 테스트하고, 원인을 찾기 어렵지 않도록 한 번에 여러 항목을 바꾸지 마세요.
deb 패키지 관리 체계를 사용하는 배포판에 적합합니다. 설치 전에 시스템 아키텍처와 종속성 요구 사항을 확인하세요.
v2rayN 다운로드 · deb x64 ARM 기기: deb arm64rpm 패키지 관리 체계를 사용하는 배포판에 적합합니다. 같은 rpm 계열이라도 런타임 라이브러리 호환성을 확인해야 합니다.
v2rayN 다운로드 · rpm x64 ARM 기기: rpm arm64| 확인 항목 | 선택 기준 |
|---|---|
| 데스크톱 환경 | 이 페이지에서는 그래픽 클라이언트를 제공합니다. 데스크톱 앱을 실행할 수 있는 Linux 환경이 필요합니다. |
| 프로세서 아키텍처 | x86_64 / amd64는 x64를, aarch64 / arm64는 arm64를 선택하세요. |
| 패키지 관리 체계 | Debian, Ubuntu 등은 일반적으로 deb를, Fedora 등은 일반적으로 rpm을 선택합니다. 현재 패키지가 대상으로 하는 환경도 확인하세요. |
| 종속성 및 권한 | 시스템 소프트웨어 설치 프로그램에서 종속성을 확인하세요. TUN을 사용하려면 가상 네트워크 인터페이스 지원과 필요한 네트워크 권한도 필요합니다. |
먼저 시스템의 「정보」 또는 하드웨어 정보 화면에서 프로세서 아키텍처를 확인한 뒤 배포판의 패키지 형식을 확인하세요. 시스템 소프트웨어 설치 프로그램으로 다운로드한 deb 또는 rpm 파일을 열고 종속성 정보를 확인한 다음 설치하세요. 패키지 관리 체계가 같아도 모든 배포판에서 동일한 패키지를 바로 실행할 수 있는 것은 아닙니다. 설치 프로그램에서 런타임 라이브러리 버전이 부족하다고 안내하면 배포판 버전과 패키지의 빌드 대상부터 확인하고 종속성을 무시하도록 강제하지 마세요.
설치가 끝나면 앱 메뉴에서 v2rayN을 실행하세요. 일반적인 그래픽 환경에서는 현재 사용자 세션에서 실행하고, 특정 권한 안내를 피하려고 데스크톱 프로그램 전체를 계속 높은 권한으로 실행하지 마세요. 로컬 수신과 시스템 프록시를 먼저 확인한 다음 TUN을 설정하세요. 데스크톱 환경마다 시스템 프록시를 읽는 방식이 다르며, 일부 앱은 자체 네트워크 설정에서 시스템 프록시를 선택하거나 로컬 주소를 직접 입력해야 합니다.
TUN을 사용할 수 없다면 로그에서 권한, 가상 네트워크 인터페이스 및 라우팅 오류를 확인하고 구체적인 오류에 맞게 조치하세요. 여러 프록시 프로그램의 TUN이 동시에 트래픽을 처리하게 하지 마세요. 배포판을 바꾸거나 기기를 옮기기 전에는 구독 그룹과 사용자 지정 라우팅을 별도로 백업하세요. 이전 시스템의 경로, 네트워크 인터페이스 이름, 권한 설정을 새 환경에 그대로 적용하지 마세요.
CLIENT & CORE
Project V는 V2Ray 기술 생태계의 출발점입니다. V2Fly는 관련 코어를 이어서 관리하고, Xray는 이 생태계의 또 다른 코어 계열입니다. 그래픽 클라이언트는 설정을 관리하고 코어를 실행하며 조작 인터페이스를 제공합니다. 프로토콜과 전송 방식의 구체적인 지원 범위는 사용 중인 코어와 버전에 따라 달라집니다.
v2rayN, v2rayNG, v2flyNG는 모두 무료 오픈 소스 클라이언트입니다. 데스크톱에서는 v2rayN을, Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. V2Fly 코어가 꼭 필요할 때는 v2flyNG를 고려하세요. 클라이언트를 다운로드해도 서버가 제공되는 것은 아니므로 구독은 별도로 준비해야 합니다.
프로토콜 필드를 인식하지 못하더라도 설치 파일을 무작정 바꾸지 마세요. 공유 링크 유형, 코어 지원 여부와 로그 오류를 확인한 뒤 클라이언트를 업데이트할지 결정하세요. 클라이언트 선택을 비교하려면 클라이언트 3종 비교를, 전체 환경 설정은 플랫폼별 설치 안내를 확인하세요.
AFTER INSTALLATION
먼저 연결을 테스트한 뒤 라우팅 분할과 트래픽 처리를 설정하세요. 한 번에 한 종류의 설정만 변경하면 쉽게 되돌리고 원인을 찾을 수 있습니다.
STEP 01
데스크톱에서는 「구독 그룹 설정」으로 이동해 그룹을 만들고 구독 주소를 입력하세요. 형식 예시는 https://example.com/sub?token=xxxx입니다. 저장한 뒤 구독을 업데이트하세요. 프록시를 아직 설정하지 않았다면 「프록시 없이 구독 업데이트」를 시도할 수 있습니다. 서비스에서 특정 네트워크 환경을 요구한다면 안내에 따라 업데이트 방식을 선택하세요.
Android에서는 추가 메뉴에서 구독을 선택하거나 클립보드에서 가져오세요. 구독 주소와 개별 공유 링크는 서로 다른 형식이므로 각각 해당하는 메뉴에 넣어야 합니다. 업데이트가 끝나면 서버 목록에 항목이 표시되는지 확인하세요. 목록이 비어 있으면 시스템 프록시를 바꾸기 전에 업데이트 결과부터 살펴보세요.
STEP 02
목록에서 서버를 선택한 뒤 주소, 포트, 프로토콜, 전송 매개변수를 확인하세요. 구독을 가져오면 대개 이 항목이 자동으로 입력되므로 추측해서 값을 추가할 필요가 없습니다. 직접 설정할 때는 각 항목을 서버 정보와 대조해야 하며, 특히 TLS, SNI, REALITY 관련 항목을 주의 깊게 확인하세요.
지연 시간 테스트는 특정 조건에서의 결과일 뿐 실제 접속을 대신하지 못합니다. 테스트에 실패하면 DNS 오류, 연결 시간 초과, 핸드셰이크 오류를 구분해 로그와 함께 원인을 확인하세요. 구독 주소, 사용자 식별 정보 또는 전체 설정이 포함된 스크린샷을 공개하지 마세요.
STEP 03
데스크톱에서는 먼저 시스템 프록시를 사용해 브라우저 접속을 확인하세요. 클라이언트의 로컬 수신 포트와 시스템 프록시 포트가 일치하고 다른 프로그램이 프록시를 중복 변경하지 않는지 확인하세요. Android에서는 시스템 VPN 권한을 허용한 다음 앱에 표시된 연결 상태를 확인하세요.
시스템 프록시가 모든 앱에 자동으로 적용되는 것은 아닙니다. 특정 프로그램이 계속 직접 연결된다면 먼저 시스템 프록시를 사용하는 앱인지 확인한 뒤 TUN이 필요한지 판단하세요. TUN은 권한, 가상 네트워크 인터페이스, DNS 및 라우팅에 영향을 주므로 기본 연결을 확인하기 전에 함께 켜지 마세요.
STEP 04
실제 사용 목적에 따라 「중국 본토 우회」와 같은 라우팅 모드를 선택하고 직접 연결해야 하는 앱과 프록시를 사용해야 하는 앱이 예상대로 작동하는지 확인하세요. 라우팅 규칙은 트래픽 경로를 정할 뿐, 작동하지 않는 서버를 복구하지는 않습니다. 사용자 지정 규칙을 변경하기 전에 현재 작동하는 설정을 저장하세요.
설정이 끝나면 웹페이지 접속, 자주 사용하는 앱, 네트워크 전환, 클라이언트 종료 후의 인터넷 연결 상태를 차례로 확인하세요. 업그레이드를 준비할 때는 로컬 포트, 구독 그룹, 규칙 출처를 기록해 두세요. 단계별 안내는 구독 가져오기 및 연결 방법에서 확인할 수 있습니다.
DOWNLOAD FAQ
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 선택할 수 있습니다. 클래식 인터페이스와 익숙한 사용 방식을 선호한다면 안정적인 WPF 버전을 선택하세요. 두 버전 모두 v2rayN입니다. 처음 사용하는 버전에서는 먼저 구독을 가져오고 시스템 프록시가 작동하는지 확인한 다음 다른 설정을 옮기세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 최종적으로는 기기에서 실제로 지원하는 앱 아키텍처를 확인하세요. 아키텍처를 모르거나 arm64 패키지가 호환되지 않는다고 표시되면 범용 버전을 선택하세요. 범용 버전은 더 많은 아키텍처를 지원하는 대신 파일 크기가 더 큰 편입니다. 구독이나 연결 문제를 해결하려고 아키텍처 패키지만 바꾸지는 마세요.
클라이언트는 설정을 읽고 트래픽을 전달하는 프로그램이며, 설치 파일에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 직접 관리하거나 적법하게 받은 구독 주소, 공유 링크 또는 설정 파일을 준비한 뒤 구독 그룹이나 가져오기 메뉴에서 추가해야 합니다. 구독 주소에는 접속 정보가 포함되므로 공개하거나 문의용 스크린샷에 그대로 노출하지 마세요.
먼저 운영체제, 프로세서 아키텍처, 패키지 형식이 맞는지 확인한 뒤 시스템 안내를 읽으세요. Windows ZIP 파일은 압축을 완전히 풀어야 합니다. macOS에서는 Apple Silicon과 Intel을 구분하세요. Android에서는 설치 권한과 서명 충돌을 확인하고, Linux에서는 패키지 관리자가 표시하는 종속성 및 배포판 호환성 문제를 확인하세요.
업데이트 전에 클라이언트의 백업 또는 내보내기 기능을 사용하고 구독 그룹, 라우팅 모드, 로컬 수신 포트를 기록해 두세요. 기존 클라이언트를 종료한 뒤 현재 시스템에 맞는 새 패키지를 설치하세요. 업데이트 후에는 설정이 유지됐는지 확인하고 구독을 갱신한 다음 연결을 테스트하세요. 인터페이스가 다른 버전으로 옮길 때 호환되지 않는 설정 파일을 그대로 덮어쓰지 마세요.