v2rayN
Desktop은 새로운 크로스 플랫폼 인터페이스를 사용하며, 처음 설치한다면 이 버전부터 시작하는 것이 좋습니다. WPF는 기존 Windows 인터페이스와 메뉴 사용 방식을 선호하는 사용자를 위한 안정적인 클래식 버전입니다. 두 파일 모두 ZIP 형식이므로 압축을 푼 뒤 안에 있는 설치 프로그램을 실행하세요. 일반적으로 둘 중 하나만 선택하면 됩니다.
클라이언트 / 설치 파일
데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 권장합니다. V2Fly 코어가 필요한 경우에는 v2flyNG를 선택하세요. 먼저 운영체제를 선택한 뒤 아키텍처와 패키지 형식을 확인하세요.
Desktop은 새로운 크로스 플랫폼 인터페이스를 사용하며, 처음 설치한다면 이 버전부터 시작하는 것이 좋습니다. WPF는 기존 Windows 인터페이스와 메뉴 사용 방식을 선호하는 사용자를 위한 안정적인 클래식 버전입니다. 두 파일 모두 ZIP 형식이므로 압축을 푼 뒤 안에 있는 설치 프로그램을 실행하세요. 일반적으로 둘 중 하나만 선택하면 됩니다.
| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 시스템 종류 | ‘설정 → 시스템 → 정보’에서 64비트 운영체제와 x64 기반 프로세서인지 확인하세요. |
| 설치 권한 | 파일 압축을 풀고 설치 프로그램을 실행할 수 있어야 합니다. 관리 기기라면 관리자에게 설치 권한을 확인하세요. |
| 실행 환경 | .NET 등 구성 요소가 없다는 메시지가 표시되면 선택한 버전에서 요구하는 런타임 버전을 확인하세요. |
구버전에서 옮기기 전에 알림 영역에서 기존 프로그램을 종료하고 설정을 백업하세요. 설치 문제와 두 클라이언트가 로컬 포트를 동시에 사용하는 문제를 구분하는 데 도움이 됩니다.
‘이 Mac에 관하여’에서 하드웨어 정보를 확인하세요. Apple M 시리즈 칩에는 Apple Silicon을, Intel 프로세서에는 Intel을 선택하면 됩니다. DMG를 마운트한 다음 창의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기고 해당 폴더에서 실행하세요.
| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 칩 | Apple Silicon은 ARM64, Intel은 x64에 해당합니다. |
| 시스템 버전 | 시스템에서 버전이 너무 낮다고 표시되면 현재 설치 파일의 호환 요구 사항을 확인하세요. 다른 아키텍처용 패키지로 바꿔도 버전 제한은 해결되지 않습니다. |
| 설치 위치 | 디스크 이미지를 마운트하고 앱을 대상 폴더로 복사할 권한이 있어야 합니다. |
복사가 끝나면 디스크 이미지를 추출해도 됩니다. 처음 실행할 때 시스템이 차단하면 버전 비호환, 아키텍처 불일치, 보안 경고 중 어떤 문제인지 먼저 확인하세요. 문제를 해결하려고 시스템 보호 기능을 끄지 마세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 고려할 수 있지만, 기기의 운영체제가 arm64-v8a를 지원하는지 확인해야 합니다. ABI를 확인하기 어렵다면 범용 버전을 선택하세요. 범용 패키지는 여러 지원 아키텍처를 포함하므로 단일 아키텍처 패키지보다 대체로 용량이 큽니다.
설정에서 V2Fly 코어를 명시적으로 요구하거나 기존 V2Fly 설정을 이어서 사용할 때만 선택하세요. 두 클라이언트는 서로 덮어 업데이트할 수 없으며, 구독·그룹·앱별 규칙도 각각 가져오거나 설정해야 합니다.
| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| ABI | arm64 패키지를 사용하려면 시스템에서 arm64-v8a를 지원해야 합니다. 하드웨어가 64비트여도 운영체제가 64비트 앱을 지원한다는 뜻은 아닙니다. |
| 시스템 버전 | 선택한 APK의 최소 시스템 요구 사항을 확인하세요. 범용 버전도 시스템 버전 제한을 우회할 수 없습니다. |
| 설치 출처 | 시스템에서 권한을 요청하면 APK를 여는 데 사용한 브라우저나 파일 관리자에만 권한을 부여하세요. 설치 후에는 권한을 해제할 수 있습니다. |
업무용 프로필이나 관리 기기에서는 사이드로드가 제한될 수 있습니다. ABI를 올바르게 선택했는데도 설치할 수 없다면 설치 프로그램의 메시지를 확인해 출처 권한, 버전 다운그레이드, 서명 불일치 중 무엇이 원인인지 살펴보세요.
Debian 및 Ubuntu 계열에서는 보통 DEB를, RPM 패키지 관리자를 사용하는 배포판에서는 RPM을 선택하세요. 배포판 버전과 의존성 호환성도 확인해야 합니다. RPM 파일 이름의 el10은 빌드 대상이며, RPM을 사용하는 모든 시스템에 바로 설치할 수 있다는 뜻은 아닙니다.
| 확인 항목 | 요구 사항 및 확인 방법 |
|---|---|
| 데스크톱 환경 | 이 사이트에서 제공하는 것은 그래픽 클라이언트 패키지이므로 그래픽 세션이 있는 시스템에서 사용해야 합니다. |
| 아키텍처 | amd64와 x86_64는 x64에, aarch64는 arm64에 해당합니다. |
| 패키지 및 의존성 | 시스템의 패키지 관리자가 선택한 형식을 지원하고 현재 패키지에 명시된 의존성을 충족해야 합니다. |
먼저 시스템 정보에서 실행 중인 배포판과 아키텍처를 확인한 뒤 시스템의 패키지 설치 도구로 파일을 여세요. 다른 기기용으로 다운로드한다면 현재 브라우저를 실행하는 기기가 아니라 대상 기기의 정보를 기준으로 선택하세요.
처음 설치할 때는 대상 기기와 패키지 형식만 확인하면 됩니다. 기존 클라이언트가 있다면 현재 설정을 기록한 뒤 덮어 업데이트할지 클라이언트를 바꿀지 결정하세요.
아키텍처 표시는 프로그램이 어떤 명령어 집합에 맞춰 빌드됐는지를 나타내며 클라이언트 기능 등급을 뜻하지 않습니다. 데스크톱 패키지에서 흔히 보는 x64, amd64, x86_64는 같은 종류의 아키텍처를 가리킵니다. amd64는 해당 아키텍처를 사용하는 Intel 프로세서에도 적용됩니다. arm64와 aarch64는 64비트 ARM을 뜻합니다. 모바일 운영체제에서는 앱이 사용할 수 있는 바이너리 인터페이스를 ABI로 표시하기도 합니다.
다른 컴퓨터용 설치 파일을 다운로드한다면 먼저 해당 기기에서 시스템 정보를 확인하게 하세요. 같은 모델이라도 하드웨어 구성이 다를 수 있고, 가상 머신을 사용하거나 프로세서는 64비트 프로그램을 실행할 수 있지만 운영체제는 32비트일 수도 있습니다. 따라서 기기명이나 제품명만으로 실제 시스템 종류를 판단할 수 없습니다. 설치 프로그램에서 아키텍처 오류가 표시되면 파일 이름을 바꾸거나 호환 모드를 반복해서 시도하기보다 대상 시스템에 맞는 패키지를 다시 선택하세요.
브라우저에 다운로드 기록이 있어도 파일 저장이 끝난 것은 아닙니다. 다운로드 상태를 확인해 작업이 중단되지 않았는지 살펴본 뒤 다운로드 폴더에서 파일을 여세요. ZIP 압축이 풀리지 않으면 다운로드가 완료됐는지 확인하세요. DMG를 마운트했는데 앱이 열리지 않으면 안내에 따라 앱을 복사했는지, 시스템에서 어떤 이유를 표시하는지 확인하세요. APK를 다운로드했지만 설치 화면이 열리지 않으면 현재 파일을 여는 앱에 설치 출처 권한이 있는지 확인하세요.
시스템 설치 화면이 열린 뒤에는 가장 먼저 표시된 명확한 오류 메시지를 보존하세요. 권한 부족, 패키지 형식 불일치, 의존성 누락, 버전 다운그레이드는 서로 다른 문제입니다. 예를 들어 Linux의 의존성 오류는 패키지 관리 단계에서 발생하며 구독 업데이트 여부와는 관계가 없습니다. 조직에서 관리하는 기기라면 먼저 설치 정책을 확인하고 시스템 보안 설정을 바꿔 제한을 우회하지 마세요.
덮어 설치하기 전에 클라이언트의 현재 버전, 설정 저장 위치, 내보내기 옵션을 확인하세요. 구독은 다시 가져올 수 있지만 직접 추가한 노드, 규칙 순서, 로컬 수신 포트, 앱별 예외는 구독만으로 복원되지 않을 수 있습니다. 현재 클라이언트의 내보내기 기능을 우선 사용하고 필요한 구독 주소는 기기에 안전하게 별도로 보관하세요. 버전이나 운영체제가 다른 클라이언트끼리 설정 폴더를 그대로 공유할 수 있다고 가정하지 마세요.
업데이트할 때는 먼저 앱과 백그라운드 프로세스를 종료한 뒤 같은 플랫폼·아키텍처·배포 경로의 설치 파일을 선택하세요. 서명이 달라 배포 경로 간 업데이트가 거부되더라도 구버전을 실행할 수 있다면 먼저 내보내고 백업을 읽을 수 있는지 확인하세요. 삭제부터 하지 마세요. 이전 버전으로 되돌릴 때도 구버전이 새 버전에서 저장한 설정을 읽을 수 있는지 먼저 확인하고, 중요한 규칙은 업데이트 전에 복사본을 보관하세요.
처음 실행할 때 앱이 정상적으로 열리고 화면을 조작할 수 있는지 확인한 다음 구독 관리로 이동하세요. 주소를 추가하고 그룹을 저장한 뒤 업데이트를 실행해 항목이 원하는 그룹에 표시되는지 확인하세요. 단일 공유 링크와 구독 주소는 입력 위치가 다릅니다. 공유 링크는 보통 노드 하나를 가져오고, 구독 주소는 저장한 뒤 그룹을 업데이트해야 합니다. 입력 유형을 잘못 선택한 문제를 해결하려고 앱을 다시 설치하지 마세요.
가져오기가 완료되면 정상 작동을 확인한 설정 하나를 선택해 연결을 테스트하세요. 일부 프로그램에서만 연결을 사용할 수 없다면 해당 프로그램이 시스템 프록시를 따르는지, 로컬 포트가 일치하는지 확인하세요. 구독 목록이 비어 있다면 구독이 유효한지, 주소가 완전한지, 현재 클라이언트가 해당 형식을 지원하는지 먼저 확인하세요. 설정 방법은 사용 설명서에서, 프로토콜과 코어의 호환 범위는 프로토콜 상세 안내에서 확인할 수 있습니다.
파일, 시스템, 설치 경로를 먼저 확인하세요. 클라이언트가 실행된 뒤 구독 가져오기와 연결 설정을 확인하면 됩니다.
아니요. 설치 파일에는 클라이언트만 포함되어 있습니다. 기존 구독 주소나 공유 링크를 클라이언트에서 가져온 다음 해당 그룹을 업데이트하세요. 구독 주소에는 접속 정보가 포함될 수 있으니 공개 댓글이나 스크린샷에 붙여 넣지 마세요.
먼저 압축 파일 전체를 일반 폴더에 풀고, 폴더 안의 설치 프로그램을 실행하세요. 파일 하나만 바탕 화면으로 옮기거나 압축 파일 미리 보기에서 프로그램을 바로 실행하지 마세요. 함께 들어 있는 파일을 찾지 못할 수 있습니다.
시스템 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’에 Apple M 시리즈가 표시되면 Apple Silicon을, ‘프로세서’에 Intel이 표시되면 Intel을 선택하세요. macOS의 주 버전으로는 프로세서 종류를 판단할 수 없습니다.
아니요. 범용 버전은 지원되는 프로세서 아키텍처에 맞추기 위한 것으로, 앱 서명은 바뀌지 않습니다. 기기에 설치된 구버전이 다른 배포 경로에서 받은 앱이라면 기존 경로에서 호환되는 업데이트를 먼저 사용하세요. 배포 경로를 바꿔야 한다면 설정을 백업하고 복원할 수 있는지 확인한 뒤 구버전을 삭제하세요.
먼저 배포판, 시스템 버전, CPU 아키텍처를 확인한 다음 배포판의 패키지 설치 도구에서 누락된 의존성을 살펴보세요. 패키지 관리자가 의존성을 해결하지 못하면 강제로 설치하거나 다른 형식의 패키지로 대체하지 마세요. 패키지 형식이 맞아도 현재 배포판 버전과 호환된다는 뜻은 아닙니다.
카드에는 목록에 등록된 앱 버전이 표시되고, 파일 이름에는 선택한 다운로드 항목의 설치 파일 버전이 표시됩니다. 두 버전이 다르면 카드의 버전만 보고 덮어 설치 가능 여부를 판단하지 마세요. 설치 파일과 시스템 설치 화면에 표시된 버전, 현재 클라이언트 버전을 확인하세요.