설치 파일 목록GUI

V2Ray 클라이언트 다운로드

데스크톱은 v2rayN, Android는 설정에 따라 v2rayNG 또는 v2flyNG를 선택하세요. 먼저 운영체제를 맞춘 뒤 아키텍처와 패키지 형식을 확인하세요.

  1. 운영체제 선택
  2. 시스템 아키텍처 확인
  3. 패키지 형식 또는 인터페이스 버전 확인

시스템에 맞는 설치 파일 선택

설치 대상에 따라 탭을 선택하세요. 다른 기기용 파일을 다운로드할 때는 해당 기기의 시스템 정보를 기준으로 하세요.

Windows 설치 파일

v2rayN

v2rayN

추천 7.24.1

데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하며, 처음 설치하거나 여러 데스크톱 시스템에서 일관된 사용 환경을 원하는 경우에 적합합니다. 클래식 WPF 버전은 익숙한 Windows 레이아웃을 유지하므로 기존 인터페이스와 조작 방식에 익숙한 사용자에게 알맞습니다. 두 버전은 각각 독립적으로 사용할 수 있는 배포 패키지이므로 하나만 선택하면 됩니다.

두 항목 모두 ZIP 파일입니다. 쓰기 가능한 폴더에 압축을 완전히 푼 뒤, 패키지 안의 설치 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 두 번 클릭하지 마세요. 이전 버전에서 옮기는 경우 먼저 트레이에서 기존 클라이언트를 종료한 다음 설치와 테스트를 진행해 두 인스턴스가 로컬 포트를 동시에 사용하지 않도록 하세요.

시스템 요구 사항

확인 항목조건
운영체제 및 아키텍처지원이 계속되는 64비트 Windows 10 또는 11을 권장합니다. 이 페이지의 두 패키지는 모두 x64입니다.
확인 방법‘설정 → 시스템 → 정보’에서 시스템 종류를 확인해 프로세서 아키텍처와 시스템 비트를 확인하세요.
실행 환경런타임 관련 안내가 표시되면 필요한 구성 요소와 버전, 비트 수를 확인하세요.

설치 프로그램이 열렸다고 클라이언트까지 실행된 것은 아닙니다. 처음 실행할 때 트레이 아이콘과 기본 창을 확인하고, 설정 화면에 들어갈 수 있는지 확인한 뒤 설정을 가져오세요.

설치·업그레이드·롤백 점검

문제가 발생한 단계를 먼저 파악하세요. 다운로드, 설치, 실행, 연결 중 어디에서 발생했나요? 이전 단계가 정상적으로 끝났다면 다음 단계에서 원인을 찾아야 합니다. 모든 이상을 설치 파일 탓으로 돌리지 마세요.

01 · 설치 전

시스템 정보와 이전 버전의 설치 경로 기록

본인이나 동료의 기기에 설치할 때는 대상 기기의 운영체제 버전과 아키텍처, 선택한 파일 이름을 먼저 기록하세요. 한 컴퓨터로 여러 기기의 설치 파일을 준비하면 다운로드 기록에서 아키텍처가 비슷한 파일을 잘못 선택하기 쉽습니다. 파일 이름을 대상 기기별로 구분하고, 특히 데스크톱 버전과 클래식 버전, 칩 아키텍처, 같은 클라이언트의 모바일 패키지 두 가지를 구별하세요.

새로 설치한다면 설치 파일과 사용할 설정을 준비하면 됩니다. 업그레이드 전에는 기존 클라이언트를 열어 버전, 인터페이스 버전, 설치 경로, 사용자 데이터 위치를 기록하세요. 구독, 수동 노드, 라우팅, 로컬 포트를 따로 정리하세요. 구독 주소만으로는 전체 설정을 복원하기 어렵습니다. 설정과 내보내기 파일에는 민감한 정보가 들어 있을 수 있으므로 직접 관리할 수 있는 위치에 보관하고, 공개된 문제 해결 스크린샷에 첨부하지 마세요.

컴퓨터를 조직에서 중앙 관리한다면 계정에 설치 권한이 있는지, 앱을 어느 폴더에 설치해야 하는지, 프록시 설정을 조직에서 일괄 배포하는지 먼저 확인하세요. 권한이 부족한 경우 압축을 반복해서 풀거나 같은 아키텍처의 패키지로 바꿔도 설치 제한이 해제되지 않습니다. 여러 폴더에서 계속 시도하기보다 전체 오류 내용을 기기 관리자에게 전달하는 편이 원인을 찾기 쉽습니다.

02 · 설치 중

오류 메시지로 아키텍처·종속성·덮어쓰기 충돌 구분

설치 프로그램에서 앱이 기기와 호환되지 않는다고 안내하면 시스템 정보에서 아키텍처를 다시 확인하세요. 아키텍처가 맞는데도 지원되지 않는다는 메시지가 나오면 운영체제 버전이나 패키지에 필요한 런타임 구성 요소를 확인하세요. 패키지 관리자가 종속성과 버전 범위를 표시하면 그 내용을 기준으로 살펴보세요. 막연히 ‘시스템이 너무 오래됐다’고 판단하지 마세요.

다운로드가 끝난 뒤 압축 도구에서 파일을 열 수 없다고 하면 브라우저의 다운로드가 완료됐는지, 이번에 받은 파일을 열고 있는지 먼저 확인하세요. 같은 이름의 이전 파일이나 다운로드가 끝나지 않은 임시 파일일 수 있습니다. 압축 파일은 먼저 완전히 풀고, 디스크 이미지는 연 다음 앱을 복사하며, 패키지는 시스템 설치 프로그램으로 설치하세요. 파일 확장자를 직접 바꿔도 형식이 변환되지는 않습니다.

같은 앱을 덮어 설치하는 데 실패했다면 새 버전과 기존 버전의 설치 경로 및 버전을 비교하세요. 서명 충돌 오류라면 범용 패키지로 바꿔도 해결되지 않습니다. 버전 롤백 오류라면 실수로 이전 패키지를 선택하지 않았는지 확인하세요. 앱을 삭제해야 한다면 데이터가 내보내졌고 복원할 방법이 있는지 먼저 확인하세요. 앱을 삭제하면 로컬 데이터도 함께 지워질 수 있으므로 첫 번째 테스트 방법으로 삼지 마세요.

03 · 첫 실행

인터페이스가 실행되는지 확인한 다음 설정 테스트

설치 후 이번에 설치한 위치에서 클라이언트를 실행해 기본 화면에 진입할 수 있는지 확인하고 버전 정보를 살펴보세요. 데스크톱 창을 닫아도 프로그램이 트레이나 메뉴 막대에서 계속 실행 중일 수 있으니 다시 열기 전에 기존 인스턴스가 있는지 확인하세요. 실행 직후 종료된다면 오류 내용과 종료 전에 수행한 작업을 기록하세요. 먼저 기존 설정을 모두 가져온 뒤 문제를 찾으려 하지 마세요.

인터페이스가 정상적으로 열리면 구독 가져오기 안내에 따라 설정을 추가하세요. 사용 가능 여부를 확인한 설정 하나를 먼저 선택해 연결이 시작되는지 확인하세요. 설정 목록이 보인다는 사실은 가져오기에 성공했다는 뜻일 뿐, 네트워크 트래픽이 예상대로 프록시를 통과한다는 의미는 아닙니다. 연결이 시작되지 않으면 클라이언트 로그를 확인하고, 연결은 시작되지만 웹 페이지가 열리지 않으면 인터넷 연결 문제 해결을 참고하세요.

일부 앱에서만 차이가 난다면 영향을 받는 앱과 시스템 프록시 사용 여부를 먼저 기록하세요. 일부 앱은 자체 프록시 설정을 사용해 시스템 설정을 따르지 않을 수 있습니다. 다른 조건은 그대로 둔 채 같은 앱에서 연결 전후 결과를 비교한 다음 라우팅 분기를 확인하세요. 연결 단계와 라우팅 단계의 설정을 동시에 바꾸면 결과를 파악하기 어렵습니다.

04 · 업그레이드

복원 가능한 데이터를 보존한 뒤 기존 버전 교체

백업 기능이 있다면 클라이언트의 백업 또는 내보내기 메뉴를 우선 사용하세요. 생성된 파일은 프로그램 폴더 밖에 저장하고, 백업을 만든 버전과 포함된 설정, 수동으로 다시 설정해야 하는 항목을 기록하세요. 다른 클라이언트로 옮길 때 기존 앱 데이터를 새 클라이언트 폴더에 통째로 덮어쓰지 마세요. 클라이언트마다 백업 구조와 필드가 다를 수 있습니다.

전환하기 전에 기존 프로그램을 종료하고 기존 프로그램이 설정한 시스템 프록시를 해제한 뒤 새 버전을 실행하세요. 복원 후 설정이 빠짐없이 들어왔는지, 기존 사용자 지정 포트가 유지됐는지, 시작 프로그램 항목이 여전히 이전 경로를 가리키는지 확인하세요. 테스트가 끝나기 전에 기존 폴더를 삭제하지 마세요. 두 프로그램을 잠시 함께 보관해야 하더라도 동시에 실행하거나 같은 설정 파일에 쓰게 하지 마세요.

롤백할 때는 이전 버전과 호환되는 백업을 우선 사용하세요. 새 버전에서 저장한 데이터는 이전 버전에서 읽지 못할 수 있습니다. 롤백이 끝나면 설정 하나를 먼저 복원해 테스트한 뒤 그룹과 사용자 지정 라우팅을 복원하세요. 이전 버전과 새 버전에서 같은 네트워크로 동일한 문제가 발생한다면 패키지를 계속 바꿔 볼 실익이 적습니다. 연결, 구독, 시스템 프록시 관련 항목에서 원인을 확인하세요.

다운로드 및 설치 FAQ

Windows에 처음 설치할 때 데스크톱 버전과 WPF 버전 중 무엇을 선택해야 하나요?

처음 설치한다면 데스크톱 버전을 권장합니다. 클래식 WPF 버전을 사용 중이고 기존 인터페이스와 조작 방식에 익숙하다면 WPF 버전을 계속 사용할 수 있습니다. 두 다운로드 모두 x64 패키지이므로 먼저 시스템 정보에서 시스템 종류를 확인하세요.

macOS에서 Apple Silicon과 Intel을 어떻게 구분하나요?

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’에 Apple M 시리즈가 표시되면 Apple Silicon을, ‘프로세서’에 Intel이 표시되면 Intel을 선택하세요. 컴퓨터를 바꿨다면 다시 확인하고 이전 기기의 다운로드 기록을 그대로 따르지 마세요.

Android 범용 패키지로 서명 충돌을 해결할 수 있나요?

아니요. 범용 패키지는 여러 프로세서 아키텍처를 지원할 뿐, 서명 충돌은 덮어쓰기 설치 조건이 맞지 않아 발생합니다. 기존 설치 경로를 우선 유지하세요. 꼭 옮겨야 한다면 설정을 복원할 수 있는지 확인한 뒤 기존 앱을 삭제하고 다시 설치하세요.

Linux는 패키지 형식과 프로세서 아키텍처 중 무엇을 기준으로 선택하나요?

두 조건을 모두 맞춰야 합니다. 배포판에 따라 deb 또는 rpm을 선택한 다음, 현재 시스템의 x86_64 또는 arm64 아키텍처에 맞는 항목을 고르세요. 파일 형식을 인식한다고 해서 종속성이 모두 충족되는 것은 아니므로 배포판 버전도 확인해야 합니다.

설정을 가져온 상태인데 새 버전을 설치하기 전에 백업해야 하나요?

네. 구독 항목은 다시 가져올 수 있어도 직접 추가한 노드, 그룹, 라우팅 설정까지 복원되는 것은 아닙니다. 업그레이드 전에 클라이언트의 백업 또는 내보내기 기능을 사용하고, 백업 파일은 기존 프로그램 폴더 밖에 저장하세요.

클라이언트에 표시된 버전과 설치 파일 이름이 다른 이유는 무엇인가요?

카드의 버전은 매니페스트에 기록된 앱 버전이고, 설치 파일 이름은 각 다운로드 항목의 파일 기록을 따르므로 일시적으로 다를 수 있습니다. 특정 버전이 필요하다면 해당 항목의 파일 이름을 확인하세요. 파일 이름으로 버전을 알 수 없거나 두 정보가 일치하지 않으면 덮어써서 업그레이드하지 마세요.