설정 항목의 역할을 먼저 구분한 뒤 필요한 항목을 변경하세요. 아래는 읽기 전용 화면 예시입니다.
v2rayN은 설정을 관리하는 그래픽 인터페이스이고, 연결을 만들고 규칙을 실행하는 것은 코어입니다. 구독은 노드 정보를 클라이언트에 전달하고, 시스템 프록시는 어떤 앱이 로컬 프록시를 사용할지 결정하며, 라우팅은 해당 요청을 직접 연결할지 원격 노드를 거칠지 정합니다. 세 기능은 서로 다른 단계에 있습니다. 구독을 업데이트해도 시스템 프록시 문제가 자동으로 해결되지는 않으며, 라우팅을 바꿔도 모든 프로그램이 시스템 네트워크 설정을 따르게 되는 것은 아닙니다.
처음 사용할 때는 구독 그룹 하나를 가져오고 노드 하나를 선택한 다음, 시스템 프록시를 켜 브라우저 연결을 확인하는 것이 좋습니다. 이 순서로 진행하면 각 설정 변경의 영향을 파악하기 쉽습니다. TUN을 켜고 DNS를 수정하고 사용자 규칙까지 추가하면 연결에 문제가 생겼을 때 원인을 찾기 어렵습니다. 플랫폼마다 화면 문구가 조금씩 다를 수 있으므로 실제 설치한 클라이언트의 메뉴를 기준으로 확인하세요.
구독 주소는 업데이트 가능한 노드 목록이지 클라이언트 설치 파일이 아닙니다. 구독 그룹 설정에서 메모와 주소를 입력해 저장한 뒤 현재 그룹을 업데이트하고, 서버 목록으로 돌아가 노드를 선택하세요. 용도별로 그룹을 나누면 개인 설정과 구독 설정이 뒤섞이는 일을 줄일 수 있습니다. v2rayN과 v2rayNG 모두 구독 메뉴가 있지만 자체 설정을 인식하는 방식은 다르므로 가져오기 전에 형식을 확인하세요. 업데이트에 실패하면 요청 오류와 주소 유효성을 먼저 확인하고, 로컬 그룹을 반복해서 삭제하지 마세요. 구독 주소에는 인증 정보가 포함될 수 있으므로 공개된 곳에 게시해서도 안 됩니다.
시스템 프록시는 로컬 프록시 주소를 시스템 네트워크 설정에 등록해 해당 설정을 따르는 앱에서 사용하도록 합니다. v2rayN에서 시스템 프록시 자동 설정을 선택한 뒤에도 사용 가능한 노드를 선택하고 코어를 실행 상태로 유지해야 합니다. 시스템 프록시를 해제하면 관련 설정이 제거됩니다. 시스템 프록시 변경 안 함은 현재 설정을 유지한다는 뜻이지, 자동으로 직접 연결한다는 뜻은 아닙니다. 트래픽을 처리하는 TUN 방식과 달리 시스템 프록시는 터미널 도구나 자체적으로 연결을 관리하는 프로그램까지 모두 적용하지 않을 수 있습니다. 클라이언트를 종료하기 전에 프록시 설정을 복원하면 로컬 포트가 더 이상 연결을 받지 않는데도 브라우저가 이전 주소로 요청을 보내는 상황을 줄일 수 있습니다.
라우팅은 요청이 코어에 들어온 뒤 어떤 경로로 내보낼지 결정합니다. 중국 본토 우회는 보통 도메인 및 IP 데이터베이스를 함께 사용해 조건에 맞는 대상은 직접 연결하고 나머지는 프록시를 사용합니다. 실제 적용 규칙은 클라이언트의 프리셋을 확인하세요. 시스템 프록시 설정과 달리 라우팅 프리셋은 앱이 프록시를 사용할지 여부를 바꾸지 않습니다. 규칙을 추가하기 전에는 매칭 순서를 확인해야 합니다. 조건이 너무 넓은 규칙이 먼저 적용되면 뒤에 있는 세부 규칙이 작동하지 않을 수 있습니다. LAN 리소스에는 사설 IP 규칙을 따로 확인하고, 도메인 접속에 문제가 있으면 DNS도 점검하세요. 노드 변경과 라우팅 변경은 별개의 작업이므로 문제를 확인할 때 각각 테스트해야 합니다.
geosite:cngeoip:private클라이언트 인터페이스는 노드를 관리하고 실제 연결은 코어가 처리합니다. v2rayN은 Xray, sing-box 등의 코어에 맞춰 설정을 생성할 수 있지만, 선택 가능한 항목은 클라이언트와 코어의 지원 범위에 따라 달라집니다. 프로토콜 이름만 확인하기보다 전송 방식, TLS 매개변수, 흐름 제어 항목을 살펴보면 호환성 문제를 파악하기 쉽습니다. 예를 들어 VLESS 노드에서 REALITY와 Vision을 사용한다면 관련 항목이 빠짐없이 설정되어 있고 코어가 이를 인식하는지 확인해야 합니다. 코어를 바꾸기 전에는 기존 설정을 저장하고, 전환 후에는 시작 로그를 확인하세요. 한 코어의 기본 JSON 설정을 다른 코어에서도 그대로 쓸 수 있는 공통 설정으로 취급하지 마세요.
TUN은 가상 네트워크 인터페이스를 통해 트래픽을 처리하므로 시스템 프록시가 적용되지 않는 앱에 유용하지만, 라우팅 및 DNS 처리 경로도 바뀝니다. 먼저 일반 프록시 연결이 정상인지 확인한 다음 플랫폼별 권한을 부여하고 TUN을 켜면 여러 문제가 겹치는 것을 줄일 수 있습니다. 시스템 프록시를 따르는 브라우저 방식보다 TUN은 더 많은 트래픽에 영향을 미치며 다른 네트워크 도구와 충돌할 가능성도 큽니다. 회사 네트워크, 원격 연결 또는 LAN 기기 접속에 문제가 생기면 먼저 TUN을 끄고 비교 테스트하세요. 처음 설정할 때는 LAN 연결을 함께 허용할 필요가 없습니다. 필요한 권한과 접근 범위를 각각 확인하세요.
여기서 여러 플랫폼 간 동기화란 호환되는 구독 출처를 재사용한다는 뜻이며, 클라이언트가 클라우드 계정 동기화를 자동으로 제공한다는 의미는 아닙니다. 데스크톱에서 v2rayN을, Android에서 v2rayNG 또는 v2flyNG를 사용할 때는 각 클라이언트에 같은 출처의 호환 구독을 가져온 뒤 따로 업데이트할 수 있습니다. 전체 설정 폴더를 복사하는 대신 이렇게 하면 플랫폼별 프록시 포트, 권한, 라우팅 설정을 각각 유지할 수 있습니다. 기본 JSON에는 특정 코어 전용 항목이 포함되는 경우가 많으므로 기기 간에 그대로 옮기지 않는 것이 좋습니다. 이전하기 전에 사용자 규칙을 기록하고 완료 후 항목별로 테스트하세요. 구독을 여러 기기에서 사용할 수 있는지는 제공 업체의 안내를 확인해야 합니다.
데스크톱에서는 v2rayN을 선택하고, Android에서는 먼저 v2rayNG를 살펴본 뒤 코어 요구 사항에 따라 v2flyNG를 고려하세요.
v2rayN은 Desktop과 클래식 WPF 버전을 제공합니다. Desktop은 크로스 플랫폼 인터페이스를 사용하고, WPF는 익숙한 기존 데스크톱 조작 방식을 유지합니다. 선택할 때는 운영체제와 실행 환경 요구 사항을 먼저 확인하세요. 같은 구독을 위해 클라이언트를 두 개 설치할 필요는 없습니다.
설치 후에는 클라이언트가 실행되고 코어가 작동하는지 먼저 확인한 다음 구독을 가져오세요. 실행 직후 종료된다면 노드 매개변수를 바꾸기보다 런타임 및 권한 안내부터 확인하세요. 기존 설정을 옮겨야 한다면 구독 주소와 사용자 라우팅 규칙을 먼저 백업한 뒤 교체하세요.
Mac에서는 먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel 프로세서는 x64에 해당합니다. 다운로드 후 시스템 안내에 따라 처음 실행하고 구독과 시스템 프록시를 설정하세요. 실행이 차단되면 출처와 시스템 알림을 먼저 확인하세요.
일상적인 웹 브라우징에는 시스템 프록시 자동 설정부터 사용해 보세요. 터미널 도구에서 프록시가 적용되지 않는다면 해당 도구의 네트워크 설정을 따로 확인해야 합니다. 더 많은 앱의 트래픽을 처리해야 하는 경우에만 TUN 권한, DNS 및 라우팅 작동 방식을 살펴보세요. 처음부터 모든 기능을 켤 필요는 없습니다.
v2rayNG는 Xray 코어를 사용하므로 관련 프로토콜과 전송 기능이 필요한 설정에 적합합니다. v2flyNG는 V2Fly 코어를 사용하며 해당 코어가 필요한 경우 대안으로 선택할 수 있습니다. 일반적인 스마트폰은 대개 arm64를 사용합니다. 프로세서 아키텍처를 모르겠다면 범용 설치 패키지 안내를 확인하세요.
구독을 가져와 그룹을 업데이트한 다음 노드를 선택하고 시스템 연결 권한을 확인하세요. 백그라운드 실행은 배터리 관리 정책의 영향을 받습니다. 연결이 한동안 유지되다가 끊기면 절전 설정과 네트워크 전환 여부를 함께 확인하세요. 두 클라이언트를 동시에 실행해 연결하면 시스템 네트워크 채널을 두고 충돌할 수 있으므로 피하는 것이 좋습니다.
배포판에 따라 deb 또는 rpm을 선택한 다음 x64와 arm64를 구분하세요. 패키지 형식은 시스템의 소프트웨어 관리 방식을, 프로세서 아키텍처는 실행 플랫폼을 나타내므로 둘 다 맞아야 합니다. 설치 전 데스크톱 환경, 종속성 및 권한 요구 사항도 확인하세요.
Linux 데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다를 수 있습니다. 브라우저는 연결되는데 다른 프로그램이 직접 연결한다면 해당 앱이 데스크톱 프록시 설정을 읽는지 먼저 확인하세요. TUN이 필요하면 가상 인터페이스와 권한을 설정하세요. 네트워크 관리자 설정 문제를 구독 오류로 오해하지 마세요.
먼저 확인 가능한 연결을 하나 만든 뒤 라우팅 규칙이나 TUN 설정을 추가하세요.
클라이언트 자체에는 연결할 원격 노드가 포함되어 있지 않습니다. 사용할 수 있는 구독 주소나 공유 링크를 준비해 구독 그룹 설정에 저장한 뒤 업데이트하세요. 링크가 하나뿐이라면 클라이언트에서 지원하는 클립보드 가져오기 메뉴로 추가할 수 있습니다. 웹페이지 주소를 구독 주소로 사용하지 마세요.
업데이트가 끝나면 서버 목록에 예상한 노드가 표시되는지 확인하세요. 목록이 비어 있다면 구독 형식, 유효 기간 및 업데이트 로그를 먼저 살펴보세요. 주소의 쿼리 매개변수는 인증에 사용될 수 있으므로 복사할 때 빠뜨리지 말고, 화면을 공유할 때는 해당 내용을 가리세요.
목록에서 노드를 선택해 현재 사용할 항목으로 지정하고 코어가 정상적으로 시작되었는지 확인하세요. 데스크톱에서는 시스템 프록시 자동 설정을 선택하고, 라우팅은 현재 용도에 맞는 프리셋을 사용하세요. Android에서는 클라이언트 안내에 따라 연결을 시작한 뒤 시스템에 표시되는 네트워크 연결 권한 요청을 승인하세요.
라우팅에서 직접 연결과 프록시는 출구 정책을 뜻할 뿐 노드가 온라인인지 확인해 주지는 않습니다. 처음 테스트할 때는 설정을 단순하게 유지하세요. 다른 네트워크 도구가 실행 중이라면 하나를 먼저 종료한 뒤 연결 결과를 확인하세요. 여러 단계의 프록시가 판단을 어렵게 할 수 있습니다.
시스템 프록시를 따르는 앱 하나를 사용해 대상 서비스에 접속한 뒤, 클라이언트 로그에 해당 연결이 기록되는지 확인하세요. 클라이언트 화면이 열린다고 요청이 코어에 전달된 것은 아닙니다. 한 웹사이트에 접속된다고 모든 앱이 같은 경로를 사용하는 것도 아닙니다.
문제가 발생하면 구독, 노드, 코어, 시스템 프록시, DNS 순서로 항목을 하나씩 확인하세요. 매번 한 항목만 변경하고 결과를 기록하세요. 일반 연결이 안정적으로 작동하는 것을 확인한 뒤 TUN, LAN 접근 또는 세부 규칙을 설정하면 나중에 원래대로 되돌리기도 쉽습니다.
설정을 저장할 때 노드 출처, 사용한 코어, 사용자 규칙의 용도를 함께 기록하는 것이 좋습니다. 구독을 업데이트하면 그룹의 노드 항목이 바뀔 수 있고, 수동으로 수정한 내용은 유지되지 않을 수 있습니다. 오래 유지해야 하는 설정은 클라이언트의 작동 방식을 확인한 뒤 별도로 관리하세요. 현재 네트워크를 벗어나거나 테스트를 마친 후에는 시스템 프록시가 복원되었는지 확인하세요. 특히 클라이언트를 종료하기 전에 확인해야 합니다.
처음 연결에 실패했다고 바로 재설치할 필요는 없습니다. 오류가 구독 요청, 코어 시작, 원격 핸드셰이크 중 어디에서 발생했는지 확인한 뒤 해당 항목을 살펴보세요. 로그에 구독 주소, 노드 도메인 또는 사용자 식별 정보가 포함되어 있다면 공유하기 전에 민감한 내용을 삭제하세요. 구체적인 설정 절차는 사용 가이드를, 플랫폼별 설치 및 권한 안내는 전체 문서를 참고하세요.
생태계, 코어, 클라이언트의 차이를 알아야 설정을 어느 프로그램에서 사용해야 할지 판단할 수 있습니다.
Project V는 프록시 관련 도구와 구성 요소가 발전한 생태계이며, V2Ray는 그중 널리 쓰이는 이름입니다. 이후 커뮤니티에서 여러 코어와 클라이언트 프로젝트가 생겨나면서 ‘V2Ray 클라이언트’를 검색하면 V2Fly, Xray, v2rayN 등의 이름도 함께 볼 수 있습니다. 이들은 서로 다른 계층에 속합니다. 프로토콜은 통신 방식을 정의하고, 코어는 프로토콜과 라우팅을 구현하며, 그래픽 클라이언트는 구독과 옵션, 실행 상태를 관리하도록 돕습니다.
V2Fly는 V2Ray 커뮤니티 개발을 이어가고 있으며, Xray는 관련 기술을 바탕으로 자체 프로토콜 구현과 기능을 발전시켰습니다. sing-box는 별도의 프록시 코어 프로젝트입니다. 세 프로젝트는 일부 기능이 겹치지만 기본 설정 형식과 기능 지원 범위는 완전히 같지 않습니다. VMess, VLESS, Trojan 이름이 같더라도 전송 계층, 보안 매개변수, 클라이언트의 설정 생성 방식을 확인하세요. 이름만 보고 전체 설정이 호환된다고 판단해서는 안 됩니다.
v2rayN, v2rayNG, v2flyNG는 모두 클라이언트 코드를 오픈 소스로 제공합니다. v2rayN은 데스크톱용으로 구독, 시스템 프록시, 라우팅 및 코어 실행을 한 화면에서 관리하는 데 중점을 둡니다. v2rayNG는 Android용이며 Xray 코어를 사용하고, v2flyNG는 V2Fly 코어를 기반으로 한 선택지입니다. 오픈 소스라는 것은 코드를 열람하고 라이선스에 따라 사용할 수 있다는 뜻이지, 모든 프로젝트가 같은 라이선스를 적용한다는 뜻은 아닙니다. 각 프로젝트의 이용 약관을 따로 확인하세요.
클라이언트 업데이트는 인터페이스, 호환성 및 프로그램 기능을 개선하고, 코어 업데이트는 프로토콜 구현과 작동 방식에 영향을 주며, 구독 업데이트는 원격 노드 정보를 새로 가져옵니다. 규칙 데이터베이스도 별도로 업데이트할 수 있습니다. 업그레이드 전에 현재 설정을 기록하고 백업을 보관하세요. 업그레이드 후에는 기존 연결을 먼저 확인한 다음 새 기능을 테스트하세요. 호환성 문제가 생기면 ‘V2Ray가 작동하지 않는다’고만 설명하지 말고 클라이언트, 코어, 노드 매개변수를 함께 기록하세요.
클라이언트를 고를 때는 먼저 기기 플랫폼을 확인하고, 노드에 필요한 프로토콜과 코어를 살펴본 다음, 사용 방식이 현재 용도에 맞는지 판단하세요. Mac 사용자는 v2rayN의 구독 및 시스템 프록시 기능부터 시작할 수 있습니다. 모바일 기기에서는 Android 클라이언트로 연결을 관리하세요. 이 사이트의 다운로드 및 문서는 도구 설정을 안내하며 구독 서비스를 제공하지 않습니다. 계정, 트래픽, 노드 사용 가능 여부는 구독 제공 업체의 안내를 확인하세요.
REALITY, Vision, DNS, GeoSite 같은 용어는 각기 다른 기술 계층에 속합니다. REALITY는 연결 보안 관련 설정이고, Vision은 관련 흐름 제어 방식이며, DNS는 이름 확인에 영향을 주고 GeoSite는 도메인 집합을 매칭하는 데 사용됩니다. 한 항목을 변경한다고 다른 단계의 문제가 자동으로 해결되지는 않습니다. 작동하는 기본 설정을 유지한 채 로그와 비교 테스트를 활용해 항목을 하나씩 추가하는 편이, 낯선 설정 전체를 한 번에 복사하는 것보다 관리하기 쉽습니다.
시스템 프록시부터 규칙 데이터베이스까지, 실제 문제에 맞는 글을 확인하세요.
두 규칙 데이터베이스에 각각 어떤 정보가 포함되는지, 클라이언트에서 한 번에 업데이트하는 방법, geosite:cn 및 geoip:private 같은 규칙의 매칭 순서와 주의 사항을 설명합니다.
글 읽기 →플랫폼별로 클라이언트가 시작하자마자 종료되는 주요 원인을 살펴봅니다. Windows의 .NET 데스크톱 런타임 누락, macOS의 손상 또는 권한 경고, Linux의 종속성 누락에 대한 해결 절차를 안내합니다.
글 읽기 →v2rayN의 시스템 프록시 세 가지 설정과 라우팅 프리셋을 비교해 전체 모드와 중국 본토 우회가 각각 어떤 트래픽에 영향을 주는지, Mac에서 일상 업무와 개발·디버깅에 어떤 설정이 적합한지 설명합니다.
글 읽기 →