클라이언트 설치, 구독 가져오기, 라우팅 분기를 한곳에 정리했습니다. 설정 이름은 클라이언트 화면과 동일하게 표기했으며, 단계대로 진행하면 기본 설정을 완료할 수 있습니다.
클라이언트 설정 패널
먼저 사용 환경을 선택한 다음 해당 설정을 확인하세요. 예시 이름은 클라이언트에서 흔히 사용하는 메뉴와 규칙 구문을 따릅니다.
구독 그룹 목록
데스크톱에서는 먼저 “구독 그룹”에 전체 구독 주소를 저장한 뒤 “현재 구독 업데이트”를 실행하세요. 가정용, 업무용, 테스트용은 각각 그룹을 만들어 서로 다른 출처가 하나의 서버 목록에 섞이지 않게 할 수 있습니다. 업데이트 후 목록이 비어 있다면 시스템 프록시를 계속 전환하기보다 그룹 필터 키워드와 주소가 완전한지 먼저 확인하세요.
규칙은 위에서 아래로 매칭됩니다
라우팅 규칙은 고정 도메인 분류, 사설 주소 및 기타 연결을 처리하는 데 적합합니다. 일반적으로 geosite:cn과 geoip:private는 direct로, geosite:geolocation-!cn은 proxy로 설정합니다. 규칙이 일치하면 보통 이후 검사를 중단하므로 구체적인 규칙을 포괄적인 규칙보다 앞에 배치해야 합니다.
트래픽 처리 범위 선택
브라우저와 시스템 프록시를 따르는 데스크톱 앱은 보통 “시스템 프록시”만 켜면 됩니다. 시스템 프록시를 읽지 않는 프로그램이 있다면 TUN 모드 활성화를 검토하세요. TUN은 더 넓은 트래픽을 처리하므로 처음 켤 때 시스템 권한이 필요할 수 있습니다. 전환 전에 라우팅과 DNS 설정을 확인해 로컬 서비스가 잘못 프록시 아웃바운드로 전송되지 않게 하세요.
설정 가져오기
단일 설정은 클립보드나 QR 코드에서 가져올 수 있어 임시 추가에 적합합니다. 구독 주소는 그룹에 저장하고 이후 업데이트 작업으로 내용을 동기화하세요. 가져온 뒤에는 프로토콜, 주소, 포트, 전송 방식 및 TLS 관련 필드를 먼저 확인하세요. QR 코드 인식에 실패하면 스크린샷 압축의 영향을 피하기 위해 전체 링크를 복사해 사용하세요.
시스템 네트워크 권한
Android 클라이언트를 시작하면 시스템 네트워크 연결 권한을 요청합니다. 로컬 트래픽 처리 채널을 만들기 위해 필요한 단계입니다. 권한을 허용하면 상태 표시줄에 시스템 네트워크 아이콘이 나타납니다. 시작 후에도 앱이 연결되지 않으면 메인 화면의 시작 버튼만 확인하지 말고 현재 설정, 라우팅 모드, DNS, 앱별 범위, 배터리 절전 제한을 차례로 점검하세요.
앱 적용 범위
앱별 프록시는 일부 프로그램만 현재 설정을 사용하게 하거나 로컬 서비스가 기존 연결을 유지하도록 할 때 유용합니다. 포함 모드는 선택한 앱만 처리하고, 제외 모드는 제외하지 않은 앱을 처리합니다. 설정 전에 대상 범위를 정한 뒤 새로 설치한 앱을 목록에 추가해야 하는지 확인하세요. 서로 반대되는 방식을 동시에 사용하면 판단이 어려워집니다.
프로토콜 필드
VMess, VLESS, Trojan 및 Shadowsocks는 서로 다른 인증 필드와 연결 방식을 사용합니다. 설정을 가져올 때는 TCP, WebSocket, gRPC, TLS, REALITY 등 전송 계층 매개변수도 함께 확인해야 합니다. 클라이언트는 해당 필드를 올바른 코어에 전달하지만 누락된 서버 이름, 경로 또는 공개 키 설정을 자동으로 수정하지는 않습니다.
조회 경로
도메인 규칙은 조회 및 스니핑 결과에 의존합니다. 기본 설정에서는 먼저 클라이언트 기본 DNS를 사용한 뒤 분기 요구에 맞춰 로컬 및 원격 조회를 설정할 수 있습니다. FakeDNS 또는 TUN을 활성화했다면 DNS 처리 범위, 사설 도메인, LAN 주소도 함께 확인하세요. 그렇지 않으면 규칙은 일치한 것처럼 보여도 실제 연결이 잘못된 아웃바운드로 나갈 수 있습니다.
단계별 문제 해결
구독 업데이트 실패가 기존 설정을 실행할 수 없다는 뜻은 아니며, 서버 테스트 실패도 반드시 시스템 프록시 문제는 아닙니다. 문제를 해결할 때는 먼저 구독을 파싱할 수 있는지 확인하고, 다음으로 설정 필드와 코어 로그를 점검한 뒤 시스템 프록시 또는 로컬 VPN이 대상 앱을 처리하는지 확인하세요. 단계별로 결과를 기록하면 여러 설정을 연속으로 바꾸는 것보다 원인을 찾기 쉽습니다.
플랫폼별 선택
데스크톱에서는 v2rayN을 사용합니다. Android에서는 코어 요구 사항에 따라 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 홈에서는 플랫폼만 안내하며, 구체적인 설치 패키지 종류와 시스템 요구 사항은 다운로드 페이지에 정리되어 있습니다.
v2rayN 데스크톱 버전 또는 클래식 WPF 버전을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고 WPF 버전은 익숙한 Windows 방식을 유지하며, 두 버전 모두 구독, 라우팅, 시스템 프록시를 관리할 수 있습니다.
다운로드 페이지로 이동v2rayN은 다양한 칩 아키텍처에 맞는 설치 항목을 제공합니다. 다운로드 전에 “이 Mac에 관하여”에서 칩 유형을 확인하고, 처음 실행할 때 시스템 안내에 따라 앱 및 네트워크 권한을 처리하세요.
다운로드 페이지로 이동v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 최신 기기는 대부분 arm64 아키텍처를 우선 선택할 수 있으며, 기기 아키텍처가 확실하지 않다면 범용 설치 패키지를 사용하세요.
다운로드 페이지로 이동v2rayN은 deb와 rpm 두 가지 데스크톱 설치 항목을 제공하며 x64와 arm64를 구분합니다. 배포판의 패키지 형식과 프로세서 아키텍처에 맞는 파일을 선택하세요.
다운로드 페이지로 이동빠른 시작
먼저 최소한의 작동 설정을 완료한 뒤 라우팅, DNS, TUN 설정을 단계적으로 추가하세요. 한 번에 너무 많은 옵션을 바꾸면 문제 원인을 찾기 어려워집니다.
플랫폼에 맞춰 다운로드 페이지로 이동하세요. Windows, macOS, Linux에서는 v2rayN을 사용하고 Android에서는 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 설치 후 “구독 그룹”을 열어 새 그룹을 만들고 전체 구독 주소를 붙여 넣은 다음 업데이트를 실행하세요. 단일 공유 링크는 클립보드에서 가져올 수 있지만 구독처럼 한곳에서 일괄 업데이트되지는 않습니다.
업데이트 후 먼저 서버 목록에 항목이 표시되는지 확인하세요. 목록이 비어 있다면 주소가 복사 중 잘리지 않았는지, 그룹 필터 조건이 지나치게 엄격하지 않은지, 업데이트가 현재 그룹에 적용되었는지를 중점적으로 확인하세요. 이때 구독 파싱은 연결보다 먼저 이루어지므로 시스템 프록시를 서둘러 변경할 필요는 없습니다.
서버 목록에서 설정 하나를 선택해 활성 항목으로 지정하세요. 데스크톱에서는 먼저 “시스템 프록시”를 켜 브라우저와 시스템 프록시를 읽는 앱이 현재 설정을 사용하게 하세요. Android에서는 연결을 시작한 뒤 시스템 안내에 따라 로컬 VPN 권한을 허용합니다. 완료 후 자주 사용하는 페이지에 접속해 기본 연결이 정상인지 확인하세요.
대상 프로그램이 시스템 프록시를 읽지 않거나 더 많은 네트워크 연결을 처리해야 할 때만 TUN 모드를 검토하세요. 활성화 후에는 로컬 개발 서비스, LAN 기기, DNS가 여전히 예상대로 접속되는지 확인해야 합니다. 기본 연결을 확인하기 전에는 복잡한 라우팅과 FakeDNS를 함께 활성화하지 않는 것이 좋습니다.
기본 연결이 안정된 뒤 규칙 기반 분기를 설정하세요. 규칙은 순서대로 매칭되므로 구체적인 도메인이나 사설 주소 조건을 먼저 배치하고 더 넓은 범위의 규칙을 뒤에 두는 것이 좋습니다. 흔히 geosite:cn, geoip:private, geosite:geolocation-!cn을 사용하며, 해당 아웃바운드는 direct 또는 proxy로 설정할 수 있습니다.
저장 후 설정을 다시 불러오고 로그에서 규칙, DNS, 아웃바운드 선택을 확인하세요. 문제가 생기면 이전 단계로 돌아가 최근 변경을 하나씩 되돌리세요. 구독, 프로토콜, DNS, 시스템 트래픽 처리 방식을 동시에 바꾸지 않아야 어느 계층의 설정이 연결에 영향을 주었는지 알 수 있습니다.
오픈 소스 생태계
클라이언트, 코어, 프로토콜의 역할을 이해하면 설정 오류가 어느 계층에서 발생했는지 판단하기 쉽습니다. 그래픽 클라이언트는 가져오기, 편집, 시작 및 중지를 담당하고, 코어는 프로토콜을 파싱해 연결을 만들고 라우팅을 실행합니다. 구독은 설정을 일괄 전달하는 수단입니다.
Project V는 V2Ray 설정 체계, 프로토콜 구현, 라우팅 기능을 중심으로 오픈 소스 생태계를 구축했습니다. V2Fly는 관련 핵심 구성 요소를 이어받아 유지 관리하며 인바운드, 아웃바운드, 라우팅, DNS, 전송 설정 구조를 유지합니다. v2flyNG는 V2Fly 코어를 사용하므로 이 코어 체계를 유지하려는 Android 사용자에게 적합합니다.
“V2Ray”는 일상적으로 생태계, 설정 방식, 클라이언트 유형을 모두 가리키는 말로 쓰이지만 이 개념들은 완전히 같지 않습니다. 오류가 발생하면 메시지가 그래픽 인터페이스, 구독 파싱, 코어 실행 로그 중 어디에서 나온 것인지 먼저 확인하세요. 계층을 구분하면 클라이언트 화면 문제를 프로토콜 문제로 잘못 판단하는 일을 줄일 수 있습니다.
Xray는 유사한 설정 생태계를 바탕으로 프로토콜과 전송 기능을 계속 확장합니다. v2rayN은 기능과 설정에 따라 적절한 코어 구성 요소를 사용할 수 있으며, v2rayNG는 Android에서 Xray 코어를 주요 실행 계층으로 사용합니다. VLESS, REALITY, gRPC 등의 필드가 정상 작동하는지는 클라이언트 이름뿐 아니라 코어 지원 여부, 서버 설정, 매개변수의 대응 상태에 따라 달라집니다.
클라이언트는 링크를 가져온 뒤 필드를 내부 설정으로 변환하지만, 변환되었다고 해서 모든 조합이 유효한 것은 아닙니다. 서버 이름, 흐름 제어, 지문, 공개 키, 짧은 식별자, 경로, 호스트 필드는 각각 명확한 용도가 있습니다. 핸드셰이크 오류가 발생하면 여러 설정 사이를 반복해서 전환하기보다 프로토콜과 전송 계층을 기준으로 하나씩 확인하세요.
v2rayN은 Windows, macOS, Linux용 데스크톱 그래픽 클라이언트로 서버 목록, 구독 그룹, 라우팅 설정, 시스템 프록시, TUN, 로그 관리 기능을 제공합니다. v2rayNG와 v2flyNG는 Android용이며 인터페이스는 비슷하지만 사용하는 코어 계열이 다릅니다. 세 클라이언트 모두 커뮤니티에서 계속 유지 관리되지만 출시 주기와 플랫폼 지원 범위가 완전히 일치할 필요는 없습니다.
오픈 소스 라이선스는 커뮤니티가 코드를 검토하고 구현을 논의하며 호환성을 지속적으로 개선할 수 있게 합니다. 일반 사용자에게는 설정 이름, 구성 구조, 문제 해결 논의를 공개적으로 확인할 수 있다는 점이 더 직접적인 가치입니다. 클라이언트를 선택할 때는 화면 디자인만 비교하기보다 운영 체제, 코어 요구 사항, 프로토콜 필드, 사용 습관을 기준으로 판단하세요.
클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 그래픽 인터페이스와 기능 통합을 바꾸고, 코어 업데이트는 프로토콜 구현과 실행 동작에 영향을 주며, 구독 업데이트는 설정 내용만 동기화합니다. 업데이트 문제를 해결할 때는 어느 계층이 변경되었는지 먼저 확인하고 현재 작동하는 설정을 비교용으로 보관하세요.
기존 설정은 새 버전에서도 대체로 계속 가져올 수 있지만, 새로 추가된 필드는 다시 저장하거나 수동으로 보완해야 할 수 있습니다. 여러 구독을 사용하는 경우 그룹 이름을 명확하게 지정해 잘못된 출처를 업데이트하지 않도록 하세요. 라우팅과 DNS 같은 로컬 설정은 원격 구독에 포함되지 않을 수 있으므로 별도로 기록해야 합니다.
자주 묻는 질문
다음 항목은 문제 해결을 시작할 지점을 빠르게 정하는 데 도움이 됩니다. 전체 원인과 화면 경로, 처리 단계는 FAQ 및 고급 설정 안내서에 정리되어 있습니다.
먼저 구독 주소가 완전한지 확인한 다음 현재 그룹의 필터 키워드를 점검하세요. 필터 조건 때문에 파싱된 설정이 모두 숨겨질 수 있습니다. 주소에 기존 연결이 필요하다면 구독 업데이트에 사용된 네트워크 경로도 확인해야 합니다.
구독 문제 안내 보기 →일부 프로그램은 시스템 프록시를 읽지 않거나 별도의 네트워크 설정을 사용합니다. 먼저 프로그램 자체의 프록시 옵션을 확인하고 필요할 때 TUN 모드를 검토하세요. 기본 설정을 확인하기 전에는 처리 범위를 바로 넓히지 마세요.
연결 단계 보기 →지연 시간 테스트는 특정 테스트 방식에서의 연결 시간만 보여 주며 전송 안정성을 단독으로 나타내지는 않습니다. 지역, 회선 변동, 트래픽 배율, 프로토콜 오버헤드, 실제 접속 대상도 함께 고려해야 합니다.
노드 선택 안내 읽기 →규칙은 위에서 아래로 매칭되므로 구체적인 조건을 포괄적인 조건보다 앞에 배치하세요. 도메인에는 geosite 분류를, 대상 주소에는 geoip 분류를 사용하며 사설 주소는 보통 직접 연결을 우선합니다.
라우팅 규칙 실전 예시 보기 →가이드 업데이트
실제 연결 지연 시간 테스트, 트래픽 배율, 서버 위치, 프로토콜 유형을 기준으로 일상적인 노드 선택 순서를 정리하고 클라이언트 그룹에서 빠르게 필터링하는 방법을 설명합니다.
전문 읽기시스템 설정 경로에 따라 처음 앱을 열 때 개발자 출처를 확인하고, 시스템 프록시 또는 TUN을 활성화할 때 네트워크 권한을 처리하는 방법을 안내합니다.
전문 읽기메인 창의 영역별로 메뉴 바, 구독 그룹, 서버 목록, 상태 표시줄, 로그 패널을 설명해 처음 사용하는 사람이 전체 작업 순서를 익히도록 돕습니다.
전문 읽기