클라이언트 설치 파일 · 플랫폼 및 아키텍처 선택

V2Ray 클라이언트 다운로드

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장합니다. 먼저 운영체제를 확인한 다음 CPU 아키텍처에 맞는 설치 파일을 선택하세요.

무료 오픈 소스 클라이언트입니다. 연결하려면 사용 권한이 있는 구독 또는 노드 설정을 별도로 가져와야 합니다.

설치 파일 선택

운영체제별 다운로드

플랫폼 선택은 주소창에 반영되어 저장하거나 공유하기 쉽습니다. 버전 정보는 각 클라이언트 카드에서 확인하고, 다운로드 전에 패키지 형식과 아키텍처도 함께 확인하세요.

Windows: v2rayN 설치 파일

v2rayN 우선 권장

7.24.1

두 다운로드 항목 모두 x64 압축 파일입니다. 데스크톱 버전은 차세대 크로스 플랫폼 UI를 사용하고, 클래식 WPF 버전은 Windows 전용의 안정적인 클래식 버전입니다. 처음 사용한다면 데스크톱 버전을 먼저 선택하고, 기존 사용 방식에 익숙하다면 전환 여부를 결정하세요.

  • 데스크톱 버전 Desktop · x64

    Avalonia 크로스 플랫폼 UI를 사용합니다. 처음 설치하는 경우나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶은 경우에 적합합니다.

    데스크톱 버전 다운로드 · x64
  • 클래식 WPF 버전 · x64

    Windows 전용 UI 프레임워크를 사용하며, 클래식 레이아웃을 계속 사용하고 싶은 경우에 적합합니다. 필요한 런타임은 데스크톱 버전과 다를 수 있으니 실행 시 안내를 확인하세요.

    클래식 WPF 버전 다운로드 · x64

시스템 및 설치 전 확인 사항

확인 항목이 페이지의 설치 파일 요구 사항확인 위치
시스템 및 아키텍처Windows x64. 지원되는 시스템 버전은 선택한 배포 패키지의 요구 사항을 확인하세요.설정 → 시스템 → 시스템 정보에서 시스템 종류 확인
런타임배포 패키지에 따라 다릅니다. 런타임이 없으면 실행 안내에 따라 해당 아키텍처 구성 요소를 설치하세요.최초 실행 안내 및 애플리케이션 오류 메시지
디렉터리 권한프로그램 및 설정 디렉터리에 쓰기 권한이 필요합니다. 압축 파일은 먼저 전체 압축을 풀어야 합니다.압축 해제 대상 폴더의 속성 및 접근 권한

압축 해제, 최초 실행 및 버전 전환

먼저 시스템 정보에서 시스템 종류가 x64 기반 프로세서인지 확인하세요. 시스템에 ARM이라고 표시된다면 ‘64비트’라는 문구만 보고 이 페이지의 x64 패키지를 선택하지 마세요. 기기의 앱 호환 조건을 먼저 확인해야 합니다. 이 페이지의 두 항목은 x64 환경용이며, 프로세서 이름만으로 다른 아키텍처의 설치 파일을 추측해서는 안 됩니다.

다운로드가 완료되면 압축 파일 전체를 고정된 쓰기 가능 폴더에 풀고, 그 안의 설치 또는 실행 프로그램을 실행하세요. 압축 프로그램의 미리보기 창에서 바로 실행하거나 실행 파일 하나만 꺼내지 마세요. 프로그램이 같은 폴더의 구성 요소를 읽을 수 있으며, 임시 경로에 압축을 풀면 이후 설정 위치를 찾기 어려울 수 있습니다.

처음 실행할 때는 기본 수신 대기 설정을 유지하고 구독을 가져와 서버를 선택한 다음, 안내에 따라 시스템 프록시를 설정하세요. 데스크톱 버전과 WPF 버전을 동시에 실행하면 로컬 수신 대기 포트를 두고 충돌할 수 있습니다. 버전을 전환하기 전에 기존 프로세스를 종료하고 설정을 저장하세요. 두 프로그램 파일을 같은 폴더에 섞어 덮어쓰지 마세요.

실행할 때 런타임 구성 요소가 없다는 안내가 표시되면 구성 요소 이름, 버전, 아키텍처를 기록한 뒤 설치하세요. 실행 실패를 모두 런타임 문제로 단정하지 마세요. 폴더에 쓰기 권한이 없거나, 파일 압축이 완전히 풀리지 않았거나, 이전 프로세스가 포트를 점유한 경우에도 오류가 발생할 수 있습니다. 자세한 절차는 설치 및 최초 실행 가이드에서 확인하세요. 두 UI의 차이는 데스크톱 버전과 WPF 버전 비교를 참고하세요.

다운로드 후 설정 순서

설치를 마친 것은 시작에 불과합니다. 처음부터 네트워크 옵션을 여러 개 바꾸기보다 ‘가져오기, 선택, 연결, 확인’ 순서로 진행하면 문제를 더 쉽게 찾을 수 있습니다.

  1. 사용 권한이 있는 설정 가져오기

    구독 주소나 노드 공유 링크를 준비하고 내용이 완전한지 확인한 뒤 클라이언트에 추가하세요. 구독 주소에는 접근 정보가 포함되는 경우가 많으므로 공개 댓글, 스크린샷, 온라인 변환 도구에 올리지 마세요. 다른 형식이 필요하다면 현재 클라이언트에 맞는 구독 항목을 제공하는지 먼저 구독 제공자에게 확인하세요.

    구독 가져오기 순서 보기 →
  2. 서버 및 프록시 방식 선택

    구독을 업데이트한 뒤 서버 하나를 선택하고 기본 또는 단순 라우팅으로 연결을 확인하세요. 데스크톱에서는 필요에 따라 시스템 프록시를 활성화하고, 모바일에서는 시스템 연결 권한을 승인하세요. 구독 업데이트 성공은 설정을 가져왔다는 뜻일 뿐, 서버에 연결할 수 있다는 의미는 아닙니다.

    프록시 및 라우팅 설정 보기 →
  3. 로그를 확인하고 정상 설정 보관하기

    실제로 접속할 앱으로 연결을 확인하고 로그에서 DNS 확인, 핸드셰이크, 연결 오류를 살펴보세요. 한 번에 설정 하나만 바꾸고 변경 전 값을 기록하세요. 연결이 안정된 뒤 분할 라우팅 규칙을 추가하고, 문제가 생기면 확인이 끝난 이전 설정으로 되돌리세요.

    자주 묻는 질문 분류 보기 →

클라이언트 업데이트 및 설정 보존

업데이트 전에 연결을 중지하고 클라이언트를 종료한 뒤 기존 프로세스가 완전히 끝났는지 확인하세요. 현재 버전의 내보내기 또는 백업 기능으로 설정을 저장하고, 설정 디렉터리를 복사해야 한다면 실제 경로부터 확인하세요. 프로그램 디렉터리, 설정 디렉터리, 시스템 설치 디렉터리는 서로 다를 수 있습니다. 설치 파일만 보관하는 것은 설정 백업을 대신할 수 없습니다.

구독 그룹, 사용자 지정 라우팅, DNS, 수신 대기 포트, 앱 프록시 방식은 업데이트 후 연결 동작에 영향을 줄 수 있습니다. 백업할 때 서버 별칭뿐 아니라 규칙과 매개변수도 보관하세요. 백업 파일에는 구독 주소와 노드 인증 정보가 포함될 수 있으므로 안전한 위치에 보관하고 일반적인 문제 해결 자료처럼 공개하지 마세요.

업그레이드 후 기존 구독이 있는지, 활성 서버가 올바른지 먼저 확인한 다음 포트와 라우팅을 점검하세요. 평소 사용에 문제가 없는 것을 확인한 뒤 오래된 파일을 정리하세요. 이전 버전으로 되돌려야 한다면 업그레이드 전에 저장한 백업을 우선 사용하세요. 새 버전에서 저장한 설정을 구버전이 모두 바로 읽을 수 있다고 가정하지 마세요.

v2rayN, v2rayNG, v2flyNG는 Project V, V2Fly, Xray 생태계의 기능을 쉽게 사용할 수 있도록 지원하는 그래픽 클라이언트입니다. 버전 숫자를 서로 비교하기보다 기기 및 설정 호환성을 먼저 살펴보세요. 프로토콜, 라우팅, TUN의 관계를 더 자세히 알아보려면 기초부터 고급까지 전체 가이드를 확인하세요.

클라이언트 다운로드 자주 묻는 질문

Windows에 처음 설치한다면 데스크톱 버전과 클래식 WPF 버전 중 무엇을 선택해야 하나요?

처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 v2rayN 데스크톱 버전을 먼저 고려해 보세요. 클래식 WPF 버전은 Windows 전용의 안정적인 클래식 버전으로, 기존 인터페이스와 사용 방식에 익숙한 경우에 적합합니다. 두 버전을 동시에 실행하지 마세요. 전환하기 전에 설정을 백업하고 필요한 런타임을 확인하세요.

Android에서는 arm64와 범용 버전 중 어떤 것을 다운로드해야 하나요?

2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택할 수 있지만, 시스템에서 64비트 앱을 지원하는지 확인해야 합니다. CPU 아키텍처를 모르거나 arm64 패키지가 호환되지 않는다는 메시지가 표시되면 범용 버전을 시도해 보세요. 범용 버전은 여러 아키텍처용 구성 요소를 포함해 파일 크기가 더 클 수 있지만, 기능이 더 많은 것은 아닙니다.

클라이언트를 설치했는데도 연결되지 않는 이유는 무엇인가요?

클라이언트는 설정과 연결을 관리하는 도구이며, 설치 파일에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소나 노드 설정을 준비해 가져온 뒤 서버를 선택하고 시스템 프록시 또는 연결 모드를 설정해야 합니다. 오류가 발생하면 먼저 클라이언트 로그를 확인해 설정, 네트워크, 권한 중 무엇이 문제인지 살펴보세요.

클라이언트를 업데이트하기 전에 구독 및 라우팅 설정을 어떻게 보존하나요?

먼저 연결을 중지하고 클라이언트를 종료한 다음, 현재 버전의 내보내기 또는 백업 기능으로 설정을 저장하세요. 데스크톱에서는 실제 설정 디렉터리도 확인해 프로그램 파일만 복사하는 일이 없도록 합니다. 업그레이드 후 구독 그룹, 활성 서버, 수신 대기 포트, 라우팅 규칙을 하나씩 확인하고 기존 백업은 당분간 보관하세요.

다운로드 후 설치할 수 없거나 앱이 호환되지 않는다고 표시되면 어떻게 해야 하나요?

먼저 플랫폼, CPU 아키텍처, 패키지 형식을 확인하세요. Windows 압축 파일은 전체 압축을 풀어야 합니다. macOS에서는 Apple Silicon과 Intel을 구분하고, Android에서는 시스템 아키텍처와 설치 권한을 확인하세요. Linux는 배포판에 맞는 deb 또는 rpm 패키지를 선택해야 합니다. 그래도 설치되지 않으면 전체 오류 메시지를 기록하고 시스템 보안 기능을 바로 끄지 마세요.

v2rayNG와 v2flyNG 설정은 서로 그대로 사용할 수 있나요?

두 클라이언트는 서로 다른 코어를 사용하므로 설정 호환성은 프로토콜, 전송 방식, 세부 매개변수에 따라 달라집니다. 일반적인 공유 링크는 각각 가져오기를 시도할 수 있지만, 모든 고급 설정을 서로 바꿔 쓸 수 있다고 단정할 수는 없습니다. 전환 전에 기존 구독을 보관하고 새 클라이언트에서 다시 가져온 뒤 라우팅과 DNS 설정을 별도로 확인하세요.