다운로드한 ZIP 파일을 일반 폴더에 완전히 압축 해제한 뒤, 폴더 안의 설치 프로그램을 실행하고 안내에 따라 설치하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 두 클라이언트가 동시에 시스템 프록시를 제어하지 않도록 주의하세요.
Windows 시스템 및 설치 준비
확인 항목
선택 및 요구 사항
확인 위치
프로세서
이 페이지의 두 설치 파일은 모두 x64이며 Intel / AMD 64비트 데스크톱 환경용입니다.
설정 → 시스템 → 정보 → 시스템 종류
시스템 및 종속성
지원이 계속되는 64비트 Windows를 사용하세요. 최소 버전과 런타임 구성 요소 요구 사항은 현재 설치 파일의 안내를 확인하세요.
먼저 Windows 버전을 확인하고, 설치 중 누락된 구성 요소나 호환성 관련 안내가 있는지 살펴보세요.
설치 권한
설치 프로그램을 실행하거나 보호된 폴더에 파일을 쓸 때 관리자 확인이 필요할 수 있습니다. 일상적인 실행 권한은 실제 기능에 필요한 범위로 허용하세요.
설치 대상 폴더에 쓰기 권한이 있는지 확인하고, 임시 압축 폴더에서 실행하지 마세요.
데스크톱 버전과 WPF 버전은 주로 인터페이스 구현과 조작 방식이 다릅니다. 어느 한쪽이 자동으로 더 빠른 연결을 제공하는 것은 아닙니다. 연결 상태는 서버, 설정, 네트워크 경로에 따라 달라집니다. 버전을 바꾸기 전에 기존 구독 그룹, 라우팅 및 사용자 설정을 저장하세요. 창 화면을 캡처하는 것만으로는 백업이 되지 않습니다.
처음 실행한 뒤 로컬 수신 포트를 확인하고 시스템 프록시를 활성화하세요. 가이드에 자주 나오는 10808과 10809는 일반적인 설정 예시일 뿐, 현재 클라이언트가 두 포트에서 모두 수신한다는 뜻은 아닙니다. 앱에는 클라이언트에 실제로 표시된 프로토콜과 포트를 입력하세요.
02 / DESKTOP
macOS 다운로드
같은 v2rayN이라도 Apple Silicon과 Intel 아키텍처용 설치 파일이 다릅니다. 먼저 ‘이 Mac에 관하여’에서 확인한 뒤 맞는 파일을 선택하세요.
v2rayN
7.24.1
macOS 데스크톱 클라이언트
arm64
Apple Silicon
칩 항목에 Apple M 시리즈가 표시되는 Mac용입니다. 칩과 일치하는 네이티브 아키텍처 파일을 권장합니다.
DMG를 연 뒤 이미지 안의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기고 해당 폴더에서 실행하세요. 처음 실행할 때 시스템 보안 안내가 표시되면 앱 출처와 안내 내용을 확인한 뒤, 시스템 설정에서 열기를 허용할지 결정하세요.
macOS 시스템 및 설치 준비
확인 항목
선택 및 요구 사항
확인 위치
CPU 아키텍처
Apple M 시리즈는 arm64, Intel 프로세서는 x64를 선택하세요.
Apple 메뉴 → 이 Mac에 관하여 → 칩 또는 프로세서
시스템 호환성
지원이 계속되는 macOS를 사용하세요. 최소 버전은 현재 앱 패키지의 요구 사항을 확인해야 합니다.
‘이 Mac에 관하여’에서 시스템 버전을 확인하고, 실행 시 호환성 안내가 있는지 살펴보세요.
앱 및 권한
앱을 설치할 폴더에 쓰기 권한이 있어야 합니다. 시스템 프록시를 변경할 때는 시스템 권한이 필요할 수 있습니다.
응용 프로그램 폴더, 시스템 설정의 개인정보 보호 및 보안, 네트워크 설정
앱을 고정 폴더에 복사한 뒤 사용하면 디스크 이미지를 추출한 후 앱을 찾지 못하는 문제를 예방할 수 있습니다. 시스템 프록시는 데스크톱 앱이 로컬 프록시에 연결하는 방법 중 하나일 뿐, 모든 앱이 이 설정을 따르는 것은 아닙니다. 터미널이나 일부 독립형 네트워크 도구는 별도로 설정해야 할 수 있습니다.
가져온 설정으로 앱은 실행되지만 예상한 트래픽이 발생하지 않는다면, 먼저 클라이언트에서 서버를 선택했는지와 시스템 프록시가 현재 수신 포트를 가리키는지 확인하세요. 아키텍처 설치 파일을 계속 바꾸기 전에 다른 원인을 살펴보세요. 아키텍처가 맞지 않으면 보통 설치나 실행 단계에서 문제가 발생하며, 특정 웹사이트만 접속되지 않는 원인은 아닙니다.
03 / MOBILE
Android 다운로드
v2rayNG를 권장합니다. 기존 설정이 V2Fly에 의존하는 경우에만 v2flyNG를 선택하세요. 두 앱 모두 유효한 설정과 시스템 연결 권한이 필요합니다.
v2rayNG
2.2.6
권장Xray 코어
arm64-v8a
arm64 버전
2015년 이후 출시된 대부분의 스마트폰에 적합한 버전입니다. 기기의 운영체제가 64비트 앱을 지원하는지도 확인하세요.
v2rayNG는 Xray 코어를 사용합니다. 설정을 가져온 뒤 서버를 선택하고 연결을 시작하세요. 시스템에서 VPN 연결을 요청하면 내용을 확인하고 권한을 허용하세요. 키 또는 VPN 아이콘이 표시되어도 연결 서비스가 시작된 것일 뿐이므로, 실제로 앱에서 접속되는지 확인해야 합니다.
v2flyNG
1.10.31
대안V2Fly 코어
arm64-v8a
arm64 버전
arm64 앱을 지원하는 기기용입니다. 설정에서 V2Fly 코어가 필요하다면 해당 설정 항목이 현재 버전과 호환되는지 먼저 확인하세요.
v2flyNG는 V2Fly 코어를 사용하는 그래픽 클라이언트 대안입니다. v2rayNG와 설정 지원 범위가 완전히 같지 않으므로 프로토콜, 전송 방식, 보안 설정을 특히 확인하세요. 설정을 점검하지 않고 클라이언트만 바꾸면 문제가 해결된다고 단정할 수 없습니다.
Android 시스템 및 설치 준비
확인 항목
선택 및 요구 사항
사용 안내
앱 아키텍처
arm64 파일은 arm64-v8a를 지원하는 기기에서 사용할 수 있습니다. 확실하지 않다면 범용 버전을 선택하세요.
프로세서가 64비트여도 시스템에서 동일한 앱 실행 환경을 제공한다는 뜻은 아닙니다.
시스템 버전
시스템 버전은 현재 APK의 최소 요구 사항을 충족해야 합니다. 설치 프로그램의 안내를 확인하세요.
범용 패키지는 지원 아키텍처를 늘릴 뿐, 앱의 최소 시스템 버전을 낮추지는 않습니다.
설치 권한
APK를 여는 브라우저나 파일 관리자에 해당 설치 출처의 앱 설치를 허용해야 합니다.
이번 설치에 실제로 사용할 출처에만 권한을 허용하고, 완료 후 필요에 따라 취소하세요.
연결 및 백그라운드 실행
연결에는 VpnService 권한이 필요합니다. 백그라운드에서 계속 실행할 수 있는지는 시스템 배터리 정책의 영향을 받습니다.
다른 VPN 앱과 동시에 연결하지 말고, 필요한 경우 배터리 최적화 설정을 조정하세요.
설치 프로그램에 ‘앱이 설치되지 않았습니다’라고 표시되어도 기존 앱을 바로 삭제하지 마세요. 먼저 다운로드가 완료됐는지, 저장 공간이 충분한지, 아키텍처와 시스템 버전이 맞는지 확인하세요. 그런 다음 설치된 앱과 새 패키지가 호환되는 서명 경로에서 제공됐는지 살펴보세요. 재설치하기 전에 보관할 설정을 백업하세요.
화면을 잠근 뒤 연결이 끊긴다면 설치 파일을 다시 받기보다 배터리 최적화, 백그라운드 활동, 시스템 정리 정책을 확인하세요. 일부 앱만 프록시를 사용하게 하려면 클라이언트의 앱별 설정을 살펴보고, ‘선택한 앱만 프록시 사용’과 ‘선택한 앱 우회’ 중 어느 모드인지 확인하세요.
04 / DESKTOP
Linux 다운로드
먼저 배포판에 맞춰 deb 또는 rpm을 선택하고 x64 / arm64를 확인하세요. 아래 설치 파일은 모두 v2rayN 그래픽 데스크톱 앱입니다.
v2rayN
7.24.1
Linux 데스크톱 클라이언트
deb · x64
Debian / Ubuntu 계열
deb 패키지 관리 방식을 사용하는 호환 배포판용입니다. 일반적인 Intel / AMD 64비트 컴퓨터라면 x64를 선택하세요.
다운로드한 패키지를 배포판의 소프트웨어 설치 프로그램으로 열고, 종속성 및 호환성 안내를 확인한 뒤 설치하세요. RPM 파일 이름에 배포판 표시가 있다고 해서 모든 RPM 시스템과 호환되는 것은 아닙니다. 종속성 충돌이 발생하면 무시하고 설치를 강행하지 마세요.
Linux 시스템 및 설치 준비
확인 항목
선택 및 요구 사항
확인 위치
패키지 관리 방식
Debian / Ubuntu 계열은 보통 deb를, RPM 계열은 rpm을 선택하세요. 사용하는 배포판과의 호환성도 확인해야 합니다.
시스템 정보, 소프트웨어 관리자 및 배포판 버전 정보
CPU 아키텍처
x64는 amd64 / x86_64에 해당하고, arm64는 aarch64에 해당합니다.
시스템 설정의 정보 또는 하드웨어 정보 페이지
실행 환경
그래픽 데스크톱 환경과 현재 패키지에 필요한 런타임 라이브러리가 필요합니다.
소프트웨어 설치 프로그램으로 종속성을 확인한 뒤 앱 메뉴에서 실행하세요.
프록시 연결
데스크톱 프록시 설정의 지원 여부는 데스크톱 환경과 앱에 따라 다릅니다.
시스템 네트워크 설정과 앱 자체의 프록시 설정을 확인하세요.
Linux에서 아키텍처 이름은 혼동하기 쉽습니다. amd64는 특정 CPU 제조사에 한정되지 않으며 일반적으로 x86 64비트 아키텍처를 가리킵니다. aarch64는 ARM 64비트에 해당합니다. 패키지 형식과 CPU 아키텍처는 서로 별개의 조건이므로, 배포판이 deb를 사용한다는 이유만으로 아무 deb 파일이나 선택하면 안 됩니다.
설치한 뒤 그래픽 클라이언트를 실행해 설정을 읽을 수 있는지와 포트가 수신 대기 중인지 확인한 다음 앱 프록시를 설정하세요. 데스크톱 시스템 프록시와 터미널 환경 변수는 서로 다른 연결 경로입니다. 브라우저가 연결된다고 해서 터미널 명령도 같은 경로를 자동으로 사용하는 것은 아닙니다.
BEFORE FIRST RUN
설치 전후 확인 순서
설치 프로그램, 연결 설정, 앱 프록시는 서로 다른 단계입니다.
기기를 확인한 뒤 기존 설정을 저장하세요
설치 실패 후 여러 파일을 번갈아 시도하지 않도록 시스템, 아키텍처, 설치 파일 형식을 먼저 확인하세요. 기존 클라이언트를 업그레이드하기 전에는 보관할 구독 그룹, 서버 항목, 라우팅 규칙, 사용자 설정을 앱에서 백업하세요. 클라이언트나 인터페이스 버전이 달라지면 모든 설정을 그대로 옮길 수 있는 것은 아닙니다. 사용자 지정 JSON을 사용한다면 별도 사본을 특히 잘 보관하세요.
유효한 구독 또는 설정 파일 가져오기
이 페이지에서 제공하는 것은 클라이언트 프로그램이며, 설치를 마쳐도 연결을 바로 사용할 수 있는 것은 아닙니다. 사용할 권한이 있는 구독 주소, 공유 링크 또는 설정 파일을 준비한 뒤 클라이언트 메뉴에서 가져오세요. 구독 업데이트에 실패하면 주소가 온전히 입력되었는지, 아직 유효한지, 업데이트 요청이 어떤 네트워크 경로를 사용하는지 먼저 확인하세요. 같은 주소를 여러 그룹에 연달아 가져오면 나중에 문제를 찾기 어려워집니다.
한 번에 하나의 연결 경로만 확인하세요
데스크톱에서는 먼저 서버를 선택하고 로컬 포트가 수신 중인지 확인한 다음 시스템 프록시를 설정하세요. Android에서는 연결 권한을 허용한 뒤 프록시를 사용할 앱에서 접속을 확인하세요. 문제를 해결할 때는 한 번에 한 가지 설정만 바꾸고 변경 전후 상태를 기록하세요. 로그의 연결 거부, 시간 초과, 설정 구문 분석 오류는 서로 다른 단계에서 발생하므로 모두 설치 파일 문제로 볼 수는 없습니다.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 적용한 데스크톱 버전을 권장합니다. 클래식 WPF 버전은 기존 Windows 인터페이스에 익숙한 사용자를 위한 안정적인 버전입니다. 두 버전 모두 유효한 설정을 가져와야 합니다. 두 클라이언트의 로컬 포트 수신과 시스템 프록시를 동시에 활성화하지 마세요.
Android에서는 arm64와 범용 버전 중 무엇을 다운로드해야 하나요?
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 단, 최종적으로는 기기에서 지원하는 앱 ABI를 확인하세요. 아키텍처를 모른다면 여러 아키텍처를 지원하는 범용 버전을 선택할 수 있지만, 파일 크기가 더 클 수 있습니다. 설치할 수 없다는 메시지가 표시되면 시스템 호환성, 다운로드 완료 여부, 기존 앱과의 서명 일치 여부도 확인하세요.
v2rayNG와 v2flyNG의 차이는 무엇인가요?
v2rayNG는 Xray 코어를 사용하는 이 페이지의 Android 권장 클라이언트입니다. v2flyNG는 설정에 따라 선택할 수 있는 V2Fly 코어 기반 대안입니다. 두 앱이 지원하는 설정 항목과 기능은 완전히 같지 않습니다. 기존 설정에서 필요한 코어를 확인한 다음 클라이언트를 선택하세요.
macOS에서는 Apple Silicon과 Intel 중 무엇을 선택해야 하나요?
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon을, 프로세서 항목에 Intel이 표시되면 Intel 버전을 선택하세요. 설치 파일은 Mac의 아키텍처에 맞아야 합니다. 외관이나 구입 연도만으로 판단하지 마세요.
Linux에서 deb, rpm, arm64 설치 파일은 어떻게 선택하나요?
먼저 배포판의 패키지 관리 방식에 맞춰 선택하세요. Debian, Ubuntu 및 호환 배포판은 보통 deb를 사용하고, Fedora 등 RPM 패키지 관리 배포판은 보통 rpm을 사용합니다. 그런 다음 CPU에 맞춰 x64 또는 arm64를 고르세요. 패키지 형식이 같아도 모든 배포판 버전과 호환되는 것은 아니므로 패키지 관리자가 안내하는 종속성도 확인해야 합니다.
설치했는데도 바로 연결할 수 없는 이유는 무엇인가요?
클라이언트는 설정을 읽고 연결을 구성하는 프로그램이며, 설치만으로 서버나 구독이 제공되지는 않습니다. 사용할 권한이 있는 유효한 설정을 가져와 서버를 선택한 뒤, 데스크톱에서는 시스템 프록시를 설정하고 Android에서는 VPN 연결을 허용해야 합니다. 그래도 연결되지 않으면 설정 유효성, 로컬 포트, 프록시 모드, 로그 순으로 확인하세요.