데스크톱·안드로이드 클라이언트 설정 가이드
구독 가져오기부터 라우팅 분할까지, 실제 메뉴를 기준으로 v2rayN과 v2rayNG 설정 순서를 정리했습니다.
화면은 설정 항목을 보여 주는 예시입니다. 메뉴 위치와 사용 가능한 코어는 실제 클라이언트에 따라 다를 수 있습니다. 기기 간 설정을 공유하기 전 코어와 항목의 호환성을 확인하세요.
설정 안내
설정 출처, 트래픽 진입점, 요청의 목적지를 구분한 뒤 고급 항목을 조정하세요. GUI 클라이언트가 설정을 관리하고 코어가 생성된 설정에 따라 연결을 처리합니다. 두 계층의 역할은 서로 다릅니다.
구독 주소는 여러 서버 설정을 가져오는 데 사용되며, 단일 공유 링크와는 다릅니다. v2rayN의 ‘구독 그룹 설정’에서 메모와 주소를 입력하고 저장한 뒤 해당 그룹을 업데이트하세요. v2rayNG에서는 ‘구독 그룹 설정’에서 추가한 다음 ‘구독 업데이트’를 실행하면 됩니다. 출처별로 그룹을 만들면 업데이트 범위를 구분할 수 있어 수동 설정과 구독 내용을 섞지 않을 수 있습니다. 업데이트 후 서버 주소, 프로토콜, 전송 설정을 확인하고 사용할 구성을 선택하세요. 구독에는 접속 정보가 포함될 수 있으므로 스크린샷이나 문제 해결 기록에 전체 주소가 노출되지 않도록 주의하세요.
시스템 프록시는 시스템 설정을 따르는 앱의 요청을 로컬 포트로 보낼지 결정하고, 라우팅은 요청이 코어에 들어온 뒤 어느 아웃바운드로 보낼지 결정합니다. v2rayN에서는 먼저 ‘시스템 프록시 자동 설정’을 확인하고 라우팅 모드를 선택하세요. 세부 조정이 필요하면 ‘라우팅 설정’에서 사전 정의 규칙을 확인합니다. 중국 본토 우회는 보통 도메인 및 IP 규칙을 사용하며, 프록시를 단순히 끄는 것과는 다릅니다. 사용자 지정 규칙은 순서대로 적용되므로 구체적인 규칙을 포괄적인 규칙보다 앞에 두세요. 시스템 프록시를 사용하지 않는 앱도 있으므로 별도의 프록시 진입점을 설정해야 할 수 있습니다. 브라우저 결과만으로 모든 앱의 트래픽 경로를 판단하지 마세요.
v2rayN은 여러 코어를 관리할 수 있지만, 동일한 항목 조합이 모든 코어에서 그대로 작동하는 것은 아닙니다. Xray, V2Fly, sing-box는 지원 프로토콜, 전송 항목, 설정 구조가 서로 다릅니다. 코어를 바꾸기 전에 서버에서 사용하는 프로토콜, 전송 방식, 보안 설정을 확인하고 클라이언트에서 선택할 수 있는 코어와 대조하세요. v2rayNG는 Xray 코어를 사용하며 v2flyNG는 V2Fly 코어를 사용하는 안드로이드 대안입니다. 시작에 실패하면 프로토콜과 라우팅을 동시에 바꾸지 말고 로그의 설정 파싱 메시지부터 확인하세요. 변경 전 설정을 보관하면 차이를 항목별로 재현하기 쉽습니다.
v2rayNG의 ‘앱별 프록시’에서는 VPN이 적용될 앱을 선택합니다. 기능을 켠 뒤 ‘우회 모드’의 의미를 확인하세요. 우회 모드에서는 선택한 앱이 프록시를 거치지 않습니다. 우회 모드를 끄면 선택한 앱에 프록시가 적용됩니다. 앱 목록과 도메인 라우팅은 서로 다른 두 단계의 규칙입니다. 앱 목록은 앱의 요청이 진입점에 들어올지 결정하고, 도메인 라우팅은 코어에 들어온 요청을 처리합니다. 설정을 바꾼 뒤 연결을 다시 시작하고 대상 앱에서 확인하세요. 테스트할 때 다른 VPN 서비스는 종료해야 합니다. 시스템에서 활성 VPN을 하나만 허용하는 제한을 노드나 규칙 문제로 오해할 수 있습니다.
데스크톱과 안드로이드 간에 설정을 옮길 때는 클라이언트가 지원하는 공유 링크나 구독 방식을 우선 사용하세요. 서버 주소, 포트, 프로토콜 매개변수는 설정과 함께 옮길 수 있지만, 로컬 수신 포트, 시스템 프록시, VPN 권한, 앱별 목록은 대상 기기에서 다시 설정해야 합니다. 전체 JSON에는 로컬 파일이나 규칙 리소스가 참조될 수 있으므로 복사에 성공했다고 해서 호환되는 것은 아닙니다. 가져온 뒤 프로토콜, 전송, 보안 항목을 확인하고 단일 연결부터 테스트한 다음 사용자 지정 라우팅을 복원하세요. 내보낸 파일에 인증 정보가 포함될 수 있으므로 안전한 위치에 보관하고 공개 로그에서는 민감한 내용을 삭제하세요.
처음 설정할 때는 명확한 기본 경로 하나만 구성하는 것이 좋습니다. 구독 그룹을 하나 추가하고, 사용할 설정을 하나 선택한 뒤, 로컬 프록시 진입점을 활성화하고 대상 앱에서 확인하세요. 이 과정이 끝나면 도메인 분기, 앱 목록, 사용자 지정 DNS를 추가합니다. 한 번에 한 종류의 설정만 바꾸면 문제 발생 계층을 좁힐 수 있습니다. 코어, 포트, 라우팅을 동시에 바꾸면 이전에 작동하던 기준 상태를 잃기 쉽습니다.
여기 표시된 화면은 메뉴 개념을 비교하기 위한 것으로 실제 설정을 대신하지 않습니다. 클라이언트 업데이트에 따라 버튼 이름이 바뀔 수 있으므로 각 설정의 역할을 기준으로 판단하세요. 구독은 설정을 가져오고, 인바운드는 로컬 요청을 받고, 아웃바운드는 연결을 만들며, 라우팅은 아웃바운드를 선택합니다. JSON을 편집해야 한다면 먼저 설정 항목 참고를 읽고 해당 항목이 어느 부분에 속하는지 확인한 뒤 GUI 밖에서 수정할지 결정하세요.
클라이언트 다운로드
데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 우선 확인하세요. 설치 파일은 프로세서 아키텍처와 시스템 환경에도 맞아야 합니다. 기기 설정에서 정보를 확인한 뒤 해당 플랫폼의 다운로드 페이지로 이동하세요.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고 WPF 버전은 기존 데스크톱 조작 방식을 유지합니다. 먼저 시스템 요구 사항을 확인한 뒤 평소 사용하는 메뉴 구성에 맞춰 선택하세요. 같은 구독을 가져오기 위해 두 버전을 동시에 실행할 필요는 없습니다.
처음 실행한 뒤 로컬 수신 포트와 시스템 프록시 상태를 확인하세요. 이전 클라이언트가 실행 중이면 같은 포트를 점유할 수 있으므로 기존 인스턴스를 종료한 뒤 테스트하세요. 브라우저에 프록시 확장 프로그램이 있다면 시스템 설정을 덮어쓰는지 확인해 두 진입점이 충돌하지 않도록 하세요.
v2rayN은 Apple Silicon과 Intel용 다운로드를 각각 제공합니다. ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 알맞은 설치 파일을 선택하세요. 프로세서 아키텍처는 인터페이스 언어와 관계없으므로 기기 외관이나 구입 연도만으로 판단할 수 없습니다.
설치 후 먼저 클라이언트가 정상적으로 실행되는지 확인한 다음 구독과 시스템 프록시를 설정하세요. 시스템 보안 알림이 표시되면 다운로드 출처와 안내된 구체적인 사유를 확인하고 시스템 설정에 따라 처리하세요. 보안 기능 전체를 바로 끄지 마세요. 연결 후에는 실제 사용하는 앱에서 프록시가 작동하는지도 확인해야 합니다.
v2rayNG는 Xray 코어를 사용하며 안드로이드에서 우선 선택할 수 있습니다. V2Fly 코어 설정이 필요하면 v2flyNG를 확인하세요. 대부분의 최신 기기는 arm64 아키텍처를 사용합니다. 확실하지 않다면 기기 정보를 확인하거나 다운로드 페이지의 범용 버전 안내를 참고하세요.
처음 연결할 때 시스템 VPN 권한을 확인해야 합니다. 이 권한은 기기의 네트워크 트래픽을 VPN이 처리하도록 허용하는 것이며, 서버 연결 성공을 뜻하지는 않습니다. 연결 후 대상 앱을 테스트하고 백그라운드 배터리 제한도 확인하세요. 백그라운드로 전환한 뒤 연결이 끊긴다면 설정을 바꾸기 전에 시스템의 앱 실행 제한부터 살펴보세요.
v2rayN은 deb 및 rpm 설치 파일을 제공하며 x64와 arm64를 구분합니다. 배포판에 맞는 패키지 형식을 고른 뒤 프로세서 아키텍처를 선택하세요. 패키지 형식은 프록시 프로토콜이 아니며 구독에 포함된 서버 매개변수도 변경하지 않습니다.
설치 후 GUI 클라이언트에서 설정을 가져오세요. 데스크톱 환경마다 시스템 프록시 지원 방식이 다를 수 있으며, 일부 앱에서는 로컬 HTTP 또는 SOCKS 주소를 직접 입력해야 합니다. 브라우저, 데스크톱 앱, 터미널 프로그램을 각각 확인하세요. 한 프로그램에서 접속된다고 해서 모든 프로그램이 같은 설정을 사용한다는 뜻은 아닙니다.
클라이언트를 설치한 뒤에도 유효한 서버 설정이나 구독이 필요합니다. 설치 파일에는 바로 사용할 수 있는 연결 정보가 포함되어 있지 않습니다.
모든 클라이언트 보기 →빠른 시작
먼저 재현 가능한 기본 설정을 만든 뒤 필요한 규칙을 추가하세요. 아래 세 단계는 전체 가이드의 작업 순서를 따르며, 데스크톱과 안드로이드의 차이는 주로 로컬 트래픽 진입점에 있습니다.
먼저 받은 항목이 구독 주소인지, vmess:// 또는 vless:// 같은 프로토콜로 시작하는 단일 공유 링크인지 확인하세요. 구독 주소는 ‘구독 그룹 설정’에 추가한 뒤 업데이트를 실행합니다. 단일 공유 링크는 클라이언트의 클립보드 가져오기 기능을 사용하세요. 웹페이지 안내 주소를 구독 주소로 착각하거나 구독 주소를 서버 주소 입력란에 넣지 마세요.
가져온 뒤 메모, 프로토콜, 서버 주소, 포트가 모두 있는지 확인하세요. 구독 업데이트에 실패하면 주소가 잘리지 않았는지, 불필요한 공백이 없는지 확인하고 업데이트 메시지를 살펴보세요. 구독 페이지를 열 수 있다고 해서 클라이언트가 유효한 설정을 가져온 것은 아닙니다. 처음 문제를 확인할 때는 기존 그룹을 유지하세요. 반복해서 삭제하고 다시 만들면 비교에 필요한 정보를 잃을 수 있습니다.
데스크톱에서는 사용할 서버 설정을 선택한 다음 ‘시스템 프록시 자동 설정’을 활성화하세요. 안드로이드에서는 설정을 선택하고 연결 버튼을 누른 뒤 시스템 VPN 권한을 허용합니다. 라우팅은 명확한 사전 정의 모드부터 사용하고 복잡한 사용자 지정 규칙은 일단 추가하지 마세요. 시스템 프록시, VPN 트래픽 처리, 코어 라우팅은 서로 다른 계층이므로 이름이 비슷해도 서로 대체할 수 없습니다.
LAN 서비스를 이용해야 한다면 우회 규칙과 대상 주소를 확인하세요. 안드로이드에서 앱 범위를 제한하려면 ‘앱별 프록시’를 설정하고 우회 모드가 켜져 있는지 확인합니다. 설정을 변경한 뒤 연결을 다시 시작하고 실제 앱의 요청으로 검증하세요. 다른 프록시나 VPN 도구가 실행 중이라면 테스트 전에 종료하세요.
연결 버튼에 실행 중으로 표시되어도 클라이언트가 작동 상태에 들어갔다는 것만 알 수 있습니다. 실제로 사용할 웹페이지나 앱을 열어 요청이 완료되는지 확인하고, 로그에서 아웃바운드, 이름 확인 또는 핸드셰이크 메시지를 살펴보세요. 내장 속도 측정은 현재 조건에서 연결 성능을 비교하는 보조 수단입니다. 지속적인 다운로드 속도를 보장하지 않으며 대상 앱의 접속 테스트를 대신할 수 없습니다.
문제가 생기면 로컬 진입점, DNS, 서버 연결, 대상 서비스 순서로 확인하세요. 선택한 모드와 변경 사항을 기록하고 한 번에 변수 하나만 조정합니다. 브라우저는 정상인데 특정 프로그램만 실패한다면 해당 프로그램의 프록시 설정부터 확인하세요. 모든 요청이 실패할 때는 라우팅 규칙을 무작정 늘리기보다 설정 매개변수, 시스템 시간, 서버 연결 가능성을 점검하세요.
설정을 되돌려야 한다면 먼저 연결을 종료하고 시스템 프록시를 복원한 다음 설정을 다시 선택하세요. 작동하는 기본 설정을 보관해 두면 이후 규칙 변경으로 생긴 문제를 찾기 쉽습니다.
전체 가이드 보기 →오픈 소스 생태계
V2Ray는 생태계와 기술의 배경을 가리키고, v2rayN·v2rayNG·v2flyNG는 각각의 클라이언트 이름입니다. 인터페이스와 코어의 역할을 구분해야 설정이 실제로 적용되는 위치를 파악할 수 있습니다.
Project V는 모듈형 네트워크 프록시를 중심으로 발전했으며 V2Ray는 널리 사용되는 구현 중 하나입니다. V2Fly는 V2Ray의 커뮤니티 유지보수를 이어가고, Xray는 관련 코드와 기술 생태계에서 출발해 자체 구현과 기능을 발전시켰습니다. 일부 개념과 설정 방식은 공유하지만 프로젝트 이름만으로 완전한 호환성을 판단할 수는 없습니다. 특정 프로토콜을 사용할 수 있어도 모든 전송 옵션, 보안 항목, 라우팅 리소스가 그대로 호환된다는 뜻은 아닙니다.
GUI 클라이언트는 구독 관리, 설정 편집, 실행 제어, 시스템 연동을 담당하고 코어는 실제 네트워크 처리를 수행합니다. 메뉴의 옵션을 확인할 때는 클라이언트가 해당 값을 어떻게 저장하는지와 현재 코어가 관련 항목을 인식하는지 함께 살펴보세요. 실행 중 생성된 파일을 직접 수정하면 다음 설정 저장 때 덮어쓰일 수 있습니다. 변경 사항을 계속 유지하려면 클라이언트가 지원하는 설정 경로에 반영하세요.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 클라이언트로, 데스크톱 또는 안드로이드 환경에 맞춰 GUI 기능을 제공합니다. v2rayN과 v2rayNG는 GPL 계열 라이선스를, v2flyNG는 GPLv3 라이선스를 적용합니다. 구체적인 적용 범위, 타사 구성 요소, 배포 조건은 각 프로젝트의 라이선스 원문을 확인하세요. V2Fly와 Xray 코어는 MPL 2.0 라이선스를 사용합니다. 클라이언트와 코어는 별개의 소프트웨어이므로 한쪽의 라이선스를 모든 구성 요소에 그대로 적용할 수 없습니다.
오픈 소스는 라이선스 조건에 따라 코드를 읽고 연구하며 유지보수에 참여할 수 있다는 뜻이지, 출처가 다른 설치 파일의 상태가 모두 같다는 뜻은 아닙니다. 클라이언트를 선택할 때는 기기 플랫폼, 필요한 프로토콜, 설정 호환성을 함께 고려하세요. 데스크톱에서는 v2rayN을 우선 확인하고, 안드로이드에서 Xray 설정을 사용한다면 v2rayNG를, V2Fly에 해당하는 동작이 필요하다면 v2flyNG를 검토하세요. 클라이언트가 서버 운영 방식을 결정하는 것은 아니며 구독 출처를 확인하는 절차를 대신하지도 않습니다.
클라이언트 인터페이스, 코어 기능, 규칙 리소스는 각각 따로 업데이트될 수 있습니다. 인터페이스를 업그레이드한 뒤에는 실제로 활성화된 코어를 확인하고, 규칙 파일을 업데이트한 뒤에는 사용자 지정 태그가 여전히 연결되어 있는지 확인하세요. 업데이트 전에 로컬 포트, 시스템 프록시 모드, 활성 설정, 사용자 지정 라우팅을 기록해 두세요. 내보내기 기능이 있다면 안전한 위치에 백업을 저장합니다. 업데이트 후에는 이전에 작동하던 요청부터 테스트하고 고급 설정을 하나씩 복원하세요. 여러 변경 사항을 한꺼번에 적용하면 문제 원인을 파악하기 어렵습니다.
구독 업데이트와 소프트웨어 업데이트는 구분해야 합니다. 구독 업데이트는 서버 설정을 새로 가져와 주소, 프로토콜, 연결 매개변수가 바뀔 수 있습니다. 소프트웨어 업데이트는 클라이언트와 구성 요소를 변경합니다. 구독에 포함된 단일 설정만으로는 기기의 전체 라우팅 선호 사항을 표현하기 어려우며, 클라이언트의 로컬 규칙도 다른 기기에 자동으로 전달되지 않습니다. 여러 기기를 관리한다면 구독에서 온 설정과 로컬 설정을 구분해 기록해 두면 기기 간 이전 시 혼동을 줄일 수 있습니다.
설정을 더 자세히 조정하려면 inbounds, outbounds, routing, dns 네 부분부터 확인하세요. 인바운드 수신 범위는 필요한 수준으로 제한하고, 아웃바운드 태그는 라우팅에서 참조하는 값과 일치해야 합니다. DNS 동작은 도메인 정책과 함께 판단하세요. 예시의 geosite:cn 규칙은 해당 리소스가 있어야 작동합니다. 규칙만 복사하고 사용할 수 있는 리소스 파일이 없으면 설정이 예상대로 시작되지 않을 수 있습니다.
전체 설정, 공유 링크, 구독 주소에는 접속 인증 정보가 포함될 수 있습니다. 도움을 요청할 때는 필요한 항목만 남기고 인증 매개변수와 전체 구독 경로를 가리세요. 클라이언트 이름, 사용 중인 코어, 오류가 발생한 단계, 관련 로그를 함께 설명하면 좋습니다. 로그의 대상 도메인도 사용 기록을 노출할 수 있으므로 문제 해결에 필요한 부분만 추출하세요. 이런 기준에 따라 자료를 정리하면 연결 실패 화면만 제공하는 것보다 문제를 재현하기 쉽습니다.
V2Ray 설정 항목 더 알아보기 →설정 읽기
가져오기 방법부터 게이트웨이 배포와 단계별 문제 해결까지 살펴봅니다. 최근 글 세 편 중 현재 문제에 맞는 글을 선택하세요. 모든 설정을 한 번에 바꿀 필요는 없습니다.
단일 공유 링크에는 연결 하나의 매개변수가 저장되고, 구독 주소는 여러 설정을 가져오고 업데이트하는 데 사용됩니다. 이 글에서는 두 방식의 가져오기 경로, 업데이트 범위, 보관 방법을 비교하고 v2rayN과 v2rayNG의 사용법을 각각 살펴봅니다. 링크를 붙여넣어도 인식되지 않거나, 가져오기 위치를 잘못 선택했거나, 업데이트 후 설정이 바뀐 경우에 참고하세요.
가져오기 방법 보기 →메인 라우터에서 코어를 실행하는 방식과 보조 라우터를 게이트웨이로 사용하는 방식은 네트워크 배포 구조가 다릅니다. 이 글은 기기 게이트웨이, 투명 프록시, DNS 분기의 관계부터 설명하고, 적용 전에 확인할 전달 경로와 복구 방법을 안내합니다. 배포 방식을 이해하기 위한 참고 자료이며 데스크톱 클라이언트의 시스템 프록시 스위치를 LAN 전체의 트래픽 처리와 동일하게 보면 안 됩니다.
배포 핵심 보기 →속도 저하는 서버 부하, 전송 회선, 로컬 설정 또는 대상 서비스에서 비롯될 수 있습니다. 이 글에서는 계층별로 확인할 항목을 정리하고 연결 시간, 지속 처리량, 앱 응답을 구분합니다. 테스트 조건을 고정한 뒤 변수 하나씩 비교하세요. 한 번의 속도 측정만 보고 설정을 계속 바꾸면 병목 위치를 확인하기 어려워집니다.
단계별 문제 해결 보기 →시스템 프록시나 연결 로그 문제를 확인 중인가요? 글 목록에서 모드 선택과 오류 메시지 해설을 찾아 구체적인 문제를 더 살펴보세요.
전체 글 보기 →