v2rayN · v2rayNG · v2flyNG
플랫폼에 맞는 클라이언트를 고른 뒤 코어와 설정을 확인하세요. 구독 가져오기, 라우팅 규칙, 시스템 프록시까지 사용 순서에 따라 정리했습니다.
데스크톱은 운영체제와 CPU 아키텍처를 먼저 확인하고, 모바일은 필요한 코어를 살펴보세요. 클라이언트는 설정과 연결 방식을 관리하지만, 사용하려면 유효한 서버 정보나 구독 주소가 필요합니다.
구독 그룹, 라우팅 편집, 시스템 프록시를 관리하려는 데스크톱 사용자에게 적합합니다. 처음 설치한다면 크로스 플랫폼 데스크톱 버전을 먼저 살펴보세요. 기존 인터페이스에 익숙하다면 WPF 버전의 실행 환경 요구사항을 확인한 뒤 선택하면 됩니다.
두 인터페이스는 서로 다른 서버 프로토콜을 사용하는 것이 아닙니다. 기존 설정을 옮길 수 있는지는 창 모양이 아니라 설정 형식과 실제로 사용하는 코어에 달려 있습니다. 처음 실행할 때 파일이 제대로 압축 해제되었는지, 폴더에 쓰기 권한이 있는지 확인한 뒤 설정을 가져오세요. 시작 오류가 발생하면 구독을 반복해서 바꾸기보다 실행 환경과 로그부터 확인하세요.
데스크톱에서 v2rayN의 설정 관리 방식을 이어서 사용하려는 경우에 적합합니다. 시스템 정보에서 프로세서를 확인하세요. Apple Silicon은 arm64 설치 파일을, Intel 프로세서는 x64 설치 파일을 선택합니다.
설치 패키지의 아키텍처와 시스템 권한은 별개의 문제입니다. 프로그램이 실행된다고 해서 시스템 프록시나 가상 네트워크 인터페이스까지 작동하는 것은 아닙니다. 먼저 설정을 가져와 일반 프록시 연결을 테스트한 다음 필요할 때 TUN을 켜세요. 시스템에서 권한을 요청하면 어떤 구성 요소에 어떤 작업 권한을 요구하는지 확인하세요. 권한 문제를 곧바로 서버 오류로 단정하지 마세요.
일반적으로 Xray 코어를 사용하는 v2rayNG를 먼저 선택합니다. 기존 설정이 V2Fly 생태계를 기반으로 한다면 v2flyNG도 고려할 수 있습니다. 이름이 비슷하다고 해서 모든 프로토콜, 전송 방식, 확장 필드를 서로 바꿔 쓸 수 있는 것은 아닙니다.
설치 전에 기기의 아키텍처를 확인하고, 확인하기 어려우면 범용 패키지 안내를 살펴보세요. 설정을 가져온 뒤 연결에 사용할 항목을 선택하고 연결을 시작한 다음, 시스템의 VPN 권한 요청을 확인합니다. 백그라운드로 전환한 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 살펴보세요. 이는 구독 가져오기 성공 여부와 직접 관련이 없는 시스템 동작입니다.
그래픽 데스크톱 환경에서 연결 설정을 한곳에서 관리하려는 사용자에게 적합합니다. 배포판의 패키지 체계에 맞춰 deb 또는 rpm을 선택한 뒤 x64와 arm64를 구분하세요. 패키지 형식이 같더라도 시스템 의존성과 데스크톱 환경을 확인해야 합니다.
데스크톱 시스템 프록시를 읽는지는 각 앱의 구현에 따라 다릅니다. 브라우저는 연결되지만 다른 프로그램이 직접 연결된다면 서버 설정을 바꾸기 전에 해당 프로그램의 프록시 설정부터 확인하세요. 더 많은 트래픽을 처리해야 한다면 TUN에 필요한 권한과 라우팅 조건을 살펴보세요. 그래픽 클라이언트 설정 절차를 데스크톱 환경이 없는 서버에 그대로 적용할 수는 없습니다.
클라이언트를 고를 때는 세 가지를 따로 확인하세요. 설치 파일이 현재 기기에서 실행되는지, 코어가 서버 설정을 인식하는지, 앱 트래픽이 실제로 프록시를 통과하는지입니다. 클라이언트를 바꾸면 이 중 일부만 달라질 뿐, 서버 상태와 네트워크 환경, 권한 정보를 확인하는 과정을 대신할 수는 없습니다. 다운로드 센터에서 플랫폼별 설치 파일을 확인하고, 클라이언트 비교 페이지에서 사용 조건을 자세히 살펴보세요.
전체 클라이언트 보기 →클라이언트 선택뿐 아니라 프로토콜, 설정 출처, 라우팅 규칙, 트래픽 처리 방식도 구분해야 합니다. 각 요소가 담당하는 단계가 다르므로 문제를 해결할 때도 따로 확인하세요.
VMess, VLESS 같은 이름은 연결 프로토콜을 나타내며, 전송 방식과 TLS 매개변수는 별도의 설정 계층에 속합니다. 클라이언트에 특정 옵션이 표시된다고 해서 현재 코어가 모든 조합을 지원하는 것은 아닙니다. v2rayN은 여러 코어의 설정을 관리할 수 있고, Android에서는 Xray 또는 V2Fly 사용 여부에 따라 해당 클라이언트를 선택할 수 있습니다. 설정을 가져오기 전에 서버에서 제공한 프로토콜, 전송 방식, 서버 이름과 관련 확장 항목을 확인하세요. 링크 접두어만 보고 호환 여부를 판단하지 말고, 필요한 기능이 선택한 코어에서 지원되는지 확인해야 합니다.
자세히 보기 →라우팅은 코어에 들어온 연결을 직접 연결, 프록시 또는 차단 경로로 분배합니다. 시스템 프록시처럼 트래픽을 앱에서 가져오는 기능을 대신하지는 않습니다. 일반적으로 도메인, IP, 규칙 세트를 함께 사용하며 규칙 수보다 매칭 순서가 중요합니다. 먼저 이해하기 쉬운 기본 규칙을 적용하고 필요한 사이트만 예외로 추가하세요. 변경 후에는 직접 연결 대상과 프록시 대상 모두 테스트해야 합니다. 도메인 규칙이 적용되지 않으면 DNS와 도메인 식별 조건도 확인하세요. 클라이언트마다 메뉴 위치는 달라도 문제를 살펴볼 때는 실제로 생성된 코어 설정을 기준으로 삼아야 합니다.
자세히 보기 →구독을 사용하면 여러 연결 설정을 한곳에서 업데이트할 수 있어 서버 설정을 계속 동기화하거나 그룹별로 관리할 때 편리합니다. 구독 주소를 추가하고 업데이트한 뒤 결과를 확인하세요. 목록에 항목이 표시되어도 내용을 읽었다는 뜻일 뿐, 각 연결이 작동한다는 보장은 없습니다. v2rayN과 Android 클라이언트가 인식하는 구독 형식은 다를 수 있으므로 이전하기 전에 제공처의 형식을 확인하세요. 구독 항목을 직접 수정하면 다음 업데이트에서 덮어써질 수 있습니다. 중요한 사용자 설정은 따로 보관하고 인증 정보가 포함된 주소도 안전하게 관리하세요.
자세히 보기 →시스템 프록시는 해당 설정을 읽는 앱에서 주로 사용하므로 데스크톱에서 처음 연결을 테스트하기 좋습니다. TUN은 가상 네트워크 인터페이스를 통해 더 많은 트래픽을 처리하며 권한, 라우팅, DNS 설정이 필요합니다. 두 기능을 항상 함께 켜야 하는 것은 아닙니다. 브라우저는 연결되지만 다른 프로그램에 변화가 없다면 먼저 해당 프로그램이 프록시를 사용하는지 확인한 다음 TUN 사용 여부를 판단하세요. Android의 연결 권한과 데스크톱 시스템 프록시는 서로 다른 기능입니다. 모드를 전환하기 전에 기존 설정을 기록해 두고 여러 프록시 도구가 시스템 네트워크 설정을 동시에 변경하지 않도록 하세요.
자세히 보기 →먼저 확인 가능한 연결 하나를 설정한 뒤 규칙을 조금씩 추가하세요. 처음부터 코어, DNS, TUN, 라우팅을 한꺼번에 바꿀 필요는 없습니다. 작업 순서를 명확히 해두면 문제를 찾기 쉽습니다.
운영체제에 맞는 클라이언트를 설치한 뒤 신뢰할 수 있는 출처에서 구독 주소, 공유 링크 또는 설정 파일을 준비하세요. 구독 주소는 구독 관리 메뉴에 추가하고, 단일 공유 링크는 해당 가져오기 기능을 사용하세요. 서로 다른 형식의 내용을 같은 입력란에 붙여 넣지 마세요. 가져오기 전에 앞뒤 공백과 줄바꿈, 주소 전체가 제대로 복사되었는지 확인하고, 가져온 뒤 그룹과 항목이 표시되는지 살펴보세요.
목록이 비어 있다면 업데이트 안내가 네트워크 요청 실패인지, 권한 만료인지, 형식 인식 실패인지 먼저 확인하세요. 가져오기에 성공했다고 해서 연결 테스트를 생략해서는 안 됩니다. 구독 주소를 공개하거나 인증 정보가 담긴 화면 캡처를 게시판에 올리지 마세요. Android 사용자는 v2rayNG에서도 같은 순서로 준비하면 되며 메뉴 이름은 데스크톱 버전과 다를 수 있습니다.
목록에서 사용할 설정을 하나 선택한 다음 클라이언트가 예상한 코어를 사용하는지 확인하세요. 데스크톱에서는 시스템 프록시를 켜고 브라우저로 먼저 테스트하며 기본 라우팅 규칙을 유지하는 것이 좋습니다. 시스템 프록시를 사용하지 않는 앱까지 처리해야 할 때 TUN을 살펴보세요. Android에서는 연결을 시작할 때 시스템의 VPN 권한 요청을 확인하고, 같은 기능을 사용하는 다른 연결이 이미 해당 권한을 점유하지 않았는지도 확인하세요.
시스템 프록시 스위치와 전역 라우팅은 같은 기능이 아닙니다. 시스템 프록시는 앱이 클라이언트에 트래픽을 전달할지 결정하고, 라우팅은 코어에 들어온 연결을 어디로 보낼지 정합니다. 두 계층을 따로 확인해야 특정 앱이 여전히 직접 연결되는 이유나 라우팅을 바꿔도 결과가 달라지지 않는 이유를 파악할 수 있습니다.
자주 사용하는 테스트 대상으로 브라우저 연결을 확인하고 실제로 프록시가 필요한 앱도 테스트하면서 클라이언트 로그를 살펴보세요. 연결 거부, 시간 초과, TLS 핸드셰이크 실패는 각각 다른 단계의 문제이므로 모두 클라이언트 사용 문제로 묶어 판단해서는 안 됩니다. 서버 주소와 포트, 시스템 시간, 전송 매개변수를 먼저 확인하고 로컬 수신 포트와 앱의 프록시 설정도 점검하세요.
한 번에 한 항목만 바꾸고 변경 전후의 증상을 기록하세요. 한 번의 속도 측정 결과는 특정 시점과 대상에만 해당하며 모든 앱의 사용 경험을 나타내지는 않습니다. 연결을 확인한 뒤 자동 업데이트를 설정하고 라우팅 규칙을 세분화하거나 DNS를 조정하세요. 클라이언트를 종료하기 전에는 필요에 따라 시스템 프록시를 해제해, 종료된 로컬 포트를 가리키는 설정이 남지 않도록 하세요.
오픈 소스 생태계를 이해하면 모든 소프트웨어를 막연히 “V2Ray”라고 부르는 것보다 클라이언트를 고르기 쉽습니다. 클라이언트 인터페이스, 연결 코어, 서버 설정은 서로 다른 역할을 맡으며 업데이트 주기도 다릅니다.
V2Ray는 Project V 생태계에서 널리 사용되는 프록시 도구 이름으로, 관련 생태계는 프로토콜, 전송 방식, 라우팅, 설정을 중심으로 발전해 왔습니다. 일상적으로 쓰는 “V2Ray 클라이언트”는 그래픽 관리 프로그램을 가리킬 수도, 실제 연결을 처리하는 코어를 의미할 수도 있는 포괄적인 표현입니다. 검색할 때는 이 용어를 사용해도 되지만, 소프트웨어를 선택하거나 로그를 읽을 때는 구체적인 구성 요소를 확인해야 합니다.
그래픽 클라이언트는 설정 가져오기, 구독 관리, 규칙 선택, 연결 시작을 인터페이스에 모아 제공합니다. 코어는 설정을 읽고 로컬 연결 지점을 열어 아웃바운드 연결을 만들며 라우팅을 실행합니다. 서버 정보는 원격 서버가 연결을 수락하는 방식을 설명합니다. 클라이언트를 설치했다고 서버 설정까지 자동으로 준비되는 것은 아니며, 연결 실패가 반드시 그래픽 인터페이스의 오류를 뜻하지도 않습니다. 이 세 계층을 구분하면 이후 작업을 더 정확히 진행할 수 있습니다.
V2Fly 커뮤니티는 V2Ray 관련 구현을 계속 발전시키고 있으며, Xray는 같은 기술 흐름에서 파생된 또 다른 코어입니다. 두 코어는 일부 프로토콜과 설정 개념을 공유하지만 기능의 발전 방향과 속도가 완전히 같지는 않습니다. 특정 구현에서만 사용할 수 있는 확장 매개변수도 있으므로 VMess 또는 VLESS 링크를 가져올 수 있다는 이유만으로 모든 서버 설정을 서로 바꿔 쓸 수 있다고 판단해서는 안 됩니다.
코어를 선택할 때는 서버 설정의 요구사항을 먼저 확인한 다음 클라이언트가 해당 구현을 관리할 수 있는지 살펴보세요. 어느 쪽이 더 빠른지 추측하기보다 현재 사용하는 프로토콜, 전송 방식, 암호화, 핸드셰이크 매개변수를 모두 지원하는지 확인하는 것이 좋습니다. 네트워크 경로와 원격 서버 부하, 로컬 환경도 성능에 영향을 주므로 소프트웨어 이름만으로 실제 결과를 판단할 수 없습니다. REALITY 같은 기능이 필요하다면 해당 코어와 설정 필드가 지원되는지 특히 주의해서 확인하세요.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트지만 지원 플랫폼과 코어 방향은 서로 다릅니다. v2rayN은 데스크톱 설정 관리에 중점을 두며 여러 운영체제에서 비슷한 방식으로 사용할 수 있습니다. v2rayNG는 Android용으로 Xray 코어를 중심으로 사용하고, v2flyNG는 V2Fly 코어를 위한 Android 클라이언트입니다. 모든 기능을 먼저 비교하기보다 기기에 맞는 제품부터 추리는 편이 효율적입니다.
오픈 소스는 구현과 라이선스 조건을 검토하고 논의하며 개발을 이어갈 수 있다는 뜻입니다. 모든 구성 요소에 같은 라이선스가 적용되거나 어떤 설정 출처든 신뢰할 수 있다는 뜻은 아닙니다. 클라이언트와 코어, 의존성은 각각 다른 라이선스를 적용할 수 있습니다. 일반 사용자는 릴리스 안내와 호환 조건을 확인하세요. 수정, 재배포 또는 다른 제품에 통합할 계획이라면 각 구성 요소의 라이선스 의무를 추가로 살펴봐야 합니다.
클라이언트 업데이트는 구독 파싱, 인터페이스 배치, 시스템 호환성을 바꿀 수 있고 코어 업데이트는 프로토콜 지원, 설정 필드 동작, 라우팅 처리에 영향을 줄 수 있습니다. 두 요소가 항상 같은 주기로 바뀌는 것은 아닙니다. 기존 설정이 정상 작동한다면 업데이트 전에 필요한 설정과 구독 그룹, 사용자 지정 규칙을 저장하세요. 업데이트 후에는 같은 대상으로 연결을 확인하고 네트워크 매개변수를 한꺼번에 많이 바꾸지 마세요.
이 페이지에서는 클라이언트 선택과 사용 절차를 안내하며, 설치 파일과 릴리스 정보는 다운로드 센터에서 확인할 수 있습니다. 튜토리얼의 메뉴 이름은 인터페이스 업데이트에 따라 바뀔 수 있습니다. 메뉴가 다르면 작업의 목적부터 확인하세요. 가져오는 항목이 설정인지 구독인지, 바꾸려는 항목이 트래픽 처리 방식인지 라우팅인지, 오류가 인터페이스에서 발생했는지 코어에서 발생했는지를 구분하면 됩니다. 설정 필드를 하나씩 확인하려면 설정 종합 가이드를, 플랫폼과 사용 방식을 비교하려면 클라이언트 비교 페이지를 참고하세요.
기본 연결을 익힌 뒤 로그에서 오류가 발생한 단계를 구분하고 DNS와 라우팅이 어떻게 맞물리는지 살펴보세요. 아래 글은 최신 글부터 정렬되어 있습니다.
geosite, geoip, 사용자 지정 도메인 규칙으로 중국 본토는 직접 연결하고 해외 트래픽은 프록시로 보내는 방법을 설명합니다. 규칙 매칭 순서, domainStrategy 값, 자주 발생하는 설정 오류도 살펴봅니다.
글 읽기 →FakeDNS가 가상 주소를 반환하고 라우팅 단계에서 도메인을 복원하는 원리를 설명합니다. TUN 모드 및 도메인 분기와 함께 사용하는 방법, 활성화하기 좋은 상황과 피해야 할 경우도 다룹니다.
글 읽기 →Xray/V2Fly 코어 로그의 수준과 구조를 소개하고 connection refused, i/o timeout, TLS 핸드셰이크 실패 등 자주 발생하는 오류의 의미와 로그를 통한 문제 진단 방법을 설명합니다.
글 읽기 →