설정 단계별로 항목을 확인하세요. 먼저 노드 하나로 실제 요청을 성공시킨 다음 분기, 트래픽 처리 방식, 코어 옵션을 차례로 추가합니다.
구독 그룹 설정을 열고 출처를 구분할 별칭을 입력한 다음, 전체 구독 주소를 선택적 주소 Url에 붙여 넣고 사용 상태를 유지하세요. 저장한 뒤 구독을 업데이트해야 서버 목록에 노드가 표시됩니다. 주소만 저장했다고 구독을 가져온 것은 아닙니다. 출처마다 그룹을 따로 만들면 필터링과 업데이트가 쉽고, 작동하지 않는 주소도 찾기 편합니다. 처음 설정할 때는 노드가 필터링되지 않도록 필터(정규식)와 User-Agent를 비워 두세요. 자동 업데이트 간격은 구독 제공자의 안내에 맞추고, 업데이트에 실패하면 프록시 사용 여부에 따른 두 요청 경로를 각각 확인하세요.
자세히 보기구독을 업데이트한 뒤 후보 서버를 선택하고 실제 연결 지연을 테스트하세요. TCPing은 대상 포트에 연결되는지만 주로 확인하므로 프로토콜 핸드셰이크나 실제 접속을 대신할 수 없습니다. 실제 연결 지연 테스트는 프록시 경로를 통해 테스트 주소에 요청을 보내므로 첫 연결 상태를 판단하는 데 더 적합합니다. 결과는 테스트 대상과 현재 네트워크, 서버 부하에 따라 달라지므로 한 번 측정한 숫자만으로 순위를 매기지 마세요. 노드를 선택해 활성 서버로 지정한 다음 대상 앱에서 접속을 확인하세요. 테스트에 실패하면 프록시 옵션을 더 켜기 전에 로그에서 핸드셰이크나 DNS 확인 오류를 살펴보세요.
자세히 보기라우팅 분기는 커널에 전달된 요청을 direct, proxy 또는 정의된 다른 아웃바운드 경로로 보냅니다. 앱 트래픽을 클라이언트로 자동 유입시키는 기능은 아닙니다. 먼저 시스템 프록시나 TUN이 적용됐는지 확인한 다음 규칙이 일치하는지 점검하세요. 규칙은 보통 위에서부터 차례로 적용되므로, 로컬 네트워크처럼 분명한 예외를 앞에 두어 포괄적인 조건이 요청을 먼저 가로채지 않게 하세요. 도메인 전략 AsIs, IPIfNonMatch, IPOnDemand에 따라 도메인 조회가 규칙 매칭에 참여하는 시점이 달라지므로 규칙 유형에 맞춰 선택해야 합니다. 설정을 바꾼 뒤에는 직접 연결 대상과 프록시 대상에 각각 접속하고 로그에서 경로를 확인하세요.
자세히 보기시스템 프록시는 운영체제의 프록시 설정을 변경하므로 해당 설정을 따르는 브라우저와 앱에 적합합니다. 자체적으로 연결을 관리하는 프로그램은 시스템 프록시를 사용하지 않을 수 있습니다. TUN은 가상 네트워크 인터페이스로 트래픽을 처리하며 적용 범위가 다르고 권한, 라우팅, DNS 설정도 필요합니다. 처음에는 시스템 프록시부터 설정해 노드가 작동하는지 확인한 뒤 TUN 사용을 검토하세요. 문제 해결을 위해 두 기능을 기본적으로 동시에 켜지는 마세요. 방식을 전환하기 전 기존 설정을 기록하고, 종료할 때 프록시 설정이 정리됐는지 확인하세요. 브라우저는 정상인데 다른 앱에서만 실패한다면 해당 앱이 어떤 프록시 경로를 사용하는지 먼저 점검하세요.
자세히 보기GUI 클라이언트는 설정을 관리하고, 코어는 프로토콜과 전송, 라우팅을 처리합니다. 구독을 인식한다고 해서 현재 코어가 모든 설정을 지원하는 것은 아닙니다. VLESS, XTLS Vision, REALITY 설정은 Xray의 지원 여부를 확인하고, 그 밖의 설정도 실제 코어가 지원하는 범위를 기준으로 판단하세요. 코어를 바꾸기 전에 구독과 사용자 지정 라우팅을 저장하고, 전환 후 활성 서버를 다시 테스트하며 시작 로그를 확인하세요. 다른 코어의 필드를 기존 설정에 그대로 복사하지 말고, 화면이 비슷하다는 이유만으로 두 클라이언트의 기능이 같다고 판단하지 마세요.
자세히 보기클라이언트 다운로드
데스크톱에서는 v2rayN, 모바일에서는 먼저 v2rayNG를 확인하세요. 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택해야 합니다. 구독 주소와 설치 파일은 서로 다른 것이므로 클라이언트를 설치해도 사용할 수 있는 노드가 자동으로 제공되지는 않습니다.
다운로드 페이지에서 데스크톱 버전이나 클래식 WPF 버전을 선택하세요. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하며, WPF 버전은 익숙한 클래식 데스크톱 조작 방식을 제공합니다. 두 버전 모두 시스템 및 실행 환경 요구 사항을 먼저 확인하고, 파일 크기만으로 적합한 버전을 판단하지 마세요.
설치 후 메인 창을 열고 로그에 코어 시작 오류가 있는지 확인한 다음 구독을 가져오세요. 기존 설정이 있다면 프로그램 파일만 복사해 실제 설정을 빠뜨리지 않도록, 먼저 구독 그룹과 사용자 지정 라우팅을 저장하세요.
‘이 Mac에 관하여’에 표시된 칩에 따라 Apple Silicon 또는 Intel 다운로드 항목을 선택하세요. 칩 종류에 맞는 아키텍처가 필요하므로 기기 외관이나 구매 연도로 판단하면 안 됩니다. 설치 후 시스템 안내에 따라 처음 실행하고 필요한 권한을 확인하세요.
먼저 시스템 프록시로 브라우저 연결을 확인한 다음 TUN 사용 여부를 검토하세요. 시스템 보안 경고가 표시되면 앱 출처와 경고 내용을 확인하고, 앱을 실행하려고 시스템 보안 기능 전체를 끄지 마세요.
Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. V2Fly 코어 설정이 필요한 경우에만 v2flyNG를 고려하면 됩니다. 비교적 최근에 출시된 대부분의 기기에는 arm64가 적합합니다. 프로세서 아키텍처를 확인하기 어렵다면 범용 버전 항목과 기기 시스템 정보를 살펴보세요.
구독을 가져온 뒤 서버 목록을 업데이트하고, 연결을 시작할 때 시스템 VPN 권한을 허용하세요. 같은 VPN 경로를 사용하는 다른 앱이 시작을 방해할 수 있습니다. 백그라운드에서 연결이 끊긴다면 구독을 반복해서 가져오기보다 배터리 절약 설정과 백그라운드 실행 권한을 확인하세요.
배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택하고 x64와 arm64 아키텍처를 확인하세요. 그래픽 패키지 설치 도구로 설치한 뒤 데스크톱 앱 메뉴에서 실행하고, 인터페이스와 코어, 설정 디렉터리가 정상적으로 작동하는지 먼저 확인하세요.
데스크톱 환경의 시스템 프록시 설정과 앱 자체 설정은 별도로 적용될 수 있습니다. 브라우저는 되는데 다른 프로그램이 연결되지 않는다면 해당 프로그램이 데스크톱 프록시 설정을 읽는지 먼저 확인하세요. TUN이 필요하다면 문서에 따라 권한과 라우팅을 점검하고 여러 트래픽 처리 도구를 동시에 실행하지 마세요.
다운로드 페이지에서 설치 파일 형식과 시스템 요구 사항을 한눈에 확인할 수 있습니다. 적합한 버전을 고르기 어렵다면 먼저 클라이언트 비교 내용을 읽고 필요한 코어와 플랫폼을 확인한 뒤 해당 다운로드 항목으로 이동하세요.
전체 클라이언트 보기빠른 시작
설정을 세 가지 점검 단계로 나누세요. 각 단계를 마친 뒤 다음으로 진행하면 오류가 발생했을 때 구독 요청, 노드 연결, 앱 프록시 중 어느 단계의 문제인지 구분할 수 있어 여러 설정을 오가며 시행착오를 겪지 않아도 됩니다.
사용할 수 있는 구독 주소를 준비하고, 복사한 내용이 프로토콜 접두어부터 시작하며 쿼리 매개변수가 빠지지 않았는지 확인하세요. 구독 그룹 설정에서 알아보기 쉬운 별칭과 선택적 주소 Url을 입력한 뒤 저장하고 구독을 업데이트합니다. 처음에는 프록시를 사용하지 않고 업데이트해 보세요. 현재 네트워크에서 구독 서버에 접속할 수 없고 이미 사용 가능한 프록시가 있다면 프록시를 통해 업데이트해 보세요.
업데이트가 끝나면 구독 그룹별로 서버 목록을 필터링해 새 항목이 올바른 출처에 속하는지 확인하세요. 목록이 비어 있으면 사용 설정과 필터(정규식), 업데이트 로그부터 살펴보고 프로토콜 필드를 바로 수정하지 마세요. 구독 주소에 접속 정보가 포함될 수 있으므로 공개 스크린샷에서는 전체 주소를 가리고, 다른 기기로 옮길 때는 신뢰할 수 있는 방법을 사용하세요.
후보 항목 몇 개를 선택해 실제 연결 지연을 테스트하고 요청이 정상적으로 완료되는지 확인하세요. TCPing은 성공했지만 실제 연결 지연 테스트에 실패했다면 프로토콜 핸드셰이크, 인증서, 대상 서버 접속 가능성 등을 추가로 점검해야 합니다. 이것만으로 노드를 사용할 수 있다고 단정할 수는 없습니다. 후보 항목을 비교할 때는 테스트 조건을 동일하게 유지해 서로 다른 방식의 결과를 섞지 마세요.
요청을 정상적으로 완료한 항목을 활성 서버로 지정하고 로그에서 코어 상태를 확인하세요. 포트가 사용 중이라는 오류가 나타나면 동시에 실행 중인 프록시 프로그램부터 확인하세요. TLS 오류나 설정 구문 분석 오류가 발생하면 로그의 키워드에 맞춰 관련 설정을 점검하세요. 한 번에 하나씩 변경하고 매번 다시 테스트하면 어떤 변경이 영향을 줬는지 파악하기 쉽습니다.
데스크톱에서는 먼저 시스템 프록시 자동 설정을 선택하고, 시스템 프록시를 따르는 브라우저에서 요청을 보내세요. 접속이 복구되는지 확인한 다음 신뢰할 수 있는 외부 IP 확인 서비스로 요청 경로를 점검하세요. 라우팅 분기를 사용하면 직접 연결 사이트와 프록시 사이트에 표시되는 외부 IP가 다를 수 있습니다. 모든 사이트가 같은 경로를 사용해야 한다고 생각하지 말고 각 대상에 적용되는 규칙을 확인하세요.
브라우저가 계속 기존 외부 경로를 사용한다면 브라우저 자체 프록시 설정과 확장 프로그램, 기존 연결을 확인한 뒤 시스템 프록시 주소와 클라이언트의 수신 포트를 점검하세요. 시스템 프록시를 사용하지 않는 프로그램까지 처리해야 한다면 TUN 설정을 확인하세요. 테스트가 끝나면 클라이언트를 정상적으로 종료하고 시스템 프록시가 복구됐는지 확인해, 종료된 포트를 가리키는 설정이 남지 않도록 하세요.
Project V · V2Fly · Xray
각 구성 요소의 역할을 이해한 뒤 업데이트나 클라이언트 변경이 문제를 해결할 수 있는지 판단하세요. GUI, 코어, 구독 출처, 원격 서버가 모두 연결 결과에 영향을 주므로 어느 한 요소도 다른 요소를 대신할 수 없습니다.
Project V는 네트워크 프록시 도구를 중심으로 형성된 프로젝트 생태계이며, V2Ray는 그중 주요 구현체입니다. 검색에서 ‘V2Ray 클라이언트’는 여러 GUI 도구를 통칭하는 경우가 많지만 클라이언트 이름과 코어 이름은 다릅니다. 인터페이스의 구독 그룹, 트레이 메뉴, 서버 목록은 설정 관리 영역에 속하고, 실제 연결과 전송 처리, 라우팅은 코어가 담당합니다.
따라서 클라이언트 다운로드는 준비 과정의 시작일 뿐입니다. 사용할 수 있는 설정을 적법한 경로로 확보하고 원격 서버 매개변수가 로컬 코어와 맞는지 확인한 뒤 앱에 적합한 트래픽 처리 방식을 선택해야 합니다. 인터페이스가 정상적으로 열려도 원격 서버에 접속할 수 있다는 뜻은 아닙니다.
V2Fly는 V2Ray의 커뮤니티 유지보수를 이어가고 있으며, Xray는 관련 기술 기반에서 발전한 별도의 코어 분기입니다. 공통 개념은 있지만 프로토콜과 전송 방식, 설정 필드가 발전한 과정은 완전히 같지 않습니다. XTLS Vision이나 REALITY 같은 기능을 사용할 때는 Xray의 실제 구현에 맞춰 설정을 확인해야 합니다. 구독에 VLESS라고 표시되어 있다는 이유만으로 호환된다고 판단할 수는 없습니다.
가이드를 읽을 때 클라이언트와 코어, 전송 방식을 함께 기록하세요. 한 분기에서 유효한 필드라고 해서 다른 분기에서도 그대로 작동하는 것은 아닙니다. 알 수 없는 필드나 지원하지 않는 프로토콜 오류가 발생하면 설정을 조정하기 전에 먼저 지원 범위를 확인하세요.
v2rayN은 구독 관리와 노드 테스트, 라우팅 설정 기능을 제공하는 오픈 소스 데스크톱 GUI 클라이언트로, 데스크톱에서는 우선 이 클라이언트부터 살펴보세요. v2rayNG는 Android용으로 Xray 코어를 사용하고, v2flyNG도 Android용이며 V2Fly 코어를 사용하므로 설정에 필요한 경우 대안으로 고려할 수 있습니다. 이름은 비슷하지만 같은 앱의 테마만 다른 것은 아닙니다.
클라이언트와 코어에는 각각 적용되는 프로젝트 라이선스가 있습니다. 관련 정보는 앱에 포함된 라이선스와 정보 화면에서 확인할 수 있습니다. 오픈 소스는 코드와 라이선스 방식을 뜻할 뿐, 클라이언트가 구독 서비스를 제공한다는 의미는 아닙니다. 구독 출처와 서버 사용 권한, 네트워크 환경은 별도로 확인해야 합니다.
구독 업데이트는 기존 출처에서 서버 설정을 가져오는 작업이고, 클라이언트 업데이트는 인터페이스와 코어 통합 방식, 설정 처리 방식을 바꿀 수 있습니다. 구독 업데이트는 노드를 추가하거나 교체, 삭제할 수 있고 클라이언트 업데이트는 지원하는 설정 필드에 변화를 줄 수 있습니다. 문제가 발생하면 어느 계층이 바뀌었는지 먼저 확인하고 모든 문제를 ‘재설치가 필요하다’고 단정하지 마세요.
업그레이드하기 전에 구독 주소와 사용자 지정 라우팅, 필요한 설정을 저장하고 앱의 업데이트 안내를 읽으세요. 업그레이드 후에는 익숙한 노드로 실제 연결 지연과 접속을 먼저 테스트한 다음 복잡한 규칙을 복원하세요. 호환성 문제가 발생하면 설정을 한꺼번에 초기화하지 말고 로그의 구체적인 오류와 재현 조건을 기록하세요.
설정 및 문제 해결 기록
첫 설정을 마친 뒤 실제로 겪은 증상에 맞춰 자세히 알아보세요. 로그 오류와 메인 화면 조작, 인증서 매개변수는 각각 따로 확인해 서로 다른 계층의 문제를 한꺼번에 초기화하지 않도록 하세요.
인증서 만료나 x509 검증 실패 오류는 대부분 기기의 시간 오차 또는 SNI와 인증서 도메인의 불일치에서 발생합니다. 이 글에서는 플랫폼별 시간 동기화와 설정 확인 방법을 안내합니다.
문제 해결 단계 보기v2rayN 메인 창을 영역별로 살펴봅니다. 서버 목록의 마우스 오른쪽 버튼 메뉴, 구독 그룹 필터링과 업데이트, 하단 로그와 상태 표시줄, 설정에서 자주 쓰는 옵션을 설명합니다.
인터페이스 안내 보기포트 사용 중, JSON 구문 분석 실패, 알 수 없는 프로토콜 필드 등의 로그 오류를 읽고 오류 키워드에 따라 설정을 하나씩 수정해 코어를 다시 시작하세요.
시작 로그 확인