클라이언트 / 설치 파일

V2Ray 클라이언트 다운로드

데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 권장합니다. V2Fly 코어가 필요한 경우에는 v2flyNG를 선택하세요. 먼저 운영체제를 선택한 뒤 아키텍처와 패키지 형식을 확인하세요.

운영체제별 선택

v2rayN

v2rayN

추천 x64 7.24.1

Desktop은 새로운 크로스 플랫폼 인터페이스를 사용하며, 처음 설치한다면 이 버전부터 시작하는 것이 좋습니다. WPF는 기존 Windows 인터페이스와 메뉴 사용 방식을 선호하는 사용자를 위한 안정적인 클래식 버전입니다. 두 파일 모두 ZIP 형식이므로 압축을 푼 뒤 안에 있는 설치 프로그램을 실행하세요. 일반적으로 둘 중 하나만 선택하면 됩니다.

Windows 시스템 요구 사항

확인 항목요구 사항 및 확인 방법
시스템 종류‘설정 → 시스템 → 정보’에서 64비트 운영체제와 x64 기반 프로세서인지 확인하세요.
설치 권한파일 압축을 풀고 설치 프로그램을 실행할 수 있어야 합니다. 관리 기기라면 관리자에게 설치 권한을 확인하세요.
실행 환경.NET 등 구성 요소가 없다는 메시지가 표시되면 선택한 버전에서 요구하는 런타임 버전을 확인하세요.

구버전에서 옮기기 전에 알림 영역에서 기존 프로그램을 종료하고 설정을 백업하세요. 설치 문제와 두 클라이언트가 로컬 포트를 동시에 사용하는 문제를 구분하는 데 도움이 됩니다.

설치 및 이전 준비

처음 설치할 때는 대상 기기와 패키지 형식만 확인하면 됩니다. 기존 클라이언트가 있다면 현재 설정을 기록한 뒤 덮어 업데이트할지 클라이언트를 바꿀지 결정하세요.

설치 파일 선택

대상 시스템의 아키텍처 확인

아키텍처 표시는 프로그램이 어떤 명령어 집합에 맞춰 빌드됐는지를 나타내며 클라이언트 기능 등급을 뜻하지 않습니다. 데스크톱 패키지에서 흔히 보는 x64, amd64, x86_64는 같은 종류의 아키텍처를 가리킵니다. amd64는 해당 아키텍처를 사용하는 Intel 프로세서에도 적용됩니다. arm64와 aarch64는 64비트 ARM을 뜻합니다. 모바일 운영체제에서는 앱이 사용할 수 있는 바이너리 인터페이스를 ABI로 표시하기도 합니다.

다른 컴퓨터용 설치 파일을 다운로드한다면 먼저 해당 기기에서 시스템 정보를 확인하게 하세요. 같은 모델이라도 하드웨어 구성이 다를 수 있고, 가상 머신을 사용하거나 프로세서는 64비트 프로그램을 실행할 수 있지만 운영체제는 32비트일 수도 있습니다. 따라서 기기명이나 제품명만으로 실제 시스템 종류를 판단할 수 없습니다. 설치 프로그램에서 아키텍처 오류가 표시되면 파일 이름을 바꾸거나 호환 모드를 반복해서 시도하기보다 대상 시스템에 맞는 패키지를 다시 선택하세요.

다운로드 및 설치

다운로드·압축 해제·설치 오류 구분하기

브라우저에 다운로드 기록이 있어도 파일 저장이 끝난 것은 아닙니다. 다운로드 상태를 확인해 작업이 중단되지 않았는지 살펴본 뒤 다운로드 폴더에서 파일을 여세요. ZIP 압축이 풀리지 않으면 다운로드가 완료됐는지 확인하세요. DMG를 마운트했는데 앱이 열리지 않으면 안내에 따라 앱을 복사했는지, 시스템에서 어떤 이유를 표시하는지 확인하세요. APK를 다운로드했지만 설치 화면이 열리지 않으면 현재 파일을 여는 앱에 설치 출처 권한이 있는지 확인하세요.

시스템 설치 화면이 열린 뒤에는 가장 먼저 표시된 명확한 오류 메시지를 보존하세요. 권한 부족, 패키지 형식 불일치, 의존성 누락, 버전 다운그레이드는 서로 다른 문제입니다. 예를 들어 Linux의 의존성 오류는 패키지 관리 단계에서 발생하며 구독 업데이트 여부와는 관계가 없습니다. 조직에서 관리하는 기기라면 먼저 설치 정책을 확인하고 시스템 보안 설정을 바꿔 제한을 우회하지 마세요.

덮어 업데이트

설정과 설치 경로 유지

덮어 설치하기 전에 클라이언트의 현재 버전, 설정 저장 위치, 내보내기 옵션을 확인하세요. 구독은 다시 가져올 수 있지만 직접 추가한 노드, 규칙 순서, 로컬 수신 포트, 앱별 예외는 구독만으로 복원되지 않을 수 있습니다. 현재 클라이언트의 내보내기 기능을 우선 사용하고 필요한 구독 주소는 기기에 안전하게 별도로 보관하세요. 버전이나 운영체제가 다른 클라이언트끼리 설정 폴더를 그대로 공유할 수 있다고 가정하지 마세요.

업데이트할 때는 먼저 앱과 백그라운드 프로세스를 종료한 뒤 같은 플랫폼·아키텍처·배포 경로의 설치 파일을 선택하세요. 서명이 달라 배포 경로 간 업데이트가 거부되더라도 구버전을 실행할 수 있다면 먼저 내보내고 백업을 읽을 수 있는지 확인하세요. 삭제부터 하지 마세요. 이전 버전으로 되돌릴 때도 구버전이 새 버전에서 저장한 설정을 읽을 수 있는지 먼저 확인하고, 중요한 규칙은 업데이트 전에 복사본을 보관하세요.

설치 후 확인

클라이언트를 실행한 뒤 구독 가져오기

처음 실행할 때 앱이 정상적으로 열리고 화면을 조작할 수 있는지 확인한 다음 구독 관리로 이동하세요. 주소를 추가하고 그룹을 저장한 뒤 업데이트를 실행해 항목이 원하는 그룹에 표시되는지 확인하세요. 단일 공유 링크와 구독 주소는 입력 위치가 다릅니다. 공유 링크는 보통 노드 하나를 가져오고, 구독 주소는 저장한 뒤 그룹을 업데이트해야 합니다. 입력 유형을 잘못 선택한 문제를 해결하려고 앱을 다시 설치하지 마세요.

가져오기가 완료되면 정상 작동을 확인한 설정 하나를 선택해 연결을 테스트하세요. 일부 프로그램에서만 연결을 사용할 수 없다면 해당 프로그램이 시스템 프록시를 따르는지, 로컬 포트가 일치하는지 확인하세요. 구독 목록이 비어 있다면 구독이 유효한지, 주소가 완전한지, 현재 클라이언트가 해당 형식을 지원하는지 먼저 확인하세요. 설정 방법은 사용 설명서에서, 프로토콜과 코어의 호환 범위는 프로토콜 상세 안내에서 확인할 수 있습니다.

다운로드 및 설치 자주 묻는 질문

파일, 시스템, 설치 경로를 먼저 확인하세요. 클라이언트가 실행된 뒤 구독 가져오기와 연결 설정을 확인하면 됩니다.

클라이언트를 다운로드하면 구독도 자동으로 제공되나요?

아니요. 설치 파일에는 클라이언트만 포함되어 있습니다. 기존 구독 주소나 공유 링크를 클라이언트에서 가져온 다음 해당 그룹을 업데이트하세요. 구독 주소에는 접속 정보가 포함될 수 있으니 공개 댓글이나 스크린샷에 붙여 넣지 마세요.

Windows용 ZIP 파일은 압축을 풀지 않고 실행해도 되나요?

먼저 압축 파일 전체를 일반 폴더에 풀고, 폴더 안의 설치 프로그램을 실행하세요. 파일 하나만 바탕 화면으로 옮기거나 압축 파일 미리 보기에서 프로그램을 바로 실행하지 마세요. 함께 들어 있는 파일을 찾지 못할 수 있습니다.

macOS용 DMG 파일 두 개 중 어떤 것을 선택해야 하나요?

시스템 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’에 Apple M 시리즈가 표시되면 Apple Silicon을, ‘프로세서’에 Intel이 표시되면 Intel을 선택하세요. macOS의 주 버전으로는 프로세서 종류를 판단할 수 없습니다.

Android 범용 버전으로 앱 서명 충돌을 해결할 수 있나요?

아니요. 범용 버전은 지원되는 프로세서 아키텍처에 맞추기 위한 것으로, 앱 서명은 바뀌지 않습니다. 기기에 설치된 구버전이 다른 배포 경로에서 받은 앱이라면 기존 경로에서 호환되는 업데이트를 먼저 사용하세요. 배포 경로를 바꿔야 한다면 설정을 백업하고 복원할 수 있는지 확인한 뒤 구버전을 삭제하세요.

Linux 설치 중 의존성을 충족하지 못한다는 메시지가 나오면 어떻게 해야 하나요?

먼저 배포판, 시스템 버전, CPU 아키텍처를 확인한 다음 배포판의 패키지 설치 도구에서 누락된 의존성을 살펴보세요. 패키지 관리자가 의존성을 해결하지 못하면 강제로 설치하거나 다른 형식의 패키지로 대체하지 마세요. 패키지 형식이 맞아도 현재 배포판 버전과 호환된다는 뜻은 아닙니다.

카드에 표시된 버전과 설치 파일 이름의 버전이 다른 이유는 무엇인가요?

카드에는 목록에 등록된 앱 버전이 표시되고, 파일 이름에는 선택한 다운로드 항목의 설치 파일 버전이 표시됩니다. 두 버전이 다르면 카드의 버전만 보고 덮어 설치 가능 여부를 판단하지 마세요. 설치 파일과 시스템 설치 화면에 표시된 버전, 현재 클라이언트 버전을 확인하세요.