클라이언트 설치 파일
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 먼저 운영체제를 확인하고 칩 아키텍처를 살펴보세요. 설치 파일 형식과 설정에 지정된 프로토콜 종류는 서로 다른 항목입니다.
01운영체제 선택
02아키텍처 확인
03설치 후 설정 가져오기
차세대 크로스 플랫폼 UI로, 처음 설치하는 사용자나 여러 데스크톱 운영체제에서 비슷한 사용 방식을 원하는 사용자에게 적합합니다. ZIP 파일을 다운로드한 뒤 먼저 전체 압축을 풀고, 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요.
Windows WPF 인터페이스를 유지하는 안정적인 클래식 버전으로, 기존 메뉴와 사용 방식에 익숙한 사용자에게 적합합니다. Desktop 버전과의 차이는 주로 인터페이스 구현과 배치에 있으며, 프록시 프로토콜이 다른 것은 아닙니다. 특정 노드 유형을 사용하기 위해 인터페이스를 바꿀 필요는 없습니다.
| 확인 항목 | 선택 기준 | 사용 안내 |
|---|---|---|
| 시스템 아키텍처 | 현재 제공되는 설치 파일은 x64입니다 | 설정 → 시스템 → 정보에서 시스템 종류를 확인하세요. |
| 시스템 및 실행 환경 | 선택한 배포 패키지의 시스템 및 런타임 요구 사항을 충족해야 합니다 | 설치 프로그램에서 런타임 구성 요소가 없다고 표시되면 안내에 따라 설치하세요. 오래된 시스템에서는 호환성부터 확인하세요. |
| 설치 경로 | 현재 계정에서 정상적으로 접근할 수 있는 위치 | 압축을 풀 때 폴더 구조를 유지하세요. 실행 파일 하나만 따로 옮기지 마세요. |
| 설정 가져오기 | 구독 그룹 또는 공유 링크 가져오기 | 가져온 뒤 서버를 선택하고 시스템 프록시와 라우팅 설정을 확인하세요. |
처음 실행한 뒤 설정에서 로컬 수신 포트를 확인하고 시스템 프록시를 켤지 결정하세요. 브라우저는 대체로 시스템 프록시 설정을 따르지만, 자체 네트워크 설정을 사용하는 앱은 프록시를 별도로 지정해야 할 수 있습니다. 프로그램이 실행 중이라는 사실만으로 모든 앱이 프록시에 연결됐다고 판단하지 마세요.
기존 설치를 업데이트할 때는 트레이 메뉴에서 이전 프로세스를 먼저 종료하세요. 기본 창을 닫아도 클라이언트가 트레이로 최소화될 뿐, 이전 프로세스가 포트를 계속 점유할 수 있습니다. 새 프로그램이 수신 대기할 수 없다는 알림이 표시되면 중복 실행부터 확인하세요. 구독과 라우팅을 동시에 바꿀 필요는 없습니다.
Apple M 시리즈 칩을 탑재한 Mac용이며, 설치 파일은 arm64 아키텍처입니다. Apple 메뉴 → 이 Mac에 관하여에서 칩 항목을 확인하세요. M 시리즈가 표시되면 해당 네이티브 아키텍처 버전을 선택하면 됩니다. 다른 컴퓨터와 버전을 맞추려고 Intel 파일을 선택할 필요는 없습니다.
Intel 프로세서를 탑재한 Mac용이며, 설치 파일은 x64 아키텍처입니다. 기기 외관이나 구매 연도만으로 판단하지 말고 이 Mac에 관하여에 표시된 프로세서 정보를 확인하세요. 아키텍처를 확인한 뒤 현재 앱의 요구 사항에 맞는 시스템 버전인지도 확인해야 합니다.
| 확인 항목 | 선택 기준 | 사용 안내 |
|---|---|---|
| 칩 | Apple M 시리즈는 arm64, Intel은 x64 선택 | Apple 메뉴 → 이 Mac에 관하여에서 칩 또는 프로세서를 확인하세요. |
| 시스템 버전 | 현재 배포 패키지에 명시된 최소 요구 사항 충족 | 칩이 맞더라도 오래된 시스템에서 최신 릴리스가 실행된다는 보장은 없습니다. |
| 설치 파일 형식 | DMG 디스크 이미지 | 안내에 따라 앱을 복사하고, 마운트된 이미지에서 계속 실행하지 마세요. |
| 네트워크 설정 | 사용 방식에 필요한 네트워크 변경 권한 허용 | 시스템 프록시를 처음 설정한 뒤 시스템 네트워크 설정에서 적용 여부를 확인하세요. |
시스템에서 처음 실행을 차단하면 다운로드 출처와 앱 이름을 확인한 뒤 시스템 설정 → 개인정보 보호 및 보안에 표시된 안내를 살펴보세요. 클라이언트 하나를 실행하기 위해 시스템 보안 기능을 전역으로 끄거나 출처가 불분명한 터미널 명령을 그대로 사용하지 마세요. 시스템이 오래된 문제, 아키텍처 불일치, 실행 권한 문제는 각각 구분해 해결해야 합니다.
설치한 뒤 먼저 구독을 가져오고 서버를 선택한 다음 필요한 프록시 모드를 켜세요. 네트워크를 바꾸거나 클라이언트를 종료한 뒤 브라우저가 연결되지 않는다면 시스템 네트워크 설정에 로컬 포트를 가리키는 프록시 항목이 남아 있는지 확인하세요. 더 이상 사용하지 않는 프록시 설정만 지우면 됩니다. 클라이언트 설정 전체를 먼저 삭제할 필요는 없습니다.
2015년 이후 출시된 대부분의 스마트폰에서 우선 선택할 수 있습니다. 단, 시스템이 arm64-v8a 앱을 지원해야 합니다. Xray 코어를 사용하며 해당 프로토콜 기능이 필요한 설정에 적합합니다. 설정을 가져와 연결할 수 있는지는 클라이언트 버전과 서버 매개변수의 호환 여부에 따라 달라집니다.
여러 아키텍처를 포함하므로 기기 아키텍처가 불분명하거나 다른 지원 아키텍처가 필요한 경우에 적합합니다. 범용 버전이라고 해서 시스템 요구 사항이 낮아지거나 모든 설치 오류가 해결되는 것은 아닙니다. 시스템 버전, 여유 공간, 기존 앱의 서명을 각각 확인하세요.
arm64 앱을 지원하는 기기용으로, 기존 V2Fly 설정과 사용 방식에 맞는 대안입니다. v2fly와 Xray의 기능은 완전히 같지 않습니다. 공유 링크의 모양이 비슷하다는 이유만으로 모든 보안 계층과 전송 매개변수를 그대로 사용할 수 있다고 판단하지 마세요.
아키텍처가 불분명하거나 다른 지원 기기 환경에서 사용할 수 있습니다. 클라이언트를 선택할 때는 먼저 설정에 필요한 코어 기능을 확인한 다음 설치 파일 아키텍처를 선택하세요. Xray 전용 기능이 필요한 설정에는 호환되는 클라이언트를 사용해야 합니다. 같은 앱의 설치 파일만 계속 바꿔도 해결되지 않습니다.
| 확인 항목 | 선택 기준 | 사용 안내 |
|---|---|---|
| 앱 아키텍처 | arm64 또는 범용 APK | 프로세서 모델만 보지 말고 시스템에서 지원하는 ABI를 확인하세요. |
| 시스템 호환성 | 현재 APK의 최소 시스템 요구 사항 충족 | 설치 파일을 파싱하지 못하면 시스템 버전, 다운로드 상태, 저장 공간을 확인하세요. |
| 설치 권한 | 시스템 안내에 따라 현재 출처의 앱 설치를 허용하세요 | 실제로 사용하는 브라우저나 파일 관리자에 필요한 권한만 부여하세요. |
| 연결 권한 | 처음 연결할 때 VPN 요청을 확인해야 합니다 | 다른 VPN 앱이 실행 중이면 연결이 충돌할 수 있습니다. |
설치가 끝나면 공유 링크나 구독 주소를 가져오고, 갱신 후 설정 항목을 선택한 다음 연결을 누르세요. 시스템에서 표시하는 VPN 권한 요청은 로컬 트래픽 경로를 만드는 권한이며, 원격 서버 연결이 검증됐다는 뜻은 아닙니다. 연결 아이콘이 표시된 뒤에도 실제로 접속해 라우팅, DNS, 외부 연결 설정이 정상인지 확인해야 합니다.
화면을 잠근 뒤 앱 연결이 자주 끊긴다면 시스템의 배터리 최적화 및 백그라운드 실행 설정을 확인하고 필요한 경우 백그라운드 활동을 허용하세요. 처음부터 모든 권한을 한꺼번에 허용하지 말고 문제가 백그라운드 제한과 관련 있는지 확인한 뒤 하나씩 조정하세요. 다른 클라이언트로 옮기기 전에 구독 주소와 필요한 사용자 설정을 저장하세요.
deb를 기본 패키지 형식으로 사용하고 의존성 요구 사항을 충족하는 배포판에서 사용할 수 있습니다. 예를 들어 호환되는 Debian 및 Ubuntu 환경이 해당됩니다. 파일 이름의 amd64는 일반적인 x64 아키텍처를 뜻하며, 이에 맞는 Intel 64비트 PC에서도 사용할 수 있습니다. AMD 프로세서 전용이 아닙니다.
RPM 패키지 관리 방식을 사용하고 이 패키지의 의존성 요구 사항을 충족하는 배포판용입니다. 현재 파일 이름에는 el10 빌드 표시가 포함되어 있으므로 설치 전에 대상 배포판과 런타임 요구 사항을 확인하세요. 파일 확장자가 같다는 이유만으로 모든 RPM 시스템에서 사용할 수 있는 것은 아닙니다.
| 확인 항목 | 선택 기준 | 사용 안내 |
|---|---|---|
| 패키지 형식 | 배포판이 기본 지원하는 deb 또는 rpm | 의존성 관리는 우선 시스템 소프트웨어 설치 프로그램을 사용하세요. |
| 프로세서 아키텍처 | x64는 amd64 / x86_64, arm64는 aarch64에 해당 | 시스템 정보에서 아키텍처를 확인하고 다른 아키텍처의 패키지를 섞어 설치하지 마세요. |
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션 | 트레이 및 시스템 프록시 연동 방식은 데스크톱 환경에 따라 다를 수 있습니다. |
| 배포판 의존성 | 설치 파일이 요구하는 런타임 라이브러리 버전 충족 | 의존성 오류가 발생하면 누락된 항목을 먼저 확인하세요. 의존성 설치를 강제로 건너뛰지 마세요. |
파일 관리자에서 설치 파일을 열고 배포판의 소프트웨어 설치 프로그램으로 설치하세요. 의존성을 충족할 수 없다는 안내가 나오면 현재 배포판 버전이 패키지의 빌드 대상에 맞는지 먼저 확인하세요. 패키지 형식을 바꿔도 기본 런타임 라이브러리가 오래된 문제는 해결되지 않는 경우가 많습니다. 클라이언트 하나를 위해 다른 배포판의 소프트웨어 저장소를 섞어 쓰는 것도 권장하지 않습니다.
설치 후 시스템 프록시 설정을 앱에서 사용하는지는 데스크톱 환경과 앱 자체 구현에 따라 달라집니다. 먼저 브라우저에서 확인한 다음 시스템 프록시를 따르지 않는 프로그램은 별도 설정이 필요한지 살펴보세요. 클라이언트를 종료하기 전에 더 이상 사용하지 않는 프록시 설정을 지우세요. 그렇지 않으면 로컬 수신이 중단된 뒤에도 앱이 이전 포트로 요청을 보낼 수 있습니다.
설치 후 설정
먼저 운영체제와 아키텍처를 확인하고 다운로드가 끝나면 시스템 설치 절차에 따라 파일을 여세요. 데스크톱에서는 이전 클라이언트를 먼저 종료하고, Android 업데이트에서는 기존 앱의 서명과 출처를 확인하세요. 새로 설치할 때와 기존 버전을 덮어쓸 때 표시되는 안내가 다를 수 있습니다. 오류가 발생하면 원문을 기록하고 설정을 바로 삭제하지 마세요.
클라이언트의 구독 그룹 관리에서 직접 확보했고 사용 권한이 있는 주소를 입력한 다음 저장하고 갱신하세요. 그룹 이름은 출처를 구분하기 위한 것이고 실제 요청 대상은 주소입니다. 구독 주소에는 접근 정보가 포함될 수 있으므로 화면을 공유하거나 도움을 요청할 때 전체 링크를 가리세요. 공개된 곳에 그대로 붙여넣지 마세요.
유효한 서버를 선택한 다음 데스크톱에서는 시스템 프록시를 설정하거나 Android에서는 연결 권한을 확인하세요. 실제 접속으로 결과를 확인하고 필요하면 로컬 포트, 라우팅, DNS, 시스템 시간을 차례로 점검하세요. 지연 시간 테스트는 참고 자료일 뿐, 실제 앱 접속 테스트를 대신할 수 없습니다.
v2rayN은 Windows, macOS, Linux 데스크톱 환경에서 구독 관리, 서버 선택, 라우팅 등을 그래픽 인터페이스로 설정하는 데 사용합니다. v2rayNG와 v2flyNG는 Android용이며 인터페이스 사용 방식은 비슷하지만 코어 기능은 구분해서 확인해야 합니다. 먼저 기기의 운영체제를 확인하고, 기존 설정에 필요한 기능을 살펴본 뒤 아키텍처와 설치 파일 형식을 선택하세요.
데스크톱에서 다른 인터페이스로 전환할 때 익숙하지 않은 데이터 디렉터리를 그대로 덮어쓰지 않는 것이 좋습니다. 먼저 클라이언트의 내보내기 기능으로 설정을 백업하고 사용자 지정 라우팅과 로컬 포트를 기록한 다음 새 설치에서 하나씩 복원하세요. 다시 가져올 수 있는 구독 설정과 직접 추가한 항목도 각각 보관해야 합니다.
Project V 생태계의 V2Fly와 Xray는 기술적 배경을 공유하지만 각기 다른 기능으로 발전해 왔습니다. VMess, VLESS 같은 이름은 설정의 일부일 뿐이며, 전송 방식과 보안 계층, 확장 매개변수도 호환성에 영향을 줍니다. 공유 링크를 인식했다고 해서 현재 코어가 모든 필드를 지원한다는 뜻은 아닙니다.
설정을 가져오는 데 성공했는데 연결이 되지 않는다면 설치 파일을 계속 바꾸기보다 서버 요구 사항과 클라이언트 로그를 먼저 확인하세요. REALITY, 전송 방식, 코어 차이를 알아보려면 프로토콜 안내서를 읽어 보세요. 인바운드, 아웃바운드, 라우팅 같은 용어가 낯설다면 용어집을 먼저 확인하세요.
설치 FAQ
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 권장합니다. 클래식 인터페이스에 익숙하거나 기존 사용 방식을 유지하고 싶다면 안정적인 WPF 버전을 선택하세요. 두 버전 모두 v2rayN이며, 현재 제공되는 설치 파일은 x64입니다. 전환하기 전에 설정을 내보내고 구독 정보를 저장하세요. 두 클라이언트가 동시에 시스템 프록시를 제어하지 않도록 주의하세요.
Apple 메뉴에서 이 Mac에 관하여를 여세요. 칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon 설치 파일을, 프로세서 항목에 Intel이 표시되면 Intel 설치 파일을 선택하세요. 칩 아키텍처와 운영체제 버전은 별개의 조건이므로 설치 전에 현재 시스템이 해당 릴리스의 요구 사항을 충족하는지 확인해야 합니다.
arm64 파일은 64비트 ARM 앱을 지원하는 기기용입니다. 2015년 이후 출시된 대부분의 스마트폰에서는 우선 이 버전을 선택할 수 있습니다. 범용 버전은 여러 아키텍처를 포함하므로 기기 아키텍처가 불분명하거나 다른 아키텍처가 필요한 경우에 적합합니다. 프로세서가 64비트를 지원해도 시스템에서 해당 앱 환경을 제공한다는 뜻은 아닙니다. 아키텍처 호환 오류가 표시되면 시스템이 지원하는 ABI를 확인하세요.
클라이언트는 설정과 연결을 위한 도구이며, 설치 파일에는 사용할 수 있는 서버나 구독이 포함되어 있지 않습니다. 직접 확보했고 사용 권한이 있는 설정을 가져온 뒤 구독을 갱신하고 유효한 항목을 선택하세요. 그런 다음 데스크톱의 시스템 프록시 또는 Android의 VPN 연결 권한을 확인해야 합니다. 클라이언트가 실행된다는 사실만으로 외부 연결 설정이 정상이라고 볼 수는 없습니다.
일반적으로 업데이트를 위해 설정을 미리 삭제할 필요는 없습니다. 다만 배포판, 설치 위치, 서명에 따라 이전 과정이 달라질 수 있습니다. 업데이트 전에 설정을 내보내고 구독 그룹, 라우팅, 로컬 포트를 기록한 다음 클라이언트를 완전히 종료하세요. Android에서 서명이 일치하지 않는다는 알림이 나오면 바로 삭제하지 말고 설치 출처와 백업 상태를 먼저 확인한 뒤 이전 방법을 결정하세요.
Debian, Ubuntu처럼 deb를 기본 패키지 형식으로 사용하는 배포판에서는 deb를 선택하세요. RPM을 기본 패키지 형식으로 사용하는 배포판에서는 rpm을 선택하고, 배포판 버전과 의존성도 확인해야 합니다. x64는 일반적인 Intel 또는 AMD 64비트 PC용이며 arm64는 해당 ARM 64비트 환경용입니다. 패키지 형식이 같아도 모든 배포판 버전과 호환되는 것은 아닙니다.