클라이언트 선택 · 설치 및 설정
클라이언트 선택부터 시작해 구독 가져오기와 프록시 설정을 단계별로 완료한 다음, 앱이 예상대로 네트워크에 접속하는지 확인하세요.
먼저 기기를 확인한 뒤 설치 패키지를 선택하세요
데스크톱에서는 v2rayN부터 시작하고, Android에서는 v2rayNG를 우선 확인하세요. V2Fly 커널이 필요할 때 v2flyNG를 고려하면 됩니다. 다운로드 전에 시스템 아키텍처, 설치 권한, 기존 설정의 호환성을 확인하세요. 클라이언트는 설정을 관리하지만 실제 연결에는 유효한 서버 정보가 필요합니다.
v2rayN은 차세대 크로스 플랫폼 데스크톱 버전과 기존 WPF 버전을 제공합니다. 처음 설치한다면 인터페이스와 시스템 요구 사항을 비교해 보세요. 기존 사용 환경이 있다면 구독 그룹, 라우팅 규칙, 커널 설정을 이전할 수 있는지 먼저 확인한 뒤 인터페이스 변경 여부를 결정하세요.
시스템 설정의 “시스템 종류”에서 아키텍처를 확인하세요. 이 사이트의 다운로드 경로는 x64 설치 패키지를 제공하므로 PC 브랜드만 보고 판단하지 마세요. 설치 후에는 일반 권한으로 가져오기와 시스템 프록시를 먼저 확인하고, TUN이 필요할 때 관련 권한을 점검하세요. 업그레이드 전 설정을 내보내고, 두 인스턴스가 동시에 시스템 프록시를 수정하지 않도록 하세요.
다운로드 페이지로 이동 ↗v2rayN 데스크톱 클라이언트에서 “이 Mac에 관하여”를 열어 칩을 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택합니다. 설치 패키지 아키텍처와 구독 프로토콜은 별개의 문제이며, 구독을 가져올 수 있다고 해서 올바른 설치 패키지를 선택했다는 뜻은 아닙니다.
처음 실행할 때 시스템 보안 경고가 표시되면 파일 출처와 경고 내용을 먼저 확인한 뒤 시스템이 안내하는 방법으로 처리하세요. 보안 기능 전체를 바로 끄지는 마세요. 시스템 프록시를 설정한 후 기존 브라우저 세션은 연결을 다시 만들어야 할 수 있습니다. 앱 자체에 프록시가 설정되어 있다면 시스템 설정을 덮어쓰는지도 확인하세요.
다운로드 페이지로 이동 ↗Xray 커널을 사용하는 v2rayNG를 우선 선택하세요. v2flyNG는 V2Fly 커널을 사용하는 대안입니다. 최신 기기는 대부분 arm64가 적합하며, 아키텍처가 확실하지 않다면 범용 버전과 설명을 확인하세요. 지원 프로토콜은 사용 커널에 따라 달라지므로 두 앱이 모든 설정에서 서로 호환된다고 볼 수 없습니다.
처음 프록시를 실행하면 시스템 VPN 권한을 확인해야 하는 경우가 많습니다. 이는 앱이 로컬 가로채기 채널을 만들도록 허용하는 절차일 뿐, 서버 연결이 완료되었다는 뜻은 아닙니다. 다른 VPN 앱이 실행 중이라면 어느 앱이 트래픽을 처리할지 먼저 정하세요. 백그라운드에서 중단될 경우 배터리 제한과 로그를 확인한 뒤 실행 정책을 조정하세요.
다운로드 페이지로 이동 ↗그래픽 데스크톱이 있는 기기에서는 v2rayN을 선택할 수 있습니다. 배포판에 맞춰 deb 또는 rpm 패키지를 사용하고, x64와 arm64도 구분하세요. 패키지 형식은 설치 방식을, 프로세서 아키텍처는 실행 환경을 나타냅니다. 두 조건이 모두 맞아야 하며 파일 확장자만 보고 선택해서는 안 됩니다.
데스크톱 환경마다 시스템 프록시 지원 범위가 다르고, 브라우저·터미널·백그라운드 서비스가 서로 다른 설정을 읽을 수 있습니다. 먼저 프록시를 명확히 지원하는 앱 하나에서 확인한 뒤 다른 프로그램을 살펴보세요. 라우터나 보조 라우터에 구축하려는 경우 게이트웨이와 DNS의 가로채기 범위를 먼저 이해해야 합니다. 데스크톱 클라이언트 설치 절차를 게이트웨이 구성 방법으로 간주하지 마세요.
다운로드 페이지로 이동 ↗작업 항목 — 설명 — 적용 조건
먼저 하나의 설정을 정상 작동시킨 다음 트래픽 분배, DNS 또는 가로채기 규칙을 추가하세요. 인터페이스의 옵션은 설정 정리를 도울 뿐 서버 매개변수를 대신하거나 네트워크 환경의 차이를 자동으로 해결하지 않습니다. 아래에서는 자주 쓰는 설정의 역할과 확인 순서를 설명합니다.
구독 그룹에 제공받은 주소를 입력하고 저장한 뒤 업데이트를 실행하세요. 그런 다음 그룹에 예상한 설정이 나타나는지 확인합니다. 구독 업데이트는 노드 정보를 가져오는 작업일 뿐, 노드 연결 가능성을 보장하거나 현재 노드 선택을 대신하지 않습니다. 출처별로 그룹을 만들고 수동 설정은 별도 위치에 두면 업데이트 과정에서 혼동을 줄일 수 있습니다. 주소에는 보통 인증 정보가 포함되므로 문제를 확인할 때 전체 링크를 숨기고 공개 스크린샷이나 메모에 붙여 넣지 마세요.
적용 조건: 신뢰할 수 있는 출처의 유효한 구독이 있고 업데이트 주소에 접근할 수 있어야 합니다. 가져오기에 실패하면 네트워크 요청 실패인지, 지원되지 않는 응답 내용인지, 링크 만료인지부터 구분하세요. 같은 주소를 반복해서 붙여 넣어도 콘텐츠 형식은 바뀌지 않습니다.
“시스템 프록시 자동 설정”을 선택하면 클라이언트가 시스템 설정을 따르는 앱에 로컬 프록시 진입점을 제공합니다. 브라우저 접속을 먼저 확인할 때 적합하지만 모든 프로그램이 가로채기된다는 뜻은 아닙니다. “시스템 프록시 변경 안 함”은 현재 시스템 상태를 유지한다는 의미이지 자동으로 직접 연결로 되돌린다는 뜻이 아닙니다. 가로채기를 해제하려면 시스템 프록시 해제를 명시적으로 실행한 뒤 시스템 설정을 확인하세요. 클라이언트 종료 후 네트워크 이상이 발생하면 남아 있는 프록시 진입점도 원인일 수 있습니다.
적용 조건: 로컬 프록시 서비스가 실행 중이고 대상 앱이 시스템 프록시를 읽어야 합니다. 앱 내장 프록시, 확장 프로그램 또는 다른 네트워크 도구가 설정을 덮어쓸 수 있으므로 설정 출처는 한 번에 하나만 명확히 유지하세요.
TUN은 가상 네트워크 어댑터로 트래픽을 받아 시스템 프록시를 읽지 않는 앱도 처리할 수 있지만, 실제 범위는 라우팅·제외 규칙·권한에 따라 달라집니다. 먼저 일반 프록시 연결이 정상인지 확인한 뒤 가상 네트워크 어댑터 가로채기를 시도하세요. 이렇게 하면 서버 문제와 시스템 가로채기 문제를 분리할 수 있습니다. 활성화 후 LAN 기기, 원격 데스크톱 또는 일부 서비스에 문제가 생기면 구독을 즉시 바꾸기보다 직접 연결 규칙과 네트워크 대역 제외를 확인하세요.
적용 조건: 시스템이 필요한 네트워크 권한을 허용하고 관련 구성 요소가 정상 작동해야 합니다. 다른 VPN, 가상 네트워크 어댑터 또는 보안 소프트웨어가 라우팅에 영향을 줄 수 있으므로 변경 전 기존 설정을 보존하고 TUN을 끌 수 있는 복구 방법을 준비하세요.
라우팅은 도메인, IP 등의 조건에 따라 요청이 사용할 아웃바운드를 결정합니다. 먼저 기존 규칙에서 직접 연결·프록시·차단의 차이를 이해한 뒤 필요한 규칙을 추가하세요. 일반적으로 매칭 순서를 주의해야 하며, 범위가 넓은 규칙이 세부 조건보다 먼저 적용될 수 있습니다. GeoIP 또는 GeoSite를 참조한다면 데이터베이스와 태그를 사용할 수 있는지도 확인하세요. 전역 프록시는 커널에 들어온 요청의 아웃바운드 방식만 바꾸며, 가로채기되지 않은 앱을 자동으로 커널에 진입시키지는 않습니다.
적용 조건: 어떤 요청을 직접 연결하고 어떤 요청을 프록시로 보낼지 명확히 정해야 합니다. 변경 후 해당 도메인과 로그로 다시 테스트하고, 웹사이트 하나가 열리는 것만으로 모든 규칙이 예상대로 작동한다고 판단하지 마세요.
DNS는 도메인을 주소로 해석하지만 요청은 앱·시스템·커널에서 각각 발생할 수 있습니다. 변경할 때는 어느 계층이 해석하는지 먼저 확인한 뒤 해석 요청의 아웃바운드 경로와 응답을 점검하세요. DNS 주소 하나만 바꾼다고 모든 앱이 해당 주소를 사용하는 것은 아닙니다. 다른 연결은 정상인데 도메인 접속만 실패한다면 로그와 함께 해석 경로, 타임아웃, 캐시를 확인하세요. 브라우저 자체의 암호화 DNS 때문에 시스템 설정과 관찰 결과가 다를 수도 있습니다.
적용 조건: 선택한 커널의 DNS 규칙과 해석 서비스가 도달하는 방식을 이해해야 합니다. 서로 다른 커널의 설정 필드를 섞지 말고, 해석 정책을 바꾼 후에는 연결을 새로 만들며 캐시의 영향을 고려하세요.
아래 내용은 검증을 시작하기 위한 기준이며 기본 설정 권장안이 아닙니다. 전체 작업 항목은 위 비교표에 정리되어 있습니다.
유효한 설정 하나를 선택하고 로컬 서비스를 시작한 다음 시스템 프록시를 설정하세요. 시스템 설정을 따르는 브라우저에서 테스트 페이지를 열고 동시에 클라이언트 로그를 확인합니다. 테스트 중에는 브라우저 프록시 확장 프로그램을 함께 사용하지 마세요. 요청이 어느 경로를 이용했는지 판단하기 어려워집니다. 검증이 끝난 뒤 트래픽 분배 규칙을 추가하세요. 브라우저가 계속 접속하지 못하면 더 많은 가로채기 기능을 켜기보다 설정과 로컬 서비스부터 점검하세요.
브라우저는 되지만 특정 앱이 되지 않는다면 해당 앱이 독립 프록시를 지원하는지, 시스템 설정을 무시하는지, 기존 연결을 다시 만들어야 하는지 확인하세요. 앱이 프록시를 지원하면 해당 진입점을 먼저 명확히 설정합니다. 더 넓은 범위의 가로채기가 정말 필요할 때 TUN 권한과 제외 규칙을 점검하세요. 한 번의 연결 실패를 곧바로 노드 문제로 단정하지 말고, 먼저 앱의 요청이 클라이언트에 들어왔는지 확인하세요.
처음 사용할 때의 확인 순서
빠른 시작에서는 구독, 노드, 프록시 적용이라는 세 단계를 먼저 처리합니다. 인터페이스 명칭은 클라이언트에 따라 달라질 수 있지만 목표는 같습니다. 설정을 가져오고, 아웃바운드를 선택하고, 실제 앱 트래픽의 경로를 확인하세요.
클라이언트를 설치하고 실행한 뒤 구독 그룹 또는 가져오기 메뉴로 기존 정보를 추가하세요. v2rayN 데스크톱은 출처별 그룹 관리에 적합하며, v2rayNG Android는 구독 관리 또는 가져오기 기능에서 시작할 수 있습니다. 주소가 완전한지, 공백이나 줄바꿈이 섞이지 않았는지 확인한 뒤 구독을 업데이트하세요. 가져오기가 완료되면 프로토콜, 서버 주소, 필요한 전송 매개변수가 있는지 확인하고 표시 이름만 보지 마세요.
공유 링크가 하나뿐이라면 해당 링크 가져오기 방식을 사용하고 구독 업데이트 주소로 취급하지 마세요. 구독은 업데이트할 수 있는 설정 모음이고 노드는 그 안에 포함된 개별 연결 설정입니다. 두 항목의 진입점과 관리 방식은 다릅니다. 연결 정보가 없다면 먼저 서비스 제공자에게 확인하세요. 클라이언트를 설치한다고 노드가 생성되지는 않습니다.
가져온 설정에서 현재 사용할 항목을 선택하고 클라이언트가 해당 커널을 시작했는지 확인하세요. 데스크톱에서는 먼저 시스템 프록시로 브라우저를 확인하고, Android에서는 안내에 따라 VPN 권한을 허용한 뒤 연결을 시작합니다. 라우팅 모드는 이해하기 쉬운 설정으로 유지하세요. 커널·DNS·TUN·트래픽 분배 규칙을 동시에 바꾸면 문제가 발생한 단계를 파악하기 어렵습니다.
“선택됨”과 “사용 중”은 같은 화면 상태가 아닐 수 있습니다. 클라이언트의 활성 설정 지정 또는 시작 동작으로 확인하세요. 설정을 전환한 후 테스트 연결을 새로 만드세요. 프린터, 공유 폴더, LAN 서비스에 접근해야 한다면 관련 직접 연결 조건을 유지하고 변경 전 규칙을 기록해 복구에 대비하세요.
먼저 클라이언트가 제공하는 연결 테스트를 실행하고, 대상 앱으로 실제 페이지에 접속하면서 같은 시각의 로그를 확인하세요. 실제 연결 테스트는 보통 프록시를 통해 요청을 한 번 수행해 테스트 대상에 도달할 수 있는지 판단합니다. 다운로드 속도 측정은 처리량에 더 가깝기 때문에 두 테스트는 서로 대체할 수 없습니다. 테스트에 성공해도 시스템의 모든 앱이 가로채기된 것은 아닙니다.
테스트가 실패하면 먼저 DNS 해석, 연결 타임아웃, 인증, 핸드셰이크 오류를 구분하세요. 테스트는 성공했지만 브라우저가 실패한다면 시스템 프록시와 앱 자체 설정을 우선 확인합니다. 한 번에 하나만 변경하고 같은 대상을 기준으로 다시 테스트하세요. 로그를 공유해야 한다면 구독 주소, 인증 정보, 식별 가능한 서버 정보를 먼저 삭제하세요.
그래픽 인터페이스, 커널과 서버
누가 설정을 담당하고, 누가 전달을 수행하며, 누가 원격 연결을 제공하는지 먼저 구분하세요. 이 세 역할을 이해하면 프로토콜 이름이나 클라이언트 외형만 보는 것보다 소프트웨어 선택과 문제 해결에 도움이 됩니다.
Project V는 프록시와 네트워크 통신 도구를 중심으로 형성된 오픈 소스 생태계이며, V2Ray은 그 안의 주요 프로젝트입니다. V2Fly 커뮤니티는 V2Ray 관련 구현을 계속 유지하고, Xray는 관련 기술 기반에서 자체 기능과 설정 체계로 발전했습니다. 공통 배경이 있지만 모든 기능과 필드를 서로 바꿔 쓸 수 있다는 뜻은 아닙니다. 가이드를 읽을 때는 “V2Ray”라는 이름만 보고 그대로 적용하지 말고 클라이언트가 지원하는 커널과 서버가 제공한 설정을 함께 확인하세요.
예를 들어 REALITY 연결을 사용할 때는 선택한 커널이 해당 기능을 지원하는지 확인하고 서버가 제공한 매개변수로 가져와야 합니다. 프로토콜 이름만으로 연결 속도를 판단할 수는 없습니다. 네트워크 경로, 서버 자원, 전송 설정과 기기 환경이 실제 사용 경험에 영향을 줄 수 있습니다. 프로토콜의 역할을 이해한 뒤 현재 설정의 호환성을 판단하는 편이 클라이언트를 계속 바꾸는 것보다 효과적입니다.
v2rayN은 데스크톱 설정 관리 인터페이스를 제공하며, 구체적인 커널과 기능은 사용 중인 배포 버전과 설정에 따라 달라집니다. v2rayNG는 Android용으로 Xray 커널을 사용하고, v2flyNG는 Android용으로 V2Fly 커널을 사용하는 대안입니다. 세 클라이언트 모두 오픈 소스로 개발됩니다. 일반 사용자에게 오픈 소스란 구현을 검토하고 변경 사항을 확인하며 문제 제보에 참여할 수 있다는 뜻이지만, 모든 구독 출처를 신뢰할 수 있다는 의미는 아닙니다.
오픈 소스 라이선스는 코드 사용·수정·배포 조건을 규정하며, 클라이언트와 커널이 서로 다른 라이선스를 사용할 수도 있습니다. 일상적인 설치 및 사용과 수정 버전의 재배포에 따르는 책임은 다릅니다. 재배포할 계획이라면 해당 프로젝트의 라이선스와 의존성 고지를 항목별로 읽어야 합니다. 이 사이트는 독립적으로 정리한 한국어 다운로드 및 사용 안내이며, 오픈 소스 프로젝트의 공식 웹사이트가 아니고 프로젝트 관리자의 약속을 대변하지 않습니다.
클라이언트 업데이트는 인터페이스나 설정 생성 방식을 바꿀 수 있고, 커널 업데이트는 프로토콜 동작을 바꿀 수 있습니다. GeoIP와 GeoSite 업데이트는 규칙이 참조하는 데이터에 영향을 줍니다. 이들은 같은 작업을 다르게 부르는 것이 아니며 문제를 해결하는 동안 모두 업데이트할 필요도 없습니다. 현재 정상 작동하는 설정을 기록하고 변경 사항을 읽은 뒤 필요한 부분만 조정하세요. 업데이트 후 기존 테스트 대상으로 다시 확인해 구독, 시스템 가로채기와 LAN 접속이 예상대로 작동하는지 점검합니다.
커뮤니티 유지 관리는 공개 코드와 변경 기록을 통해 진행되며 릴리스 주기는 프로젝트에 따라 달라집니다. 이 사이트는 특정 다운로드 경로를 영구적으로 최선이라고 설명하지 않으며, 쉽게 오래되는 버전 정보를 홈페이지에 고정하지도 않습니다. 설치 패키지는 다운로드 페이지에, 플랫폼 차이와 설정 문제는 전체 플랫폼 가이드에 모아 두었습니다. 여러 페이지의 흩어진 단계를 조합하지 않고 작업 단계별로 찾을 수 있습니다.
최근 설정 주제
기본 연결이 정상화된 뒤 겪고 있는 문제에 맞춰 자세히 살펴보세요. 각 글은 Android 백그라운드 배터리 소모, Linux 게이트웨이 가로채기, 라우팅 데이터베이스 관리를 다루며 하나의 설정을 모든 네트워크 환경에 적용되는 해답으로 제시하지 않습니다.
Android 배터리 통계와 연결 로그를 함께 확인해 지속적인 트래픽, 잦은 재연결, 시스템 백그라운드 제한으로 인한 배터리 소모를 구분하세요. 관찰, 단일 항목 조정, 재검증 순서로 백그라운드 실행 정책을 선택합니다.
구축 전 선택을 위해 게이트웨이·DNS·전달·커널의 역할을 설명하고, 메인 라우터와 보조 라우터의 트래픽 경로를 비교하며 권한·자원 사용량·복구 준비를 정리합니다. 클라이언트 추천 목록은 확장하지 않습니다.
IP 분류 데이터베이스와 도메인 분류 데이터베이스를 구분하고, 클라이언트 업데이트 경로·커널 호환성·규칙 태그 참조를 정리합니다. 로그로 로드 실패를 판단하고 기존 트래픽 분배를 복구하는 방법도 설명합니다.