v2rayN · 설정 예시
설치 후 설정을 가져오고 프록시 적용 방식을 지정하세요.
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 운영체제를 확인한 뒤 프로세서 아키텍처에 맞는 파일을 다운로드하세요.
설치 파일에는 연결 설정이 포함되어 있지 않습니다. 처음 사용하는 경우 사용 가이드를 참고하세요.
플랫폼 선택은 주소 표시줄의 앵커와 동기화됩니다. 플랫폼을 바꾸면 해당 운영체제의 설치 경로와 요구 사항을 확인하세요.
데스크톱 버전은 차세대 크로스 플랫폼 UI를 사용하며, WPF 버전은 클래식 Windows 인터페이스를 유지하는 안정적인 선택입니다. 두 다운로드 항목은 모두 x64 설치용 압축 파일입니다.
처음 사용하거나 크로스 플랫폼 인터페이스를 선호한다면 선택하세요. 다운로드한 파일의 압축을 푼 뒤, 폴더 안의 설치 프로그램을 실행하세요.
클래식 메뉴와 설정 경로에 익숙한 사용자에게 적합합니다. 인터페이스 버전을 바꾸기 전에 기존 설정과 구독 그룹을 저장하세요.
v2rayN-Desktop-Setup-x64-7.24.1.zip
| 확인 항목 | 선택 기준 |
|---|---|
| 프로세서 아키텍처 | 이 페이지의 두 다운로드 항목은 모두 x64입니다. 시스템의 ‘정보’에서 시스템 종류를 확인하세요. x64 패키지를 다른 아키텍처용 설치 파일로 사용하면 안 됩니다. |
| 운영체제 및 실행 환경 | 지원 기간이 끝나지 않은 Windows를 사용하는 것이 좋습니다. 최소 운영체제 버전과 실행 환경은 선택한 배포 파일의 안내 및 설치 메시지를 확인하세요. |
| 파일 형식 | ZIP은 설치용 압축 파일입니다. 쓰기 가능한 폴더에 압축을 모두 푼 다음 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요. |
| 네트워크 트래픽 처리 | 일반적인 앱에서는 먼저 시스템 프록시를 사용하세요. TUN이 필요하다면 클라이언트 안내에 따라 필요한 권한과 구성 요소를 준비하세요. |
처음 실행한 뒤 인터페이스가 정상적으로 열리는지 확인하고 구독 주소나 공유 링크를 가져오세요. 가져온 설정이 목록에 표시되더라도 실제로 사용할 항목을 선택해야 합니다. 다음으로 시스템 프록시와 라우팅 모드를 설정하세요. 시스템 프록시는 앱의 요청을 클라이언트로 보낼지 결정하고, 라우팅은 클라이언트로 전달된 요청을 어떻게 분배할지 결정합니다. 두 설정은 서로 다른 기능이며, 설치에 성공했다고 연결까지 성공한 것은 아닙니다.
기존 설치를 업데이트할 때는 트레이에서 실행 중인 이전 프로세스를 종료해 두 인스턴스가 로컬 수신 포트를 놓고 충돌하지 않도록 하세요. 사용자 지정 라우팅, DNS 또는 설정 파일을 사용하는 경우 업데이트 전에 별도로 저장하세요. 데스크톱 버전과 WPF 버전은 메뉴 위치가 다를 수 있습니다. 전환할 때는 기능 이름으로 메뉴를 찾고, 예전 화면을 보고 무작정 항목을 클릭하지 마세요. 실행에 문제가 있으면 오류 창의 문구를 기록한 뒤 문제 해결 안내를 참고하세요.
시스템 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple 칩이 표시되면 Apple Silicon을, Intel 프로세서가 표시되면 Intel을 선택하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 칩 종류 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. ‘이 Mac에 관하여’에 표시된 정보를 기준으로 선택하세요. |
| 운영체제 버전 | 현재 macOS가 배포 파일의 요구 사항을 충족하는지 확인하세요. 구형 시스템에서 호환성 안내가 표시되더라도 파일 이름을 바꿔 우회하지 마세요. |
| 설치 형식 | DMG를 연 다음 디스크 이미지의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기고, 해당 폴더에서 실행하세요. |
| 권한 범위 | 시스템 프록시를 변경하거나 TUN을 활성화할 때 시스템 권한이 필요할 수 있습니다. 필요한 기능에만 권한을 허용하세요. |
설치 후에는 마운트된 디스크 이미지에서 앱을 계속 실행하지 마세요. 앱을 고정된 위치에 두면 업데이트 경로와 권한 설정을 일관되게 유지할 수 있습니다. 처음 실행할 때 시스템이 앱을 차단하면 다운로드 출처, 선택한 아키텍처, 시스템 안내를 먼저 확인한 뒤 시스템 설정에서 관련 설명을 살펴보세요. 앱을 실행하려고 시스템 보안 기능 전체를 끄지 마세요. 현재 시스템에서 앱을 사용할 수 없다는 안내가 표시되면 버전 요구 사항과 칩 호환성을 확인하세요.
데스크톱 클라이언트에서 설정을 가져와도 모든 앱이 시스템 프록시를 사용하는 것은 아닙니다. 브라우저는 대개 시스템 설정을 따르지만, 일부 터미널 도구나 앱에는 별도의 프록시 설정이 있습니다. 설정을 마친 뒤 시스템 프록시를 따르는 앱 하나로 먼저 확인하고 다른 소프트웨어를 점검하세요. 더 많은 트래픽을 처리해야 한다면 TUN 권한과 라우팅 설정을 확인하세요. 여러 트래픽 처리 방식을 동시에 적용하면 문제를 찾기 어려워질 수 있습니다.
Xray 코어를 사용합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 아키텍처를 확인하기 어렵거나 호환되지 않는다는 안내가 표시되면 범용 버전을 선택할 수 있습니다.
V2Fly 코어를 사용하며, 기존 설정이 해당 코어와 호환되는 경우 선택할 수 있습니다. 클라이언트 이름이 비슷하다고 프로토콜 기능까지 완전히 같다고 볼 수는 없습니다.
아키텍처 선택이 확실하지 않을 때 사용할 수 있는 대안입니다. 코어의 프로토콜 지원 범위가 넓어지는 것은 아닙니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 실행 아키텍처 | arm64 패키지를 사용하려면 기기의 운영체제가 해당 실행 환경을 지원해야 합니다. 프로세서 모델만으로 판단할 수 없습니다. |
| 운영체제 버전 | 최소 Android 버전은 설치 파일의 요구 사항을 확인하세요. 범용 버전은 아키텍처 선택 문제를 해결하지만, 운영체제 버전이 너무 오래된 문제까지 해결하지는 않습니다. |
| 설치 권한 | 시스템에서 요구하면 앱을 설치할 때 사용하는 브라우저나 파일 관리자에 설치 권한을 허용하세요. 설치가 끝난 뒤 권한을 해제할 수 있습니다. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 권한을 확인하세요. 다른 앱이 같은 VPN 트래픽 처리 경로를 이미 사용 중인지도 살펴보세요. |
설치 화면에 ‘앱이 설치되지 않았습니다’라는 안내가 표시되면 먼저 아키텍처 불일치, 시스템 버전 미지원, 서명 불일치, 다운그레이드 제한 등의 원인을 구분하세요. 같은 이름의 앱이 이미 설치되어 있다면 해결을 위해 바로 삭제하지 마세요. 보관할 내용을 먼저 내보낸 뒤 설치 출처를 바꿔야 하는지 판단하세요. 앱을 삭제하면 로컬 설정이 사라질 수 있으며, 재설치해도 백업하지 않은 사용자 설정은 복구되지 않습니다.
설치가 완료되면 구독 그룹 설정에서 사용 권한이 있는 주소를 추가해 업데이트하거나 클립보드에서 공유 링크를 가져오세요. 연결하기 전에 사용할 설정이 선택되어 있는지 확인하세요. 처음 연결할 때 시스템 VPN 권한 허용과 구독 가져오기는 별개의 단계입니다. 일부 앱만 프록시를 사용하도록 하려면 설치 파일을 계속 바꾸기보다 앱별 프록시 설정을 확인하세요. 백그라운드에서 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 점검하세요.
v2rayNG와 v2flyNG 중 무엇을 선택할지는 이름의 길이나 설치 파일 크기가 아니라 설정 호환성을 기준으로 판단해야 합니다. REALITY 등의 설정을 사용한다면 프로토콜과 코어 지원 여부를 먼저 확인하세요. 같은 구독이라도 두 앱에서 같은 결과를 얻는다고 가정하지 마세요. 자세한 내용은 코어 선택 가이드를, 처음 설정을 가져오고 권한을 허용하는 방법은 Android 사용 가이드를 참고하세요.
먼저 배포판에 맞는 deb 또는 rpm을 고르고 x64와 arm64 중 기기에 맞는 아키텍처를 확인하세요. 아래 기본 다운로드는 x64 패키지이며 다른 아키텍처용 링크는 버튼 아래에 있습니다.
deb 패키지 관리 방식을 사용하고 필요한 의존성을 충족하는 배포판에 적합합니다.
arm64 기기: deb 패키지 다운로드 →rpm 패키지 관리 방식을 사용하고 해당 패키지의 의존성을 충족하는 배포판에 적합합니다.
arm64 기기: rpm 패키지 다운로드 →| 확인 항목 | 선택 기준 |
|---|---|
| 패키지 형식 | 배포판의 패키지 관리자에 맞춰 deb 또는 rpm을 선택하세요. 파일 확장자를 바꿔 서로 변환할 수 없습니다. |
| 아키텍처 표기 | amd64와 x86_64는 x64에, arm64와 aarch64는 ARM 64비트 아키텍처에 해당합니다. |
| 시스템 의존성 | 패키지 형식이 같아도 모든 배포판에 설치할 수 있는 것은 아닙니다. 시스템 라이브러리 버전과 의존성이 해당 패키지의 요구 사항을 충족해야 합니다. |
| 데스크톱 환경 | 이 페이지는 그래픽 클라이언트를 제공합니다. 설치 후 데스크톱 앱 메뉴에서 실행하고 필요에 따라 시스템 프록시와 권한을 설정하세요. |
다운로드하기 전에 시스템 설정의 ‘정보’ 페이지에서 배포판과 하드웨어 정보를 확인할 수 있습니다. 설치할 때는 시스템 패키지 관리자를 사용하고 의존성 안내를 읽으세요. 시스템 라이브러리가 없거나 기본 구성 요소를 업데이트해야 한다는 안내가 표시되면 패키지와 배포판이 맞는지 먼저 확인하고 의존성 문제를 무시하지 마세요. rpm 파일 이름에 표시된 배포 대상 정보도 실제 시스템에 맞는지 확인해야 합니다. rpm 형식이라고 해서 모든 시스템과 호환되는 것은 아닙니다.
클라이언트를 실행한 다음 구독을 가져오고 설정을 선택한 뒤 현재 데스크톱 환경이 시스템 프록시를 사용하는지 확인하세요. 앱마다 프록시 환경과 데스크톱 설정을 지원하는 방식이 다릅니다. 브라우저에서는 연결되지만 다른 앱에서는 연결되지 않는다면 해당 앱의 프록시 설정을 살펴보세요. TUN으로 트래픽을 처리해야 할 때 권한과 라우팅을 설정하세요. 권한 오류, 설정 오류, 앱의 프록시 미사용을 하나의 문제로 혼동하지 않도록 합니다.
먼저 프로그램이 실행되는지 확인한 뒤 설정과 네트워크 트래픽 처리를 점검하세요. 서로 다른 단계의 문제를 혼동하지 않는 것이 좋습니다.
다운로드 요청이 완료되지 않았다면 먼저 브라우저의 다운로드 기록을 확인해 요청 실패, 다운로드 일시 중지, 다른 폴더에 저장된 경우를 구분하세요. 파일은 다운로드됐지만 설치할 수 없다면 아키텍처, 시스템 호환성, 설치 권한을 확인하세요. 프로그램은 실행되지만 연결되지 않는다면 설정, 시스템 프록시, DNS를 점검하세요. 단계별로 원인을 찾으면 여러 패키지를 반복해서 다운로드하는 것보다 유용한 단서를 더 잘 보존할 수 있습니다.
구독 업데이트 실패가 반드시 클라이언트 설치 문제를 뜻하는 것은 아닙니다. 주소가 완전하고 유효한지, 업데이트 요청이 어떤 네트워크 경로를 사용하는지 먼저 확인한 뒤 설정 호환성을 살펴보세요. 자세한 절차는 구독 업데이트 실패 문제 해결을 참고하세요. 로그나 스크린샷을 공유하기 전에 구독 주소, 접속 자격 증명, 기타 개인 정보를 가리세요.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 데스크톱 버전을 선택할 수 있습니다. 기존 Windows 인터페이스와 사용 방식에 익숙하다면 안정적인 클래식 WPF 버전이 적합합니다. 두 버전 모두 v2rayN입니다. 전환하기 전에 설정을 백업하고, 두 인스턴스가 같은 로컬 수신 포트를 동시에 사용하지 않도록 하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 다만 프로세서가 64비트를 지원해도 운영체제가 64비트 실행 환경을 제공한다는 뜻은 아닙니다. 먼저 기기의 아키텍처를 확인하세요. 확인하기 어렵거나 arm64 패키지에서 아키텍처 비호환 안내가 표시되면 범용 버전을 시도할 수 있습니다. 범용 버전도 모든 Android 버전과 호환되는 것은 아닙니다.
v2rayNG는 Xray 코어를 사용하며, 이 페이지에서 우선 추천하는 Android 클라이언트입니다. v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 설정 호환 여부는 프로토콜, 전송 방식, 코어 지원 여부에 따라 달라지므로 구독 주소가 같다는 이유만으로 호환된다고 판단할 수 없습니다. REALITY 설정을 사용한다면 선택한 클라이언트의 프로토콜 지원 여부를 먼저 확인하세요.
설치 파일에는 클라이언트 프로그램만 포함되어 있으며 연결 서비스나 사용할 수 있는 설정은 제공되지 않습니다. 사용 권한이 있는 구독 주소나 공유 링크를 준비해 가져온 뒤, 설정을 선택하고 시스템 프록시를 지정하거나 VPN 연결을 허용하세요. 라우팅 모드도 확인해야 합니다.
버전 표기와 아키텍처별 파일 경로는 목록의 서로 다른 항목에서 가져오므로 업데이트 시점이 일치하지 않을 수 있습니다. 다운로드 버튼에 연결된 설치 파일을 기준으로 선택하고, 설치 후 클라이언트에서 실제 버전을 확인하세요. 이 페이지는 버전 표기를 바탕으로 파일 경로를 다시 만들지 않습니다.
먼저 구독 그룹, 라우팅 규칙, 사용자 설정을 백업한 다음 실행 중인 클라이언트를 종료하세요. 업데이트할 때는 앱, 아키텍처, 설치 방식을 동일하게 유지하세요. 인터페이스 버전이나 코어를 바꿔 마이그레이션하는 경우 필요한 항목을 먼저 내보내고, 새 클라이언트에서 읽을 수 있는지 확인한 뒤 기존 설치를 정리하세요.