운영체제에 맞는 오픈 소스 클라이언트를 선택하고 한국어 설정 가이드에 따라 구독 가져오기와 라우팅을 설정하세요. 데스크톱에서는 v2rayN부터, Android에서는 v2rayNG부터 살펴보세요.
먼저 운영체제를 고른 다음 프로세서 아키텍처를 확인하세요. 데스크톱에서는 v2rayN을, Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 살펴보세요. V2Fly 설정 환경이 필요하다면 v2flyNG도 확인할 수 있습니다. 설치 파일은 프로그램을 제공할 뿐, 실제 연결에는 유효한 서비스 설정이 필요합니다. 클라이언트를 다운로드해도 구독 주소가 자동으로 생성되지는 않습니다.
처음 설치할 때 여러 클라이언트를 한꺼번에 준비할 필요는 없습니다. 먼저 하나의 클라이언트에서 설정을 가져오고 실행 및 접속을 확인한 뒤 기존 설정의 이전을 고려하세요. 설치 파일 형식을 바꿔도 서버의 프로토콜 요구 사항은 달라지지 않습니다. 아키텍처 불일치, 프로토콜 항목 누락, 만료된 주소는 각각 따로 확인해야 합니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 조작 방식을 유지합니다. 먼저 운영체제 요구 사항에 맞춰 선택하고, 익숙한 버전이 있다면 화면 구성을 비교해 보세요.
다운로드 페이지에서 해당 설치 방법을 확인할 수 있습니다. 처음 실행한 뒤에는 코어가 정상적으로 시작되는지 확인하고 구독을 가져오세요. 시스템에서 프로그램을 실행할 수 없다는 안내가 표시되면 설치 파일을 반복해서 바꾸기보다 프로세서 아키텍처와 실행 환경부터 확인하세요.
다운로드 페이지로 이동v2rayN은 Apple Silicon과 Intel용 설치 파일을 따로 제공합니다. ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인하세요. Apple Silicon은 arm64, Intel은 x64에 해당하며 컴퓨터 외관만으로 판단해서는 안 됩니다.
설치를 마친 뒤 구독과 시스템 프록시를 설정하세요. 시스템 보안 안내가 표시되면 다운로드 출처와 안내 내용을 먼저 확인한 다음 운영체제에서 제공하는 방법에 따라 처리하세요. 앱을 정해진 위치에 두면 설정과 업데이트를 관리하기도 편리합니다.
다운로드 페이지로 이동먼저 v2rayNG를 살펴보세요. v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 최신 스마트폰은 대체로 arm64를 선택하면 됩니다. 기기의 아키텍처를 모른다면 시스템 정보를 확인하고 필요할 때 범용 패키지를 고려하세요.
처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다. 백그라운드 실행, 앱 절전 제한, 앱별 프록시 설정도 사용에 영향을 줄 수 있습니다. 화면을 잠근 뒤 연결이 끊긴다면 구독이나 프로토콜 문제로 단정하지 말고 배터리 관리 설정부터 확인하세요.
다운로드 페이지로 이동v2rayN은 deb 및 rpm 설치 파일을 제공하며 x64와 arm64를 구분합니다. 배포판에서 사용하는 패키지 형식을 확인한 뒤 프로세서 아키텍처를 확인하세요. 패키지 형식과 데스크톱 환경은 서로 다른 항목입니다.
그래픽 클라이언트를 설치해도 시스템 프록시를 실제로 사용할지는 데스크톱 환경과 앱 자체 설정에 따라 달라집니다. 브라우저에서는 접속되지만 다른 프로그램에서는 안 된다면 해당 프로그램의 프록시 설정부터 확인하세요. 명령줄 도구는 프록시 매개변수를 별도로 지정해야 할 수도 있습니다.
다운로드 페이지로 이동구독 그룹을 사용하면 서로 다른 출처의 설정을 나누어 관리할 수 있습니다. 그룹 설정에 메모와 전체 주소를 입력하고 업데이트를 켠 뒤 수동 업데이트를 한 번 실행해 설정 항목이 표시되는지 확인하세요. 구독 주소는 여러 설정을 가져오는 경로이며, 개별 노드 공유 링크와는 다릅니다. 항목을 하나씩 직접 추가하는 것보다 그룹 업데이트가 서버 측 변경 사항을 반영하기 편리합니다. 다만 자동 업데이트에 실패해도 기존 연결까지 사용할 수 없다는 뜻은 아닙니다. 로그에서 요청 오류나 형식 안내를 확인하고 링크 만료 여부를 점검한 뒤 업데이트 방식을 조정하세요. 화면에 표시되는 메뉴 이름은 클라이언트 업데이트에 따라 조금씩 달라질 수 있습니다.
코어가 시작된 뒤에는 데스크톱 앱의 요청이 로컬 프록시로 전달되도록 설정해야 합니다. ‘시스템 프록시 자동 설정’을 선택하면 시스템 프록시 설정을 따르는 앱이 클라이언트의 프록시를 사용할 수 있습니다. 시스템 프록시를 설정해도 모든 앱의 트래픽이 자동으로 처리되지는 않습니다. 코어만 실행하는 것과 달리, 이 설정은 앱이 프록시에 연결되는 경로를 지정합니다. 특정 프로그램이 계속 직접 연결된다면 별도의 프록시 설정이 있는지 확인하세요. 종료 전 시스템 프록시를 해제하면 이미 닫힌 리스너 포트를 시스템이 계속 가리키는 일을 방지할 수 있습니다. ‘시스템 프록시 변경 안 함’은 기존 시스템 설정을 유지할 때 사용합니다.
라우팅은 코어로 들어온 연결을 직접 연결할지, 프록시를 사용할지, 다른 출구로 보낼지 결정합니다. 처음에는 사용 범위에 맞는 프리셋을 선택한 뒤 필요한 도메인 규칙을 추가하세요. 시스템 프록시는 트래픽이 들어오는 경로를, 라우팅 규칙은 들어온 뒤 향하는 곳을 정합니다. 하나의 출구만 사용하는 대신 로컬 서비스와 원격 사이트의 연결을 나눠 처리할 수 있습니다. 규칙을 수정할 때는 순서, 도메인 일치 여부, DNS 조회 결과를 확인하고 여러 규칙 세트를 한꺼번에 바꾸지 마세요. 전역 모드는 일시적인 비교와 문제 해결에 사용할 수 있지만, 시스템 프록시를 우회하는 앱까지 자동으로 처리하지는 않습니다.
클라이언트는 설정을 정리하고 화면에 표시하며, 실제 연결은 코어가 처리합니다. Core 유형을 고를 때는 프로토콜과 전송 방식, TLS 또는 REALITY 같은 보안 계층 항목을 함께 확인해야 합니다. 설정을 가져올 수 있다고 해서 현재 코어가 모든 매개변수를 지원하는 것은 아닙니다. 여러 코어를 지원하는 인터페이스는 다양한 설정에 대응하기 편리하지만, 코어를 바꾸면 지원되는 항목도 달라질 수 있습니다. 현재 잘 작동하는 설정이 있다면 이름이 새롭다는 이유만으로 바꿀 필요는 없습니다. 시작에 실패하면 먼저 설정 오류를 확인하고 코어의 지원 범위와 대조해 항목 호환성 문제를 네트워크 장애로 오인하지 않도록 하세요.
로컬 SOCKS 및 HTTP 포트는 앱이 클라이언트에 연결하는 진입점이므로 앱의 프록시 주소와 일치해야 합니다. 다른 프로그램이 포트를 사용 중이면 코어가 제대로 리스닝하지 못할 수 있으며, 로그에서 원인을 찾을 수 있습니다. 원격 연결을 확인하기 전에 리스닝이 성공했는지 먼저 확인하세요. 연결 버튼만 보는 것보다 로그를 살펴보면 설정 오류, 포트 충돌, 핸드셰이크 실패를 구분하기 쉽습니다. 이 컴퓨터에서만 사용할 경우 로컬 접근 범위를 유지하세요. ‘로컬 네트워크 연결 허용’을 켜면 진입점이 확대되므로 방화벽, 리스닝 주소, 현재 네트워크의 신뢰성을 함께 고려해야 합니다.
설치를 마친 뒤 ‘설정을 클라이언트로 가져오기, 앱을 프록시에 연결하기, 요청을 규칙에 따라 전송하기’ 순서로 진행하세요. 각 단계에서 문제가 생겨도 겉으로는 모두 연결 실패처럼 보일 수 있습니다. 프로토콜, DNS, 포트를 한 번에 바꾸기보다 각 단계를 따로 확인하는 편이 원인을 찾기 쉽습니다. 아래는 빠른 안내이며, 자세한 메뉴와 순서는 전체 가이드에서 확인하세요.
v2rayN의 구독 그룹에 주소를 추가하고 업데이트하거나, v2rayNG에서 해당 가져오기 메뉴를 사용하세요. 링크를 복사할 때는 앞뒤와 줄바꿈을 확인해 안내 문구가 함께 들어가지 않도록 합니다. 업데이트한 뒤 항목이 속한 그룹, 프로토콜 유형, 메모를 확인하고 사용할 설정을 선택하세요.
구독 내용이 비어 있는 경우와 요청이 실패한 경우는 원인이 다릅니다. 전자는 서비스 상태나 응답 형식과 관련될 수 있고, 후자는 주소 유효성과 요청 오류를 확인해야 합니다. 구독 주소를 공개 페이지에 붙여 넣지 말고, 링크 모양만 보고 접근 자격 정보가 포함되어 있는지 추측하지 마세요. 문제가 생기면 민감한 정보를 가린 오류 설명을 공유하는 편이 좋습니다.
데스크톱에서는 코어가 시작됐는지 확인한 뒤 시스템 프록시와 라우팅 프리셋을 선택하세요. Android에서는 연결 설정을 확인하고 시스템 VPN 권한을 허용하세요. 처음 테스트할 때는 사용자 설정을 최소화해 현재 설정 자체가 작동하는지 확인하는 것이 좋습니다. 다른 프록시 도구를 실행 중이라면 로컬 포트와 시스템 프록시 설정을 중복 변경하지 않도록 주의하세요.
앱에서 별도의 프록시 설정을 사용한다면 주소와 포트가 현재 클라이언트의 실제 리스닝 위치를 가리키도록 지정하세요. SOCKS 포트를 HTTP 포트로 입력하지 마세요. 로컬 네트워크 접근, 추가 인바운드 연결, 복잡한 라우팅은 꼭 필요할 때만 조정하고 반복해서 확인할 수 있는 기본 설정부터 마련하세요.
평소 사용하는 브라우저로 대상 사이트를 열고 로컬 서비스도 정상적으로 접속되는지 확인하세요. 한 번 접속에 실패했다고 프로토콜을 사용할 수 없다고 단정할 수는 없습니다. 도메인 조회, 시스템 시간, 앱 프록시 설정, 서버 상태가 모두 영향을 줄 수 있습니다. 먼저 코어가 시작됐는지 확인한 다음 요청이 프록시로 들어오는지 살펴보세요.
V2Ray 지연 시간 테스트와 V2Ray 노드 속도 측정은 목적을 구분해야 합니다. 연결 테스트 결과는 특정 대상과 시점의 상태만 보여 줄 뿐 실제 웹페이지 접속을 대신하지 못합니다. 시간 초과나 핸드셰이크 실패가 발생하면 오류 유형을 기록하고 한 번에 설정 하나만 바꾼 뒤 같은 대상을 다시 테스트하세요. 그래야 변경 효과를 판단할 수 있습니다.
‘V2Ray’는 설정과 클라이언트의 한 계열을 통칭하는 말로 쓰이지만, 다운로드할 때는 구체적인 구성 요소를 구분해야 합니다. Project V는 이 생태계의 주요 출발점이며 V2Ray는 조합 가능한 네트워크 프록시 기능을 제공합니다. V2Fly 커뮤니티는 V2Ray 개발과 유지 관리를 이어가고, Xray는 관련 코드 기반에서 발전한 별도의 코어 계열입니다. 서로 일부 개념과 설정 방식을 공유하지만 기능 발전 방향이 완전히 같지는 않습니다.
그래픽 클라이언트는 그룹, 메뉴, 구독 업데이트, 연결 제어 기능을 제공합니다. 코어는 설정을 해석하고 연결을 만들며 라우팅을 적용하고 데이터 흐름을 처리합니다. 따라서 클라이언트 화면이 비슷해도 기반 기능까지 모두 같다는 뜻은 아닙니다. 같은 클라이언트라도 코어 업데이트에 따라 새로운 설정을 지원할 수 있으므로 호환성을 판단할 때는 앱 이름만 보지 말고 클라이언트와 사용 중인 코어를 함께 확인하세요.
v2rayN은 데스크톱용으로 여러 코어의 설정을 지원합니다. v2rayNG는 Android용이며 Xray 코어를 사용합니다. v2flyNG는 V2Fly 코어 기반의 Android 대안입니다. 세 클라이언트 모두 오픈 소스 소프트웨어이며 사용 환경과 기능 범위가 서로 다릅니다. 기기와 기존 설정을 기준으로 선택하세요. 데스크톱과 Android에서 메뉴가 완전히 같을 필요는 없으며, 핵심 설정 항목이 같은 연결 요구 사항을 나타내는지 확인하면 됩니다.
VMess, VLESS, Trojan, Shadowsocks는 널리 쓰이는 프로토콜 유형이고 REALITY는 보안 계층과 관련된 기술이므로 모두 같은 계층의 상호 배타적인 선택지로 보면 안 됩니다. 실제 설정에는 전송 방식, 서버 이름, 인증서 검증, 흐름 제어 등의 매개변수도 포함됩니다. 서버에서 제공하는 조합에 맞춰 클라이언트를 설정해야 하며, 프로토콜 드롭다운만 바꾼다고 연결이 성공하는 것은 아닙니다.
연결 속도, 리소스 사용량, 모바일 기기 배터리 소모도 프로토콜 이름만으로 비교할 수 없습니다. 서버와의 거리, 회선 품질, 핸드셰이크, 전송 캡슐화, 기기 성능이 모두 결과에 영향을 줍니다. 안정적으로 작동하는 설정이 있다면 요구 사항을 충족하는 한 유지하세요. 비교가 필요하다면 같은 네트워크와 대상, 비슷한 시간대에 테스트하세요. 일반 사용자에게는 특정 이름을 좇기보다 설정 항목이 완전한지, 코어가 지원하는지, 설정을 관리하기 쉬운지가 더 중요합니다.
오픈 소스는 프로젝트에서 채택한 라이선스에 따라 코드를 공개한다는 뜻이지, 모든 구성 요소가 같은 라이선스를 사용한다는 뜻은 아닙니다. 클라이언트, 코어, 의존성마다 적용되는 조건이 다를 수 있으므로 사용, 수정, 재배포 전에 각 프로젝트에 포함된 라이선스 안내를 확인하세요. 오픈 소스는 구현 방식과 유지 관리 경로를 살펴보는 데 도움이 되지만 실행 환경, 서비스 출처, 설정 내용을 판단하는 일을 대신하지는 않습니다.
클라이언트 자체는 원격 서버를 제공하지 않으며 사용할 수 있는 계정을 대신 만들어 주지도 않습니다. 구독에 포함된 주소, 자격 증명, 사용 기간은 설정을 제공한 곳에서 결정하며 로컬 앱 설치 성공 여부와는 별개입니다. 이 사이트에서는 설치 경로와 한국어 안내를 정리해 각 요소를 구분할 수 있도록 돕습니다. 특정 서비스 상태에 관한 문제는 설정 출처의 안내와 클라이언트 로그를 함께 확인해야 합니다.
구독 업데이트는 설정 내용을 가져오는 작업이고, 클라이언트 업데이트는 앱을 교체하는 작업입니다. 코어 업데이트는 프로토콜 지원과 설정 해석 방식에 영향을 줄 수 있습니다. 세 작업은 서로 같지 않습니다. 구독 업데이트에 성공해도 앱이 최신 버전이라는 뜻은 아니며, 새 클라이언트를 설치해도 만료된 서비스 주소가 자동으로 복구되지는 않습니다. 문제의 원인이 어느 단계에 있는지 먼저 판단한 뒤 필요한 작업을 선택하면 불필요한 재설치를 줄일 수 있습니다.
업데이트 전에 현재 라우팅 모드, 사용자 규칙, 로컬 리스너 설정을 기록하고 클라이언트가 제공하는 방법으로 필요한 설정을 저장하세요. 업데이트 후에는 기존 사용 환경부터 확인하고 새 기능은 하나씩 활성화하세요. 코어를 바꿀 때는 프로토콜 항목과 DNS 동작을 특히 점검해야 합니다. 기존 환경에서 작동하던 설정도 다른 코어로 옮긴 뒤에는 다시 확인해야 하며, 호환 여부를 그대로 적용해서는 안 됩니다.
v2rayN 구독 업데이트 실패: 주소가 완전한지, 유효 기간이 남았는지, 요청 결과가 로그에 어떻게 표시되는지 확인하세요. 노드가 계속 작동한다면 모든 설정을 급히 삭제하기보다 구독을 가져오는 단계부터 살펴보세요. 구독과 노드의 차이는 용어 안내에서 확인할 수 있습니다.
V2Ray 연결 안 됨: 코어 시작, 로컬 리스닝, 앱 프록시, 라우팅, 원격 핸드셰이크 순서로 확인하세요. 브라우저만 실패하는 경우와 모든 앱에서 실패하는 경우는 점검 방향이 다릅니다. 설정 오류와 연결 시간 초과도 각각 구분해야 합니다. 먼저 코어, 리스너, 라우팅 용어를 살펴보고 가이드에 따라 확인하세요.
V2Ray 노드 속도 측정 결과가 다름: 테스트 방식마다 대상과 연결 과정이 다를 수 있습니다. 연결 가능 표시가 모든 사이트 접속을 보장하지 않으며, 한 번의 결과가 장기적인 성능을 나타내지도 않습니다. 먼저 어떤 항목을 테스트했는지 확인한 뒤 실제 사용 환경에 맞춰 판단하세요. 관련 개념은 용어 안내에서 확인할 수 있습니다.
기본 연결을 확인한 뒤 실제로 겪은 문제에 맞춰 자세히 살펴보세요. 프로토콜 입문 자료는 구독에 포함된 유형을 구분하는 데 도움이 되고, 사용자 라우팅 규칙 문서는 매칭 순서를 설명합니다. 라우터 배포 개요에서는 그래픽 클라이언트 외부에서 코어를 실행하는 환경을 다룹니다. 문서가 설명하는 계층을 먼저 확인하고 현재 기기에 해당하는 내용을 적용해 서버 매개변수, 데스크톱 설정, 게이트웨이 구성을 혼동하지 않도록 하세요.
라우터 또는 보조 라우터에서 Xray 코어를 직접 실행하는 여러 방법을 살펴보고, 메인 라우터와 보조 라우터의 네트워크 구성을 비교하며 하드웨어 아키텍처, 메모리, 저장 공간의 기본 요구 사항을 정리합니다.
domain, full, regexp, ip, geosite, geoip의 작성 방법을 하나씩 살펴보고 규칙이 위에서 아래로 적용되는 순서를 설명합니다. 자주 발생하는 설정 오류의 점검 방법도 정리합니다.
최소한의 전문 용어로 두 프로토콜의 암호화, 설정 항목, 클라이언트 호환성 차이를 설명합니다. 구독의 프로토콜 유형을 알아보고 가져오기 전에 필요한 매개변수를 확인할 수 있습니다.