클라이언트 설치 파일 / 플랫폼 및 아키텍처
데스크톱은 v2rayN, Android는 v2rayNG를 우선 선택하세요. 운영체제를 확인한 다음 CPU 아키텍처와 설치 파일 형식을 고르면 됩니다.
클라이언트는 무료이며 오픈 소스입니다. 설치 후 유효한 설정을 가져오고 프록시가 제대로 작동하는지 확인해야 합니다.
다운로드 링크는 각 클라이언트 카드에 있습니다. 플랫폼을 전환해 해당 안내를 확인하세요. 아키텍처를 모르겠다면 아래 시스템 요구 사항을 먼저 확인하고 여러 파일을 무작정 설치하지 마세요.
Desktop은 차세대 크로스 플랫폼 UI를 적용해 처음 설치하는 사용자에게 적합하며, 여러 데스크톱 운영체제에서 비슷한 방식으로 사용할 수 있습니다. WPF는 익숙한 Windows 인터페이스와 조작 방식을 유지하는 클래식 안정 버전입니다. 두 버전은 서로 다른 프록시 서비스가 아닙니다. 인터페이스 선호도와 현재 시스템의 실행 환경에 따라 선택하세요.
두 설치 파일은 모두 ZIP 형식입니다. 다운로드한 뒤 압축을 완전히 풀고 폴더 안의 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하면 안 됩니다. 인터페이스 버전을 바꾸기 전 구독 그룹과 사용자 지정 설정을 백업하고 기존 클라이언트를 종료하세요. 로컬 포트와 시스템 프록시 설정이 서로 덮어쓰이는 일을 방지할 수 있습니다.
| 항목 | 선택 기준 |
|---|---|
| 시스템 아키텍처 | 이 페이지의 두 설치 파일은 모두 x64입니다. Windows 설정의 ‘정보’에서 시스템 종류를 먼저 확인하세요. |
| 실행 환경 | 선택한 버전의 실행 안내를 따르세요. 실행 구성 요소가 부족하면 표시된 안내에 따라 설치하면 됩니다. |
| 설치 폴더 | 압축을 풀 폴더에 쓰기 권한이 있어야 합니다. 같은 폴더의 파일을 함께 보관하고 실행 파일만 따로 옮기지 마세요. |
| 권한 | 일반 시스템 프록시와 Tun은 필요한 권한이 다릅니다. 먼저 시스템 프록시로 작동 여부를 확인하세요. |
더블 클릭해도 창이 열리지 않으면 먼저 작업 표시줄 알림 영역에서 클라이언트가 이미 실행 중인지 확인하세요. 포트가 사용 중이라는 안내가 나오면 다른 프록시 프로그램을 종료한 뒤 다시 시도하세요. 창이 표시되지 않는 문제, 실행 환경 누락, 서버 응답 시간 초과는 서로 다른 문제입니다.
첫 설정 단계 계속 보기 →
Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple M 시리즈 칩이면 Apple Silicon을, Intel이라고 표시되면 x64를 선택하면 됩니다. 본체 모양이나 화면 크기로 아키텍처를 판단하지 마세요. 같은 제품군이라도 프로세서 플랫폼이 다를 수 있습니다.
DMG를 연 다음 앱을 ‘응용 프로그램’ 폴더로 복사하고 해당 폴더에서 실행하세요. 처음 실행할 때 보안 알림이 나타나면 다운로드 출처와 시스템 안내를 확인한 뒤 시스템의 ‘개인정보 보호 및 보안’에서 처리하세요. 클라이언트를 실행하기 위해 시스템 보안 기능 전체를 끌 필요는 없습니다.
| 항목 | 선택 기준 |
|---|---|
| Apple Silicon | M 시리즈 칩에는 arm64 DMG를 선택하세요. |
| Intel | Intel 프로세서에는 x64 DMG를 선택하세요. |
| 시스템 호환성 | 최소 macOS 버전은 설치 파일의 요구 사항과 시스템 안내를 확인하세요. |
| 실행 위치 | 앱을 ‘응용 프로그램’ 폴더에 복사한 뒤 실행하세요. 마운트된 디스크 이미지에서 계속 실행하지 마세요. |
앱이 정상적으로 열렸다면 설치 단계가 완료된 것입니다. 설정을 가져온 뒤 시스템 프록시가 활성화되어 있는지 확인하세요. 일부 앱은 시스템 프록시를 따르지 않으므로 별도로 설정해야 할 수 있습니다. 연결에 문제가 있으면 먼저 프록시 적용 범위를 확인하고, Tun이 필요한지 검토하세요. 여러 설정을 한꺼번에 바꾸지 마세요.
권한 및 프록시 문제 해결 →
Android에서 처음 사용한다면 v2rayNG를 우선 선택하세요. 2015년 이후 출시된 주요 스마트폰은 대체로 arm64를 사용할 수 있지만, 일부 기기는 시스템 아키텍처와 프로세서 지원이 다를 수 있으므로 실제 기기 호환 여부를 확인해야 합니다. 아키텍처를 모르면 여러 아키텍처 파일을 포함한 범용 버전을 선택할 수 있습니다. 설치 파일 크기는 더 클 수 있습니다.
APK를 설치한 뒤 기존 설정을 가져오고 서버를 선택하세요. 처음 연결할 때 시스템의 VPN 연결 요청이 표시됩니다. 권한을 허용해야 클라이언트가 기기의 트래픽을 처리할 수 있습니다. 일부 앱에만 프록시를 적용하려면 앱별 프록시 목록을 확인하세요. 트래픽 적용 범위 문제를 해결하기 위해 설치 파일을 반복해서 바꾸지 마세요.
v2flyNG는 V2Fly 코어 설정이 필요한 경우 대안으로 사용할 수 있습니다. 이름은 v2rayNG와 비슷하지만 코어 기능과 지원하는 설정 범위가 같지는 않습니다. 사용 전에 구독에 포함된 프로토콜과 전송 매개변수가 호환되는지 확인하세요. 클라이언트 간 설정 차이를 설치 실패로 오해하지 마세요.
아키텍처 선택 기준은 위와 같습니다. 기기가 지원하면 arm64를, 확실하지 않으면 범용 버전을 선택하세요. 두 클라이언트의 설정을 각각 보관할 수 있지만 연결 테스트 중에는 한 번에 하나의 VPN 서비스만 켜야 합니다. 다른 클라이언트를 실행하기 전에 기존 연결을 끊으면 실제로 어떤 클라이언트가 트래픽을 처리하는지 확인하기 쉽습니다.
| 항목 | 선택 기준 |
|---|---|
| CPU 아키텍처 | arm64는 64비트 앱을 지원하는 기기에 적합합니다. 아키텍처가 확실하지 않으면 범용 패키지를 선택하세요. |
| 시스템 버전 | 현재 APK의 최소 시스템 요구 사항과 설치 프로그램의 안내를 확인하세요. |
| 설치 권한 | APK를 여는 브라우저나 파일 관리자에 ‘알 수 없는 앱 설치’ 권한을 허용하세요. |
| 연결 권한 | 처음 연결할 때 VPN 요청을 허용하세요. 연결이 끊기면 백그라운드 배터리 제한과 다른 VPN 앱을 확인하세요. |
카드에 표시되는 버전과 파일명은 각각 목록의 버전 필드와 다운로드 필드에서 가져오므로 서로 다를 수 있습니다. 두 정보를 별도로 확인하고 다운로드 주소를 임의로 수정하지 마세요. 서명과 버전 업그레이드·다운그레이드 규칙에 따라 기존 앱 위에 설치하지 못할 수 있습니다. 시스템에서 설치를 거부하면 설정을 먼저 보관한 뒤 구체적인 오류 안내를 확인하세요.
먼저 배포판의 패키지 형식을 확인한 다음 CPU 아키텍처를 확인하세요. Debian, Ubuntu 등은 일반적으로 deb를 사용합니다. RPM 패키지 관리 체계를 사용하는 배포판에서는 rpm을 선택하세요. 패키지 형식이 맞더라도 모든 시스템 버전에서 종속성이 충족되는 것은 아니므로 설치 프로그램이 안내하는 라이브러리 버전을 확인해야 합니다.
일반적인 Intel 또는 AMD 64비트 컴퓨터에는 x64를, ARM 64비트 기기에는 아래의 arm64 파일을 선택하세요. 파일명의 amd64와 x86_64는 여기서 x64에 해당하며, aarch64는 arm64에 해당합니다. 설치 중 종속성 누락이나 충돌 안내를 확인하기 쉽도록 시스템의 그래픽 패키지 설치 도구를 우선 사용하세요.
| 항목 | 선택 기준 |
|---|---|
| 데스크톱 환경 | 이 페이지의 클라이언트는 그래픽 인터페이스를 제공하므로 사용 가능한 그래픽 데스크톱 환경이 필요합니다. |
| deb | Debian 패키지 형식을 사용하며 현재 패키지의 종속성을 충족하는 시스템에 적합합니다. |
| rpm | RPM 패키지 형식용입니다. 배포판과 종속성 버전을 확인하세요. |
| 아키텍처 및 권한 | 패키지 아키텍처를 시스템에 맞추세요. 설치와 Tun 기능에 각각 별도 권한이 필요할 수 있습니다. |
설치 프로그램에서 종속성이 충족되지 않는다고 안내하면 종속성 검사를 무시하고 강제로 설치하지 마세요. 배포판 버전과 패키지 형식부터 확인하세요. 설치가 끝난 뒤에는 데스크톱 환경마다 시스템 프록시를 사용하는 방식이 다를 수 있습니다. 브라우저에서 접속된다고 해서 모든 터미널 프로그램에도 프록시가 적용된 것은 아닙니다.
로컬 프록시 작동 여부 확인 →다운로드, 실행, 연결은 각각 다른 단계입니다. 현재 단계의 확인을 마친 뒤 다음 설정을 조정하세요. 문제 해결 시 유효한 단서를 놓치지 않도록 도와줍니다.
클라이언트에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 데스크톱에서는 구독 그룹에 주소를 추가한 뒤 해당 그룹을 업데이트하세요. Android에서는 구독 설정이나 공유 링크 메뉴를 통해 가져오면 됩니다. 구독 주소와 개별 공유 링크는 형식이 다르므로 잘못된 메뉴에 입력하면 목록이 비어 있을 수 있습니다.
업데이트 후 서버 목록에 항목이 표시되는지 확인하고 설정 하나를 선택하세요. 구독 업데이트에 실패하면 요청 안내와 응답 내용을 확인하고, 라우팅이나 DNS부터 변경하지 마세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 화면을 캡처하거나 문의할 때 전체 주소를 가리세요.
데스크톱에서는 먼저 시스템 프록시 모드를 확인하고, 네트워크에 접속할 앱이 시스템 프록시를 사용하는지 살펴보세요. Tun은 트래픽 처리 범위를 바꾸며 추가 권한과 라우팅 설정이 필요할 수 있습니다. 설치 직후 반드시 켜야 하는 기능은 아닙니다. 먼저 변경 요소를 최소화해 연결을 확인하세요.
Android에서는 VPN 요청을 허용한 뒤 앱별 프록시 목록에 대상 앱이 포함되어 있는지 확인하세요. 화면을 잠근 뒤에만 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 연결 중에는 VPN 서비스를 하나만 사용하세요. 다른 앱이 트래픽을 처리하면 문제 원인을 판단하기 어려워집니다.
선택한 서버에 실제로 연결해 속도를 측정한 다음 대상 앱에서 접속을 확인하세요. TCPing은 포트 연결 가능 여부를 주로 보여 주며 전체 프록시 경로 테스트를 대신할 수 없습니다. 테스트가 실패하면 로그의 오류 유형을 기록해 로컬 수신 실패, 원격 응답 시간 초과, 도메인 이름 확인 오류를 구분하세요.
브라우저에서는 접속되지만 다른 앱에서 실패하면 앱의 프록시 설정부터 확인하세요. 모든 앱에서 실패한다면 현재 서버와 네트워크를 확인하세요. 한 번에 하나씩 변경하고 전후 결과를 기록하면 여러 설정을 동시에 바꾸는 것보다 원인을 찾기 쉽습니다.
먼저 패키지 형식과 시스템 안내를 확인하세요. 설치 문제는 대개 기기에서 발생하므로 서버 연결 문제로 바로 판단하면 안 됩니다.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 적용한 Desktop을 선택해 보세요. WPF는 익숙한 클래식 인터페이스를 선호하거나 기존 사용 방식에 익숙한 사용자에게 적합한 안정 버전입니다. 둘 다 v2rayN이지만 메뉴와 사용 위치가 다를 수 있습니다. 전환하기 전에 설정을 백업하고, 두 클라이언트의 시스템 프록시를 동시에 켜지 마세요.
기기 구매 연도가 아니라 시스템에 표시된 CPU 아키텍처를 확인하세요. macOS는 ‘이 Mac에 관하여’에서 칩을 확인합니다. Apple Silicon은 arm64, Intel은 x64를 선택하세요. Linux는 시스템 아키텍처에 따라 amd64·x86_64 또는 arm64·aarch64 패키지를 선택하면 됩니다. 대부분의 Android 스마트폰은 arm64를 사용하며, 호환 여부가 불확실하면 범용 버전을 선택할 수 있습니다.
ZIP은 압축 파일입니다. 먼저 쓰기 가능한 폴더에 압축을 완전히 푼 다음, 압축 해제된 파일에서 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 프로그램만 바로 열면 같은 폴더의 종속 파일을 읽지 못할 수 있습니다. 업그레이드 전에는 실행 중인 클라이언트를 종료하세요.
설치 파일이 기기의 아키텍처에 맞는지, 저장 공간이 충분한지 확인하세요. APK를 여는 브라우저나 파일 관리자에 ‘알 수 없는 앱 설치’ 권한도 허용해야 합니다. 서명이 다르거나 이전 버전으로 내려가는 경우 기존 앱 위에 설치되지 않을 수 있습니다. 설정을 먼저 백업한 뒤 시스템 안내에 따라 처리하고, 반복해서 삭제 후 재설치하지 마세요.
클라이언트만 설치되며 사용할 수 있는 서버 설정이 자동으로 만들어지지는 않습니다. 유효한 구독이나 공유 링크를 가져와 그룹을 업데이트하고 서버를 선택한 다음 적절한 프록시 모드를 켜세요. 데스크톱에서는 시스템 프록시를, Android에서는 VPN 권한을 확인하세요. 마지막으로 실제 연결 속도 테스트와 앱 접속으로 작동 여부를 확인합니다.
구독 그룹, 사용자 지정 라우팅, 로컬 수신 포트, 프록시 모드를 기록하고 클라이언트의 백업 또는 내보내기 기능을 사용하세요. 설정에는 구독 주소와 인증 정보가 포함될 수 있으므로 안전한 위치에 백업을 보관해야 합니다. 업데이트 후 설정을 불러왔는지 확인하고 연결을 테스트하세요. 유일한 백업 파일을 바로 덮어쓰지 마세요.