설치 패키지 / 플랫폼 및 아키텍처

V2Ray 클라이언트 다운로드

먼저 운영체제를 선택한 다음 CPU와 패키지 형식에 맞는 파일을 다운로드하세요. 데스크톱에서는 v2rayN을 사용하고, Android에서는 v2rayNG를 권장합니다. v2fly 코어가 필요하다면 v2flyNG를 선택하세요.

플랫폼별 설치 패키지 선택

v2rayN

릴리스 버전 7.24.1 · x64

추천

Desktop은 새로운 크로스 플랫폼 인터페이스를 사용하며, 처음 설치하거나 여러 데스크톱 기기에서 전환해 사용하는 경우에 적합합니다. WPF는 기존의 안정적인 버전으로, 이전 인터페이스와 사용 방식에 익숙한 사용자에게 적합합니다. 두 패키지 모두 ZIP 파일입니다. 먼저 압축을 완전히 푼 다음 패키지 안의 설치 프로그램을 실행하세요. 압축 파일 안에서 바로 실행하지 마세요.

설치 파일에는 클라이언트만 포함되어 있습니다. 설정 가져오기와 연결 확인 방법은 사용 가이드에서, 클라이언트와 코어 선택은 클라이언트 비교에서 확인하세요.

설치 및 업데이트, 순서대로 확인

새로 설치하기 전에 운영체제와 아키텍처 확인

이 페이지를 보고 있는 기기가 아니라 클라이언트를 설치할 기기를 기준으로 선택하세요. 예를 들어 데스크톱 브라우저에서 휴대전화용 설치 파일을 받더라도 Android를 선택해야 합니다. 여러 기기에 사용할 파일을 준비한다면 다운로드 후 원래 파일명을 유지하고 플랫폼별로 나누어 보관하세요. 같은 클라이언트에 비슷한 패키지가 여러 개 있을 수 있으므로 다운로드 순서보다 파일명의 아키텍처와 확장자를 확인하는 편이 정확합니다.

아키텍처와 운영체제 버전은 각각 확인해야 합니다. 아키텍처는 패키지에 포함된 프로그램을 기기에서 실행할 수 있는지를 결정하고, 운영체제 버전은 클라이언트가 필요한 시스템 인터페이스를 사용할 수 있는지를 결정합니다. 아키텍처를 올바르게 선택해도 오래된 운영체제에서 실행된다는 보장은 없습니다. Linux에서는 배포판의 패키지 형식과 의존성도 확인해야 합니다. 설치 프로그램에서 패키지를 거부하면 아키텍처 불일치, 운영체제 버전 미달, 의존성 누락 중 무엇이 원인인지 먼저 살펴보세요.

다운로드한 파일로 설치 시작

먼저 브라우저의 다운로드 목록에서 파일 다운로드가 완료되었는지 확인한 다음 시스템 파일 관리자로 여세요. ZIP은 압축을 완전히 풀어야 하고, DMG는 연 뒤 창의 안내에 따라 앱을 복사해야 합니다. APK는 Android 설치 프로그램으로, deb와 rpm은 해당 배포판의 패키지 관리자로 설치하세요. 확장자만 수동으로 바꿔 한 형식의 패키지를 다른 형식으로 만들지 마세요.

ZIP 압축을 풀었을 때 폴더가 여러 겹이라면 이번에 압축을 풀어 만든 폴더를 열었는지 확인하세요. 이름이 같은 이전 폴더와 혼동하지 않도록 주의해야 합니다. 프로그램 구성 요소를 찾을 수 없다는 메시지가 표시되더라도 실행 파일 하나만 바탕 화면으로 옮겨 실행하지 마세요. 설치가 끝나면 시스템 앱 목록이나 실제 설치 폴더에서 실행하세요. 그래야 이전 바로 가기가 예전 프로그램을 가리키는 일을 막을 수 있습니다. 시스템 권한 안내가 표시되면 설치 프로그램의 권한 요청인지, 시스템 정책 안내인지, 프록시를 처음 활성화할 때 필요한 승인인지 먼저 확인하세요. 각 경우에 필요한 조치는 다릅니다.

업데이트 전에 복구할 수 있도록 설정 보관

업데이트 전 클라이언트 이름과 현재 버전, 설치 경로를 기록해 두세요. 클라이언트에서 백업이나 내보내기를 지원한다면 설정을 먼저 저장하세요. 설정을 가져온 출처별 그룹, 현재 선택된 연결 항목, 시스템 프록시 사용 여부, 직접 지정한 로컬 수신 포트도 기록해 두는 것이 좋습니다. 이러한 설정이 모두 하나의 파일에 들어 있는 것은 아닙니다. 구독 주소와 내보낸 설정에는 접속 정보가 포함될 수 있으므로 본인 기기에 보관하고 공개 게시물이나 오류 화면에 올리지 마세요.

데스크톱에서는 업데이트 전에 프록시를 중지하고 클라이언트를 종료하세요. 시스템 트레이에서 실행 중인 이전 인스턴스도 종료해야 합니다. 업데이트 후 한 번 실행해 기존 그룹과 설정이 남아 있는지 확인한 다음 연결을 시작하세요. Android에서 덮어쓸 수 없다는 메시지가 표시되면 기존 앱을 그대로 두고 서명 충돌인지 확인하세요. 같은 경로에서 아키텍처만 다른 패키지를 반복해서 설치해도 서명 문제는 대개 해결되지 않으며, 설치가 실패할 때마다 기존 앱을 삭제할 필요도 없습니다.

설치 후 프로그램 실행을 확인한 다음 연결을 확인하세요

클라이언트가 실행되고 설정 화면을 열 수 있다면 기본 설치는 완료된 것입니다. 그렇다고 네트워크 연결까지 설정된 것은 아닙니다. 처음 사용할 때는 본인의 구독이나 설정을 가져오고 목록에 항목이 표시되는지 확인하세요. 항목을 선택한 다음 필요한 프록시 모드를 활성화합니다. 목록이 비어 있으면 가져온 그룹과 구독 업데이트 여부를 확인하고, 항목은 있지만 연결되지 않으면 실행 로그를 확인하세요. 이렇게 하면 설정 문제를 패키지 선택 오류로 오해하지 않을 수 있습니다.

데스크톱에서는 시스템 프록시 설정을 따르는 것이 확실한 앱 하나로 먼저 테스트할 수 있습니다. 일부 앱에서만 문제가 발생한다면 별도의 프록시 설정을 사용하는지, 입력한 프로토콜과 포트가 클라이언트 설정과 일치하는지 확인하세요. Android에서 클라이언트는 실행 중인데 시스템 VPN 연결이 만들어지지 않는다면 확인 대기 중인 시스템 승인 요청이 있는지, 다른 앱이 같은 유형의 연결을 사용 중인지 살펴보세요. 진행 순서는 첫 설정 가이드를 참고하고, 수신 포트와 라우팅을 직접 조정하려면 설정 파일 안내를 확인하세요.

설치 패키지 자주 묻는 질문

Windows에서 Desktop과 WPF를 모두 설치해야 하나요?

아니요. 둘 중 하나만 선택하면 됩니다. 처음 설치한다면 Desktop을 권장합니다. 기존 WPF 사용 방식이 익숙하거나 설정을 이전해야 한다면 WPF를 계속 사용할 수 있습니다. 다른 버전을 사용하기 전에는 현재 클라이언트를 종료해 두 버전이 같은 로컬 포트를 동시에 사용하지 않도록 하세요.

macOS에서 Apple Silicon과 Intel 패키지 중 무엇을 선택해야 하나요?

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’ 항목에 Apple M 시리즈가 표시되면 Apple Silicon을, ‘프로세서’ 항목에 Intel이 표시되면 Intel을 선택하세요. 구매 연도나 기기 외관으로 판단하지 마세요.

Android 설치 시 기기와 호환되지 않는다는 메시지가 표시되면 어떻게 하나요?

먼저 Android 버전이 앱의 지원 범위에 포함되는지 확인한 다음, 시스템에서 지원하는 ABI를 확인하세요. arm64-v8a를 지원하지 않는다면 같은 클라이언트의 범용 패키지를 사용해 볼 수 있습니다. 범용 패키지는 지원 아키텍처를 넓히는 것이며, 앱의 최소 Android 버전을 낮추지는 않습니다.

Android 업데이트 중 서명 충돌 메시지가 표시되면 어떻게 하나요?

먼저 현재 설치한 경로에서 같은 앱의 업데이트를 받아 보세요. Android에서는 서명이 다른 패키지로 기존 앱을 바로 덮어쓸 수 없습니다. 다른 경로의 앱으로 바꾸려면 먼저 설정을 백업하거나 내보내세요. 기존 앱을 삭제하면 로컬 데이터가 사라질 수 있습니다.

Linux에서 deb와 rpm 패키지를 함께 사용할 수 있나요?

함께 사용하지 마세요. 먼저 배포판의 패키지 형식을 확인하고 맞는 아키텍처를 선택하세요. Debian·Ubuntu 계열은 보통 deb, Fedora·RHEL 계열은 보통 rpm을 사용합니다. 형식이 맞더라도 현재 배포판과 버전이 패키지 의존성을 충족하는지 확인해야 합니다.

클라이언트를 다운로드해 설치했는데 목록이 비어 있는 이유는 무엇인가요?

설치 파일에는 클라이언트만 포함되며 연결 설정은 들어 있지 않습니다. 먼저 본인의 구독 링크, 공유 링크 또는 설정 파일을 가져와야 합니다. 구독을 가져온 뒤에도 항목이 표시되지 않으면 구독 업데이트를 실행했는지 확인하세요. 전체 구독 주소를 다른 사람에게 보내지 마세요.

클라이언트 다운로드