데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. CPU 아키텍처를 확인한 뒤 알맞은 형식의 파일을 다운로드하고, 설치가 끝나면 구독 그룹에서 기존 구독을 가져오세요.
플랫폼과 설치 파일 선택 ↓운영체제를 먼저 선택한 다음 카드에 표시된 아키텍처와 패키지 형식을 확인하세요. 버전 정보는 다운로드 목록에 따라 업데이트되며, 설치 호환성은 기기 환경도 함께 고려해야 합니다.
같은 클라이언트 카드에서 UI 버전을 선택하세요. Desktop 버전은 차세대 크로스 플랫폼 UI를 사용합니다. 클래식 WPF 버전은 기존 Windows 인터페이스를 유지하는 안정적인 클래식 버전입니다. 기존 사용 방식에 익숙하다면 WPF를 계속 사용하고, 처음 설치한다면 Desktop부터 시작해 보세요.
차세대 크로스 플랫폼 UI입니다. ZIP을 다운로드한 뒤 먼저 압축을 풀고, 폴더 안의 설치 프로그램을 실행하세요. 압축 파일 미리 보기에서 바로 실행하지 마세요.
Windows용 클래식 안정 버전입니다. UI 버전을 바꾸기 전에 구독 주소와 사용자 지정 라우팅을 저장하세요. UI 차이를 구독 정보가 사라진 것으로 오해하지 않도록 주의하세요.
| 확인 항목 | 요구 사항 및 처리 방법 |
|---|---|
| 운영체제 및 아키텍처 | Windows x64 환경용입니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요. 구형 시스템에서는 현재 배포 패키지의 호환성을 별도로 확인해야 합니다. |
| 설치 환경 | 압축 해제와 설치에 필요한 공간을 확보하세요. 설치 프로그램에서 실행 구성 요소가 없다고 안내하면 표시된 구성 요소를 설치하세요. |
| 실행 권한 | 시스템 프록시는 필요할 때 사용하세요. TUN을 활성화하면 가상 네트워크 어댑터와 라우팅을 설정하므로 일반적으로 관리자 권한이 필요합니다. |
실행 중인 기존 인스턴스를 종료한 다음 압축을 풀고 설치하세요. 처음 실행한 뒤 로그에 코어 시작 오류가 있는지 확인하고 구독 그룹을 추가합니다. 포트가 사용 중이라면 다른 프록시 프로세스부터 점검하고, 두 클라이언트가 같은 수신 포트를 놓고 동시에 실행되지 않도록 하세요.
시스템 프록시는 시스템 프록시 설정을 따르는 앱에만 적용됩니다. 클라이언트의 기본 창이 열려도 브라우저 요청이 프록시를 거친다는 뜻은 아닙니다. 구독을 가져오고 노드를 선택한 뒤 시스템 프록시 설정을 확인하고 실제 접속을 테스트하세요.
Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. M 시리즈 칩이면 Apple Silicon, Intel 프로세서라면 Intel을 선택합니다. 컴퓨터 외관이나 구매 연도, 설치 파일 크기만으로 아키텍처를 판단하지 마세요.
M 시리즈 칩용입니다. 실행 환경과 아키텍처가 맞지 않아 발생하는 시작 문제를 줄이려면 네이티브 아키텍처 패키지를 우선 사용하세요.
Intel 프로세서용입니다. 시스템에서 앱을 실행할 수 없다고 표시하면 먼저 아키텍처와 시스템 호환성을 확인한 다음 설치 과정을 점검하세요.
| 확인 항목 | 요구 사항 및 처리 방법 |
|---|---|
| 프로세서 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. ‘이 Mac에 관하여’에서 확인하세요. |
| 시스템 호환성 | 현재 DMG도 시스템 버전과 실행 구성 요소의 영향을 받습니다. 구형 시스템에서는 설치 전에 배포 패키지 요구 사항을 확인하세요. |
| 네트워크 권한 | 시스템 프록시를 변경하거나 TUN을 활성화할 때는 시스템 안내에 따라 권한을 허용하세요. 관리자 인증 정보가 필요하다면 어떤 작업을 실행하는지 먼저 확인하세요. |
DMG를 열고 앱을 ‘응용 프로그램’ 폴더로 복사한 뒤 실행하세요. 마운트된 디스크 이미지에서 계속 실행하면 업데이트와 권한, 설정 경로를 파악하기 어려워질 수 있습니다. 처음 실행할 때 시스템이 차단한다면 파일 출처와 패키지 유형을 확인한 후 시스템의 보안 설정을 이용하세요. 클라이언트 설치를 위해 보안 기능 전체를 끄지 마세요.
구독 업데이트가 성공하면 먼저 노드를 하나 선택해 테스트하세요. Wi-Fi, 유선 네트워크 또는 다른 네트워크 서비스를 전환한 뒤에는 현재 네트워크 서비스의 프록시 상태를 다시 확인하세요. 클라이언트를 종료하기 전에 시스템 프록시를 사용했다면 해당 설정을 복구하세요. 종료 후에도 앱이 중지된 로컬 포트를 가리키는 상황을 방지할 수 있습니다.
Android에서는 v2rayNG를 우선 선택하세요. Xray 코어를 사용하며 해당 프로토콜과 전송 방식을 지원하는 설정에 적합합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 되지만, 일부 기기의 시스템에는 앱 아키텍처 제한이 있으므로 실제 지원 여부를 확인하세요.
64비트 앱을 지원하는 일반적인 Android 기기용입니다. 설치 전에 저장 공간을 확보하고, 설치 후 처음 연결할 때 VPN 요청을 허용하세요.
아키텍처를 확인하기 어렵거나 다른 지원 아키텍처가 필요한 기기에 적합합니다. 범용 패키지를 사용해도 오래된 시스템의 호환성 제한은 해결되지 않습니다.
V2Fly 코어 설정이 필요한 경우 v2flyNG를 선택하세요. v2rayNG와 지원하는 코어 기능 범위가 완전히 같지는 않으므로 노드 이름만 보고 설정이 호환된다고 판단하지 마세요. 특정 프로토콜이나 전송 방식 조합이 필요하다면 클라이언트를 바꾸기 전에 설정 요구 사항을 확인하세요.
arm64 앱을 지원하는 기기용 설치 파일입니다. 설치 후 구독을 별도로 가져오세요. 다른 클라이언트의 설정이 자동으로 이전된다고 가정하지 마세요.
그 밖의 지원 아키텍처를 사용하는 기기나 아키텍처를 아직 확인하지 못한 기기용입니다. 클라이언트를 바꾸기 전에 구독 주소를 보관하고 기존 앱별 프록시 설정을 기록하세요.
| 확인 항목 | 요구 사항 및 처리 방법 |
|---|---|
| 앱 아키텍처 | arm64 앱을 지원한다면 arm64를 우선 선택하세요. 확인하기 어렵다면 범용 버전을 시도하고 시스템 호환성을 점검하세요. |
| 설치 권한 | 시스템 안내에 따라 현재 브라우저나 파일 관리자에서 앱 설치를 허용하세요. 설치가 끝나면 해당 출처의 설치 권한을 해제할 수 있습니다. |
| 연결 환경 | 처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 다른 VPN 앱이 실행 중이면 연결에 충돌이 발생할 수 있습니다. |
| 백그라운드 실행 | 필요에 따라 배터리 최적화와 백그라운드 제한을 조정하세요. 화면을 잠근 뒤 연결이 끊기면 먼저 시스템의 프로세스 관리 설정을 확인하세요. |
‘앱이 설치되지 않았습니다’라는 메시지가 나와도 기존 클라이언트를 바로 삭제하지 마세요. 저장 공간, 설치 파일 아키텍처, 기존 앱 버전과 서명의 호환성을 먼저 확인하세요. 제거 후 다시 설치해야 한다면 설정을 내보내거나 구독 주소를 저장해 두세요. 앱을 바로 삭제하면 내부 데이터가 지워질 수 있습니다.
두 클라이언트의 설정을 각각 보관할 수 있지만, 한 번에 VPN 연결을 설정하는 클라이언트는 하나만 사용하세요. 구독을 가져온 뒤 노드를 선택하고 연결을 시작한 다음 알림 영역의 연결 상태와 실제 요청 결과를 확인하세요. 플랫폼별 자세한 사용법은 Android 설치 및 설정에서 확인하세요.
먼저 배포판의 패키지 형식을 확인한 다음 CPU 아키텍처에 맞는 파일을 선택하세요. 일반적인 Intel 및 AMD 데스크톱은 대개 x64를 사용합니다. ARM 데스크톱이나 개발 기기는 arm64인지 확인해야 합니다. deb와 rpm은 선호에 따라 고르는 형식이 아니라 배포판의 패키지 관리 체계에 따라 달라집니다.
deb 형식을 사용하는 배포판용입니다. 시스템 패키지 설치 프로그램으로 열어 패키지 관리자가 실행 의존성을 확인하도록 하세요.
ARM 기기: arm64 deb 다운로드 →rpm 형식을 사용하며 의존성이 호환되는 배포판용입니다. 패키지 형식이 같다고 모든 시스템 버전에 바로 설치할 수 있는 것은 아닙니다.
ARM 기기: arm64 rpm 다운로드 →| 확인 항목 | 요구 사항 및 처리 방법 |
|---|---|
| 패키지 관리 체계 | Debian·Ubuntu 계열은 보통 deb, Fedora·RHEL 계열은 보통 rpm을 사용합니다. 구체적인 의존성도 확인해야 합니다. |
| CPU 아키텍처 | amd64와 x86_64는 보통 x64를 뜻하고, aarch64는 대개 arm64에 해당합니다. 다른 아키텍처용 패키지를 설치하지 마세요. |
| 데스크톱 환경 | 그래픽 클라이언트에는 사용할 수 있는 데스크톱 세션과 관련 그래픽 실행 의존성이 필요합니다. 순수 명령줄 서버 설치용 안내가 아닙니다. |
| 네트워크 권한 | TUN은 가상 네트워크 어댑터와 라우팅 권한이 필요합니다. 앱이 시스템 프록시 설정을 읽을 수 있는지는 데스크톱 환경과 앱 자체에 따라 달라집니다. |
설치 프로그램에서 의존성이 충족되지 않는다고 표시하면 전체 안내를 기록한 다음 배포판 버전과 패키지 아키텍처를 확인하세요. 의존성 검사를 강제로 건너뛰거나 다른 배포판의 소프트웨어 저장소를 현재 시스템에 추가하지 마세요. 설치 후 일반 데스크톱 세션에서 먼저 실행하고 설정 디렉터리에 쓸 수 있는지 확인한 다음 네트워크 기능을 하나씩 활성화하세요.
클라이언트가 연결되어 있는데 특정 앱이 계속 직접 연결된다면 해당 앱이 데스크톱 시스템 프록시를 사용하는지 먼저 확인하세요. 더 많은 앱 트래픽을 처리해야 한다면 TUN 모드를 검토하고 기존 VPN, 컨테이너 네트워크, 사용자 지정 라우팅을 점검하세요. 여러 네트워크 관리 기능이 동시에 라우팅을 변경하지 않도록 주의해야 합니다.
설정, 테스트, 트래픽 처리 순서로 구성하세요. 설치 문제와 연결 문제를 나눠 점검하고 한 번에 여러 설정을 변경하지 마세요.
구독 그룹 설정을 열고 알아보기 쉬운 별칭과 전체 구독 주소를 입력하세요. 주소에 개인 전용 token이 포함될 수 있으므로 복사할 때 줄바꿈이나 공백, 메신저가 덧붙인 문장 부호가 들어가지 않도록 주의하세요. 안내에 나온 https://example.com/sub?token=xxxx는 형식을 설명하기 위한 예시이며 노드를 가져오는 데 사용할 수 없습니다.
그룹을 저장한 뒤 구독을 업데이트하고 서버 목록에 설정이 표시되는지 확인하세요. 업데이트에 실패하면 주소가 만료되었는지 먼저 확인하고 현재 네트워크에 맞춰 프록시를 사용하거나 사용하지 않고 업데이트하세요. 노드를 선택해 실제 연결 지연 시간을 테스트하세요. TCPing 결과는 포트 연결 여부를 판단하는 보조 자료일 뿐 실제 요청 테스트를 대신할 수 없습니다.
실제 연결 지연 시간 안내 →데스크톱에서 처음 설정한다면 시스템 프록시부터 시작해 어떤 앱이 이를 사용하는지 확인하세요. 더 넓은 범위의 트래픽을 처리해야 한다면 TUN에 필요한 권한과 라우팅 변경 사항을 알아보세요. Android에서는 시스템 안내에 따라 VPN 연결 요청을 허용하세요. 연결 후에도 실제 접속과 출구 IP를 확인해야 적용 여부를 알 수 있습니다.
프록시 모드 설정 보기 →클라이언트를 업데이트하기 전에 구독 주소와 사용자 지정 라우팅, 포트 설정을 저장하세요. 구독 그룹에서 다시 가져올 수 있는 노드와 수동으로 추가한 설정은 따로 관리해야 합니다. 문제가 생기면 먼저 로그의 주요 오류를 기록하고 설치, 코어 시작, 구독 업데이트, 노드 연결 중 어디서 발생했는지 확인하세요. 원인을 찾는 대신 반복해서 재설치하지 마세요.
클라이언트 사용 범위 확인 →운영체제와 아키텍처, 설치 방식을 먼저 확인하세요. 구독 업데이트와 연결 문제는 FAQ에서 더 살펴볼 수 있습니다.
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop 버전을 먼저 고려해 보세요. 클래식 WPF 버전은 Windows용 안정적인 구형 인터페이스로, 기존 UI에 익숙한 사용자에게 적합합니다. 두 버전 모두 x64 패키지입니다. 전환하기 전에 구독 주소와 사용자 설정을 저장하고, 두 인스턴스가 동시에 시스템 프록시를 제어하지 않도록 하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 먼저 선택하면 됩니다. 다만 실제 기기에서 지원하는 앱 아키텍처를 확인하세요. 구형 기기나 32비트 앱만 지원하는 시스템, 아키텍처를 확인하기 어려운 경우에는 범용 버전을 시도할 수 있습니다. 호환되지 않는다는 메시지가 나오면 시스템 버전과 남은 저장 공간, 기존 앱의 서명을 확인하고 반복해서 덮어 설치하지 마세요.
Apple Silicon 패키지는 M 시리즈 칩에, Intel 패키지는 Intel 프로세서에 적합합니다. Apple 메뉴의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 항목을 확인한 다음 해당 DMG를 선택하세요. 패키지 형식이 같아도 CPU 아키텍처는 다를 수 있으므로 기기에 맞는 네이티브 패키지를 우선 사용하세요.
Debian, Ubuntu 및 관련 파생 배포판은 보통 deb를 사용하고, Fedora, RHEL 및 관련 배포판은 보통 rpm을 사용합니다. x64와 arm64도 확인하고 시스템 패키지 설치 프로그램으로 의존성을 점검하세요. 같은 패키지 형식을 사용하는 배포판이라도 의존성 버전이 다를 수 있으므로 의존성 설치를 무시하지 마세요.
클라이언트는 설정을 관리하는 프로그램이며, 설치 파일에 구독 주소나 노드가 포함되어 있지는 않습니다. 사용할 권한이 있는 구독 주소를 준비해 구독 그룹에 저장하고 업데이트한 다음, 노드를 선택해 실제 연결 지연 시간을 테스트하세요. 테스트를 통과하면 시스템 프록시를 설정하거나 필요한 경우 TUN을 활성화하고, 출구 IP를 확인하세요.
구독 주소와 구독 그룹 별칭, 사용자 지정 라우팅 및 포트 설정을 먼저 저장하고, 클라이언트의 내보내기 기능으로 필요한 설정을 백업하세요. 기존 인스턴스를 종료한 뒤 새 패키지를 설치합니다. 실행 후 구독과 라우팅을 확인하고 실제 연결 지연 시간을 다시 테스트하세요. 백업 파일이나 스크린샷에 포함된 token을 공개적으로 공유하지 마세요.