CLIENT PACKAGES / 설치 파일 선택
운영체제, 칩, 설치 형식에 맞는 클라이언트를 선택하세요.
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장하며 v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 기기 아키텍처를 확인한 뒤 다운로드하세요. 설정 가져오기와 연결 방법은 사용 설명서를 참고하세요.
WINDOWS / x64
Desktop: 차세대 크로스 플랫폼 UI. WPF: 안정적인 클래식 버전.
Desktop은 처음 설치하거나 여러 플랫폼에서 일관된 사용 방식을 원하는 사용자에게 적합합니다. WPF는 익숙한 클래식 Windows UI를 유지하므로 기존 설정 경로에 익숙한 사용자에게 알맞습니다. 두 패키지는 UI 선택 사항이며 노드 프로토콜에 따라 구분되지 않습니다. 연결 가능 여부는 사용하는 코어와 설정에 따라 달라집니다.
이 페이지의 두 다운로드는 모두 x64 버전입니다. 다운로드가 끝나면 ZIP 파일을 별도 폴더에 완전히 압축 해제한 뒤, 파일에 포함된 설치 프로그램이나 앱을 실행하세요. 압축 파일 미리보기에서 바로 실행하면 종속 파일이 제대로 풀리지 않을 수 있습니다. 실행 환경이 필요하다는 안내가 나오면 앱이 표시한 구성 요소 이름과 시스템 요구 사항을 확인하세요.
MACOS / 칩 선택
Apple 메뉴 → 이 Mac에 관하여를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요.
Apple M 시리즈 칩은 Apple Silicon을, Intel 프로세서는 Intel 다운로드를 선택하세요. 구입 연도나 기기 이름만으로 칩을 정확히 알 수는 없습니다. 같은 제품군에도 서로 다른 프로세서가 사용될 수 있습니다. 기기 아키텍처에 맞는 패키지를 우선 선택하고, 호환 변환은 기본 설치 방법으로 사용하지 마세요.
DMG를 연 뒤 화면 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기고 해당 폴더에서 실행하세요. 첫 실행 시 시스템 경고가 표시되면 구체적인 사유를 확인한 다음 ‘시스템 설정 → 개인정보 보호 및 보안’에서 관련 기록을 살펴보세요. 앱을 실행하려고 시스템 보호 기능 전체를 끄지 마세요.
설정을 가져온 뒤 선택한 노드와 로컬 수신 포트를 먼저 확인하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 영향을 주며 모든 네트워크 요청을 자동으로 처리하지는 않습니다. 다른 연결 방식을 사용하려면 관련 설정을 확인한 뒤 필요한 권한을 승인하세요.
ANDROID / XRAY
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 아키텍처가 확실하지 않다면 범용 버전을 선택하세요.
v2rayNG는 Android에서 노드를 가져오고 구독을 업데이트하며 라우팅을 설정하는 데 사용합니다. VLESS나 REALITY 설정을 사용할 때는 현재 클라이언트에 포함된 코어의 지원 범위와 서버에서 요구하는 전송 및 보안 계층 매개변수를 함께 확인하세요. 같은 프로토콜을 사용하더라도 선택 가능한 모든 항목을 서로 바꿔 쓸 수 있는 것은 아닙니다.
APK를 다운로드한 뒤 시스템 다운로드 목록에서 파일을 여세요. 브라우저나 파일 관리자가 앱 설치 권한을 요청하면 현재 사용 중인 출처에만 필요한 권한을 허용하세요. 처음 연결할 때 VPN 연결 권한 안내가 표시되면 앱 이름을 확인한 뒤 진행하세요. 알림 권한과 백그라운드 실행 제한에 따라 연결 상태 표시가 달라질 수 있습니다.
ANDROID / V2FLY
기존 V2Fly 설정을 사용하며 해당 코어의 동작 방식을 유지해야 하는 사용자에게 적합합니다.
v2flyNG와 v2rayNG는 비슷한 용도로 쓰이지만 서로 다른 코어 계열을 사용합니다. 설정을 가져오기 전에 특정 코어의 확장 항목에 의존하는지 확인하세요. 이름만 다른 앱처럼 취급해서는 안 됩니다. 클라이언트를 바꿀 때는 기존 구독 URL이나 설정 사본을 보관하고 DNS, 분기 라우팅, 전송 설정을 각각 확인하세요.
두 앱을 모두 설치해 설정을 별도로 관리할 수는 있지만, 연결 문제를 확인할 때는 사용할 앱 하나만 실행하세요. 여러 연결 서비스가 번갈아 네트워크를 제어하면 테스트 결과를 파악하기 어렵습니다. 이전 연결을 중지한 뒤 새 연결을 시작하고 현재 앱의 로그를 확인하세요.
LINUX / DEB · RPM
Debian / Ubuntu는 보통 deb, Fedora / RHEL 계열은 보통 rpm을 선택하세요.
패키지 형식은 배포판의 패키지 관리 체계에 따라, 프로세서 아키텍처는 기기와 시스템 환경에 따라 결정됩니다. 두 조건을 모두 맞춰야 합니다. 패키지 이름에서 x64는 amd64 또는 x86_64로, arm64는 aarch64로 표기될 수 있습니다. 이름이 다르다고 다른 클라이언트인 것은 아닙니다.
다운로드한 파일을 시스템 기본 패키지 설치 프로그램으로 열고 의존성과 호환성 안내를 확인한 뒤 설치하세요. 같은 패키지 형식을 사용하는 배포판이라도 버전에 따라 필요한 의존성이 충족되지 않을 수 있습니다. 라이브러리 누락이나 버전 충돌이 발생하면 구성 요소 이름을 확인하고 의존성 검사를 강제로 건너뛰지 마세요.
GUI가 실행되면 먼저 설정을 가져온 뒤 로컬 수신 주소와 포트를 확인하고 앱에서 프록시를 설정하세요. 데스크톱 환경마다 시스템 프록시를 읽는 방식이 다를 수 있으며 브라우저와 다른 앱에 별도 프록시 설정이 있을 수도 있습니다. 실제로 사용할 앱에서 연결을 확인하세요.
AFTER INSTALL / 첫 실행
설치가 끝나면 GUI 클라이언트를 사용할 준비가 된 것입니다. 구독, 아웃바운드 매개변수, 트래픽 처리 방식은 각각 설정해야 합니다.
01 / IMPORT
사용 권한이 있는 구독 URL, 공유 링크 또는 설정 파일을 준비하세요. 구독 URL에는 접근 자격 증명이 포함될 수 있으므로 공개 스크린샷이나 문의 내용에 노출하지 마세요. 가져온 뒤 노드가 표시되는지, 이름을 구분하기 쉬운지 확인하고 구독을 업데이트하세요.
구독을 업데이트하면 구독 그룹의 항목이 덮어써질 수 있습니다. 직접 수정한 노드는 먼저 별도로 저장하세요. 사용자 지정 라우팅과 DNS 설정도 따로 보관해야 하며, 구독에 모든 설정이 포함된다고 가정하지 마세요.
02 / SELECT
사용할 노드를 선택한 뒤 연결을 시작하세요. 데스크톱에서는 시스템 프록시가 가리키는 주소와 로컬 포트를 확인하고, Android에서는 VPN 권한과 앱별 분기 설정을 확인하세요. 목록에 노드가 표시되는 것만으로 설정이 활성화된 것은 아닙니다.
클라이언트를 바꿀 때는 포트 충돌이나 네트워크 제어 상태가 겹치지 않도록 기존 연결을 먼저 중지하세요. 여러 설정을 동시에 바꾸기보다 조건을 명확히 정해 두면 문제 원인을 찾기 쉽습니다.
03 / CHECK
확인할 서비스를 대상 앱에서 열고 클라이언트 로그를 살펴보세요. 관련 요청이 로그에 없다면 시스템 프록시, 앱 자체 프록시, 분기 라우팅을 확인하세요. 요청은 있지만 연결에 실패한다면 서버 주소와 포트, 보안 계층 매개변수를 확인하세요.
다운로드 속도, 노드 이름, 설정 가져오기 성공 여부만으로 연결 상태를 판단할 수는 없습니다. 오류 문구와 발생 단계를 기록해 두고 문제를 확인하세요. 클라이언트를 반복해서 재설치하는 것보다 효과적입니다.
전체 사용 설명서 계속 보기 → 항목의 의미는 용어집과 설정 레퍼런스를 참고하세요.
PACKAGE NOTES / 자주 묻는 질문
먼저 패키지 선택, 시스템 설치, 연결 설정 중 어느 단계에서 발생한 문제인지 확인한 뒤 해당 안내를 살펴보세요.
Desktop은 차세대 크로스 플랫폼 UI이고 WPF는 안정적인 클래식 버전입니다. 처음 설치한다면 Desktop을, 기존 UI에 익숙하다면 WPF를 선택하세요. 두 버전 모두 x64 설치 파일입니다. 업데이트 전에 보관할 설정을 내보내세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 실제 지원 아키텍처를 확인하세요. 아키텍처를 모르거나 설치 파일이 기기와 호환되지 않는다는 안내가 표시되면 범용 버전을 시도할 수 있습니다. 범용 버전은 더 많은 아키텍처를 포함해 파일 크기가 큰 편입니다.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’에 Apple M 시리즈가 표시되면 Apple Silicon을, ‘프로세서’에 Intel이 표시되면 Intel을 선택하세요. 외관이나 구입 연도만으로 판단하지 마세요.
Debian, Ubuntu 및 호환 배포판은 보통 deb를, Fedora와 RHEL 계열 및 호환 배포판은 보통 rpm을 사용합니다. x64 또는 arm64 아키텍처도 확인하세요. 패키지 형식이 맞아도 의존성이 충족된다는 뜻은 아니므로 시스템 설치 프로그램의 안내를 따르세요.
클라이언트는 설정과 연결을 관리하는 도구이며, 설치 파일에 바로 사용할 수 있는 서버 연결 정보가 포함되어 있지는 않습니다. 사용 권한이 있는 구독 URL이나 노드 설정을 가져온 뒤 선택해 연결하고, 시스템 프록시 또는 VPN 방식으로 앱 트래픽이 클라이언트를 통과하는지 확인하세요.
버전 표시와 패키지 파일 경로는 다운로드 목록의 별도 항목이므로 서로 다를 수 있습니다. 이 페이지는 목록에 표시된 값을 각각 유지하며 파일 이름으로 버전을 추정하지 않습니다. 설치 후 클라이언트의 정보 화면에서 실제 버전을 확인하세요. 특정 버전이 필요하다면 패키지 정보를 먼저 확인한 뒤 설치 여부를 결정하세요.