v2rayN
데스크톱판은 최신 크로스 플랫폼 인터페이스를 사용하며 처음 설치하는 경우에 적합합니다. WPF판은 Windows용 클래식 버전으로, 기존 인터페이스와 사용 방식에 익숙한 사용자에게 적합합니다. 둘 중 하나만 설치하면 됩니다.
설치 파일 선택
먼저 운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요. 컴퓨터에는 v2rayN을, Android 기기에는 v2rayNG를 권장합니다. V2Fly 코어가 필요하다면 v2flyNG를 선택하세요.
데스크톱판은 최신 크로스 플랫폼 인터페이스를 사용하며 처음 설치하는 경우에 적합합니다. WPF판은 Windows용 클래식 버전으로, 기존 인터페이스와 사용 방식에 익숙한 사용자에게 적합합니다. 둘 중 하나만 설치하면 됩니다.
| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 운영체제 | 지원이 계속되는 Windows 11 사용을 권장합니다. 구형 운영체제에서는 해당 빌드와 런타임 요구 사항을 먼저 확인하세요. |
| 아키텍처 | 이 파일은 x64용입니다. 「설정 → 시스템 → 시스템 정보」에서 시스템 종류와 프로세서를 확인하세요. |
| 설치 방법 | 먼저 ZIP 파일의 압축을 푼 다음 폴더 안의 설치 프로그램을 실행하세요. 런타임이 없다는 오류가 명확히 표시되면 요구되는 버전과 아키텍처를 확인하세요. |
운영체제 비트 수와 프로세서 아키텍처는 다릅니다. 운영체제에 「64비트」라고 표시되어도 x64 프로세서라는 뜻은 아닙니다. ARM 기기라면 현재 Windows에서 이 x64 빌드를 에뮬레이션으로 실행할 수 있는지 먼저 확인하세요. 여기서 제공하는 두 설치 파일은 모두 네이티브 ARM용이 아닙니다.
설치 전에 이전 버전을 종료하세요. 창을 닫은 뒤 작업 표시줄 알림 영역을 확인하고, 아이콘이 남아 있다면 트레이 메뉴에서 종료하세요. 두 프로그램이 동시에 실행되면 수신 포트를 공유하거나 같은 시스템 프록시 설정을 차례로 변경할 수 있습니다. 처음 실행할 때는 인터페이스가 정상적으로 열리는지 확인한 뒤 설정을 가져오세요. 시스템 프록시와 TUN을 동시에 켜서 테스트하지 마세요.
설치 프로그램을 실행하자마자 오류가 발생하면 오류 메시지를 그대로 보관하고, 「설치 프로그램이 실행되지 않음」, 「클라이언트 창이 열리지 않음」, 「실행 후 연결 실패」를 구분하세요. 앞의 두 경우에는 운영체제, 런타임 또는 설치 폴더 권한을 확인하세요. 인터페이스는 정상인데 연결에 실패한다면 설정과 네트워크를 살펴보면 됩니다. 다른 인터페이스 버전으로 먼저 바꿀 필요는 없습니다.
Apple 메뉴에서 「이 Mac에 관하여」를 여세요. Apple M 시리즈 칩으로 표시되면 Apple Silicon을, Intel 프로세서로 표시되면 Intel 버전을 선택하세요. 외관이나 구매 연도로 판단하지 마세요.
| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 운영체제 | 지원이 계속되는 macOS를 사용하세요. 구형 시스템에서는 선택한 빌드의 최소 버전을 확인해야 합니다. |
| 칩 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. |
| 설치 방법 | DMG를 열고 이미지 안의 안내에 따라 앱을 「응용 프로그램」으로 옮긴 다음 실행하세요. |
복사가 끝난 뒤 디스크 이미지를 추출하세요. 마운트된 이미지를 앱의 상시 실행 위치로 사용하지 마세요. 새 버전을 설치했는데도 이전 버전이 열리면 Finder의 「응용 프로그램」에서 새로 복사한 앱을 직접 실행하세요. Dock의 기존 아이콘이 다른 앱을 가리키는지도 확인하세요.
현재 macOS 버전과 호환되지 않는다는 메시지가 표시되면 먼저 운영체제 버전을 확인하세요. 앱을 실행할 수 없다는 메시지가 표시되면 칩 종류와 다운로드한 파일의 아키텍처를 확인하세요. 보안 경고가 나타나면 원인을 읽고 확인되지 않은 개발자, 손상된 앱, 시스템 버전 불일치를 구분하세요. 모든 경고를 네트워크 문제로 간주하거나 시스템 보호를 전역적으로 끄지 마세요.
Xray 코어를 사용합니다. 2015년 이후 출시된 주요 스마트폰은 일반적으로 arm64를 선택할 수 있습니다. arm64-v8a를 지원하는지 확인한 뒤 선택하세요. 아키텍처를 알 수 없다면 범용 버전을 선택할 수 있습니다.
V2Fly 코어를 사용합니다. 기존 설정에 필요한 프로토콜과 전송 방식이 이 빌드에서 지원되는 경우에만 기존 클라이언트를 대체해 사용하세요. 범용 버전은 더 많은 아키텍처를 지원하지만 기능이 추가되는 것은 아닙니다.
| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 운영체제 | 「휴대전화 정보」에서 Android 버전을 확인하세요. 기기가 선택한 빌드의 최소 시스템 요구 사항과 설치 정책을 충족해야 합니다. |
| 아키텍처 | 기기에서 지원하는 앱 ABI를 기준으로 선택하세요. 칩이 64비트라는 이유만으로 arm64 설치 파일을 사용할 수 있다고 단정할 수 없습니다. |
| 설치 방법 | 기기에서 사용하는 브라우저나 파일 관리자가 앱 설치를 실행할 수 있어야 합니다. 관리 대상 기기에는 관리자 정책이 우선 적용됩니다. |
설치 권한과 연결 권한은 별개입니다. 먼저 현재 다운로드 출처에서 앱을 설치하도록 허용해야 할 수 있으며, 설치 후에는 이 권한을 취소할 수 있습니다. 프록시 서비스를 처음 시작할 때 시스템에서 VPN 연결을 요청할 수도 있습니다. 설치 성공은 앱 실행이 가능하다는 뜻일 뿐, 연결 권한을 받았거나 설정을 가져왔다는 의미는 아닙니다.
다른 빌드에서 업데이트할 때 「앱을 설치할 수 없음」이라는 메시지가 표시되면 기존 앱을 바로 삭제하지 말고 시스템 안내를 기록하세요. 아키텍처 불일치, 앱 서명 차이, 설치된 버전보다 낮은 대상 버전, 기기 정책 등으로 설치가 거부될 수 있습니다. 원인을 확인한 뒤 설치 파일을 바꾸거나 백업 후 이전할지 결정하세요. 앱을 삭제하면 일반적으로 로컬 데이터도 함께 삭제됩니다.
v2rayn_7.24.1_arm64.deb
v2rayN-7.24.1-1.el10.aarch64.rpm
Debian 및 Ubuntu 계열은 일반적으로 DEB를 선택합니다. RPM 기반 시스템에서는 배포판과 의존성을 먼저 확인하세요. 여기서 제공하는 RPM 파일 이름에는 el10이 표시되어 있습니다. RPM 설치를 지원한다고 해서 반드시 호환되는 것은 아닙니다.
| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 실행 환경 | 그래픽 데스크톱 세션이 필요하며 선택한 빌드의 시스템 의존성을 충족해야 합니다. |
| 아키텍처 | uname -m 출력이 x86_64이면 x64, aarch64이면 arm64입니다. 아키텍처가 혼합된 환경에서는 패키지 관리자의 대상 아키텍처를 기준으로 하세요. |
| 패키지 형식 | 배포판에 맞는 DEB 또는 RPM을 선택하면 시스템 패키지 도구가 의존성을 처리합니다. |
아키텍처와 패키지 형식은 각각 맞춰야 합니다. DEB에서 amd64는 x64를 뜻하며 AMD 프로세서에만 해당하지 않습니다. RPM에서는 일반적으로 x86_64로 표시합니다. 마찬가지로 DEB의 arm64와 RPM의 aarch64는 모두 64비트 ARM을 가리키지만, 패키지 형식은 서로 바꿔 사용할 수 없습니다.
패키지 설치 도구에서 의존성을 충족할 수 없다는 메시지가 표시되면 처음 나온 누락 의존성 또는 버전 충돌 메시지를 보관하고, 배포판 버전과 저장소 상태를 확인하세요. 의존성을 강제로 무시하거나 다른 배포판의 패키지를 섞어 설치하지 마세요. 설치는 성공했지만 앱 메뉴에서 실행해도 반응이 없다면 그래픽 세션 여부를 확인하고 앱 실행 오류와 프록시 설정 오류를 구분하세요.
플랫폼을 선택한 뒤 버튼 아래 파일 이름으로 형식과 아키텍처를 확인하세요. 브라우저에 다운로드 중이라고 표시되면 완료될 때까지 기다린 다음 파일을 여세요. 저장된 파일이 설치 파일이 아니라 웹페이지라면 다운로드 링크를 다시 시도하고, 브라우저에 네트워크 오류, 접근 제한, 링크 만료 중 무엇이 표시되는지 기록하세요. 확장자만 바꿔 웹페이지를 설치 파일로 만들 수는 없습니다.
카드의 목록 버전과 파일 이름이 다르면 앱 버전 정보와 개별 다운로드 링크를 구분하세요. 설치 파일은 해당 링크의 파일 이름을 기준으로 선택하고, 업데이트 전에는 설치된 버전과 비교하세요. 다운로드 시간이 더 최근이라는 이유만으로 새 파일을 최신 버전이라 판단하지 마세요. 압축 파일 이름만 보고 실행 중인 프로그램이 정상적으로 교체되었다고 단정해서도 안 됩니다.
버전을 바꾸기 전에 현재 클라이언트, 구독 그룹, 기본 선택 노드, 사용자 지정 라우팅을 기록하세요. 구독 주소만 저장하는 것으로 전체 설정이 백업되지는 않습니다. 수동으로 추가한 노드, 로컬 수신 포트, 라우팅 규칙은 별도로 내보내야 할 수 있습니다. 구독 주소에 접근 인증 정보가 포함될 수 있으므로 백업 파일은 관리되는 기기에 보관하고 공개 문의나 채팅방에 올리지 마세요.
설치 후 먼저 프로그램이 실행되는지 확인하고 기존 설정을 읽었는지 살펴보세요. 수동으로 복원해야 한다면 필요한 설정만 먼저 가져와 목록을 확인하고, 새 디렉터리 전체를 덮어쓰지 마세요. 새 버전이 실행되고 설정을 읽으며 연결 테스트까지 통과할 때까지 이전 버전이나 백업을 보관한 뒤 정리 여부를 결정하세요.
클라이언트를 새로 설치하면 목록이 비어 있는 것이 정상입니다. 기존 구독을 해당 그룹으로 가져와 직접 업데이트하거나, 알고 있는 서버 설정을 추가하세요. 노드 목록이 표시되면 하나를 선택하고 클라이언트 로그에 시작 오류가 있는지 확인하세요. 구독 업데이트 실패는 설정을 가져오는 단계의 문제이며, 가져온 노드에 연결할 수 없는 문제와는 다르므로 따로 점검해야 합니다.
데스크톱에서는 클라이언트 실행 여부와 대상 앱의 프록시 사용 여부도 구분해야 합니다. 접속 가능한 것으로 확인된 사이트에 먼저 연결해 보고, 대상 앱이 시스템 프록시 설정을 따르는지 확인하세요. TUN을 켜거나 라우팅을 변경하기 전에 기본 설정 중 하나를 검증해 두고 한 번에 한 항목만 변경하세요. 자세한 방법은 구독 가져오기 및 연결 가이드를 참고하세요. 로그에 포트 사용 중이라고 표시되면 로컬 수신 포트 문제 해결을 확인하세요.
카드의 버전은 앱 목록에 표시된 값이고, 파일 이름은 각 다운로드 링크에 해당하므로 서로 다를 수 있습니다. 다운로드하기 전에 선택한 링크의 파일 이름을 확인하세요. 설치 후 실제 버전은 클라이언트의 정보 화면이나 시스템 앱 정보에서 확인할 수 있습니다.
아니요. 처음 설치한다면 크로스 플랫폼 인터페이스를 사용하는 데스크톱판을 권장합니다. 클래식 인터페이스에 익숙하거나 기존 사용 방식을 유지하려면 WPF판을 선택하세요. 전환 전에 설정을 백업하고 기존 버전을 완전히 종료해야 두 프로그램이 시스템 프록시를 동시에 제어하거나 로컬 수신 포트를 놓고 충돌하는 일을 방지할 수 있습니다.
아키텍처 호환성이 문제인 경우에만 범용 설치 파일로 해결될 수 있습니다. Android 버전과 저장 공간, 기존 앱과 서명이 다르거나 더 높은 버전의 빌드가 설치되어 있는지도 확인하세요. 서명 충돌 메시지가 표시되면 먼저 설정을 백업한 뒤 기존 앱을 삭제할지 결정하세요.
업데이트 전에 클라이언트를 종료하고, 내보내기 기능으로 설정을 저장하거나 현재 버전의 안내에 따라 데이터 디렉터리를 백업하세요. 구독 그룹, 사용자 지정 라우팅, 로컬 포트, 프록시 모드를 기록해 두세요. 새 버전에서 설정이 정상적으로 읽히는지 확인한 다음 이전 디렉터리나 앱을 정리하세요.
설치 파일에는 클라이언트만 포함되어 있습니다. 기존 구독이나 서버 설정을 먼저 가져와야 합니다. 구독을 사용하는 경우 업데이트를 실행한 뒤 목록에 노드가 표시되는지 확인하세요. 설정이 불러와졌는지 확인하고 노드를 선택한 다음 필요한 프록시 모드를 켜서 연결을 테스트하세요.