클라이언트 설치 파일 · 플랫폼 선택
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요.
먼저 운영체제를 확인한 뒤 CPU 아키텍처와 설치 파일 형식을 선택하세요.
클라이언트는 설정과 연결을 처리합니다. 사용을 시작하기 전에 유효한 구독 주소나 설정 파일을 준비하세요.
두 가지 인터페이스 버전 중 사용 방식에 맞는 하나를 선택하세요.
Desktop 버전
Desktop 버전 다운로드 · x64차세대 크로스 플랫폼 UI로, 처음 설치하거나 여러 데스크톱 플랫폼에서 일관된 사용 방식을 원하는 사용자에게 적합합니다. ZIP 파일을 다운로드한 뒤 압축을 풀고 내부의 설치 프로그램을 실행하세요.
클래식 WPF 버전
클래식 WPF 버전 다운로드 · x64Windows WPF 인터페이스를 사용하는 안정적인 클래식 버전입니다. 기존 레이아웃에 익숙한 사용자에게 적합합니다. Desktop 버전과는 별도의 인터페이스이며, 두 구성 요소를 차례로 설치할 필요는 없습니다.
두 버전 모두 x64 패키지입니다. 설치 전에 ‘설정 → 시스템 → 시스템 정보’에서 시스템 종류를 확인해 CPU 아키텍처와 Windows 제품 이름을 혼동하지 않도록 하세요.
| 확인 항목 | 선택 및 준비 |
|---|---|
| 시스템 및 아키텍처 | 64비트 Windows에서는 x64 설치 파일을 사용하세요. 지원되는 Windows 버전은 설치 프로그램의 안내를 확인하세요. |
| 설치 권한 | 쓰기 가능한 폴더에 설치 파일의 압축을 푸세요. 설치 프로그램이나 TUN 네트워크 구성 요소에서 권한을 요청하면 안내에 따라 허용하세요. |
| 실행 환경 | 실행 환경이 없다는 안내가 표시되면 설치 프로그램의 설명에 따라 필요한 구성 요소를 설치하세요. 파일 이름만으로 실행 환경 포함 여부를 판단하지 마세요. |
설치 전에 실행 중인 이전 클라이언트를 종료하세요. 작업 표시줄의 알림 영역에 백그라운드 프로세스가 남아 있는지도 확인해야 합니다. 압축 파일 미리보기에서 프로그램을 바로 실행하지 마세요. 파일을 모두 압축 해제해야 필요한 파일이 누락되어 실행이 실패하는 일을 막을 수 있습니다. 업데이트 전에는 구독 그룹과 사용자 지정 라우팅 설정을 저장한 뒤 기존과 같은 설치 경로를 사용하세요.
처음 실행하면 먼저 구독을 가져와 그룹을 업데이트하고, 사용할 수 있는 설정 항목이 목록에 표시되는지 확인한 다음 시스템 프록시 자동 설정을 활성화하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. 다른 트래픽까지 처리해야 할 때 TUN 안내를 확인하세요. 클라이언트를 종료한 뒤 웹페이지에 문제가 생기면 시스템 프록시가 종료된 로컬 포트를 가리키고 있지 않은지 먼저 살펴보세요.
Windows 전체 설치 안내 보기 →‘이 Mac에 관하여’에서 칩을 확인한 다음 알맞은 DMG를 선택하세요.
Apple Silicon
Apple Silicon 다운로드 · arm64‘이 Mac에 관하여’에 Apple M 시리즈 칩이 표시되는 기기용입니다. 노트북인지 데스크톱인지로 판단하지 말고 칩에 맞는 네이티브 아키텍처 패키지를 우선 사용하세요.
Intel
Intel 다운로드 · x64‘이 Mac에 관하여’에 Intel 프로세서가 표시되는 기기용입니다. 여기서 x64와 파일 이름에 표시된 64는 모두 해당 64비트 프로세서 아키텍처를 뜻합니다.
| 확인 항목 | 선택 및 준비 |
|---|---|
| 칩 유형 | Apple M 시리즈는 arm64, Intel 프로세서는 x64를 선택하세요. |
| 시스템 호환성 | 시스템 업데이트를 계속 제공하는 macOS를 사용하세요. 최소 버전 요구 사항은 앱에 표시되는 안내를 확인하세요. |
| 설치 및 권한 | 앱 설치 공간을 확보하세요. 시스템 프록시를 변경하거나 네트워크 구성 요소를 활성화할 때는 시스템 안내에 따라 권한을 허용하세요. |
DMG를 연 다음 앱을 ‘응용 프로그램’ 폴더로 복사하고, 해당 폴더에서 실행하세요. 디스크 이미지 안에서 계속 실행하지 마세요. 처음 실행할 때 보안 경고가 표시되면 다운로드 출처와 안내 내용을 확인한 뒤 시스템 설정의 ‘개인정보 보호 및 보안’에서 열기 허용 옵션을 살펴보세요. 앱 하나 때문에 시스템 전체의 보안 기능을 끄는 것은 권장하지 않습니다.
설치가 완료되어도 클라이언트를 실행할 수 있을 뿐, 연결을 사용하려면 설정을 가져오고 적절한 프록시 방식을 활성화해야 합니다. 시스템 프록시를 사용하기 전 현재 네트워크 서비스의 프록시 설정을 기록해 두면 사용 후 복원하기 쉽습니다. Wi-Fi, 유선 네트워크 등 네트워크 서비스를 전환한 뒤 프록시 동작이 달라지면 클라이언트를 반복해서 재설치하지 말고 현재 네트워크 서비스의 설정을 확인하세요.
macOS 전체 설치 안내 보기 →v2rayNG를 우선 선택하고, V2Fly 호환성이 필요한 경우에만 v2flyNG를 선택하세요.
arm64 아키텍처
v2rayNG 다운로드 · arm642015년 이후 출시된 대부분의 스마트폰에 적합한 우선 선택입니다. 다만 최종적으로는 운영체제가 지원하는 앱 아키텍처를 확인하세요. 64비트 프로세서가 탑재되어 있어도 운영체제가 완전한 64비트 앱 환경을 제공하지 않을 수 있습니다.
범용 버전
v2rayNG 다운로드 · 범용 버전기기 아키텍처를 모르거나 다른 아키텍처와의 호환성이 필요한 경우에 적합합니다. 범용 패키지에는 여러 아키텍처용 파일이 포함되지만 모든 운영체제 버전이나 앱 서명 충돌 문제를 해결하는 것은 아닙니다.
arm64 아키텍처
v2flyNG 다운로드 · arm64V2Fly 코어와의 호환성이 필요한 설정에 사용하세요. 선택 전에 구독에서 사용하는 프로토콜과 매개변수를 지원하는지 확인해야 합니다. 클라이언트 이름만 보고 설정을 그대로 옮길 수 있다고 판단하지 마세요.
범용 버전
v2flyNG 다운로드 · 범용 버전기기 아키텍처를 모른다면 범용 패키지를 선택할 수 있습니다. v2rayNG에서 전환하기 전에 현재 연결을 끊어 두 앱이 시스템 VPN 연결을 동시에 사용하지 않도록 하세요.
| 확인 항목 | 선택 및 준비 |
|---|---|
| 기기 아키텍처 | 대부분의 64비트 시스템에서는 arm64를 우선 선택하고, 아키텍처를 모른다면 범용 버전을 선택하세요. |
| 설치 권한 | APK를 여는 데 사용할 브라우저나 파일 관리자에만 앱 설치 권한을 부여하세요. |
| 시스템 권한 | VPN 모드를 처음 활성화할 때 시스템의 연결 요청을 승인해야 합니다. 백그라운드 동작은 기기 운영체제에서 관리합니다. |
APK 다운로드가 완료되면 다운로드 기록이나 파일 관리자에서 파일을 여세요. 설치가 차단되었다는 안내가 표시되면 현재 사용하는 앱 설치 출처에만 권한을 허용하고, 설치가 끝나면 권한을 해제할 수 있습니다. 앱을 설치할 수 없다는 메시지가 나오면 먼저 이름은 같지만 서명이 다른 앱이 설치되어 있는지 확인한 다음 저장 공간과 시스템 호환성을 살펴보세요. 기존 앱과 설정을 바로 삭제하지 마세요.
처음 연결할 때 시스템 VPN 권한 요청이 표시되는 것은 VPN 모드의 정상적인 절차입니다. 화면을 잠근 뒤 연결이 끊긴다면 배터리 최적화, 백그라운드 활동, 자동 시작 설정을 확인하세요. 기기마다 메뉴 이름이 다르므로 해당 클라이언트에 필요한 옵션만 조정하세요. 배터리 소모가 심하다면 반복적인 속도 측정과 잦은 업데이트를 줄이고 로그를 확인하세요. 모든 백그라운드 제한을 한꺼번에 해제할 필요는 없습니다.
Android 전체 설치 안내 보기 →먼저 배포판에 맞는 패키지 형식을 선택한 다음 x64 또는 arm64를 확인하세요.
deb 패키지
deb 다운로드 · x64Debian, Ubuntu 등 deb 패키지 관리 방식을 사용하는 데스크톱 배포판용입니다. 파일 이름의 amd64는 x64 아키텍처를 뜻하며 특정 프로세서 제조사에만 해당하지 않습니다.
arm64 기기: deb 다운로드 →rpm 패키지
rpm 다운로드 · x64RPM 패키지 관리 방식을 사용하는 호환 배포판용입니다. 같은 패키지 형식이라도 필요한 종속성이 모두 같지는 않으므로 설치할 때 패키지 관리자가 요구하는 시스템 라이브러리와 실행 환경을 확인하세요.
arm64 기기: rpm 다운로드 →| 확인 항목 | 선택 및 준비 |
|---|---|
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션이 필요합니다. 이 설치 파일은 순수 명령줄 서버의 서비스 설정용이 아닙니다. |
| CPU 아키텍처 | x86_64와 amd64는 x64에 해당하고, aarch64는 arm64에 해당합니다. |
| 종속성 및 권한 | 배포판의 소프트웨어 설치 도구로 종속성을 처리하세요. 네트워크 트래픽 제어 기능에 추가 권한이 필요하면 안내에 따라 설정하세요. |
시스템 설정의 ‘정보’ 페이지에서 아키텍처와 배포판 정보를 확인한 다음 해당 패키지를 열고 그래픽 설치 도구로 설치하세요. 종속성 문제가 표시되면 배포판 버전과 패키지 호환 범위를 먼저 확인하세요. 강제 설치로 종속성 검사를 건너뛰지 마세요. 설치가 끝나면 앱 메뉴에서 클라이언트를 실행하고 그래픽 인터페이스가 정상적으로 표시되는지 확인하세요.
Linux 데스크톱 환경마다 시스템 프록시 지원 방식이 다를 수 있습니다. 클라이언트에서 프록시를 설정해도 일부 앱은 자체 네트워크 설정을 사용할 수 있습니다. 먼저 데스크톱 프록시 설정을 따르는 브라우저로 확인한 뒤 필요에 따라 다른 앱이나 TUN을 설정하세요. 네트워크 방식을 바꾸기 전에는 기존 설정을 기록해 여러 트래픽 제어 기능이 동시에 작동하지 않도록 하세요.
Linux 전체 설치 안내 보기 →설치 파일은 현재 기기에 맞는 클라이언트를 결정할 뿐, 연결 사용 가능 여부를 보장하지 않습니다. v2rayN, v2rayNG, v2flyNG 모두 유효한 연결 설정이 필요합니다. 시작하기 전에 구독 주소나 단일 설정을 준비하고 사용 권한이 있는지 확인하세요. 화면을 공개할 때는 전체 주소, 계정 정보, 서버 인증 정보를 가리세요.
업데이트 전에 중요한 설정을 내보내고 사용자 지정 라우팅, DNS, 로컬 포트를 별도로 기록하세요. 백업 파일에는 민감한 정보가 포함될 수 있으므로 안전하게 관리해야 합니다. 백업한 뒤 프록시를 중지하고 이전 프로세스를 종료한 다음 새 패키지를 설치하세요. 인터페이스나 설치 경로를 바꾸려면 먼저 설정 이전 방법을 확인하세요. 덮어 설치가 모든 상황에 통하는 이전 방법은 아닙니다.
설치 후에는 기존 설정을 읽을 수 있는지 먼저 확인한 다음 연결을 테스트하세요. 처음 실행하면서 모든 설정을 한꺼번에 바꾸지 마세요. 문제가 생기면 오류 메시지와 재현 절차를 기록하는 편이 반복해서 제거하고 재설치하는 것보다 원인을 찾는 데 도움이 됩니다. 클라이언트와 코어의 차이는 클라이언트 3종 비교에서, 라우팅과 DNS 추가 설정은 라우팅 규칙 안내에서 확인하세요.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 적용한 Desktop 버전을 권장합니다. 기존 Windows 레이아웃에 익숙하다면 클래식 WPF 버전을 선택하세요. 두 설치 파일 모두 x64용이므로 원하는 버전 하나만 설치하면 됩니다. 전환 전에는 설정을 백업하고 두 클라이언트를 동시에 실행하지 마세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 단, 최종적으로는 운영체제가 지원하는 앱 아키텍처를 확인하세요. 구형 기기나 특수 운영체제를 사용하거나 아키텍처를 모른다면 범용 버전을 선택할 수 있습니다. 설치에 실패하면 시스템 호환성, 저장 공간, 기존 앱과의 서명 충돌도 확인하세요.
클라이언트는 설정을 읽고 연결을 처리하지만 구독 서비스는 제공하지 않습니다. 설치 후 사용할 권한이 있는 구독 주소나 설정을 가져온 다음, 설정을 선택하고 시스템 프록시 또는 VPN 모드를 구성해야 합니다. 구독 주소는 민감한 정보이므로 공개하지 마세요.
카드에 표시된 버전과 설치 파일 경로는 목록의 별도 항목이며 업데이트 시점이 다를 수 있습니다. 버전 표시는 참고용이고, 실제 설치 파일은 다운로드 링크가 가리키는 파일을 기준으로 확인하세요. 설치 후에는 클라이언트의 정보 화면에서 버전을 확인할 수 있습니다. 다른 버전을 받으려고 파일 이름의 숫자를 직접 바꾸지 마세요.
먼저 구독 그룹, 라우팅 규칙, 사용자 설정을 백업한 뒤 이전 클라이언트를 종료하세요. 덮어 설치할 수 있는지는 패키지 형식, 앱 서명, 설치 경로에 따라 달라집니다. 가능하면 같은 경로를 유지하세요. 서명 충돌이 발생해도 앱 데이터를 바로 삭제하지 말고 백업을 복원할 수 있는지 먼저 확인하세요.
먼저 유효한 설정을 가져와 사용할 항목을 선택했는지 확인한 다음, 시스템 프록시, VPN 또는 TUN이 실제로 활성화되어 있는지 살펴보세요. 이후 로그에서 연결 및 DNS 해석 오류를 확인하고 구독 유효성, 시스템 시간, 포트 사용 여부, 다른 프록시 프로그램과의 충돌을 점검하세요. 원인을 찾기 쉽도록 한 번에 설정 하나만 변경하세요.