클라이언트 설치 파일 및 아키텍처 선택
먼저 운영체제를 선택한 다음 CPU 아키텍처를 고르세요. 데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 우선 사용하고 V2Fly 코어가 필요하면 v2flyNG를 선택하세요.
세 클라이언트 모두 무료 오픈 소스 소프트웨어입니다. 설치 파일은 클라이언트를 준비하는 용도이며, 구독 및 서버 설정은 별도로 가져와야 합니다.
처음 설정하기: 구독 가져오기 및 연결 안내 →플랫폼별 선택
아키텍처가 불확실하면 먼저 시스템의 ‘정보’ 또는 기기 정보를 확인한 뒤 해당 파일을 다운로드하세요.
7.24.1
데스크톱 버전 Desktop · x64
차세대 크로스 플랫폼 UI를 적용했습니다. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하고 싶은 경우에 적합합니다.
클래식 WPF 버전 · x64
익숙한 Windows 인터페이스를 유지하는 클래식 안정 버전입니다. WPF 버전의 사용 방식에 익숙하다면 계속 이 버전을 선택할 수 있습니다.
두 파일 모두 ZIP 압축 파일입니다. 먼저 압축을 완전히 푼 다음 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요.
| 확인 항목 | 선택 및 준비 |
|---|---|
| 운영체제 및 아키텍처 | 이 페이지에서는 Windows x64 패키지를 제공합니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요. x64 패키지를 다른 아키텍처용 패키지로 간주하지 마세요. |
| 실행 환경 | 필요한 운영체제 버전과 런타임은 현재 설치 프로그램의 안내를 따르세요. 런타임이 없다는 알림이 표시되면 먼저 구성 요소 이름과 아키텍처를 확인하세요. |
| 폴더 및 권한 | 현재 계정으로 쓸 수 있는 폴더에 압축을 풀고 설치 및 설정 공간을 확보하세요. 기본 시스템 프록시를 테스트할 때 처음부터 TUN을 활성화할 필요는 없습니다. |
데스크톱 버전과 WPF 버전의 주요 차이는 인터페이스 기술과 화면 구성입니다. 구독이 서로 다른 서버 구성으로 자동 변환되는 것은 아닙니다. 처음 설치한다면 우선 한 버전을 선택하고 구독 가져오기와 브라우저 접속을 테스트한 뒤 변경 여부를 결정하세요. 두 버전을 비교할 때는 현재 인스턴스를 종료해 로컬 수신 포트 충돌을 방지하고, 다른 인스턴스의 트레이 상태를 현재 설정으로 착각하지 않도록 주의하세요.
기존 설정이 있다면 업그레이드하거나 인터페이스 버전을 바꾸기 전에 구독 그룹, 라우팅, DNS 설정을 백업하세요. 설치가 끝나면 실행 경로와 실제로 읽는 설정 위치를 확인하세요. 프로그램 파일 하나만 복사해 기존 폴더를 덮어쓰면 안 됩니다. 시작 오류가 발생하면 오류 원문을 보관하고 런타임 누락, 폴더 권한, 포트 사용 중 문제를 구분해 원인에 맞게 점검하세요.
7.24.1
Apple Silicon · arm64
‘이 Mac에 관하여’에 Apple 칩이라고 표시되면 이 항목을 선택하세요. 칩에 맞는 arm64 앱 패키지입니다.
Intel · x64
‘이 Mac에 관하여’에 Intel 프로세서라고 표시되면 이 항목을 선택하세요. 기기 외관이나 구입 연도로 아키텍처를 추측하지 마세요.
DMG를 연 뒤 설치 창의 안내에 따라 앱을 설치하세요. 설치가 끝나면 디스크 이미지가 아닌 응용 프로그램 폴더에서 실행하세요.
| 확인 항목 | 선택 및 준비 |
|---|---|
| 칩 종류 | 시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인해 Apple Silicon 또는 Intel 패키지를 선택하세요. |
| 운영체제 버전 | 앱의 구체적인 시스템 요구 사항은 현재 배포 패키지의 안내를 따르세요. 아키텍처가 맞아도 운영체제 버전이 요구 사항을 충족하지 않을 수 있습니다. |
| 네트워크 권한 | 처음 프록시를 설정하거나 가상 네트워크 인터페이스를 활성화할 때 시스템 권한 안내를 확인하고 현재 작업에 필요한 권한만 허용하세요. |
먼저 칩 종류를 확인한 뒤 해당 디스크 이미지를 여세요. 설치가 끝나면 디스크 이미지를 종료하고 응용 프로그램 폴더에서 클라이언트를 다시 실행해 설정이 정상적으로 저장되는지 확인하세요. 앱을 열 수 없다는 시스템 알림이 표시되면 안내된 원인을 먼저 확인하세요. 출처 확인, 운영체제 버전, 앱 아키텍처 문제를 구분하고 모든 알림을 같은 오류로 취급하거나 시스템의 전역 보안 기능을 끄지 마세요.
처음 연결할 때는 시스템 프록시부터 시작해 시스템 프록시를 따르는 브라우저가 작동하는지 확인한 다음 다른 앱을 테스트하세요. 명령줄 프로그램은 시스템 프록시를 사용하지 않을 수 있습니다. 브라우저는 정상인데 터미널 요청이 실패해도 클라이언트 설치 오류라고 단정할 수 없습니다. 더 많은 앱에 적용해야 한다면 TUN 모드 안내를 확인하고 권한, DNS, 라우팅 설정을 점검한 뒤 하나씩 활성화하세요.
2.2.6
arm64
2015년 이후 출시된 대부분의 스마트폰에는 arm64를 선택하면 됩니다. 다만 기기의 운영체제가 해당 아키텍처용 앱을 실행할 수 있는지 확인하세요.
범용 버전
앱 아키텍처를 모를 때 선택할 수 있는 대안입니다. 여러 아키텍처 구성 요소를 포함하지만 모든 운영체제 버전에서 사용할 수 있다는 뜻은 아닙니다.
Android에서 구독 가져오기, 서버 선택, 라우팅 설정을 할 수 있습니다. 연결을 활성화할 때 시스템 VPN 권한을 확인하세요.
1.10.31
arm64
V2Fly 코어의 동작이 필요하고 기기가 arm64를 지원하는 경우 선택하세요. 기존 설정이 있다면 프로토콜과 전송 방식의 호환성을 먼저 확인하세요.
범용 버전
앱 아키텍처를 확인하기 어려울 때 선택할 수 있습니다. v2rayNG와 다른 코어를 사용하므로 인터페이스가 비슷하다는 이유만으로 설정 호환성을 판단하지 마세요.
v2flyNG는 코어에 대한 명확한 요구가 있을 때 대안으로 선택하세요. 처음 사용한다면 v2rayNG와 같은 절차로 설정을 시작할 수 있습니다.
| 확인 항목 | 선택 및 준비 |
|---|---|
| 앱 아키텍처 | 먼저 기기에서 지원하는 앱 아키텍처를 확인하세요. 프로세서가 64비트를 지원하더라도 현재 운영체제가 완전한 64비트 앱 환경을 제공하지 않을 수 있습니다. |
| 시스템 호환성 | APK 설치 프로그램에 표시되는 시스템 요구 사항을 따르세요. 범용 패키지는 지원 아키텍처를 넓혀 주지만 앱의 시스템 요구 사항을 낮추지는 않습니다. |
| 설치 및 연결 권한 | 실제로 APK를 여는 브라우저나 파일 관리자에만 필요한 설치 권한을 부여하세요. 처음 연결할 때 시스템 VPN 권한도 확인해야 합니다. |
| 백그라운드 실행 | 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 제한을 확인하세요. 다른 VPN 앱이 연결을 사용 중인지도 확인해야 합니다. |
APK를 다운로드한 뒤 다운로드 기록이나 파일 관리자에서 열어 설치하세요. 설치에 실패하면 먼저 오류 내용을 확인하세요. 아키텍처 불일치, 낮은 운영체제 버전, 저장 공간 부족, 서명 충돌은 서로 다른 문제입니다. 백업 없이 기존 클라이언트를 바로 삭제하지 마세요. 구독과 사용자 지정 규칙이 있다면 먼저 내보내기 기능으로 저장한 뒤 재설치 여부를 결정하세요.
v2rayNG와 v2flyNG는 모두 그래픽 클라이언트지만 코어가 지원하는 구체적인 설정 항목은 다를 수 있습니다. 구독을 가져올 수 있다는 것은 클라이언트가 해당 형식을 인식한다는 뜻일 뿐, 모든 연결 매개변수가 작동한다는 의미는 아닙니다. 서비스 제공자가 클라이언트나 코어 요구 사항을 안내했다면 우선 해당 내용을 확인하세요. 클라이언트를 바꾸기 전에 기존 전송 방식, 보안, 라우팅 설정을 기록해 설정 차이를 네트워크 오류로 오인하지 않도록 하세요.
연결 버튼을 켜면 시스템은 보통 VPN 인터페이스를 통해 설정에 해당하는 트래픽을 처리합니다. 이 인터페이스는 로컬 트래픽 처리 방식이며 프록시 아웃바운드를 사용할지는 라우팅 규칙에 따라 달라집니다. 처음 문제를 점검할 때는 프록시 클라이언트를 하나만 켜고 일반 웹페이지부터 테스트한 다음 별도 라우팅이 필요한 앱을 확인하세요. 앱별 라우팅, DNS, 백그라운드 정책을 한꺼번에 변경하면 어느 설정이 결과에 영향을 줬는지 파악하기 어렵습니다.
7.24.1
deb · x64
deb 패키지 관리 체계를 사용하는 x64 데스크톱 시스템용입니다. 설치할 때 소프트웨어 설치 프로그램이 의존성을 처리합니다.
arm64 기기: deb 패키지 다운로드 →rpm · x64
rpm 패키지 관리 체계를 사용하는 x64 데스크톱 시스템용입니다. 배포판 및 의존성 버전이 호환되는지도 확인하세요.
arm64 기기: rpm 패키지 다운로드 →먼저 패키지 체계를 확인한 뒤 CPU 아키텍처를 선택하세요. deb와 rpm은 인터페이스 버전의 차이가 아닙니다. 확장자만 바꾸거나 패키지를 강제로 변환해 설치하는 방법은 권장하지 않습니다.
| 확인 항목 | 선택 및 준비 |
|---|---|
| 데스크톱 환경 | 이 페이지의 그래픽 클라이언트는 사용 가능한 그래픽 데스크톱 세션이 필요합니다. 터미널만 있는 환경은 이 설치 안내의 대상이 아닙니다. |
| 패키지 체계 | 배포판에서 사용하는 패키지 관리자에 따라 deb 또는 rpm을 선택하세요. 확장자가 맞는지 확인하는 것은 시작 단계일 뿐이며 시스템 라이브러리 의존성도 충족해야 합니다. |
| 아키텍처 표기 | amd64와 x86_64는 일반적으로 x64에 해당하고, arm64와 aarch64는 ARM 64비트에 해당합니다. 다운로드 전에 시스템의 실제 아키텍처를 확인하세요. |
| 권한 및 네트워크 모드 | 패키지 설치와 가상 네트워크 인터페이스 활성화에는 서로 다른 권한이 필요할 수 있습니다. 먼저 일반 사용자로 인터페이스를 실행한 뒤 기능 안내에 따라 권한을 설정하세요. |
시스템 설정에서 배포판과 프로세서 정보를 확인하고 알맞은 패키지를 선택한 뒤 시스템 소프트웨어 설치 프로그램으로 여세요. 패키지 관리자가 의존성 부족을 알리면 누락된 라이브러리와 버전 요구 사항을 확인하세요. 의존성을 무시하고 강제 설치하지 마세요. 확장자가 같아도 배포판 간 호환성이 보장되지는 않으며 아키텍처가 맞더라도 시스템 라이브러리 버전은 별도로 확인해야 합니다.
실행한 뒤 구독 하나를 가져오고 프록시 설정을 지원하는 앱에서 연결을 확인하세요. Linux 데스크톱 환경마다 시스템 프록시를 적용하는 방식이 다를 수 있으며 일부 명령줄 프로그램은 별도의 프록시 환경 설정이 필요합니다. TUN은 라우팅, 인터페이스 권한, DNS에 영향을 주므로 기본 연결이 정상인지 확인한 뒤 활성화하는 것이 좋습니다. 테스트 후에는 시스템 라우팅을 원래대로 복구해 남은 설정이 이후 점검에 영향을 주지 않도록 하세요.
다운로드 후
먼저 최소한의 설정으로 연결을 확인한 뒤 라우팅, DNS, TUN 설정을 하나씩 추가하세요.
설치가 끝나면 유효한 구독 주소나 공유 링크를 준비하세요. 구독 주소에는 액세스 권한 정보가 포함되는 경우가 있으므로 안전하게 보관하고 전체 링크가 공개 스크린샷, 게시판, 오류 로그에 노출되지 않도록 하세요. 구독 그룹을 추가한 뒤 업데이트를 실행해 서버 목록이 표시되는지 확인하고 서버 하나를 선택해 연결을 테스트하세요.
목록이 비어 있다면 구독 만료 여부, 그룹 활성화 여부, 업데이트 로그의 구체적인 안내부터 확인하세요. 클라이언트를 반복해서 재설치해도 만료된 구독 주소는 해결되지 않는 경우가 많습니다. 공유 링크를 직접 가져올 때는 복사한 내용이 완전한지 확인하고 공백, 설명 문구, 누락된 매개변수가 섞이지 않도록 하세요.
구독 가져오기 단계 보기 →데스크톱에서는 먼저 시스템 프록시로 브라우저를 테스트하고 Android에서는 VPN 인터페이스 권한을 확인하세요. 웹페이지가 열리면 의도한 라우팅 결과가 나오는지 점검하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 영향을 줍니다. 한 프로그램의 결과만으로 모든 프로그램이 같은 연결 경로를 사용한다고 판단하지 마세요.
라우팅 규칙, DNS, TUN은 서로 다른 단계에 영향을 줍니다. 값을 변경하기 전에 기존 설정을 기록하고 한 번에 하나의 항목만 바꾼 뒤 같은 대상으로 다시 테스트하세요. 문제가 생기면 가장 최근에 변경한 옵션을 먼저 되돌리고 로그에서 아웃바운드와 이름 해석 결과를 확인하세요. 여러 기능을 동시에 바꾸는 것보다 원인을 쉽게 찾을 수 있습니다.
라우팅 규칙 안내 보기 →설치 파일 및 업데이트
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 적용한 데스크톱 버전 Desktop을 선택할 수 있습니다. 클래식 인터페이스에 익숙하거나 기존 작업 흐름을 유지하려면 안정적인 WPF 버전을 선택하세요. 둘 다 v2rayN 클라이언트입니다. 설치 전에 기존 설정을 백업하고, 테스트할 때는 한 번에 하나의 인스턴스만 실행하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 기기에서 지원하는 앱 아키텍처를 기준으로 선택하세요. 아키텍처를 확인하기 어렵거나 arm64 패키지가 호환되지 않는다고 표시되면 범용 버전을 시도할 수 있습니다. 범용 버전이라고 모든 시스템 버전을 지원하는 것은 아니며 서명 충돌도 해결하지 못합니다.
Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. V2Fly 코어의 동작이 필요하거나 관련 설정을 이미 사용 중이라면 v2flyNG를 선택할 수 있습니다. 클라이언트를 고르기 전에 서비스 제공자가 요구하는 프로토콜, 전송 방식, 보안 매개변수를 확인하세요. 구독 링크의 모양만으로 호환성을 판단해서는 안 됩니다.
먼저 운영체제, CPU 아키텍처, 패키지 형식이 서로 맞는지 확인한 다음 시스템에 표시된 오류 내용을 살펴보세요. Windows 압축 파일은 먼저 완전히 풀어야 합니다. Android에서는 설치 출처 권한과 서명 충돌을, Linux에서는 패키지 관리자 의존성을, macOS에서는 칩 종류와 시스템 보안 알림을 확인하세요. 시스템의 전역 보안 기능을 바로 끄지 마세요.
설치는 클라이언트를 준비하는 단계일 뿐입니다. 유효한 구독 주소, 공유 링크 또는 설정도 필요합니다. 먼저 구독을 가져와 서버 목록을 업데이트한 다음 서버를 선택하세요. 필요에 따라 시스템 프록시나 VPN 인터페이스를 활성화하고 대상 앱의 트래픽이 의도한 경로로 나가는지 확인하세요.
먼저 클라이언트의 백업 또는 내보내기 기능으로 구독 그룹, 라우팅 규칙, DNS 설정, 사용자 지정 아웃바운드를 저장하고 기존 네트워크 모드도 기록하세요. 백업에는 구독 주소나 액세스 자격 증명이 포함될 수 있으므로 안전한 곳에 보관해야 합니다. 업그레이드 후 설정을 제대로 읽는지 확인한 다음 연결과 분할 라우팅을 항목별로 테스트하세요.