v2rayN 추천
데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용합니다. WPF는 익숙한 Windows 인터페이스와 조작 방식을 유지하는 클래식 안정 버전입니다. 둘 중 하나만 선택하면 됩니다.
설치 파일 및 시스템 요구 사항
먼저 운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장합니다. v2fly 코어 설정을 이미 사용 중이라면 v2flyNG를 고려해 보세요.
데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용합니다. WPF는 익숙한 Windows 인터페이스와 조작 방식을 유지하는 클래식 안정 버전입니다. 둘 중 하나만 선택하면 됩니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 시스템 종류 | 「설정 → 시스템 → 정보」에서 시스템 종류를 확인하세요. 이 페이지에서는 x64 설치 파일을 제공합니다. |
| 실행 환경 | .NET 데스크톱 런타임이 없다는 메시지가 표시되면 안내에 따라 필요한 버전과 아키텍처를 확인하세요. |
| 설치 권한 | 압축을 푼 다음 설치 프로그램을 실행하세요. 관리 대상 기기에서는 조직의 소프트웨어 설치 정책을 따라야 합니다. |
압축 파일의 미리 보기 창에서 프로그램을 바로 실행하지 마세요. 쓰기 권한이 있는 폴더에 압축을 푼 뒤 설치 프로그램을 실행하세요. 이렇게 하면 문제가 발생했을 때 압축 해제 오류, 런타임 누락, 설치 권한 부족을 구분하기도 쉽습니다.
데스크톱 버전과 WPF 버전 비교 →
「이 Mac에 관하여」에서 칩 또는 프로세서를 확인하세요. Apple 칩이면 arm64, Intel 프로세서이면 x64를 선택하세요. 두 파일 모두 디스크 이미지 설치 파일입니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 칩 아키텍처 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. |
| 시스템 호환성 | 칩 아키텍처가 맞아도 macOS 버전이 호환된다는 뜻은 아닙니다. 호환성 안내가 표시되면 빌드의 최소 시스템 요구 사항을 확인하세요. |
| 설치 위치 | DMG를 마운트한 다음 앱을 「응용 프로그램」 폴더로 복사하고 해당 폴더에서 실행하세요. |
업데이트하기 전에 실행 중인 앱을 종료한 뒤 새 앱으로 교체하세요. 시스템에서 실행을 차단하면 안내 내용을 먼저 확인하고, 시스템 버전 비호환, 다운로드 미완료, 조직의 보안 정책 중 무엇이 원인인지 구분하세요. 설치를 위해 시스템 보호 기능을 끄지 마세요.
Xray 코어를 사용합니다. 2015년 이후 출시된 일반적인 스마트폰이라면 먼저 arm64를 선택하세요. 기기가 32비트 시스템만 실행하거나 아키텍처를 확인하기 어렵다면 범용 버전을 선택하세요.
v2fly 코어를 사용합니다. 설정 안내에서 해당 코어를 명시적으로 요구하는 경우 이 클라이언트를 선택하세요. 이전하기 전에 프로토콜과 전송 설정을 확인하고, 구독을 가져올 수 있다는 이유만으로 설정이 호환된다고 판단하지 마세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 앱 아키텍처 | 시스템이 arm64-v8a를 지원하면 arm64를 선택하세요. 스마트폰에 64비트 칩이 탑재되어 있어도 시스템이 64비트 앱을 지원한다는 보장은 없습니다. |
| 설치 출처 | 시스템에서 권한을 요구하면 신뢰할 수 있는 현재 파일 관리자나 브라우저에만 앱 설치 권한을 임시로 허용하세요. |
| 연결 권한 | 시스템 VPN 권한은 처음 연결을 설정할 때 표시되며 설치 과정과는 별개입니다. 클라이언트를 바꾸기 전에 현재 연결을 끊으세요. |
Debian 및 Ubuntu 계열에서는 보통 DEB를 선택합니다. RPM을 사용하는 배포판은 빌드 대상과 의존성을 추가로 확인하세요. 이 페이지의 RPM 파일에는 el10이 표시되어 있습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 프로세서 아키텍처 | uname -m의 출력이 x86_64이면 x64를, aarch64이면 ARM 64비트 패키지를 선택하세요. |
| 패키지 형식 및 의존성 | 배포판의 패키지 관리자로 의존성을 확인하세요. 확장자가 같아도 다른 배포판에 설치할 수 있는 것은 아닙니다. |
| 실행 환경 | v2rayN은 그래픽 클라이언트입니다. 로컬 그래픽 세션에서 실행한 뒤 상태를 확인하세요. |
의존성 오류가 발생하면 메시지에 표시된 라이브러리 이름, 버전, 배포판 정보를 기록하세요. 다른 배포판용으로 빌드된 패키지를 강제로 설치하지 마세요. 검사를 무시해도 프로그램 실행에 필요한 라이브러리가 설치되는 것은 아닙니다.
플랫폼, 아키텍처, 패키지 형식에 따라 설치 가능 여부가 달라집니다. 기존 설정을 계속 사용할 수 있는지는 별도로 확인해야 합니다.
기기 모델이나 구입 연도만 보고 판단하지 마세요. 데스크톱과 노트북은 시스템 정보에서 아키텍처를 확인할 수 있습니다. Android 기기는 현재 시스템이 지원하는 앱 아키텍처를 확인하세요. 같은 기기도 운영체제를 바꾸면 설치할 수 있는 패키지가 달라질 수 있습니다. 다른 사람을 위해 다운로드한다면 다운로드에 사용한 기기가 아니라 설치 대상 기기의 정보를 기준으로 선택하세요.
amd64와 x86_64는 모두 일반적인 x86 64비트 아키텍처를 뜻하며, amd64는 특정 프로세서 브랜드에 한정되지 않습니다. arm64와 aarch64는 ARM 64비트 아키텍처를 가리킵니다. 이름의 차이를 확인한 다음 페이지에서 선택한 플랫폼도 점검해 아키텍처만 같고 운영체제가 다른 설치 파일을 혼용하지 마세요.
백업할 때는 구독, 수동 설정, 클라이언트 자체 설정을 구분하세요. 구독을 다시 가져오면 구독에 포함된 항목은 대개 복원되지만, 직접 추가한 항목이나 라우팅 규칙, 수신 대기 포트까지 자동으로 복원되지는 않습니다. 기존 클라이언트에서 내보내기를 지원한다면 필요한 정보를 먼저 내보내고 현재 프록시 모드와 활성 설정도 기록해 두세요.
구독 주소에는 접속 인증 정보가 포함될 수 있으므로 안전하게 관리하고 스크린샷에 그대로 담아 공개하지 마세요. 인터페이스나 빌드만 바꾸는 경우에는 기존 클라이언트를 종료한 뒤 새 클라이언트를 실행하세요. 두 클라이언트가 같은 포트를 사용하거나 시스템 프록시 설정을 반복해서 변경하는 일을 방지할 수 있습니다. 기본 연결과 필요한 규칙이 정상인지 확인한 다음 이전 프로그램과 백업을 정리하세요.
설치 프로그램이 열리지 않는 문제, 설치 후 앱이 종료되는 문제, 앱은 열리지만 연결되지 않는 문제는 각각 발생 단계가 다릅니다. 첫 번째 문제라면 파일 다운로드가 완료됐는지, 패키지 형식이 맞는지, 시스템 권한 안내가 있는지 확인하세요. 두 번째 문제라면 런타임, 폴더 권한, 프로그램 시작 로그부터 확인하세요. 이 단계에서 구독을 다시 가져올 필요는 없습니다.
오래된 시스템에서는 프로세서 아키텍처가 맞아도 시스템 인터페이스나 의존성 버전이 호환되지 않을 수 있습니다. 패키지를 계속 바꾸기보다 운영체제 버전, 선택한 빌드, 오류 메시지 원문을 함께 확인하는 편이 효과적입니다. Android에서 「앱이 설치되지 않았습니다」라는 메시지가 표시되면 서명 불일치, 시스템 요구 사항 미충족, 저장 공간 부족을 구분하세요.
시작 직후 종료되는 문제 해결 →사용 중인 설정이 있다면 업그레이드 전에 현재 클라이언트, 프록시 모드, 로컬 포트를 기록하세요. 업그레이드 후에는 기존 설정으로 먼저 테스트하세요. 코어, 구독, 라우팅을 한꺼번에 바꾸면 문제가 생겨도 원인을 찾기 어렵습니다.
이전 클라이언트로 돌아가야 한다면 새 버전이 설정 형식을 변경했는지 먼저 확인한 뒤 업그레이드 전 백업을 사용하세요. 새 프로그램과 이전 프로그램을 같은 폴더에 임의로 압축 해제하지 마세요. 패키지 관리자로 설치한 프로그램은 프로그램 제거와 사용자 설정 삭제를 구분해, 이전 패키지를 정리할 때 계속 사용할 규칙까지 지우지 않도록 주의하세요.
먼저 앱이 실행되는지 확인한 다음 설정을 가져오고 연결을 점검하세요. 다운로드, 설치, 트래픽 전달은 각각 별도의 단계입니다.
클라이언트를 열면 먼저 기존 구독을 그룹에 추가한 뒤 수동 업데이트를 한 번 실행하세요. 항목이 표시되어도 연결이 완료된 것은 아닙니다. 활성 설정을 선택하고 클라이언트 로그에서 코어 프로세스가 정상적으로 시작됐는지 확인하세요. 수동 설정이 있다면 구독 항목과 분리해 관리해야 구독 업데이트 후에도 헷갈리지 않습니다.
구독 업데이트에 실패하면 먼저 주소에 접속할 수 없는 문제인지 콘텐츠를 인식하지 못하는 문제인지 구분하세요. 테스트를 위해 클라이언트를 여러 개 실행할 필요는 없습니다. 동시에 켜면 시스템 프록시나 VPN 상태가 바뀌어 오류를 재현하기 어려워질 수 있습니다. 도움을 요청할 때는 실패 단계와 민감 정보를 가린 오류 메시지만 기록해도 충분하며, 전체 구독 주소를 공유할 필요는 없습니다.
구독 가져오기 방법 보기 →데스크톱에서는 먼저 시스템 프록시 설정을 따르는 브라우저로 확인하세요. 터미널 도구와 일부 데스크톱 앱은 시스템 프록시를 사용하지 않을 수 있으므로, 각 앱에서 사용하는 프록시 주소를 따로 확인해야 합니다. 업데이트 후 로컬 포트가 바뀌었다면 프록시 주소를 직접 입력한 앱도 함께 수정하세요. 클라이언트 창에 연결됨으로 표시되는지만 확인해서는 안 됩니다.
Android에서는 처음 연결할 때 시스템 VPN 권한 안내를 확인하세요. 기기에서 다른 VPN 연결을 사용 중이라면 클라이언트를 바꾸기 전에 어떤 연결을 유지할지 결정하세요. 앱이 필요한 트래픽을 처리하지 못하는 경우에만 가이드의 TUN 및 라우팅 항목을 확인하면 됩니다. 첫 연결을 확인할 때는 트래픽 처리 방식과 분할 라우팅 규칙을 동시에 바꾸지 않아도 됩니다.
라우팅 및 분할 터널링 안내 보기 →설치 파일 선택, 덮어쓰기 업데이트 및 버전 확인
아니요. 처음 설치한다면 데스크톱 버전을 선택하세요. 기존 클래식 인터페이스에 익숙하다면 WPF 버전을 사용할 수 있습니다. 버전을 바꾸기 전에 기존 클라이언트를 종료하고 설정을 백업하세요.
아니요. 범용 버전은 아키텍처를 잘못 선택할 가능성을 줄여 주지만, 최소 시스템 요구 사항은 달라지지 않습니다. 서명 충돌이나 기기 관리 정책으로 인한 제한도 해결하지 못합니다.
먼저 덮어쓰기가 지원되는지 확인하고 설정을 백업하세요. Android에서 서명이 일치하지 않는다는 메시지가 표시되면 바로 삭제하지 마세요. 앱을 삭제하면 데이터가 지워질 수 있습니다.
설치 파일에는 클라이언트 프로그램이 들어 있습니다. 설치 후 기존 구독이나 설정을 별도로 가져와야 합니다. 클라이언트 설치가 완료되어도 프록시 연결이 자동으로 설정되는 것은 아닙니다.
카드에는 앱 버전이, 다운로드 항목에는 개별 빌드 버전이 표시됩니다. 버전이 다르면 실제 파일 이름을 기록해 두고, 설치 후 클라이언트의 정보 페이지에서 실행 중인 버전을 확인하세요.