4개 플랫폼용 클라이언트 다운로드 경로를 정리하고, 구독 가져오기부터 라우팅 분기까지 순서대로 설정 방법을 안내합니다.
위에서부터 규칙을 적용합니다. final은 기본 아웃바운드를 나타내는 예시 이름입니다.
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}도메인이 geosite:cn에 매칭되면 direct 태그가 지정한 직접 연결 아웃바운드를 사용합니다.
예시를 적용하려면 해당 규칙 데이터와 아웃바운드 정의가 필요합니다. 실제 결과는 실행 로그를 확인하세요.
SETTINGS / 설정 색인
연결 방식과 아웃바운드 규칙을 먼저 구분한 뒤 커널과 DNS 해석 동작을 조정하세요. 왼쪽 목차는 일반적인 설정 순서로 구성했습니다. 코드에는 관련 항목만 표시했으며, 그대로 가져올 수 있는 완성된 설정 파일은 아닙니다.
구독 그룹 → 추가
그룹 이름: 일반 설정
구독 주소: 설정 제공자가 전달한 주소
구독 그룹 → 현재 구독 업데이트구독은 연결 설정을 일괄 관리하는 기능이며 클라이언트 계정과는 다릅니다. 구독 그룹에 주소를 추가해 저장한 뒤 현재 그룹을 업데이트하고, 선택 가능한 설정이 목록에 표시되는지 확인하세요. 그룹 이름은 구독 출처를 구분할 때 사용합니다. 이후 업데이트하면 해당 그룹의 내용이 바뀌므로 직접 수정하기 전에 백업하는 것이 좋습니다. 공유 링크를 하나씩 붙여 넣는 것보다 구독을 사용하면 설정을 한곳에서 갱신하기 편리합니다. 목록이 비어 있다면 주소가 올바르고 만료되지 않았는지, 현재 네트워크에서 구독 서비스에 접속할 수 있는지 먼저 확인하세요. 라우팅 모드를 계속 바꿔 보는 것은 해결책이 아닙니다. 화면에 따라 메뉴 이름은 조금씩 다를 수 있습니다.
함께 읽기 → 사용 설명서: 구독 가져오기시스템 프록시 → 시스템 프록시 설정
라우팅 모드 → 중국 본토 우회
클라이언트로 연결 → 라우팅 규칙 매칭 → 아웃바운드 선택시스템 프록시는 시스템 프록시 설정을 따르는 앱의 요청을 클라이언트로 보낼지 결정하고, 라우팅 모드는 연결된 요청을 직접 연결할지 프록시로 보낼지 결정합니다. 전체 프록시 모드는 보통 클라이언트에 연결된 요청을 프록시 아웃바운드로 보내지만, 모든 앱이 자동으로 연결되는 것은 아닙니다. 평소에는 시스템 프록시와 분할 라우팅을 함께 사용하는 것부터 시작하세요. 규칙 문제를 확인할 때만 전체 프록시 모드로 잠시 바꿔 비교하면 됩니다. 시스템 네트워크를 가로채는 TUN보다 변경 범위가 좁고 원상 복구도 쉽습니다. 특정 앱에서 적용되지 않으면 노드 설정을 바꾸기 전에 해당 앱이 시스템 프록시를 사용하는지 확인하세요.
함께 읽기 → 사용 설명서: 프록시 모드{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}라우팅 분기는 조건에 따라 아웃바운드를 선택하므로 규칙 순서와 필드 값이 모두 중요합니다. 사설 주소는 직접 연결로 유지하고, 구체적인 도메인 규칙을 추가한 다음, 어떤 규칙에도 매칭되지 않은 요청의 기본 경로를 확인하세요. 위 예시는 도메인 목록에 매칭된 요청을 direct 태그로 보내는 설정입니다. 해당 데이터 파일이 커널에 로드되어 있고 같은 이름의 아웃바운드가 정의되어 있어야 합니다. 전체 프록시 모드를 전환하는 것보다 라우팅 규칙을 사용하면 앱이 접속하는 대상을 세밀하게 나눌 수 있지만 관리 부담은 커집니다. 수정할 때는 한 번에 한 종류의 조건만 변경하고 로그로 매칭 여부를 확인하세요. 도메인 해석 실패를 규칙이 적용되지 않은 것으로 오해하지 않도록 주의하세요.
함께 읽기 → 사용 설명서: 라우팅 분기TUN 모드 → 사용 전 권한 확인
확인 항목: 가상 네트워크 어댑터 / 라우팅 / DNS
복구 순서: TUN 끄기 → 기존 네트워크 설정 복원TUN은 가상 네트워크 어댑터를 통해 시스템 네트워크 트래픽을 받습니다. 시스템 프록시를 사용하지 않는 앱에 적합할 수 있지만, 사용 가능 여부는 클라이언트 구현, 시스템 권한, 드라이버 환경에 따라 달라집니다. 먼저 일반 프록시 모드에서 설정을 확인한 뒤 TUN을 켜고 로컬 네트워크, 도메인 해석, 대상 앱이 정상 작동하는지 살펴보세요. 시스템 프록시보다 적용 범위가 넓어 다른 가상 네트워크 어댑터나 네트워크 도구와 충돌하기 쉽습니다. 인터넷 연결이 끊기면 TUN을 끄고 기존 설정을 복원한 다음 권한, 라우팅, DNS를 각각 확인하세요. 네트워크 트래픽을 가로채는 도구를 여러 개 동시에 켜지 않는 것이 좋습니다.
함께 읽기 → 사용 설명서: TUN 모드클라이언트 화면 → 설정 관리
프록시 커널 → 프로토콜 및 전송 처리
선택 기준 → 서버 설정과 커널 지원 범위그래픽 클라이언트는 설정을 관리하고, 커널은 연결을 수립합니다. 두 구성 요소는 서로 다릅니다. 일부 v2rayN 빌드는 여러 커널을 선택할 수 있지만, 구체적인 기능은 사용 중인 빌드의 설정 항목을 기준으로 확인해야 합니다. v2rayNG와 v2flyNG는 각각 다른 커널 생태계를 대상으로 합니다. 전환하기 전에 프로토콜, 전송 방식, 보안 매개변수가 호환되는지 확인하고 기존 설정을 저장해 두세요. 커널 이름만 좇기보다 서버 요구 사항을 항목별로 대조하는 편이 효과적입니다. 매개변수를 가져오지 못한다면 삭제하기 전에 클라이언트와 커널의 지원 범위를 확인하세요.
함께 읽기 → 사용 설명서: 커널 선택{
"routing": {
"domainStrategy": "IPIfNonMatch"
}
}DNS는 도메인을 IP 주소로 변환하고, 도메인 전략은 라우팅에서 해석 결과를 언제 사용할지 결정하므로 함께 확인해야 합니다. 예시 전략은 도메인 규칙이 매칭되지 않을 때 주소 조건과 계속 비교할 수 있도록 해석을 시도합니다. 모든 요청이 특정 DNS 서버를 고정적으로 사용한다는 뜻은 아닙니다. DNS 주소 하나를 입력하는 것만으로는 충분하지 않습니다. DNS 질의가 어떤 아웃바운드를 통과하는지, 시스템 캐시가 사용되는지, IPv6를 어떻게 처리하는지도 확인해야 합니다. 조정 전에는 작동하는 기존 설정을 보존하고 도메인 접속과 IP 주소 연결을 따로 테스트하세요. 아직 연결되지 않은 프록시에 DNS 질의를 의존해 순환이 발생하지 않도록 주의하세요.
함께 읽기 → 사용 설명서: DNS 설정CLIENT SHELF / 플랫폼별 클라이언트
데스크톱에서는 v2rayN부터, 안드로이드에서는 v2rayNG부터 살펴보세요. 다운로드 전 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 클라이언트를 설치한 뒤에는 신뢰할 수 있는 출처에서 받은 유효한 연결 설정이 필요합니다.
v2rayN / Desktop · WPF
브라우저와 업무용 프로그램을 주로 사용하는 데스크톱 환경에 적합합니다. 다운로드 페이지에서 차세대 크로스 플랫폼 인터페이스 버전과 기존 WPF 버전을 구분해 제공하므로, 익숙한 화면과 실행 환경에 따라 선택할 수 있습니다. 처음 설정할 때는 시스템 프록시부터 사용하고 구독, 연결, 라우팅이 정상인지 확인한 뒤 TUN이 필요한지 검토하세요.
설치하거나 압축을 푼 뒤에는 설정 디렉터리에 쓰기 권한이 있는지 확인하세요. 컴퓨터를 옮길 때는 프로그램 바로 가기만 복사하지 말고 구독 그룹과 사용자 지정 규칙도 백업해야 합니다.
다운로드 페이지로 이동 →v2rayN / Apple Silicon · Intel
먼저 시스템 메뉴에서 ‘이 Mac에 관하여’를 열어 칩 또는 프로세서 모델을 확인하세요. Apple Silicon과 Intel은 설치 파일의 아키텍처가 다르므로 파일 이름이 비슷한지만 보고 선택하면 안 됩니다. 설치 후에는 클라이언트 실행 권한과 시스템 프록시 상태도 확인하세요.
브라우저에서는 연결되지만 다른 앱에서는 연결되지 않는다면 해당 앱의 프록시 설정부터 확인하세요. 가상 네트워크 어댑터 권한과 일반 시스템 프록시는 서로 다른 문제 해결 경로입니다.
다운로드 페이지로 이동 →v2rayNG / v2flyNG
v2rayNG는 Xray 커널 설정에, v2flyNG는 V2Fly 커널 생태계의 대안으로 사용할 수 있습니다. 최근 출시된 일반적인 기기라면 대개 arm64를 선택하면 됩니다. 아키텍처를 모르겠다면 범용 패키지 안내를 확인하세요. 처음 연결할 때는 시스템의 VPN 연결 권한을 허용해야 합니다. 이 권한은 기기를 로컬 네트워크에 연결하기 위한 것으로, 사용 가능한 원격 설정이 이미 있다는 뜻은 아닙니다.
백그라운드에서 연결이 끊긴다면 절전 제한과 백그라운드 실행 권한도 확인하세요. 앱별 프록시를 설정할 때는 먼저 목록 모드의 의미를 확인한 뒤 연결할 앱을 선택하세요.
다운로드 페이지로 이동 →v2rayN / deb · rpm
배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 뒤 기기 아키텍처가 x64인지 arm64인지 확인하세요. 그래픽 클라이언트는 데스크톱 세션에서 구독을 관리하고 규칙을 조정하는 데 적합합니다. 앱이 시스템 프록시를 사용할 수 있는지는 데스크톱 환경과 앱 자체 설정에도 영향을 받습니다.
TUN이나 시스템 라우팅을 사용한다면 권한과 다른 네트워크 서비스도 확인해야 합니다. 먼저 일반 프록시를 검증하고 트래픽 적용 범위를 단계적으로 넓히면 설정이 겹쳐 문제를 찾기 어려워지는 상황을 줄일 수 있습니다.
다운로드 페이지로 이동 →FIRST CONNECTION / 설정 순서
처음 사용할 때는 같은 결과를 재현할 수 있는 연결 절차부터 만드세요. 프록시 모드, DNS, 커널을 한꺼번에 바꾸면 연결 결과가 달라졌을 때 어떤 설정이 영향을 줬는지 알기 어렵습니다.
데스크톱에서는 구독 그룹에 주소를 저장한 뒤 현재 그룹을 업데이트하고, 안드로이드에서는 구독 설정에서 주소를 추가해 새로고침하세요. 구독 주소에는 개인 접근 정보가 포함될 수 있으므로 공개된 스크린샷이나 대화 기록에 올리지 마세요. 가져온 뒤에는 설정 이름, 프로토콜 종류, 구독 출처를 확인하세요. 목록이 비어 있다면 먼저 구독을 가져오는 과정에 문제가 없는지 점검하세요.
공유 링크가 하나뿐이라면 클라이언트의 클립보드 가져오기 기능을 사용하세요. 구독 업데이트와 수동 가져오기는 서로 다른 작업입니다. 공유 링크를 구독 주소 입력란에 붙여 넣지 마세요. 메뉴 이름이 화면마다 다르면 ‘소스 추가, 저장, 업데이트’ 순서로 해당 기능을 찾아보세요.
사용 가능한 설정 하나를 활성 항목으로 지정한 뒤 연결 방식을 선택하세요. 데스크톱에서는 시스템 프록시부터 시도하고, 안드로이드에서는 연결 권한을 허용한 뒤 서비스를 시작하세요. 라우팅은 클라이언트의 기본 분할 모드부터 시작하고, 검증하지 않은 사용자 지정 규칙을 많이 추가하지 않도록 현재 설정을 기록해 두세요.
시스템 프록시와 전체 라우팅은 서로 다른 계층에서 작동합니다. 시스템 프록시는 요청을 클라이언트로 보내고, 라우팅은 아웃바운드를 선택합니다. 대상 앱이 시스템 설정을 사용하지 않는다면 앱에서 프록시를 별도로 설정하거나, 적용 범위를 충분히 파악한 뒤 TUN을 고려하세요. 라우팅 모드를 바꿔도 서버 매개변수가 누락된 문제는 해결되지 않습니다.
시작한 뒤 설정 해석, 연결 수립, 도메인 해석 오류가 있는지 확인하고 대상 앱에서 실제 요청을 보내 보세요. 한 번의 테스트는 특정 경로만 확인할 수 있으며 모든 프로토콜과 앱이 정상이라는 뜻은 아닙니다. 일반적으로 직접 연결할 서비스와 프록시가 필요한 대상이 각각 예상대로 작동하는지도 확인하세요.
문제가 생기면 가장 단순하게 작동하던 설정으로 돌아가세요. 새로 추가한 트래픽 가로채기 기능을 끄고 기본 라우팅을 복원한 뒤 항목별로 다시 켜면 됩니다. 테스트 후 클라이언트를 당분간 사용하지 않는다면 시스템 프록시가 복원되었는지도 확인하세요. 창을 닫는 것만으로 백그라운드 서비스가 중지되거나 시스템 설정이 초기화되는 것은 아닙니다.
PROJECT V / 생태계 안내
일상적인 대화에서 ‘V2Ray’는 프로젝트, 커널, 또는 관련 설정 도구를 가리킬 수 있습니다. 각 구성 요소의 역할을 먼저 구분해야 기능이 클라이언트 화면에 속하는지, 커널이나 서버에 달려 있는지 판단할 수 있습니다.
Project V 생태계는 모듈형 네트워크 프록시 기능을 기반으로 하며, 인바운드, 라우팅, 아웃바운드의 역할을 분리합니다. 요청은 인바운드로 처리 과정에 들어온 뒤 라우팅 조건에 따라 아웃바운드를 선택합니다. 버튼 위치를 외우는 것보다 이 순서를 이해하는 편이 오래 도움이 됩니다. 인터페이스가 바뀌어도 연결 범위, 매칭 조건, 연결 매개변수는 각각 확인해야 합니다. V2Ray 관련 글에서 말하는 ‘설정’은 로컬 동작 전체를 담은 완성된 설정 파일이 아니라 원격 연결 정보 하나를 뜻할 수도 있습니다.
V2Fly는 V2Ray 관련 오픈 소스 프로젝트의 개발과 유지 관리를 이어가고, Xray는 별도로 발전하는 커널 분기가 되었습니다. 두 프로젝트는 일부 역사와 개념을 공유하지만 프로토콜, 보안 매개변수, 설정 동작이 항상 일치하는 것은 아닙니다. VLESS, VMess, Trojan은 연결 프로토콜 계층의 개념이며 전송 방식과 보안 설정은 별도로 확인해야 합니다. 프로토콜 이름이 같다고 해서 모든 커널에서 설정을 그대로 옮길 수 있다고 가정하면 안 됩니다. 인식하지 못하는 필드가 있다면 설정을 변환하기 전에 지원 범위를 확인하세요.
v2rayN, v2rayNG, v2flyNG는 모두 설정 관리 작업을 간편하게 해 주는 오픈 소스 그래픽 클라이언트입니다. v2rayN은 데스크톱 플랫폼용이며, v2rayNG는 주로 Xray 커널을, v2flyNG는 V2Fly 커널을 대상으로 합니다. 이 클라이언트는 원격 서버 자체가 아니며 설치 프로그램이 사용할 수 있는 구독을 자동으로 만들지도 않습니다. 오픈 소스란 해당 라이선스에 따라 소스 코드를 확인하고 사용할 수 있다는 뜻이지, 임의의 구독 출처나 원격 서비스의 품질을 보장한다는 의미는 아닙니다. 클라이언트, 커널, 종속 구성 요소에는 서로 다른 라이선스가 적용될 수 있으므로 사용과 배포 전에 각 프로젝트의 실제 라이선스 내용을 확인하세요.
클라이언트 업데이트, 커널 업데이트, 규칙 데이터 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 화면이나 설정 생성 방식을 바꿀 수 있고, 커널 업데이트는 프로토콜 구현과 실행 동작에 영향을 줍니다. 규칙 데이터 업데이트는 도메인 및 주소 목록의 매칭 결과를 바꿉니다. 업데이트 전에는 구독 그룹, 사용자 지정 라우팅, 주요 설정을 백업하세요. 업데이트 후에는 새 기능을 켜기 전에 기존에 작동하던 환경부터 확인해야 합니다. 문제를 확인할 때 운영체제, 클라이언트 종류, 사용 중인 커널, 오류가 발생한 단계를 기록하면 ‘연결 안 됨’이라고만 말하는 것보다 원인을 좁히기 쉽습니다. 로그를 공유하기 전에는 구독 주소와 개인 연결 정보를 삭제하세요.
V2Ray 지식 베이스는 다운로드 경로, 그래픽 클라이언트 사용법, 설정 개념을 정리합니다. 클라이언트를 공식 배포하거나 서버·구독 서비스를 제공하는 곳은 아닙니다. 안내는 각 기능의 역할과 문제 해결 순서를 중심으로 하며, 실제 메뉴와 사용 가능한 항목은 설치된 빌드에 따라 달라질 수 있습니다. 처음 시작한다면 입문 문서부터 읽고, 매개변수 간 관계가 궁금하다면 사용 설명서를 확인하세요. 특정 용어나 반복되는 오류는 용어 설명과 FAQ에서 찾아볼 수 있습니다. 한 가지 문제 때문에 이미 작동하는 설정 전체를 바꾸지 않도록 하세요.
TECHNICAL NOTES / 최신 노트
모든 연결 실패를 같은 원인으로 보지 않고 실제 증상에 따라 설정을 나눠 살펴봅니다. 아래 세 편은 로컬 클라이언트, 게이트웨이 배포, 안드로이드 백그라운드 동작을 각각 다룹니다. 기본 연결을 확인한 다음 읽어 보세요.
노드 품질, 전송 경로, 로컬 클라이언트 설정을 차례로 점검해 속도 저하 원인을 찾습니다. 각 단계에서 실행할 수 있는 확인 항목과 조정 방법을 안내합니다. 먼저 같은 조건에서 비교한 뒤 설정 변경이 필요한지 판단하세요.
노트 읽기 →메인 라우터와 보조 라우터에서 Xray 또는 V2Fly 커널을 직접 실행하는 방법을 소개합니다. 투명 프록시 원리, 게이트웨이 설정, 하드웨어 리소스 점검 항목을 다룹니다. 배포 위치가 바뀌면 트래픽 적용 범위와 장애 영향도 달라집니다.
노트 읽기 →안드로이드에서 v2rayNG를 설정할 때 중요한 세 가지를 살펴봅니다. VpnService 연결 권한, 연결 끊김을 막는 배터리 최적화 예외, 앱별 프록시 목록 설정 방법을 안내합니다. 서비스 시작 문제와 백그라운드 실행 문제를 나누어 해결하세요.
노트 읽기 →