클라이언트 설치 파일

V2Ray 클라이언트 다운로드

대상 기기의 운영체제를 선택한 다음 CPU 아키텍처와 설치 파일 형식을 확인하세요.

Windows 설치 파일

v2rayN

추천 목록 버전 7.24.1

데스크톱 버전(Desktop)은 최신 크로스 플랫폼 인터페이스를 사용합니다. 클래식 WPF 버전은 안정적인 Windows 클래식 인터페이스를 유지해 기존 사용 방식에 익숙하거나 이전 튜토리얼의 화면을 참고해 메뉴를 찾는 사용자에게 적합합니다. 두 버전의 주요 차이는 인터페이스와 메뉴 배치이며, 버전을 바꾼다고 구독을 변경할 필요는 없습니다.

두 링크 모두 설치 프로그램이 들어 있는 ZIP 파일을 다운로드합니다. 먼저 압축 파일 전체를 로컬 폴더에 풀고 안에 있는 설치 프로그램을 실행하세요. 업그레이드 전에는 알림 영역에 남아 있는 프로세스를 포함해 실행 중인 클라이언트를 모두 종료해야 합니다. 이전 버전과 새 버전이 로컬 수신 포트를 동시에 사용하려는 상황을 방지할 수 있습니다.

시스템 요구 사항

확인 항목요구 조건
운영체제 및 아키텍처64비트 Windows, x64 프로세서
확인 위치설정 → 시스템 → 정보 → 시스템 종류
파일 형식ZIP, 압축을 푼 뒤 설치 프로그램 실행

‘64비트 운영 체제’와 ‘x64 기반 프로세서’를 모두 확인하세요. 이 페이지의 두 다운로드는 모두 x64 패키지입니다. 인터페이스 버전을 바꿔도 아키텍처 요구 사항은 달라지지 않습니다.

패키지 선택, 설치 및 업그레이드

설치 파일은 대상 기기에 따라 선택하고, 설치 후 연결 방식은 클라이언트 설정에서 정합니다. 두 단계를 차례로 확인해 문제를 혼동하지 마세요.

  1. 01 다운로드 전

    대상 기기에서 아키텍처 확인

    다른 기기용 파일을 다운로드한다면 현재 브라우저를 사용하는 기기가 아니라 대상 기기의 시스템 정보를 확인하세요. 특히 프로세서가 실행할 수 있는 명령어 세트와 운영체제가 실제로 지원하는 앱 아키텍처를 구분해야 합니다. 하드웨어가 64비트여도 현재 시스템에서 모든 64비트 앱을 설치할 수 있는 것은 아닙니다.

    같은 클라이언트의 아키텍처별 패키지는 파일 크기만으로 적합한지 판단할 수 없습니다. 범용 패키지가 더 큰 것은 보통 여러 구성 요소를 포함하기 때문이지, 더 많은 프로토콜을 지원해서가 아닙니다. 먼저 아키텍처를 확인한 뒤 같은 플랫폼에서 제공하는 인터페이스나 패키지 형식을 비교하세요.

  2. 02 설치 중

    설치 프로그램의 첫 오류부터 확인

    파일을 열 수 없는 문제, 설치 프로그램이 설치를 거부하는 문제, 클라이언트가 실행 후 종료되는 문제는 각각 발생 단계가 다릅니다. 먼저 파일이 압축 파일인지, 디스크 이미지인지, 시스템 설치 프로그램에서 처리하는 패키지인지 구분하고 처음 표시된 구체적인 오류 메시지를 기록하세요. 마지막에 나오는 ‘설치 실패’보다 원인을 파악하는 데 도움이 되는 경우가 많습니다.

    시스템 버전이나 의존성이 낮다는 메시지가 나오면 현재 시스템이 요구 사항을 충족하는지 확인하세요. 앱이 이미 있거나 덮어쓸 수 없다는 메시지가 나오면 이전 인스턴스가 실행 중인지, 버전을 낮추려는 것인지, 모바일 설치 파일의 출처가 기존 앱과 다른지 확인하세요. 원인을 알아보기 전에 기존 버전을 먼저 삭제하지 마세요.

  3. 03 업그레이드 전

    복구할 수 있도록 설정 백업

    사용자 지정 라우팅, 직접 추가한 노드, 변경한 로컬 포트가 있다면 먼저 클라이언트에서 지원하는 방법으로 설정을 백업하세요. 구독 주소로는 일반적으로 해당 구독의 노드를 다시 가져올 수 있지만, 직접 추가한 노드나 로컬 라우팅 규칙, 현재 선택된 설정까지 복구할 수 있다고 보장되지는 않습니다.

    백업 파일은 직접 관리할 수 있는 위치에 보관하고 구독 주소나 내보낸 설정을 공개 게시판에 올리지 마세요. 업그레이드 후에는 앱이 단독으로 실행되는지, 기존 노드가 남아 있는지 확인한 다음 라우팅과 프록시 상태를 점검하세요. 인터페이스 버전이나 클라이언트를 바꿀 때 설정이 자동으로 이전된다고 가정하지 마세요.

설치 후 첫 점검

클라이언트가 정상적으로 열리는지 확인한 뒤 기존 구독이나 개별 노드를 가져오세요. 첫 테스트에서는 사용 가능한 것으로 확인된 설정 하나만 선택하고 프로토콜과 전송 매개변수는 그대로 두세요. 한 번에 설정 하나만 변경하면 오류가 설정 가져오기, 클라이언트의 트래픽 처리, 원격 연결 중 어느 단계에서 발생했는지 파악하기 쉽습니다.

노드 목록이 있다고 연결이 된 것은 아닙니다

가져오기에 성공하면 클라이언트가 노드 설정을 받았다는 뜻일 뿐, 원격 서버가 작동하거나 현재 앱 트래픽이 클라이언트로 전달된다는 뜻은 아닙니다. 먼저 선택한 노드가 예상한 노드인지 확인한 다음 클라이언트 로그에 연결 요청이 표시되는지 살펴보세요. 구독은 업데이트되지만 실제 연결이 실패한다면 구독 주소와 노드 서버는 별개의 연결이므로 각각 점검해야 합니다.

프록시 연결과 라우팅 규칙 구분하기

시스템 프록시는 해당 설정을 지원하는 앱의 트래픽을 로컬 프록시로 보내지만, 모든 앱이 동일한 프록시 설정을 읽는 것은 아닙니다. 라우팅 규칙은 클라이언트에 들어온 연결이 어떤 아웃바운드로 전달될지 정합니다. 한 앱은 연결되고 다른 앱은 연결되지 않는다면 클라이언트를 다시 설치하거나 바로 전역 라우팅으로 바꾸기보다, 문제가 있는 앱이 로컬 프록시 요청을 보냈는지 먼저 확인하세요.

Android에서 클라이언트로 처음 연결을 시작하면 시스템에서 VPN 연결 권한을 요청하는 경우가 많습니다. 다른 앱이 이미 이 연결을 사용 중이라면 현재 어느 앱이 활성화되어 있는지 확인하세요. 클라이언트에서 노드를 선택하는 것만으로 시스템 권한이나 연결 상태가 대체되지는 않습니다.

오류에 따라 원인을 파악한 뒤 재설치

시작 로그에서 로컬 포트 사용 중이라는 내용이 나오면 이전 인스턴스나 다른 앱이 같은 포트를 사용하고 있는지 먼저 확인하세요. 포트를 바꿔야 한다면 수동으로 입력한 앱의 프록시 설정도 함께 업데이트해야 합니다. 로그에 요청이 클라이언트에 도달한 것으로 표시되면 오류 내용을 바탕으로 원격 주소, 프로토콜, 전송 방식과 라우팅을 확인하세요. 설치 파일, 노드, 분기 규칙을 한꺼번에 바꾸지 마세요.

가져오기와 검증 절차는 시작 가이드에서 확인하세요. 로컬 수신 포트 충돌은 포트 충돌 문제 해결을 참고하고, 설정 항목의 관계는 JSON 매뉴얼에서 살펴볼 수 있습니다.

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

Windows 데스크톱 버전과 클래식 WPF 버전, 어떤 것을 선택해야 하나요?

처음 설치한다면 최신 크로스 플랫폼 인터페이스를 적용한 데스크톱 버전을 선택할 수 있습니다. 기존 사용 방식에 익숙하거나 클래식 인터페이스를 기준으로 한 스크린샷에서 메뉴를 찾으려면 클래식 WPF 버전을 선택하세요. 두 다운로드 모두 x64이며, 인터페이스 선택에 따라 설치 파일의 CPU 아키텍처가 달라지지는 않습니다.

Mac에는 어떤 DMG 파일을 다운로드해야 하나요?

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple M 시리즈 칩이 표시되면 Apple Silicon(arm64), Intel 프로세서가 표시되면 Intel(x64)을 선택하세요. 다른 Mac용 파일을 다운로드할 때는 해당 기기에 표시된 정보를 확인하세요.

Android 범용 버전과 arm64 버전은 어떻게 다른가요?

arm64 버전은 arm64-v8a를 지원하는 Android 기기용입니다. 범용 버전은 여러 아키텍처용 구성 요소를 포함해 파일 크기가 더 큰 편입니다. 아키텍처를 모르겠다면 범용 버전을 먼저 선택할 수 있지만, 모든 Android 버전을 지원한다는 뜻은 아니며 앱 서명 충돌도 해결하지 못합니다.

Linux 배포판에 맞는 설치 파일은 어떻게 선택하나요?

Debian 계열 배포판은 DEB를, RPM을 사용하는 배포판은 RPM을 확인하세요. 시스템 아키텍처와 배포판 호환성도 함께 살펴봐야 합니다. 이 페이지의 RPM 파일명에는 el10이 포함되어 있으므로, RPM 형식이라는 이유만으로 다른 배포판이나 구버전 시스템에 설치할 수 있다고 단정할 수 없습니다.

카드에 표시된 목록 버전과 파일명의 버전이 다른 이유는 무엇인가요?

목록 버전은 클라이언트 항목에 기록된 버전이며, 다운로드 링크는 아키텍처별로 실제 파일에 연결되어 있어 두 버전이 다를 수 있습니다. 다운로드한 패키지는 저장된 파일명으로, 실행 중인 버전은 클라이언트의 버전 정보에서 확인하세요.

설치 후에도 구독이나 노드를 가져와야 하는 이유는 무엇인가요?

설치 파일에는 클라이언트 프로그램이 포함되어 있습니다. 프록시 연결을 사용하려면 기존 구독이나 노드 설정을 가져온 뒤 사용 가능한 노드를 선택하고, 기기 설정에 따라 트래픽을 전달할 방식을 정해야 합니다. 설치 성공, 설정 가져오기 성공, 연결 성공은 서로 다른 상태입니다.