클라이언트 설치 패키지
먼저 운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요. 데스크톱에는 v2rayN을, Android에는 v2rayNG를 권장하며 설정에 따라 v2flyNG를 선택할 수도 있습니다.
처음 설치한 뒤 구독 또는 공유 링크를 가져와야 합니다. 자세한 방법은 사용 가이드 →를 확인하세요.
Desktop은 새로운 크로스 플랫폼 UI를 사용해 처음 설치하는 분에게 적합합니다. WPF는 기존 인터페이스를 유지하는 클래식 안정 버전으로, 익숙한 사용 방식을 선호하는 분에게 적합합니다. 아래 두 링크는 모두 x64 설치 파일이며, 둘 중 하나만 선택하면 됩니다.
ZIP 파일을 다운로드한 뒤 먼저 압축을 완전히 푸세요. 압축 파일 미리보기 창에서 바로 설치 프로그램을 실행하지 말고, 압축을 푼 폴더에서 실행하세요.
시스템 설정에서 ‘시스템 → 시스템 정보’를 열고 시스템 종류가 x64인지 확인하세요. 설치 파일 아키텍처는 시스템과 일치해야 합니다. 프로세서 브랜드만으로는 다운로드할 프로그램을 판단하기 어렵습니다. 이 페이지의 Windows 다운로드는 x64용이므로 파일명에 맞춰 다운로드 주소를 임의로 바꾸지 마세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 운영체제 | 보안 업데이트가 계속 제공되는 Windows를 사용하세요. 최소 버전은 현재 설치 프로그램의 안내를 확인하세요. |
| 프로세서 아키텍처 | x64 시스템인지 시스템 정보에서 확인하세요. |
| 실행 환경 | 선택한 버전의 실행 안내에 따라 필요한 실행 환경을 설치하세요. 아키텍처가 다른 구성 요소를 혼용하지 마세요. |
| 권한 및 설치 경로 | 설치 경로에 읽기 및 쓰기 권한이 있어야 합니다. TUN을 켤 때는 관리자 권한이 필요할 수 있습니다. |
파일을 임시 다운로드 폴더가 아닌 고정된 경로에 압축 해제하세요. 설치 후에는 먼저 일반 권한으로 실행해 기본 창과 설정 화면이 열리는지 확인합니다. 실행 환경이 없다는 안내가 표시되면 필요한 구성 요소 이름과 아키텍처를 확인한 뒤 설치하세요. 같은 설치 파일을 반복해서 다운로드해도 누락된 종속성은 해결되지 않습니다.
처음 실행할 때 로컬 리스닝 포트를 확인한 다음 구독을 가져오세요. WPF에서 Desktop으로 전환하려면 먼저 기존 설정을 내보내고 복구할 수 있는 백업을 보관하세요. 인터페이스마다 메뉴 위치가 다를 수 있으므로 복원 후 구독 그룹, 라우팅, 단축 동작을 하나씩 확인하세요. 로컬 포트를 두고 충돌하지 않도록 두 버전을 동시에 실행하지 마세요.
Apple Silicon 기기는 arm64, Intel 프로세서 기기는 x64를 선택하세요. 시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인한 뒤 다운로드하세요.
두 링크 모두 DMG 설치 이미지입니다. 기기의 외관이나 구입 연도가 아니라 칩 정보를 확인해 선택하세요.
다운로드한 DMG를 열고 앱을 ‘응용 프로그램’ 폴더로 복사한 다음 해당 폴더에서 실행하세요. 마운트된 이미지에서 바로 실행하면 업데이트 위치와 앱 권한을 확인하기 어려워집니다. 복사가 끝나면 설치 이미지를 추출하고, 설치된 앱을 사용하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 운영체제 | 보안 업데이트가 계속 제공되는 macOS를 사용하세요. 최소 시스템 버전은 앱의 호환성 안내를 확인하세요. |
| 칩 유형 | Apple Silicon은 arm64, Intel은 x64를 선택하세요. |
| 설치 위치 | ‘응용 프로그램’ 폴더에 복사하고 대상 위치에 쓰기 권한이 있는지 확인하세요. |
| 네트워크 권한 | 시스템 프록시를 변경하거나 TUN을 켤 때는 시스템 안내에 따라 필요한 권한을 확인하고 허용하세요. |
시스템에서 처음 실행을 차단하면 파일 출처와 아키텍처를 확인한 뒤, 시스템 설정의 ‘개인정보 보호 및 보안’ 안내에 따라 진행하세요. 앱 하나를 실행하기 위해 시스템 보안 기능 전체를 끄지 마세요. 기기가 조직에서 관리되는 경우 네트워크 설정 변경이 관리 정책상 허용되는지 먼저 확인하세요.
실행 후에는 최소한의 설정으로 시작하세요. 구독 하나를 가져와 서버 하나를 선택하고 시스템 프록시를 켠 다음, 시스템 프록시를 따르는 브라우저에서 연결을 확인합니다. 안내와 비교하기 쉽도록 우선 기본 로컬 포트를 유지하세요. 다른 앱의 트래픽까지 처리해야 할 때만 TUN을 설정해 설치 문제와 라우팅 문제를 구분하세요.
Xray 코어를 사용합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하세요. 기기 아키텍처가 불분명하거나 시스템에서 호환되지 않는다고 안내하면 범용 버전을 고려하세요. 실제 지원 여부는 기기의 시스템을 기준으로 확인해야 합니다.
카드에 표시된 버전과 현재 패키지 이름이 출시 시점에 따라 다를 수 있습니다. 설치 전에 시스템 설치 프로그램에 표시된 버전을 확인하고, 설치 후에는 앱 정보에서 실제 버전을 확인하세요.
v2fly 코어를 사용하며, 기존 설정이 해당 코어를 기준으로 구성된 경우에 적합합니다. 선택하기 전에 구독에 필요한 프로토콜과 전송 설정을 확인하세요. 클라이언트 이름이 비슷하다고 기능이 완전히 같다고 가정하면 안 됩니다.
두 클라이언트는 설정을 각각 관리합니다. 처음에는 보통 v2rayNG를 선택하면 됩니다. v2fly 코어가 꼭 필요한 경우에만 v2flyNG를 선택하세요. 범용 버전은 여러 아키텍처를 지원하지만 연결 기능이 더 뛰어나다는 뜻은 아니며, 서버 대역폭도 바꾸지 않습니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 시스템 호환성 | Android 설치 프로그램에서 해당 앱의 최소 시스템 버전을 확인하세요. |
| 앱 아키텍처 | 대부분의 기기는 arm64를 먼저 선택하세요. 잘 모르겠다면 기기 정보를 확인하거나 범용 버전을 선택하세요. |
| 설치 권한 | APK를 실제로 여는 브라우저나 파일 관리자에만 앱 설치 권한을 허용하세요. |
| 연결 권한 | 처음 연결할 때 시스템의 VPN 요청을 승인해야 합니다. 일반적으로 VPN 서비스는 한 번에 하나만 실행할 수 있습니다. |
브라우저 다운로드 목록이나 파일 관리자에서 APK를 열고 앱 이름을 확인한 뒤 설치를 진행하세요. 앱이 설치되지 않는다는 안내가 나오면 저장 공간, 아키텍처, 시스템 버전을 확인하고 서명이 다른 기존 앱이 있는지도 살펴보세요. 바로 기존 앱을 삭제하지 마세요. 먼저 설정을 내보내지 않으면 저장된 구독과 규칙이 함께 삭제될 수 있습니다.
설치가 끝나면 구독을 가져오고 서버를 선택한 다음 연결을 눌러 시스템 권한을 승인하세요. 다른 앱으로 전환한 뒤 연결이 자주 끊기면 배터리 최적화와 백그라운드 활동 제한을 확인하세요. 앱은 실행되지만 연결되지 않는다면 설치 파일을 계속 바꾸기보다 설정, 서버, 네트워크를 점검하세요.
배포판의 패키지 형식에 따라 deb 또는 rpm을 선택하세요. 기본 다운로드는 x64용입니다. Debian·Ubuntu 계열은 보통 deb를, RPM 패키지 관리 체계를 사용하는 배포판은 rpm을 선택하고 현재 패키지의 요구 사항을 시스템이 충족하는지 확인하세요.
arm64 기기에는 해당 아키텍처용 패키지를 사용하세요:
먼저 시스템의 ‘정보’ 또는 하드웨어 정보 화면에서 프로세서 아키텍처를 확인하고, 배포판의 패키지 관리 방식을 살펴보세요. x64는 amd64 또는 x86_64로, arm64는 aarch64로 표시되기도 합니다. 이는 프로세서 명령어 집합을 구분하는 이름이며 클라이언트 기능 버전을 뜻하지 않습니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 Linux 데스크톱 세션이 필요합니다. |
| 패키지 형식 | 배포판에서 지원하는 deb 또는 rpm을 선택하세요. 확장자만 바꿔서는 패키지 형식이 변환되지 않습니다. |
| 프로세서 아키텍처 | x64와 arm64에 맞는 설치 파일을 각각 사용하세요. |
| 종속성 및 권한 | 그래픽 패키지 관리자로 종속성을 확인하고, 설치와 TUN 권한은 시스템 안내에 따라 처리하세요. |
시스템의 그래픽 패키지 설치 프로그램에서 파일을 열고 종속성과 호환성 안내를 먼저 확인하세요. 패키지 관리자에서 종속성을 충족할 수 없다고 표시되면 배포판 버전과 소프트웨어 저장소 상태를 확인하고, 종속성을 강제로 무시하지 마세요. 패키지 형식이 같아도 모든 배포판에서 바로 실행되는 것은 아닙니다. 특히 시스템 런타임 라이브러리 요구 사항을 확인하세요.
설치가 끝나면 앱 메뉴에서 실행하세요. 먼저 설정을 가져와 로컬 프록시를 테스트한 뒤 데스크톱 환경에서 시스템 프록시 설정을 사용하는지 확인하세요. 시스템 프록시 지원 방식은 데스크톱 환경과 앱마다 다릅니다. 특정 앱에서 프록시가 작동하지 않아도 클라이언트 설치에 실패한 것은 아닙니다. TUN이 필요하면 권한과 라우팅을 확인하고 여러 네트워크 설정을 한꺼번에 바꾸지 마세요.
INSTALLATION NOTES
설치, 설정, 연결을 나눠 확인하세요. 먼저 프로그램이 실행되는지 점검하면 반복 설치를 줄일 수 있습니다.
기존 클라이언트를 업데이트하기 전에 프로그램의 백업 또는 내보내기 기능으로 설정을 저장하세요. 구독 그룹, 직접 추가한 서버, 사용자 지정 라우팅, 로컬 리스닝 포트, 앱별 분기 설정을 확인해야 합니다. 내보낸 파일에는 접속 정보가 포함될 수 있으니 안전한 위치에 보관하고 공개 게시판이나 공유 폴더에 올리지 마세요.
그런 다음 연결을 끊고 클라이언트를 종료하세요. 데스크톱 앱은 기본 창을 닫아도 시스템 트레이에서 계속 실행될 수 있으니 업데이트 전에 백그라운드 프로세스가 종료됐는지 확인하세요. 업그레이드 후 설정을 하나씩 비교할 수 있도록 기존 설정과 설치 정보를 보관하고, 새 버전이 정상 작동하는지 확인하기 전에는 이전 백업을 삭제하지 마세요.
클라이언트를 연 뒤 구독 주소나 공유 링크의 출처와 유효성을 먼저 확인하고 가져오거나 업데이트하세요. 서버 하나를 현재 서버로 선택하고 로컬 리스닝 포트를 다른 프로그램이 사용 중인지 확인합니다. 구독 업데이트에 성공했다는 것은 설정을 가져와 해석했다는 뜻일 뿐, 모든 서버에 연결할 수 있다는 의미는 아닙니다.
데스크톱에서는 먼저 시스템 프록시를 켜고, 해당 설정을 따르는 브라우저로 확인하세요. Android에서는 연결을 시작할 때 시스템 VPN 권한을 승인합니다. 이 단계에서는 라우팅 설정을 단순하게 유지하고 기본 연결이 되는지 확인한 뒤 사용자 지정 규칙을 추가하세요. 포트나 라우팅 충돌을 막기 위해 여러 프록시 클라이언트를 동시에 켜지 마세요.
‘프로그램이 실행되지 않음’, ‘구독을 업데이트할 수 없음’, ‘서버 연결 실패’, ‘일부 앱에서만 접속할 수 없음’을 구분하세요. 프로그램 실행 문제는 종속성과 권한을, 구독 문제는 주소와 유효 기간을, 연결 실패는 서버 매개변수와 네트워크를 확인하세요. 일부 앱에서만 문제가 생기면 시스템 프록시, DNS, 라우팅 규칙을 점검하세요.
클라이언트 로그를 확인할 때는 오류 유형, 발생 시각, 당시 작업을 우선 기록하세요. 로그를 공유하기 전에 구독 주소와 서버 접속 정보 같은 민감한 내용을 삭제하세요. 클라이언트를 바꾸기 전에 설정에 필요한 프로토콜과 전송 방식을 확인하세요. 인터페이스가 비슷해도 코어가 다르면 모든 설정을 똑같이 지원하는 것은 아닙니다.
PACKAGE / UPDATE / SETUP
설치 파일, 아키텍처, 업데이트에 관한 간단한 답변입니다. 연결 및 라우팅 문제는 도움말 센터에서 확인하세요.
설치 파일에는 클라이언트 프로그램만 포함되어 있으며, 바로 사용할 수 있는 서버 설정은 제공되지 않습니다. 처음 실행한 뒤 직접 관리하거나 사용 권한을 받은 구독 주소 또는 공유 링크를 가져오고, 서버를 선택해 프록시 모드를 설정해야 합니다. 구독 주소에는 접속 정보가 포함될 수 있으니 공개적으로 공유하지 마세요.
처음 설치한다면 새로운 크로스 플랫폼 인터페이스를 사용하는 Desktop을 권장합니다. WPF는 기존 인터페이스와 사용 방식에 익숙한 분을 위한 클래식 안정 버전입니다. 두 버전은 인터페이스가 다르며 함께 설치할 필요는 없습니다. 전환하기 전에 구독 그룹, 라우팅 규칙, 사용자 지정 설정을 백업하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 다만 기기가 실제로 지원하는 앱 아키텍처를 기준으로 선택하세요. 시스템에서 아키텍처가 호환되지 않는다고 안내하면 범용 버전을 선택할 수 있습니다. 범용 버전은 여러 아키텍처를 지원하며 파일 크기가 더 큰 편입니다. 설치에 실패하면 저장 공간, 시스템 호환성, 기존 앱의 서명도 확인하세요.
먼저 클라이언트의 백업 또는 내보내기 기능으로 구독 그룹, 사용자 지정 라우팅, 서버 설정, 로컬 포트 설정을 저장하세요. 그런 다음 연결을 끊고 프로그램을 종료합니다. 덮어 설치하기 전에 대상 클라이언트, 아키텍처, 설치 위치가 맞는지 확인하세요. 업데이트 후에는 구독, 활성 서버, 시스템 프록시, TUN 상태를 점검하세요.
먼저 브라우저의 다운로드 목록에서 다운로드가 시작됐는지 또는 저장 위치 확인을 기다리는지 살펴보고, 디스크 공간과 네트워크 연결을 확인하세요. 중단됐다면 기존 다운로드 링크를 다시 클릭하면 됩니다. 페이지에 표시된 버전과 파일명이 다르면 카드의 정보와 실제 파일을 각각 확인하세요. 파일명만으로 설치된 버전을 판단하지 마세요.
먼저 설정을 가져오고 사용할 수 있는 서버를 선택했는지 확인하세요. 그런 다음 시스템 프록시가 켜져 있는지, 브라우저가 시스템 프록시 설정을 따르는지 살펴보세요. 시스템 프록시는 해당 설정을 사용하는 앱에만 적용됩니다. 더 많은 앱의 트래픽을 처리해야 한다면 사용 가이드에 따라 TUN을 설정하고 권한과 라우팅을 확인하세요. 여러 프록시 도구를 동시에 켜지 마세요.