v2rayN
7.24.1Windows x64 · Desktop은 차세대 크로스 플랫폼 인터페이스, WPF는 안정적인 클래식 인터페이스입니다. 두 설치 파일 모두 ZIP 형식입니다.
먼저 압축을 푼 다음 설치 프로그램을 실행하세요. 인터페이스를 바꾸기 전에 기존 설정을 내보내고 구독 그룹과 사용자 지정 라우팅을 기록하세요.
클라이언트 설치 / 패키지 형식 선택
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 먼저 운영체제를 확인한 뒤 CPU 아키텍처에 맞는 파일을 다운로드하면 됩니다.
설치 후 구독 가져오기 및 연결 방법 →같은 플랫폼에서도 인터페이스, 칩 또는 패키지 형식에 따라 선택지가 나뉩니다. 버전 정보는 클라이언트 이름 아래에서 확인할 수 있습니다.
v2rayN은 Desktop과 클래식 WPF, 두 가지 인터페이스를 제공합니다. 두 설치 파일 모두 x64 시스템용이며, 차이는 인터페이스 기술과 화면 구성에 있습니다. 프록시 프로토콜이 다른 것은 아닙니다. 처음 설치한다면 튜토리얼에서 사용하는 메뉴와 같은 인터페이스를 선택하세요. 기존 설정을 사용 중이라면 먼저 백업한 뒤 전환 여부를 결정하세요.
Desktop은 차세대 크로스 플랫폼 UI로, 여러 데스크톱 운영체제에서 비슷한 사용 방식을 유지하고 싶은 사용자에게 적합합니다. WPF는 기존 Windows 작업 흐름을 이어 가기 좋은 안정적인 클래식 버전입니다. 각 버전의 세부 운영체제 및 실행 환경 요구 사항은 현재 설치 프로그램의 안내를 확인하세요.
보안 프로그램이 파일을 차단하면 파일 출처와 구체적인 경고 내용을 먼저 확인하세요. 경고가 불분명하면 설치를 중단하고, 모든 보호 기능을 바로 끄지 마세요. 프로그램을 실행할 수 있게 된 후 구독 가져오기, 시스템 프록시, 라우팅을 설정하세요.
Windows x64 · Desktop은 차세대 크로스 플랫폼 인터페이스, WPF는 안정적인 클래식 인터페이스입니다. 두 설치 파일 모두 ZIP 형식입니다.
먼저 압축을 푼 다음 설치 프로그램을 실행하세요. 인터페이스를 바꾸기 전에 기존 설정을 내보내고 구독 그룹과 사용자 지정 라우팅을 기록하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| CPU 아키텍처 | 이 페이지의 두 설치 파일은 모두 x64입니다 |
| 데스크톱 환경 | Windows 그래픽 데스크톱 필요; 세부 버전 제한은 설치 안내 확인 |
| 실행 환경 | Desktop과 WPF의 요구 사항은 다를 수 있으므로 안내된 누락 구성 요소를 설치하세요 |
| 폴더 권한 | 압축 해제 폴더에서 파일을 읽고 쓸 수 있고 설정 폴더에 설정을 저장할 수 있어야 합니다 |
macOS에서는 v2rayN 데스크톱 인터페이스를 사용합니다. 설치 전 Apple Silicon과 Intel을 구분하는 것이 중요합니다. Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple M 시리즈는 Apple Silicon용, Intel 프로세서는 Intel용 설치 파일을 선택하면 됩니다. 기기 이름만으로 판단하지 마세요.
두 DMG 파일은 같은 클라이언트를 서로 다른 CPU 아키텍처로 빌드한 것입니다. Apple Silicon 기기에는 기본 arm64 패키지를, Intel 기기에는 x64 패키지를 선택하세요. 아키텍처와 연결 프로토콜은 별개의 문제입니다. 설치 파일 아키텍처를 바꿔도 잘못된 구독 주소나 서버 설정은 해결되지 않습니다.
설치 오류와 네트워크 권한 문제는 따로 확인해야 합니다. ‘앱을 열 수 없음’은 보통 실행 단계에서 발생합니다. 앱은 실행되지만 브라우저에서 프록시가 작동하지 않는다면 시스템 프록시 모드와 브라우저 자체 설정을 확인하세요. 특정 앱의 안내를 해결하려고 시스템 보안 기능 전체를 끄지 마세요.
기존 설정을 옮길 때는 원래 구독과 규칙을 먼저 백업한 다음 새 클라이언트로 가져오세요. 데스크톱 운영체제 간에 이전한 뒤에는 로컬 규칙 파일 위치 같은 경로 설정도 확인해야 합니다. 다른 기기의 폴더 경로가 그대로 적용되지 않도록 주의하세요.
‘이 Mac에 관하여’에서 칩을 확인하세요. Apple M 시리즈는 Apple Silicon, Intel 프로세서는 Intel을 선택합니다.
파일 형식은 DMG입니다. 처음 실행할 때와 네트워크 권한을 설정하는 방법은 설치 튜토리얼을 확인하세요. 서버 설정을 먼저 변경할 필요는 없습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| Apple Silicon | Apple M 시리즈 칩: arm64 DMG 선택 |
| Intel | Intel 프로세서: x64 DMG 선택 |
| 운영체제 버전 | 현재 앱의 실행 안내 및 릴리스 노트를 기준으로 확인하세요 |
| 권한 준비 | 앱 설치를 허용하고 실제 기능에 필요한 네트워크 권한을 부여하세요 |
Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. V2Fly 생태계 설정이 필요하다면 v2flyNG를 고려할 수 있습니다. 두 클라이언트는 별개의 앱으로, 메뉴 이름과 설정 기능, 데이터 폴더가 완전히 같지 않습니다. 같은 앱의 스킨만 다른 것으로 보면 안 됩니다.
2015년 이후 출시된 대부분의 스마트폰에는 arm64 패키지가 적합하지만, 기기 아키텍처나 시스템의 비트 수가 다를 수 있으므로 실제 지원 ABI를 확인하세요. 확인하기 어렵다면 범용 버전을 선택할 수 있습니다. 범용 버전은 여러 아키텍처를 지원하지만 연결 속도를 높이거나 구독 설정의 호환성을 바꾸지는 않습니다.
‘앱이 설치되지 않음’이 표시되면 저장 공간, 시스템 버전, 아키텍처를 먼저 확인한 다음 기존 앱과 서명이 충돌하는지 살펴보세요. 같은 이름의 앱이라도 빌드 출처가 다르면 덮어쓸 수 없습니다. 설정을 저장하기 전에 이전 앱을 바로 삭제하지 마세요.
연결 후 백그라운드로 전환하면 끊기는 경우 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 문제를 확인할 때는 한 번에 한 항목만 바꾸고 결과를 기록하세요. v2rayNG와 v2flyNG의 네트워크 처리 기능을 동시에 켜면 시스템 연결 상태가 번갈아 바뀌어 원인을 파악하기 어려울 수 있습니다.
Xray 코어 · 일반적인 arm64 기기는 첫 번째 항목을 우선 선택하세요. 아키텍처를 모르면 범용 버전을 선택할 수 있습니다.
APK 설치 파일입니다. 처음 연결할 때 시스템 VPN 권한을 허용해야 하며, 구독 링크는 별도로 가져와야 합니다.
V2Fly 설정을 위한 대안 클라이언트입니다. 가져오기 전에 프로토콜과 전송 방식 지원 여부를 확인하세요. v2rayNG 설정을 그대로 대체한다고 볼 수는 없습니다.
| 확인 항목 | 선택 기준 |
|---|---|
| arm64 | arm64-v8a 지원 시스템; 일반적인 스마트폰에서 우선 고려 |
| 범용 버전 | 아키텍처를 모를 때 선택할 수 있지만 시스템 버전 요구 사항은 적용됩니다 |
| 운영체제 버전 | 선택한 APK 설치 프로그램의 호환성 안내를 확인하세요 |
| 연결 권한 | 설치 출처 권한과 첫 VPN 연결 권한은 각각 따로 설정하세요 |
Linux에서는 v2rayN 데스크톱 클라이언트를 사용합니다. 배포판의 패키지 관리 체계에 맞춰 deb 또는 rpm을 선택한 뒤 CPU 아키텍처를 확인하세요. Debian, Ubuntu 및 파생 배포판은 보통 deb를, Fedora, RHEL 계열 및 파생 배포판은 보통 rpm을 사용합니다. 데스크톱 테마나 창 모양으로 패키지 형식을 판단하지 마세요.
일반적인 데스크톱 PC는 x64이며 시스템 정보에 x86_64로 표시될 수 있습니다. 일부 개발 보드와 데스크톱 기기는 arm64를 사용하며 시스템에 aarch64로 표시될 수 있습니다. 두 아키텍처는 서로 호환되지 않습니다. 카드의 기본 다운로드는 x64이며 arm64 파일은 아래에 별도로 표시되어 있으니 설치 전에 다시 확인하세요.
그래픽 클라이언트를 사용하려면 데스크톱 세션이 필요합니다. 명령줄 환경만 있는 기기에는 이 페이지의 데스크톱 설치 절차를 적용하지 마세요. 공유 라이브러리가 없거나 의존성 버전이 맞지 않으면 의존성을 강제로 무시하지 말고 먼저 지원되는 배포판 범위를 확인하세요.
Linux에서는 앱마다 데스크톱 시스템 프록시 설정을 지원하는 방식이 다를 수 있습니다. 브라우저가 연결된다고 해서 모든 터미널 프로그램이 같은 프록시를 사용한다는 뜻은 아닙니다. 설치 후에는 실제 사용하는 앱을 하나씩 확인하세요. 라우팅과 DNS는 클라이언트가 정상 실행된 뒤 조정하면 됩니다.
기본 설치 파일은 x64 데스크톱용입니다. 배포판에 맞는 패키지 형식을 선택한 뒤 설치 프로그램에 표시되는 의존성을 확인하세요.
그래픽 데스크톱 환경이 필요합니다. arm64를 선택하더라도 패키지 형식은 배포판의 패키지 관리 체계에 맞춰야 합니다.
| 확인 항목 | 선택 기준 |
|---|---|
| 패키지 형식 | 배포판에 따라 deb 또는 rpm 선택 |
| CPU 아키텍처 | x86_64는 x64, aarch64는 arm64에 해당 |
| 실행 환경 | 사용 가능한 그래픽 데스크톱 세션 및 설치 프로그램이 요구하는 의존성 |
| 권한 준비 | 소프트웨어 설치 권한 및 설정 폴더 읽기·쓰기 권한 |
프로그램 실행, 설정 가져오기, 앱 연결은 각각 별도로 확인해야 합니다.
데스크톱에서는 v2rayN의 ‘구독 그룹’ 메뉴를 열어 구독 주소를 추가하고 업데이트하세요. Android에서는 v2rayNG의 ‘구독 그룹 설정’에 주소를 저장한 뒤 구독을 업데이트하면 됩니다. 개별 설정 링크는 ‘클립보드에서 가져오기’를 사용하세요. 복사할 때는 링크 전체를 선택하고 설명 문구나 페이지 주소가 구독 내용에 섞이지 않도록 하세요.
목록에 설정이 나타나면 사용할 항목을 선택한 뒤 해당 연결 모드를 켜세요. v2rayN의 ‘시스템 프록시 자동 설정’은 시스템 프록시를 따르는 앱에 주로 적용되며 모든 트래픽을 자동으로 처리하는 기능은 아닙니다. 처음 테스트할 때는 기본 라우팅 규칙이나 내용을 이해한 규칙을 사용하세요. 시스템 프록시, 라우팅, DNS를 동시에 변경하면 문제 원인을 찾기 어렵습니다.
구독 그룹, 사용자 지정 규칙, 로컬 리스닝 설정을 기록하고 클라이언트의 백업 또는 내보내기 기능으로 저장하세요. 구독 주소에는 개인 접근 정보가 포함될 수 있으므로 백업 파일과 스크린샷을 공개적으로 공유하지 마세요. 클라이언트나 코어 계열을 바꿀 때는 프로토콜과 전송 방식 지원 여부도 확인하세요. 링크를 가져올 수 있어도 모든 설정 항목이 지원되는 것은 아닙니다.
각 단계를 따라 설정하려면 v2rayN 및 v2rayNG 설정 가이드를 참고하세요. VMess, VLESS와 코어 호환성을 확인하려면 프로토콜 및 코어 기술 안내를 확인하세요. DNS 관련 문제는 DNS 설정 단계에서 이어서 점검할 수 있습니다.
패키지 형식, CPU 아키텍처, 설정 이전 순서를 확인하세요.
Desktop은 여러 운영체제에서 비슷한 방식으로 사용할 수 있는 차세대 크로스 플랫폼 인터페이스입니다. WPF는 기존 Windows 사용법과 튜토리얼을 따르기 좋은 안정적인 클래식 인터페이스입니다. 두 설치 파일 모두 x64 ZIP 형식이므로 압축을 푼 다음 설치 프로그램을 실행하세요.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon을, 프로세서 항목에 Intel이 표시되면 Intel용 파일을 선택하세요. 기기 외관이나 구입 연도만으로 판단하지 말고 실제 프로세서에 맞는 아키텍처를 선택해야 합니다.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 시스템에서 arm64-v8a를 지원하는지 확인하세요. 아키텍처를 확인하기 어렵다면 범용 버전을 선택할 수 있습니다. 범용 버전은 여러 아키텍처를 지원할 뿐 연결 속도를 높여 주지는 않습니다. 설치에 실패하면 시스템 버전, 저장 공간, 서명 충돌도 확인하세요.
Debian, Ubuntu 및 같은 패키지 관리 체계를 사용하는 배포판은 보통 deb를 선택합니다. Fedora, RHEL 계열 및 그 파생 배포판은 대체로 rpm을 사용합니다. x64와 arm64도 구분하고 설치 프로그램이 안내하는 의존성을 확인하세요. 패키지 형식이 같아도 모든 배포판 버전과 호환되는 것은 아닙니다.
설치 파일에는 클라이언트만 포함되며 사용할 수 있는 서버 설정은 들어 있지 않습니다. 사용 권한이 있는 서비스에서 구독 링크나 개별 설정을 받은 뒤 구독 그룹 설정 또는 클립보드 가져오기로 추가하세요. 가져온 설정을 선택하고 안내에 따라 프록시 모드를 설정한 다음 연결을 확인하세요.
먼저 클라이언트의 내보내기 또는 백업 기능으로 설정을 저장하고 현재 구독 그룹과 사용자 지정 규칙을 기록하세요. 같은 클라이언트의 같은 서명 출처에서 업데이트하면 데이터가 유지되는 경우가 많지만, 설치 안내를 우선 확인해야 합니다. 서명 충돌이 발생해도 바로 삭제하지 말고 백업을 사용할 수 있는지 확인한 뒤 마이그레이션하세요.