클라이언트 설치 파일 / 아키텍처 선택
운영체제에 맞는 클라이언트를 고른 다음 프로세서에 맞는 설치 파일을 선택하세요.
데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 권장합니다. v2fly 코어가 필요할 때는 v2flyNG를 선택하세요. 먼저 기기를 확인한 뒤 알맞은 파일을 다운로드하세요.
같은 클라이언트, 두 가지 인터페이스. 처음 설치한다면 Desktop 버전을 권장합니다.
Desktop은 차세대 크로스 플랫폼 UI를 사용하므로 처음 사용하는 분이나 여러 데스크톱 운영체제에서 비슷한 방식으로 작업하고 싶은 분에게 적합합니다. WPF는 익숙한 Windows 인터페이스를 유지하는 클래식 안정 버전입니다. 두 버전 모두 그래픽 클라이언트이며, 구독을 가져오기 위해 설정을 직접 작성할 필요가 없습니다.
두 다운로드 파일은 ZIP 압축 파일입니다. 다운로드가 끝나면 압축을 완전히 푼 뒤 내부의 설치 프로그램을 실행하세요. 압축 프로그램의 임시 미리보기 폴더에서 바로 실행하지 마세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 운영체제 | 지원이 계속되는 Windows 10 / 11 사용을 권장합니다. 실제 호환성은 설치 프로그램의 안내를 따르세요. |
| 아키텍처 | 이 페이지의 두 설치 파일은 모두 x64입니다. 먼저 시스템의 ‘정보’에서 시스템 종류를 확인하세요. |
| 설치 방법 | ZIP 압축을 푼 다음 내부 설치 프로그램을 실행하세요. 런타임 안내가 표시되면 지시에 따라 처리하세요. |
| 권한 | 일반적인 구독 작업과 TUN에 필요한 권한은 다릅니다. TUN을 켤 때 안내에 따라 권한을 부여하세요. |
v2rayN을 실행한 뒤 구독 주소를 추가하고 업데이트를 실행하세요. 노드 목록에 항목이 표시되면 사용할 노드를 활성화하세요. 구독 주소와 단일 노드 공유 링크는 서로 다른 형식이므로 각각 구독 관리와 클립보드 가져오기 기능을 사용해야 합니다. 주소만 그룹에 저장하고 업데이트하지 않으면 노드 목록이 비어 있을 수 있습니다.
브라우저처럼 시스템 프록시 설정을 따르는 앱은 먼저 시스템 프록시로 연결을 테스트할 수 있습니다. 일부 앱은 별도의 네트워크 설정을 사용해 시스템 프록시를 자동으로 따르지 않으므로, 이때 TUN 사용을 검토하세요. TUN은 가상 네트워크 어댑터와 라우팅에 영향을 줍니다. 페이지가 열리지 않는다는 이유만으로 여러 트래픽 처리 방식을 동시에 켜지 마세요. 클라이언트를 종료하기 전에 시스템 프록시를 해제하면 다른 앱이 닫힌 로컬 포트에 계속 접속하는 문제를 줄일 수 있습니다.
WPF에서 Desktop으로 바꾸기 전에 구독, 라우팅, 사용자 설정을 백업하세요. 두 인스턴스가 같은 로컬 포트를 동시에 사용하지 않도록 하고, 설치 경로가 다르면 설정도 공유된다고 가정하지 마세요. 이전 후 활성 노드, 시스템 프록시 상태, 시작 프로그램 설정을 확인한 다음 기존 설치를 제거할지 결정하세요.
‘이 Mac에 관하여’를 열어 Apple 칩인지 Intel 프로세서인지 확인하세요.
M 시리즈 칩에는 Apple Silicon 패키지를, Intel 프로세서에는 x64 패키지를 선택하세요. 하드웨어와 일치하는 빌드를 권장합니다. 컴퓨터를 구입한 연도만으로 판단하지 마세요. 외관이 같은 기기도 프로세서가 다를 수 있습니다.
DMG를 열고 창에 표시되는 안내에 따라 설치한 뒤 응용 프로그램 폴더에서 실행하세요. 이후 설정을 진행하기 전에 디스크 이미지에서 실행한 임시 인스턴스를 종료하세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 칩 | Apple M 시리즈는 arm64, Intel 프로세서는 x64를 선택하세요. |
| 운영체제 버전 | 지원이 계속되는 macOS를 사용하세요. 최소 버전은 앱의 실제 요구 사항을 확인해야 합니다. |
| 설치 형식 | DMG 디스크 이미지입니다. 응용 프로그램 폴더에 설치한 뒤 실행하세요. |
| 권한 | 시스템 프록시와 TUN은 서로 다른 권한 안내를 표시할 수 있습니다. 사용하는 기능에 맞춰 각각 확인하세요. |
처음 실행할 때 보안 알림이 표시되면 먼저 파일이 이 페이지에서 선택한 다운로드 경로에서 제공된 것인지 확인한 뒤 시스템 설정의 ‘개인정보 보호 및 보안’을 살펴보세요. 이번 앱 실행 요청에 해당하는 안내만 처리하고 시스템 보호 기능 전체를 끄지 마세요. 앱이 아예 실행되지 않는 문제와 실행은 됐지만 네트워크가 연결되지 않는 문제는 별개이므로 따로 기록해 점검해야 합니다.
앱이 정상적으로 열리면 구독을 가져와 업데이트한 뒤 노드를 선택하세요. 데스크톱 앱의 프록시 사용 여부는 시스템 설정을 따르는지에 따라 달라집니다. 브라우저에 별도로 설정한 프록시 확장 프로그램이 시스템 설정을 덮어쓸 수도 있습니다. 연결을 확인할 때는 프록시 경로를 하나로 고정하세요. 시스템 프록시, 앱 자체 프록시, 다른 네트워크 도구가 동시에 트래픽 경로를 바꾸지 않도록 하세요.
TUN이 필요하면 클라이언트 안내에 따라 권한을 설정하세요. 권한 부여에 실패하면 로그에 기록된 구체적인 오류를 확인하고 가상 네트워크 어댑터나 기존 네트워크 확장 기능과 충돌하는지 살펴보세요. 클라이언트를 업데이트하기 전에 실행 중인 인스턴스를 종료하고 기존 설정을 백업하세요. 교체 후 메뉴 막대 상태와 구독 그룹을 확인해 새 인스턴스가 예상한 설정 경로를 읽는지 점검하세요.
먼저 클라이언트를 고른 뒤 아키텍처를 선택하세요. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다.
Xray 코어를 사용하며 Android에서 구독 가져오기, 노드 선택, 라우팅 설정을 할 수 있습니다. 처음이라면 이 클라이언트를 우선 사용하세요. 프로토콜과 전송 매개변수는 서버 설정과 일치해야 합니다.
arm64 패키지는 해당 앱 아키텍처를 지원하는 기기에서 사용할 수 있습니다. 아키텍처를 확인하기 어렵다면 범용 버전을 선택하세요. 설치 파일과 버전 표기는 배포 채널별 업데이트 일정에 따라 달라질 수 있으므로 실제 버전은 앱 내 표시를 확인하세요.
v2fly 코어를 사용하며 기존 설정이 이 코어에 의존하는 경우 대안으로 사용할 수 있습니다. 공유 링크의 프로토콜 이름만 보고 호환성을 판단하지 말고 전송 방식, 보안 설정, 추가 매개변수도 확인하세요.
두 Android 클라이언트는 앱 데이터를 각각 별도로 관리합니다. 클라이언트를 바꾸면 설정을 다시 가져오고 라우팅을 확인해야 합니다. 다른 앱이 구독이나 연결 상태를 자동으로 이어받는다고 가정하지 마세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 앱 아키텍처 | 대부분의 기기는 arm64를 권장합니다. 오래된 기기이거나 아키텍처를 모르면 범용 버전을 시도하세요. |
| 시스템 호환성 | APK 설치 프로그램의 시스템 요구 사항을 확인하세요. 범용 버전으로 오래된 운영체제 버전 문제를 해결할 수는 없습니다. |
| 설치 출처 | APK를 여는 브라우저나 파일 관리자에 이번 설치에 필요한 권한을 부여하세요. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 요청을 승인해야 합니다. 일반적으로 VPN 서비스는 한 번에 하나만 실행할 수 있습니다. |
다운로드가 끝나면 파일 관리자에서 APK를 여세요. 시스템이 설치를 거부하면 출처 권한, 시스템 버전, 아키텍처 중 어떤 문제인지 먼저 확인하세요. 같은 파일을 반복해서 다운로드하지 마세요. 2015년 이후 출시된 대부분의 스마트폰은 arm64에 적합하지만, 기기의 하드웨어와 시스템이 지원하는 앱 아키텍처가 다를 수 있습니다. 실제 설치 가능 여부를 기준으로 선택하세요.
구독을 가져온 뒤 업데이트하고 유효한 노드를 선택한 다음 연결을 누르고 시스템 VPN 권한을 승인하세요. VPN 아이콘은 트래픽 처리 서비스가 실행 중이라는 뜻일 뿐, 원격 노드가 정상 작동한다는 의미는 아닙니다. 테스트 페이지에 접속하고 로그에서 도메인 확인과 연결 결과를 살펴보세요. 다른 VPN 앱이 실행 중이면 먼저 종료한 뒤 테스트하세요.
화면을 잠근 뒤 연결이 자주 끊긴다면 배터리 최적화, 백그라운드 활동, 제조사의 자동 실행 관리 설정을 확인하세요. 선택한 클라이언트에 필요한 설정만 조정하고 모든 백그라운드 권한을 한꺼번에 허용할 필요는 없습니다. 앱별 프록시를 사용한다면 대상 앱이 프록시 목록에 있는지도 확인하세요. 라우팅에서 제외된 경우와 노드 장애는 연결이 안 되는 앱의 범위가 다르게 나타납니다.
먼저 deb / rpm 패키지 체계를 확인한 다음 x64 / arm64 프로세서 아키텍처를 확인하세요.
Debian, Ubuntu 등에서는 보통 deb를 선택합니다. RPM 패키지 체계를 사용하는 배포판에서는 rpm을 선택하세요. 패키지 형식이 맞는지 확인한 뒤 배포판 버전과 의존성이 해당 빌드의 요구 사항을 충족하는지도 확인해야 합니다.
이 페이지의 파일은 데스크톱 세션용 그래픽 클라이언트입니다. ARM 데스크톱 기기는 작은 글씨로 표시된 arm64 링크를 선택하세요. amd64 패키지를 범용 패키지로 간주해 설치하지 마세요.
| 확인 항목 | 선택 기준 |
|---|---|
| 데스크톱 환경 | 사용 가능한 그래픽 데스크톱 세션이 필요합니다. 시스템 트레이 지원 여부는 데스크톱 환경에 따라 다릅니다. |
| 패키지 형식 | 배포판의 패키지 체계에 맞춰 deb 또는 rpm을 선택하세요. |
| 아키텍처 | amd64 / x86_64는 x64, aarch64는 arm64에 해당합니다. |
| 의존성 및 권한 | 패키지 관리자로 의존성을 확인하세요. TUN에는 네트워크 장치와 라우팅을 위한 추가 권한이 필요합니다. |
다운로드한 파일을 그래픽 소프트웨어 설치 프로그램으로 여세요. 의존성 오류가 표시되면 배포판과 패키지 대상 환경이 맞는지 먼저 확인하고, 의존성을 무시한 채 강제로 설치하지 마세요. rpm 파일 이름에 포함된 빌드 환경 정보만으로 모든 RPM 기반 시스템에서 사용할 수 있다고 판단할 수는 없습니다. 설치 프로그램이 표시하는 누락 구성 요소와 버전 요구 사항을 호환성 판단의 기준으로 삼으세요.
처음 실행한 뒤 구독을 가져와 노드를 업데이트하고 데스크톱 환경의 시스템 프록시 설정을 확인하세요. Linux에서는 앱마다 시스템 프록시 지원 방식이 다를 수 있습니다. 그래픽 브라우저, 명령줄 프로그램, 백그라운드 서비스가 같은 프록시 설정을 공유한다고 볼 수 없습니다. 브라우저는 연결되지만 다른 앱에서 실패한다면 노드를 바꾸기 전에 해당 앱이 프록시를 사용하는지 확인하세요.
TUN을 켜기 전에 가상 네트워크 장치를 사용할 수 있는지 확인하고 클라이언트 안내에 따라 필요한 최소 권한을 부여하세요. 컨테이너 네트워크, 다른 VPN, 사용자 지정 라우팅을 이미 사용 중이라면 기존 설정을 먼저 저장하세요. TUN을 끈 뒤 네트워크에 문제가 생기면 라우팅과 DNS가 복구됐는지 확인하세요. 네트워크 상태를 점검하는 대신 클라이언트를 반복해서 설치하지 마세요.
설치 후
다운로드는 첫 단계일 뿐입니다. 설정, 트래픽 처리 방식, 실제 접속 순서로 확인하면 문제를 더 빠르게 찾을 수 있습니다.
클라이언트는 설정을 읽고 코어를 실행하며 프록시를 관리하지만, 바로 사용할 수 있는 노드는 제공하지 않습니다. 신뢰할 수 있는 설정 제공자에게 구독 주소를 받아 전체 내용을 빠짐없이 복사하세요. 공백, 줄바꿈, 채팅 앱의 문장 부호가 섞이지 않도록 주의하세요.
구독에는 접속 정보가 포함될 수 있으므로 전체 주소를 공개 게시판에 올리지 마세요. 문제를 문의할 때는 오류 유형만 설명하고 서버 주소, 사용자 식별 정보, 구독 매개변수는 숨기세요.
구독 가져오기 안내 →데스크톱에서는 먼저 시스템 프록시를 사용해 시스템 설정을 따르는 앱을 확인하세요. 다른 트래픽도 처리해야 할 때 TUN을 설정하면 됩니다. Android는 시스템 VPN 인터페이스로 트래픽을 처리하며 클라이언트 설정에 따라 앱 범위를 지정할 수 있습니다.
전체 라우팅과 TUN은 같은 설정이 아닙니다. 전체 라우팅은 트래픽이 클라이언트에 들어온 뒤 어떤 경로로 나갈지 정하고, TUN은 트래픽을 클라이언트로 전달하는 방식입니다. 직접 연결 여부는 라우팅 규칙에 따라 달라집니다.
전체 플랫폼 설정 가이드 보기 →노드 하나를 선택하고 프록시 모드를 하나만 사용해 대상 앱을 테스트하세요. 지연 시간 테스트가 성공해도 해당 테스트에 응답했다는 뜻일 뿐, 실제 웹페이지 접속을 보장하거나 모든 도메인과 앱이 정상 연결된다는 의미는 아닙니다.
문제가 발생하면 클라이언트 이름, 시스템 아키텍처, 프록시 모드, 로그 오류를 기록하세요. 한 번에 설정 하나만 바꾸면 구독, 노드, DNS, 앱 자체 프록시 중 무엇이 영향을 줬는지 파악하기 쉽습니다.
증상별 자주 묻는 질문 확인 →다운로드 및 설치 FAQ
먼저 패키지 형식과 아키텍처 문제를 확인한 뒤 연결 설정을 살펴보세요.
클라이언트만 설치해서는 프록시 연결을 사용할 수 없습니다. 유효한 노드 설정이나 구독 주소가 필요합니다. 가져온 뒤 구독을 업데이트하고 노드를 선택한 다음 적절한 프록시 모드를 켜세요. 클라이언트에는 구독 서비스가 포함되어 있지 않습니다.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 제공하는 Desktop 버전을 권장합니다. 기존 Windows 인터페이스에 익숙하다면 안정적인 클래식 WPF 버전을 선택하세요. 두 버전 모두 x64 패키지이므로 설치 전에 시스템 아키텍처를 확인하고 버전을 바꾸기 전에 설정을 백업하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 실제로 지원되는 앱 아키텍처를 확인하세요. 아키텍처를 모르거나 arm64 패키지가 호환되지 않는다고 표시되면 범용 버전을 시도할 수 있습니다. 범용 버전은 더 많은 아키텍처를 지원하며 파일 크기가 더 큰 편입니다.
같은 앱과 설정 경로를 사용해 업데이트하면 보통 설정이 유지되지만, 설치 방식이나 버전 간 이전에 따라 달라질 수 있습니다. 업데이트 전에 클라이언트의 백업 또는 내보내기 기능으로 설정을 저장하고 앱 데이터를 먼저 삭제하지 마세요. 업데이트 후 구독, 활성 노드, 프록시 모드를 확인하세요.
먼저 다운로드가 완료됐는지 확인하고 파일 형식, 프로세서 아키텍처, 시스템 버전이 맞는지 살펴보세요. Windows ZIP 파일은 압축을 풀어야 합니다. Android에서는 현재 설치 출처를 허용하고, macOS에서는 개인정보 보호 및 보안 알림을 확인하세요. Linux에서는 패키지 관리자의 의존성 오류를 살펴보세요. 설치 문제를 해결하려고 시스템 보호 기능 전체를 끄지 마세요.