설치 파일 및 시스템 요구 사항

V2Ray 클라이언트 다운로드

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하고 v2fly 코어가 필요하면 v2flyNG를 선택하세요. 설치할 기기의 플랫폼을 고른 다음 CPU 아키텍처와 패키지 형식에 맞는 파일을 선택하면 됩니다.

플랫폼별 설치 파일 선택

v2rayN

우선 추천

목록 버전 7.24.1

데스크톱 버전 다운로드 · x64

v2rayN-Desktop-Setup-x64-7.24.1.zip

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

v2rayN-Setup-x64-7.24.1.zip

Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하므로 처음 설치한다면 이 버전부터 시작해도 좋습니다. WPF는 Windows의 클래식 인터페이스를 이어가는 안정 버전으로, 기존 메뉴에 익숙한 사용자에게 적합합니다. 두 버전의 주요 차이는 인터페이스와 설정 위치입니다. 같은 구독을 가져오기 위해 두 버전을 모두 설치할 필요는 없습니다.

Windows 시스템 요구 사항

확인 항목선택 기준
시스템 및 아키텍처Windows 10 / 11 x64 데스크톱 환경을 대상으로 합니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요.
파일 형식두 다운로드 모두 ZIP 파일입니다. 먼저 압축을 완전히 푼 다음 폴더 안의 설치 프로그램을 실행하세요.
실행 환경실행할 때 .NET이 없다는 메시지가 표시되면 오류에 나온 런타임 이름과 버전을 확인해 설치하세요.

압축 파일 미리보기 창에서 설치 프로그램을 바로 실행하지 마세요. 파일 하나만 임시로 풀리고 나머지 설치 리소스는 풀리지 않을 수 있습니다. 업그레이드하기 전에 트레이 메뉴에서 기존 버전을 종료하세요. 기본 창만 닫으면 백그라운드에서 계속 실행될 수 있습니다. 새 버전에서 포트가 이미 사용 중이라는 메시지가 나오면 포트를 바꾸기 전에 기존 프로세스가 실행 중인지 확인하세요.

다운로드 후 확인

첫 설치 및 기존 버전 이전

처음 사용할 때는 프로그램이 정상적으로 실행되는지 확인한 다음 노드를 가져오세요. 기존 버전을 교체할 때는 복구할 수 있는 설정을 보관한 뒤 설치를 진행하세요. 이렇게 하면 문제가 생겼을 때 설치, 설정 불러오기, 네트워크 연결 중 어디서 발생했는지 구분하기 쉽습니다.

다운로드가 끝나면 파일을 저장한 위치에서 열기

파일이 저장된 위치를 확인할 때는 주소 표시줄보다 브라우저의 다운로드 목록을 이용하는 편이 좋습니다. 전송이 완료됐는지 확인한 다음 ‘폴더에서 보기’ 또는 ‘저장 위치 열기’를 선택하세요. 브라우저가 같은 이름의 파일에 번호를 붙일 수 있습니다. 새 파일인지 이전 파일인지 헷갈리면 다운로드 시간과 이 페이지의 버튼 아래 표시된 파일 이름을 비교하세요. 아이콘만 보고 판단하지 마세요.

ZIP은 압축을 풀고, DMG는 마운트하세요. APK와 Linux 패키지는 각 시스템의 설치 프로그램이나 패키지 관리자에 맡기세요. 파일을 열 수 있게 보이도록 확장자를 직접 바꾸지 마세요. 관리 대상 컴퓨터나 휴대폰은 설치 출처, 설치 위치, 네트워크 설정을 제한할 수 있습니다. 제한이 있다면 기기 정책 때문인지 패키지를 잘못 선택했는지 먼저 구분한 뒤 다음 단계를 정하세요. 한 번 설치하기 위해 시스템 전체 정책을 바꾸지 마세요.

업데이트 전에 설정과 프로그램을 따로 보관하기

설치 파일을 다시 다운로드해도 프로그램만 복구할 수 있을 뿐, 직접 추가한 노드나 작성한 라우팅 규칙, 변경한 로컬 포트는 복구되지 않습니다. 라우팅 규칙은 특정 연결을 어떤 출구로 보낼지 결정합니다. 업무용 네트워크나 특정 앱에 맞춰 규칙을 변경한 적이 있다면 업데이트 전에 현재 규칙 구성을 기록해 두세요. 클라이언트에 내보내기 기능이 있으면 우선 사용하되 내보내기 범위를 확인하세요. 노드 목록, 구독 그룹, 프로그램 설정이 모두 같은 파일에 포함된다고 보장할 수 없습니다.

다른 기기로 옮길 때는 내보낸 파일을 본인만 접근할 수 있는 위치에 먼저 저장하세요. 구독 주소에는 보통 접근 권한 정보가 포함되어 있으므로 공개 클라우드 저장소나 단체 채팅으로 전달하지 않는 것이 좋습니다. 주요 옵션 몇 개만 복구하려는 경우에는 노드 주소나 계정 정보는 기록하지 말고 옵션 이름과 현재 값만 적어 두세요. 새 버전이 정상적으로 실행되면 현재 그룹, 선택한 노드, 프록시 상태를 확인하세요. 정상 작동을 확인한 뒤 기존 사본을 정리하면 됩니다.

기본 연결을 확인한 다음 고급 기능 사용하기

처음 연결할 때는 노드 하나와 프록시 방식 하나만 테스트하세요. 데스크톱의 시스템 프록시는 프록시 주소를 시스템에 전달해 해당 설정을 따르는 앱이 사용하도록 합니다. 모든 프로그램이 같은 경로를 이용한다고 보장하지는 않습니다. 휴대폰에서 다른 앱이 시스템 VPN을 사용 중이라면 현재 유지할 연결이 무엇인지 먼저 확인하세요. 테스트할 때는 평소 확인이 필요한 페이지나 앱을 사용하고, 연결에 성공한 설정을 기록한 뒤 항목을 하나씩 조정하세요.

앱은 정상 실행되지만 구독 목록이 비어 있다면 주소가 올바른 그룹에 추가됐는지 확인하고 직접 한 번 업데이트하세요. 목록은 보이지만 페이지가 열리지 않는다면 실제 사용할 노드가 선택됐는지, 관련 프록시 스위치가 켜져 있는지 확인하세요. 라우팅, DNS(도메인 이름을 주소로 변환하는 서비스), 그 밖에 네트워크를 제어하는 옵션을 한 번에 함께 바꾸지 마세요. 항목을 하나씩 바꿀 때마다 원래 상황에서 다시 테스트하면 문제가 생겼을 때 되돌리기 쉽습니다.

다운로드 및 설치 FAQ

Windows 데스크톱 버전과 클래식 WPF 버전을 모두 설치해야 하나요?

하나만 선택하면 됩니다. 처음 설치한다면 데스크톱 버전을 권장합니다. 클래식 인터페이스에 익숙하다면 WPF 버전을 선택할 수 있습니다. 전환하기 전에 실행 중인 버전을 종료하고 설정을 백업하세요. 두 클라이언트를 동시에 실행하면 로컬 포트를 놓고 충돌하거나 서로 시스템 프록시 설정을 덮어쓸 수 있습니다.

Mac에 맞는 설치 파일을 어떻게 확인하나요?

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. M1, M2 또는 이후 모델처럼 Apple 칩이 표시되면 Apple Silicon을, Intel 프로세서가 표시되면 Intel을 선택하세요. 브라우저나 다른 앱이 표시하는 아키텍처가 아니라 이 Mac의 정보를 기준으로 선택해야 합니다.

Android에서 앱을 설치할 수 없다고 합니다. 범용 버전으로 바꿔야 하나요?

기기가 arm64 설치 파일을 지원하지 않으면 범용 버전을 시도해 보세요. 기존 앱과 충돌한다는 메시지가 표시되면 먼저 기존 버전을 어느 배포 경로에서 받았는지 확인하세요. 서명이 다르면 기존 앱 위에 설치할 수 없는 경우가 많습니다. 다시 가져올 수 있도록 설정을 백업하거나 기록한 뒤, 로컬 설정을 잃지 않도록 기존 앱을 삭제할지 결정하세요.

Linux에서 패키지를 설치할 때 의존성이 없다는 메시지가 나오면 어떻게 해야 하나요?

먼저 배포판, 패키지 형식, 아키텍처를 확인한 다음 배포판에 기본 제공되는 패키지 관리자로 패키지를 설치하세요. 특정 의존성을 충족할 수 없다는 메시지가 계속 나오면 의존성 이름과 필요한 버전을 기록하세요. 특히 el10 표시가 있는 RPM은 다른 배포판이나 구형 시스템에 강제로 설치하지 않는 것이 좋습니다.

클라이언트를 설치하면 구독도 자동으로 표시되나요?

아니요. 설치 파일에는 클라이언트 프로그램만 들어 있습니다. 구독은 노드 목록을 가져오는 주소이므로 별도로 가져오거나 기존 기기에서 옮겨야 합니다. 가져온 뒤 해당 구독 그룹을 업데이트하고 목록에서 노드를 선택하세요. 전체 구독 주소를 공개 질문 게시글에 올리지 마세요.

업데이트 후 연결되지 않으면 무엇부터 확인해야 하나요?

새 버전이 기존 설정을 제대로 불러왔는지 먼저 확인한 다음, 선택한 노드와 시스템 프록시 상태를 살펴보세요. 설정이 바뀌었다면 한 번에 하나씩만 이전 상태로 되돌리고, 기존에 접속되던 같은 페이지로 확인하세요. 앱이 열리지 않는다면 구독을 먼저 수정하지 말고 실행 또는 설치 문제부터 점검하세요.

전체 FAQ 보기 →