Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하므로 처음 설치하거나 여러 운영체제에서 비슷한 사용 방식을 원하는 사용자에게 적합합니다. WPF는 클래식 Windows 인터페이스를 유지해 기존 메뉴와 창 배치에 익숙한 사용자에게 알맞습니다. 선택 기준은 인터페이스와 실행 환경이지, 패키지 이름에 따른 연결 속도가 아닙니다. 두 버전 모두 설정을 가져온 뒤 현재 사용하는 앱에 맞는 프록시 방식을 선택해야 합니다.
다운로드 파일은 압축 파일입니다. 폴더 전체를 먼저 압축 해제한 다음 안에 있는 프로그램을 실행하세요. 압축 프로그램의 미리 보기 창에서 바로 실행하지 마세요.
Windows 시스템 요구 사항 및 설치 준비
확인 항목
적용 조건
설치 전 확인
프로세서 아키텍처
x64 Windows
시스템 설정의 ‘정보’에서 시스템 종류를 확인하세요. PC 브랜드만 보고 선택하지 마세요.
런타임 환경
현재 패키지의 실행 안내를 따르세요
.NET 런타임 안내가 표시되면 안내에 나온 버전과 아키텍처를 확인하세요.
프로그램 폴더
쓰기 및 보관이 가능한 로컬 폴더
압축을 완전히 풀고 임시 폴더는 피하세요. 프로그램과 포함 파일의 상대 경로를 유지하세요.
프록시 권한
시스템 프록시와 TUN은 필요한 권한이 다릅니다
우선 일반 권한으로 설정을 완료하세요. TUN이 필요하다면 클라이언트 안내에 따라 권한을 설정하세요.
설치할 때는 별도의 폴더를 만들고 다운로드한 패키지의 파일 구조를 그대로 유지하세요. 기기에 v2rayN이 이미 설치되어 있다면 Desktop과 WPF 파일을 같은 폴더에 섞지 마세요. 새 폴더에서 실행하기 전에 기존 클라이언트의 구독 그룹과 직접 추가한 노드를 백업하세요. 설정이 정상적으로 이전되었는지 확인한 다음 기존 폴더를 정리하세요. 런타임 누락, 포트 사용 중, 프로그램 파일 격리는 서로 다른 문제이므로 구체적인 오류에 따라 해결해야 합니다. 구독을 반복해서 바꾸는 것으로 해결하려 하지 마세요.
처음 연결할 때는 시스템 프록시부터 설정하는 것이 좋습니다. 구독 주소를 저장하고 그룹을 업데이트한 뒤 노드를 선택하고 시스템 프록시를 켜서 브라우저로 확인하세요. 일부 명령줄 도구는 시스템 프록시를 사용하지 않으므로 프록시 환경 변수를 별도로 설정해야 합니다. 더 많은 앱의 트래픽을 처리해야 한다면 v2rayN TUN 모드를 사용할 수 있지만, 라우팅 규칙과 DNS 설정, 시스템 권한의 영향을 받습니다. 스위치를 켰다고 모든 연결이 프록시를 통과하는 것은 아닙니다.
macOS 다운로드
먼저 ‘이 Mac에 관하여’에서 칩을 확인하세요. Apple M 시리즈와 Intel은 서로 다른 설치 파일을 사용합니다.
칩 이름에 Apple M 시리즈가 표시되면 Apple Silicon을, Intel 프로세서가 표시되면 Intel을 선택하세요. 구입 연도로 칩을 판단하지 마세요. 같은 해에 서로 다른 아키텍처의 기기가 출시될 수 있습니다. 기기에 맞는 기본 패키지를 우선 사용하세요. 앱을 열 수 없다는 안내가 나오면 다른 런타임을 찾기 전에 macOS 버전과 아키텍처, 시스템 보안 알림부터 확인하세요.
DMG를 연 뒤 설치 화면의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기세요. 해당 폴더에서 앱을 실행해 초기 설정을 마치면 됩니다.
macOS 시스템 요구 사항 및 설치 준비
확인 항목
적용 조건
설치 전 확인
칩
Apple Silicon 또는 Intel
‘이 Mac에 관하여’에서 칩 또는 프로세서 항목을 확인하세요.
운영체제 버전
현재 앱 패키지의 호환성 요구 사항을 따르세요
macOS 버전을 기록하고 실행 안내가 표시되면 항목별로 대조하세요.
설치 위치
응용 프로그램 폴더
복사가 끝나면 앱을 실행하세요. 디스크 이미지에서 계속 실행하지 마세요.
네트워크 설정
시스템 프록시 또는 클라이언트가 지원하는 트래픽 처리 방식
다른 프록시 도구가 같은 네트워크 서비스의 설정을 변경했는지 확인하세요.
처음 실행할 때 시스템 보안 알림이 나타날 수 있습니다. 안내 내용을 읽고 방금 설치한 앱이 맞는지 확인한 뒤 시스템 설정에서 해당 권한을 처리하세요. 앱을 실행하려고 시스템 보안 기능 전체를 끄지 마세요. 앱은 실행되지만 웹 연결에 문제가 있다면 프록시 모드와 노드, DNS를 점검하세요. 설치 권한 문제는 대개 프로그램 실행 단계에서 발생하며, 구독 노드의 온라인 여부와는 별개의 문제입니다.
시스템 프록시를 사용할 때는 무선 또는 유선 네트워크처럼 현재 사용 중인 네트워크 서비스를 확인하세요. 네트워크를 바꾸면 이전 프록시 설정이 새 서비스에 적용되지 않을 수 있습니다. 클라이언트를 종료하기 전에 제공된 방법으로 시스템 프록시를 해제해, 중지된 로컬 포트를 가리키는 설정이 남지 않도록 하세요. 앱을 업그레이드하기 전에 구독과 사용자 지정 라우팅을 보관하세요. 프로그램을 교체한 뒤에는 로컬 수신 포트와 프록시 상태를 확인하고 평소처럼 사용하세요.
Android 다운로드
v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 두 클라이언트는 각각 설치하고 설정도 별도로 관리합니다.
2015년 이후 출시된 일반적인 스마트폰은 우선 arm64를 선택하면 되지만, 기기별 시스템 환경이 다를 수 있으므로 실제 호환성을 확인하세요. 아키텍처를 모르거나 설치 중 패키지가 호환되지 않는다는 안내가 나오면 범용 버전을 선택할 수 있습니다. 두 패키지는 같은 클라이언트를 아키텍처별로 배포한 것이며 기능 수준의 차이는 없습니다. v2rayNG는 Xray 설정과 관련 프로토콜 조합을 사용하는 사용자에게 적합하지만, 지원 기능은 설치한 버전에 따라 달라질 수 있습니다.
처음 연결할 때 시스템 VPN 권한을 확인하세요. 설치가 끝나면 설정을 가져온 다음 연결을 시작하세요.
v2flyNG는 V2Fly 코어를 사용하려는 Android 사용자용입니다. 선택하기 전에 구독에 설정된 프로토콜과 전송 옵션을 현재 버전에서 인식할 수 있는지 확인하세요. 다른 클라이언트에서 지원하는 모든 설정을 그대로 가져올 수 있다고 가정하지 마세요. 두 앱의 설정은 각각 보관할 수 있지만 연결을 시험할 때는 시스템 VPN 충돌을 노드 문제로 오해하지 않도록 실행 중인 VPN 세션을 먼저 중지한 뒤 다른 클라이언트를 시작하세요.
다른 클라이언트를 설치해도 기존 설정이 자동으로 동기화되지는 않습니다. 이전할 때 구독을 다시 가져오고 사용자 지정 설정을 확인하세요.
Android 시스템 요구 사항 및 설치 준비
확인 항목
적용 조건
설치 전 확인
기기 아키텍처
arm64 또는 범용 패키지가 지원하는 아키텍처
먼저 기기 정보를 확인하고, 아키텍처를 알 수 없다면 범용 버전을 사용하세요.
시스템 호환성
APK의 설치 요구 사항을 따르세요
시스템에서 버전이 호환되지 않는다고 표시하면 Android 버전과 오류 문구를 기록하세요.
설치 출처
현재 다운로드 앱 또는 파일 관리자에서 앱 설치 허용
시스템 안내에 따라 이번에 사용할 설치 출처에만 권한을 부여하세요.
연결 권한
시스템 VPN 권한
처음 연결을 시작할 때 권한을 승인하고, 다른 VPN 세션이 실행 중인지 확인하세요.
백그라운드 실행
기기의 배터리 정책에 맞게 설정
화면을 잠근 뒤 연결이 끊기면 앱의 백그라운드 실행과 배터리 제한을 확인하세요.
APK 설치와 VPN 연결은 별개의 단계입니다. 설치 출처를 허용하면 앱을 설치할 수 있을 뿐이며, 연결을 시작할 때 VPN 권한도 별도로 승인해야 합니다. 업그레이드 중 앱 서명이 다르다는 안내가 나오더라도 바로 삭제하지 마세요. 삭제하면 로컬 노드와 설정이 지워질 수 있습니다. 먼저 설정을 백업한 뒤 기존 설치 출처와 새 패키지를 덮어쓸 수 있는 배포 방식인지 확인하고, 필요하면 마이그레이션 절차에 따라 다시 설치하세요.
v2rayNG 구독 가져오기를 하려면 먼저 구독 그룹을 만들고 주소를 입력해 저장한 다음 구독을 업데이트하세요. 업데이트가 끝나면 노드를 선택하고 연결을 시작한 뒤 브라우저에서 접속을 확인하세요. 화면을 잠근 뒤 연결이 끊기면 백그라운드 제한을 먼저 확인하고, 특정 앱에서만 문제가 생기면 앱별 프록시 목록을 확인하세요. 클라이언트의 테스트 결과는 노드 선택에 참고할 수 있지만, 모든 앱과 웹사이트의 접속 상태를 보장하지는 않습니다.
Linux 다운로드
배포판의 패키지 시스템에 따라 deb 또는 rpm을 선택한 뒤 x64와 arm64 아키텍처를 확인하세요.
deb는 일반적으로 Debian, Ubuntu 등 deb 패키지 체계를 사용하는 배포판에서 쓰며, rpm은 RPM 패키지 체계를 사용하는 배포판용입니다. 패키지 형식이 같아도 모든 배포판 버전에서 의존성 조건이 충족되는 것은 아니므로 설치 전에 패키지 관리자의 안내를 확인하세요. x64 패키지의 amd64 또는 x86_64는 아키텍처 표기이며, arm64 패키지의 arm64 또는 aarch64는 다른 프로세서 유형을 뜻합니다. 서로 바꿔 사용할 수 없습니다.
그래픽 인터페이스가 있는 데스크톱 클라이언트입니다. 패키지를 선택할 때 데스크톱 환경과 배포판 의존성, 프로세서 아키텍처를 함께 확인하세요.
Linux 시스템 요구 사항 및 설치 준비
확인 항목
적용 조건
설치 전 확인
패키지 형식
deb 또는 rpm
배포판의 소프트웨어 설치 도구에서 설치 가능한 패키지 형식을 확인하세요.
프로세서 아키텍처
x64 또는 arm64
시스템 정보에서 아키텍처를 확인하세요. 패키지 확장자만 보고 판단하지 마세요.
데스크톱 환경
그래픽 앱을 실행할 수 있는 데스크톱 세션
앱 메뉴와 그래픽 설치 도구를 사용할 수 있는지 확인하세요.
의존성 및 권한
현재 패키지의 의존성 요구 사항 충족
패키지 관리자의 안내에 따라 의존성을 해결하세요. 프록시 권한은 별도로 설정해야 합니다.
배포판의 그래픽 소프트웨어 설치 도구로 패키지를 열어 의존성과 설치 결과를 확인하는 것이 좋습니다. 설치 도구에서 오류가 나면 같은 패키지를 반복해서 열지 말고 구체적인 의존성 이름과 시스템 버전을 기록하세요. 다른 출처에서 같은 이름의 앱을 설치했다면 프로그램 파일 교체와 사용자 설정 이전을 혼동하지 않도록 설정 저장 위치와 패키지 관리 상태를 먼저 확인하세요. 업그레이드 전에 사용자 지정 라우팅과 구독을 보관하고, 설치 후 연결 상태를 확인하세요.
Linux 데스크톱의 시스템 프록시, 브라우저 자체 프록시, 터미널 환경 변수는 각각 별도로 적용될 수 있습니다. 클라이언트가 실행 중이라는 표시는 로컬 서비스가 작동한다는 뜻일 뿐, 모든 앱이 프록시 설정을 사용한다는 의미는 아닙니다. 먼저 시스템 프록시를 사용하는 앱 하나로 확인한 뒤 다른 프로그램도 하나씩 점검하세요. 더 많은 트래픽을 처리하려면 클라이언트가 지원하는 모드와 권한, DNS 설정을 확인하고 서로 충돌하는 여러 트래픽 처리 규칙을 동시에 켜지 마세요.
설치 준비, 설정 이전
다운로드 전: 기기와 기존 설정 확인
먼저 운영체제 종류와 프로세서 아키텍처, 기존 클라이언트의 설치 위치를 확인하세요. 패키지 형식은 설치 방법을 결정하고, 아키텍처는 프로그램 실행 가능 여부를 결정합니다. 둘 다 확인한 뒤 다음 단계로 넘어가세요. 이미 클라이언트를 사용 중인 기기라면 구독 그룹과 직접 추가한 노드, 사용자 지정 라우팅, 로컬 포트 설정을 먼저 백업하세요. 구독을 다시 업데이트할 수 있다고 해서 모든 수동 설정까지 복구되는 것은 아닙니다.
처음 설치한다면 플랫폼에 맞는 다운로드를 선택하면 됩니다. 인터페이스 버전이나 클라이언트를 바꾸는 경우에는 마이그레이션을 별도 단계로 진행해야 합니다. 특히 데스크톱의 서로 다른 프로그램 폴더나 Android의 두 앱은 설정을 자동으로 공유한다고 가정하지 마세요. 오류가 발생하면 원래 안내 문구와 현재 시스템 정보를 보관하세요. 설치, 권한, 연결 문제를 구분하는 데 도움이 됩니다.
다운로드 후: 구독, 모드 및 연결 확인
클라이언트는 설정을 관리하고 연결을 시작하는 도구이며, 설치 파일 자체에는 구독이 포함되지 않습니다. 사용할 권한이 있는 구독 주소를 준비한 뒤 그룹 설정에 입력하고 저장한 다음 업데이트하세요. 구독 주소에 접속 정보가 포함될 수 있으므로 스크린샷이나 문의 글, 동기화 노트에 전체 링크가 보이지 않게 하세요. 업데이트 후 프로토콜 유형과 노드 메모를 확인하고 노드를 선택한 다음 해당 시스템 프록시나 VPN 모드를 켜세요.
V2Ray 노드 속도 테스트는 실제 접속 확인과 함께 진행하세요. 테스트 실패는 테스트 대상이나 DNS, 네트워크 환경 때문일 수 있으므로 한 번의 결과만 보고 그룹 전체를 삭제하지 마세요. VLESS 프로토콜과 다른 전송 방식의 조합을 알아보려면 설정 안내를 확인하세요. 최종적으로 선택하는 V2Ray 프로토콜은 서버에서 제공하는 설정과 일치해야 합니다.
V2Ray 클라이언트는 구독과 노드 목록, 라우팅 설정을 관리하고 연결을 시작하며, 코어는 설정에 따라 연결을 처리합니다. Project V는 이 생태계를 이해하는 배경이며, V2Fly와 Xray는 관련 코어 계열이지 운영체제 이름이 아닙니다. 다운로드할 때는 기기에 맞는 그래픽 클라이언트를 먼저 선택하고, 설정할 때 구독에 필요한 프로토콜과 전송 방식의 지원 여부를 확인하세요. 코어 이름을 설치 패키지 아키텍처로 착각하는 일을 줄일 수 있습니다.
v2rayN은 데스크톱 플랫폼용으로, 클라이언트에서 지원하는 범위 안에서 관련 코어와 설정을 관리할 수 있습니다. v2rayNG는 Android용이며 Xray 코어를 사용하고, v2flyNG는 Android용이며 V2Fly 코어를 사용합니다. 세 클라이언트의 설정 화면과 지원 매개변수는 서로 다를 수 있으며, 구독을 가져올 수 있는지도 현재 버전에 따라 달라집니다. 특정 프로토콜을 인식하지 못한다면 구독 형식과 클라이언트 지원 여부부터 확인하세요.
오픈 소스란 프로젝트를 살펴보고 개선할 수 있다는 뜻이지만, 설치 시에는 시스템 호환성과 업그레이드 후 설정 이전을 고려해야 합니다. 일상적으로 사용할 때 모든 인터페이스 변경을 따라갈 필요는 없습니다. 현재 필요한 기능이나 호환성 문제, 수정 사항이 기기와 관련 있을 때 업그레이드하면 됩니다. 업그레이드 후에는 구독 그룹과 라우팅이 유지되었는지 확인하고 실제 접속을 테스트하세요. 새 기본 설정을 기존 설정으로 착각하지 않도록 주의하세요.
다운로드 및 설치 FAQ
Windows에서는 Desktop과 WPF 중 어떤 버전을 선택해야 하나요?
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop을 선택해 보세요. WPF는 익숙한 기존 Windows 인터페이스를 선호하는 사용자에게 적합한 클래식 안정 버전입니다. 두 패키지 모두 압축을 완전히 푼 뒤 사용하고, 버전을 바꾸기 전에 기존 설정을 백업하세요. 두 버전의 프로그램 폴더를 섞어 덮어쓰지 마세요.
macOS에서 Apple Silicon과 Intel을 어떻게 구분하나요?
시스템 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩에 Apple M 시리즈가 표시되면 Apple Silicon을, 프로세서에 Intel이 표시되면 Intel을 선택하세요. 설치 파일 이름의 arm64는 Apple Silicon에 해당하며, 64는 여기서 안내하는 Intel용 패키지입니다.
Android의 arm64와 범용 버전은 무엇이 다른가요?
2015년 이후 출시된 일반적인 스마트폰은 우선 arm64를 선택하면 되지만, 실제 기기의 아키텍처를 확인하는 것이 가장 정확합니다. 아키텍처를 모르거나 arm64 패키지가 호환되지 않는다는 안내가 표시되면 범용 버전을 선택하세요. 두 패키지는 같은 클라이언트를 아키텍처별로 배포한 것으로, 노드나 프로토콜 지원 수준의 차이를 뜻하지 않습니다.
설치하면 바로 사용할 수 있는 구독이 포함되나요?
설치 파일에는 클라이언트 프로그램만 포함되며 연결 설정은 제공되지 않습니다. 실행한 뒤 사용 권한이 있는 구독 주소나 노드 설정을 가져오고, 구독을 업데이트한 다음 노드를 선택하세요. 이후 시스템 프록시나 VPN 연결 방식을 설정해야 합니다. 구독 주소에 접속 정보가 포함될 수 있으므로 전체 링크를 공개하지 마세요.
업그레이드 전에 무엇을 보관해야 하나요?
구독 그룹, 직접 추가한 노드, 사용자 지정 라우팅 및 관련 설정을 먼저 백업하고, 현재 프록시 모드와 로컬 포트를 기록하세요. 기존 프로그램을 종료한 뒤 새 패키지를 설치하거나 압축을 푸세요. 처음 실행한 후 그룹과 라우팅이 정상인지 확인하고 구독을 업데이트하세요. 같은 로컬 포트를 사용하는 클라이언트를 동시에 실행하지 마세요.
다운로드한 파일이 실행되지 않으면 무엇부터 확인해야 하나요?
먼저 운영체제와 프로세서 아키텍처가 맞는지 확인하고, 압축 파일을 완전히 풀었는지 살펴보세요. Windows는 실행 시 안내되는 런타임 요구 사항을, macOS는 시스템 보안 알림을 확인하세요. Android에서는 설치 출처 권한과 서명 충돌을, Linux에서는 패키지 의존성 안내를 확인하세요. 오류 메시지를 기록한 뒤 해당 플랫폼에 맞게 점검하세요.