CONFIGURATION INDEX
먼저 연결이 되는지 확인한 뒤 그룹, 트래픽 분기, 트래픽 처리 방식을 하나씩 조정하세요. 설정 조각은 각 필드를 설명하기 위한 예시이며, 전체 설정 파일을 그대로 덮어쓸 수 있는 내용이 아닙니다.
‘구독 그룹 설정’을 열고 출처별로 그룹을 만든 다음 전체 구독 주소를 입력하세요. 그룹 이름은 출처를 식별하고 필터 조건은 목록에 포함할 서버를 결정하므로 서로 혼동하지 마세요. 처음 업데이트할 때는 필터 조건을 비워 두고 내용을 불러올 수 있는지 확인한 뒤 이름으로 필터링하세요. 업데이트 후 목록이 비어 있으면 먼저 링크가 유효한지, 응답이 구독 형식인지 확인하고 필터 표현식을 살펴보세요. 공유 링크를 한꺼번에 직접 가져오는 것과 달리 구독 그룹은 업데이트 경로를 유지하므로 나중에 특정 출처만 새로고침할 수 있습니다. 로그를 공유하기 전에 구독 주소에 포함된 인증 정보를 삭제하세요.
v2rayN → 구독 그룹 설정
그룹 추가 → 구독 주소 입력 → 저장
구독 그룹 → 현재 구독 업데이트(프록시 사용 안 함)‘라우팅 설정’에서 현재 활성화된 규칙 집합을 확인한 다음 도메인 또는 주소 일치 조건을 추가하세요. 규칙은 순서대로 평가되며 먼저 일치한 항목이 아웃바운드를 결정합니다. 포괄적인 규칙을 앞에 두면 뒤에 있는 세부 규칙이 적용되지 않을 수 있습니다. outboundTag가 실제로 존재하는 아웃바운드를 가리키는지 확인하고 화면의 메모만 보지 마세요. 아래 조각은 차단 규칙 하나를 보여 주며 해당 geosite 리소스와 block 아웃바운드가 필요합니다. 전체 프록시와 달리 규칙 기반 라우팅은 직접 연결·프록시·차단을 각각 처리할 수 있지만, 규칙 리소스를 함께 관리하고 대상 도메인을 하나씩 테스트해야 합니다.
{
"type": "field",
"domain": ["geosite:category-ads-all"],
"outboundTag": "block"
}먼저 시스템 DNS, 코어 DNS, 앱 자체의 암호화 DNS가 서로 다른 경로를 사용할 수 있다는 점을 구분하세요. ‘DNS 설정’의 서버 주소는 코어가 어디에 조회할지 정하고, 라우팅 규칙과 아웃바운드 정책은 조회 요청이 어떤 경로로 전송될지 결정합니다. 문제를 확인할 때는 연결 가능한 리졸버 하나를 유지하고 대상 도메인과 오류를 기록한 뒤 도메인별 조회를 단계적으로 추가하세요. DNS를 바꾸는 것만으로 모든 연결 문제가 해결되지는 않습니다. 아래는 V2Ray 계열 설정의 일부 예시입니다. 다른 코어를 사용한다면 필드 정의를 확인하세요. 시스템 리졸버만 바꾸는 것과 달리 코어 DNS는 라우팅 판단에 참여할 수 있지만, 인바운드에서 도메인을 전달받는지에 따라 달라집니다.
{
"dns": {
"servers": ["https://1.1.1.1/dns-query"]
}
}먼저 시스템 프록시로 서버 연결을 확인한 다음 ‘TUN 모드’를 켜세요. TUN은 가상 네트워크 인터페이스로 트래픽을 받아 시스템 프록시 설정을 읽지 않는 앱에 적합하지만, 대상 연결을 실제로 처리할지는 라우팅, 제외 항목, 코어 구현에 따라 달라집니다. 활성화 전에 관리자 권한을 확인하고 같은 네트워크 기능을 사용하는 다른 도구는 잠시 중지하세요. 켠 뒤에는 웹페이지, 도메인 조회, 로컬 네트워크 리소스를 각각 테스트하세요. 아래는 sing-box TUN 인바운드 필드 일부이며 Xray 설정에 그대로 넣을 수 없습니다. 시스템 프록시보다 적용 범위가 넓은 만큼 루프백이나 라우팅 충돌이 발생하기 쉬우므로 문제가 생기면 먼저 트래픽 처리를 중지한 뒤 원인을 찾으세요.
{
"type": "tun",
"auto_route": true,
"strict_route": true
}클라이언트 화면과 연결을 실행하는 코어는 서로 다른 구성 요소입니다. ‘Core 유형 설정’을 열기 전에 사용할 프로토콜과 전송 방식, 현재 클라이언트에서 선택할 수 있는 코어를 확인하세요. 전환한 뒤에는 메뉴에서 선택된 것만 보지 말고 시작 로그에서 설정이 정상 생성되었는지 확인해야 합니다. Xray, V2Fly 및 기타 호환 코어는 필드가 완전히 동일하지 않으므로 사용자 지정 설정은 특히 항목별로 확인해야 합니다. 클라이언트 전체를 바꾸는 대신 같은 화면에서 코어를 전환하면 익숙한 관리 방식을 유지할 수 있지만, 구독을 가져올 수 있다고 모든 서버가 실행되는 것은 아닙니다. 지원하지 않는 필드가 있으면 계속 재설치하지 말고 문서를 확인하세요.
v2rayN → 매개변수 설정 → Core 유형 설정
프로토콜에 맞는 Core 유형 확인
저장 → 서비스 재시작 → 시작 로그 확인‘가져오기 성공 → 코어 시작 → 앱에서 프록시 사용 → 라우팅 규칙 일치’ 순서로 확인하세요. 구독 업데이트와 연결 테스트는 별개의 작업입니다. 구독을 읽을 수 있다는 것은 업데이트 주소에 접근할 수 있다는 뜻이지 모든 서버에 연결할 수 있다는 뜻은 아닙니다. 브라우저에서 페이지가 열려도 다른 앱이 프록시를 사용한다고 볼 수 없습니다. 한 번에 설정 하나만 바꾸고 변경 전 값을 기록해 두어야 결과와 원인을 연결할 수 있습니다.
처음 설정한다면 빠른 시작부터 진행하고, 연결이 이미 된다면 고급 핸드북을 확인하세요. 낯선 필드는 용어집에서 프로토콜, 전송 방식, 코어, 아웃바운드의 차이를 먼저 살펴보세요. 화면 이름은 클라이언트 릴리스에 따라 달라질 수 있으니 실제 설정 화면을 기준으로 하고, 서로 다른 코어의 JSON 조각을 섞어 붙이지 마세요.
PROJECT V / V2FLY / XRAY
클라이언트 다운로드는 설치와 관리에 필요한 단계이고, 코어 선택은 설정 기능을 결정하며, 서버 매개변수를 가져와야 연결을 구성할 수 있습니다. 이 세 단계를 각각 확인해야 합니다.
Project V는 네트워크 프록시 도구와 관련 기능을 중심으로 구성된 프로젝트 체계이며, V2Ray는 그 주요 구성 요소 중 하나입니다. V2Fly 커뮤니티는 V2Ray 코어의 개발과 유지 관리를 이어 왔고, Xray는 관련 기술을 바탕으로 독자적인 코어와 기능 발전 경로를 만들어 왔습니다. 일부 프로토콜 개념과 설정 방식은 공유하지만 같은 프로그램의 다른 화면은 아닙니다. ‘V2Ray 코어 차이’를 알아볼 때는 지원 프로토콜, 전송 조합, 설정 필드, 클라이언트 통합 방식을 함께 비교하세요.
코어는 설정을 읽고 인바운드 연결을 받아 라우팅을 매칭한 뒤 아웃바운드를 설정합니다. GUI 클라이언트는 구독과 설정을 코어가 이해할 수 있는 설정으로 변환하고 시작·중지·로그·시스템 연동 기능을 제공합니다. 이름이 비슷한 클라이언트라도 코어가 완전히 같다는 뜻은 아니며, 같은 클라이언트가 여러 코어를 사용할 수도 있습니다. 앱 이름만 보고 호환성을 판단하기보다 실제로 실행된 코어와 로그를 확인하는 편이 정확합니다.
프로토콜 이름은 연결 양쪽에서 데이터를 주고받는 방식을 설명하고, 전송 방식은 데이터가 어떤 통로를 이용하는지 나타내며, 보안 매개변수는 핸드셰이크와 인증에 영향을 줍니다. 공유 링크를 가져오면 클라이언트가 이 필드를 해석하지만 서버에서 빠진 설정까지 채워 주지는 않습니다. 연결되지 않는다면 먼저 서버 주소, 포트, 시간, 핸드셰이크 매개변수를 확인한 뒤 코어 기능 차이인지 살펴보세요. 모든 오류를 소프트웨어 설치 문제로 돌리지 마세요.
v2rayN은 데스크톱용으로 구독 관리, 라우팅 설정, 멀티 코어 실행 등의 기능을 제공합니다. 데스크톱 버전은 크로스 플랫폼 UI를 사용하며, 클래식 WPF 버전은 별도의 데스크톱 UI와 사용 방식을 유지합니다. 시스템과 아키텍처를 먼저 확인하고 필요한 UI 기능에 따라 선택하세요. 이름이 같다고 두 배포판을 같은 폴더에 설치할 필요는 없습니다. 업그레이드하거나 이전하기 전에 구독 그룹, 라우팅, 사용자 지정 설정을 백업해 기존 설정을 덮어쓴 뒤 복구하지 못하는 일을 방지하세요.
v2rayNG는 Android 기기용으로 Xray 코어를 주요 연결 기능으로 사용하고 시스템 VPN 인터페이스를 통해 앱 트래픽을 받습니다. v2flyNG는 V2Fly 코어를 사용하는 대체 클라이언트입니다. 화면과 가져오기 방식은 비슷할 수 있지만 코어별 지원 범위는 각각 확인해야 합니다. 모바일 클라이언트를 선택할 때는 서버 설정과 코어 호환성을 먼저 확인한 다음 앱별 프록시, 백그라운드 실행, 배터리 설정을 살펴보세요. 클라이언트 이름만으로 연결이 보장되지는 않습니다.
세 클라이언트 모두 오픈 소스 프로젝트를 기반으로 합니다. 오픈 소스란 소스 코드와 관련 라이선스를 확인할 수 있다는 뜻이지, 임의로 수정한 배포 파일도 같은 출처라는 뜻은 아닙니다. 프로젝트 라이선스를 읽을 때는 클라이언트와 통합 코어를 구분해야 합니다. V2Ray 코어는 MIT 라이선스, Xray 코어는 MPL-2.0 라이선스를 사용하며 클라이언트 자체에도 각 프로젝트의 라이선스 조건이 적용됩니다. 수정하거나 재배포하려면 해당 조건을 각각 확인하세요.
프로그램 업데이트는 클라이언트나 코어의 실행 기능을 바꾸고, 구독 업데이트는 서버 매개변수를 새로고침하며, 규칙 리소스 업데이트는 도메인 및 주소 분류 매칭에 영향을 줍니다. 세 가지는 서로 다른 업데이트입니다. 구독 업데이트 실패는 클라이언트를 재설치해도 대개 해결되지 않습니다. 특정 라우팅 규칙이 적용되지 않는 것도 서버 문제라고 단정할 수 없습니다. 분류 리소스, 매칭 순서, 대상 도메인 식별이 원인일 수 있습니다. 먼저 어떤 항목의 업데이트인지 파악한 뒤 해당 메뉴를 선택하세요.
구독 자동 업데이트를 설정하기 전에 전체 과정을 수동으로 확인하세요. 링크에 접근할 수 있는지, 콘텐츠 형식을 인식하는지, 그룹 필터 조건이 맞는지 점검한 다음 출처의 실제 변경 주기에 맞춰 업데이트 간격을 정하세요. 프록시를 통해 업데이트할지는 현재 네트워크에서 해당 구독 주소에 접근할 수 있는지에 따라 결정해야 합니다. 연결 자체가 작동하지 않을 때 업데이트가 그 연결에 의존하게 하지 마세요. 인증서 오류가 난다고 계속 새로고침하지 말고 시스템 시간과 구체적인 오류 메시지를 먼저 확인하세요.
코어나 규칙 리소스를 변경한 뒤에는 고정된 테스트 대상을 준비하세요. 직접 연결이 예상되는 도메인 하나, 프록시가 예상되는 도메인 하나, 실제로 접근해야 하는 로컬 네트워크 리소스 하나를 정하고 로그에서 예상한 규칙이 적용되는지 확인하세요. 결과를 확인한 다음 DNS를 바꾸거나 TUN을 켜면 여러 변수가 서로 영향을 주는 일을 줄일 수 있습니다. 설정을 내보내거나 스크린샷을 공유할 때는 서버 식별 정보, 구독 인증 정보, 문제 해결과 무관한 개인정보를 삭제하세요.
시스템 프록시는 해당 설정을 읽는 앱에만 프록시 경로를 제공하며 모든 프로그램에 같은 경로를 강제하지 않습니다. 라우팅 규칙은 트래픽이 코어에 들어온 뒤 아웃바운드를 결정하므로 ‘전체 프록시’와 ‘모든 앱의 트래픽 처리’는 같은 뜻이 아닙니다. 브라우저는 정상인데 다른 프로그램에 문제가 있다면 규칙을 계속 바꾸기 전에 해당 프로그램이 시스템 프록시를 사용하는지, 로컬 프록시 주소를 별도로 입력해야 하는지 확인하세요. 그다음 TUN 적용을 고려하세요.
DNS 문제도 어느 단계에서 발생했는지 나누어 살펴봐야 합니다. 앱이 시스템 리졸버로 주소를 먼저 조회할 수도 있고, 코어가 라우팅 매칭 또는 연결 설정 과정에서 조회할 수도 있습니다. 로그에 주소가 표시된다고 원래 도메인이 유지된 것은 아닙니다. 트래픽 스니핑을 켜도 모든 연결에서 도메인을 복원할 수 있는 것은 아닙니다. 도메인별 라우팅이 필요하다면 인바운드, 조회 경로, sniffing 설정의 관계를 확인하세요. FakeDNS 설정은 트래픽 처리 범위와 함께 살펴봐야 하며 리졸버 주소 하나만 바꿔서는 안 됩니다.
오류 로그를 확인할 때는 먼저 작업 시간, 대상, 오류 유형을 기록하고 DNS 조회·연결·핸드셰이크·라우팅 중 어느 단계인지 찾으세요. 연결 시간 초과와 인증서 오류는 대응 방법이 다르며, 코어 시작 실패와 특정 대상에 접근할 수 없는 문제도 구분해야 합니다. 전체 설정 과정은 빠른 시작에서, 조합 설정은 고급 핸드북에서 확인하세요. 문제가 어느 단계에 속하는지 먼저 판단하려면 FAQ 분류에서 점검 순서를 확인한 뒤 해당 설정 페이지로 돌아오세요.
TECHNICAL NOTES
개별 문제를 검증 가능한 단계로 나눠 확인하세요. 읽기 전에 클라이언트 종류, 시스템 환경, 문제가 발생하는 조건을 기록하면 다른 플랫폼의 해결 방법을 그대로 적용하는 일을 피할 수 있습니다.
초보자가 자주 묻는 10가지 질문에 답합니다. 코어와 클라이언트의 차이, 클라이언트 3종 선택법, 구독 가져오기, 전체 프록시와 분기 라우팅의 차이, 연결되지 않을 때 먼저 확인할 항목을 다룹니다.
클라이언트는 설치했지만 시스템 프록시와 라우팅 모드를 구분하기 어려운 사용자에게 적합합니다. 설정을 누가 제공하고 트래픽을 누가 받는지 먼저 파악한 뒤 가져오기와 연결을 순서대로 확인하세요. 용어를 화면 설정과 연결해 이해하면 이후 문제 해결의 출발점이 명확해집니다.
초보자 질문 보기 →Android에서 v2rayNG의 배터리 소모가 커지는 흔한 원인을 분석하고 앱별 프록시, 로그 수준, 제조사 백그라운드 제한을 다룹니다. 배터리 최적화 예외와 VPN 상시 실행 설정도 안내합니다.
연결이 계속 작동하면서 발생하는 소모와 백그라운드에서 반복 재시작하며 생기는 소모를 먼저 구분하세요. 필요한 시스템 권한은 유지하고 프록시가 필요하지 않은 앱까지 트래픽 처리 대상으로 설정하지 않았는지 확인한 다음 로그에서 비정상적인 재연결 원인을 찾으세요. 백그라운드 실행을 유지하려고 시스템 배터리 관리를 전부 끄지는 마세요.
배터리 소모 문제 해결 방법 보기 →macOS에서 v2rayN을 처음 실행할 때 표시되는 ‘개발자를 확인할 수 없음’ 차단, 시스템 프록시 권한, TUN 모드에 필요한 권한, 로그인 항목 설정을 시스템 설정 경로에 따라 단계별로 설명합니다.
처음 실행할 때 표시되는 보안 경고와 실행 후 필요한 네트워크 권한을 구분해 처리하세요. 먼저 설치 출처를 확인한 뒤 시스템에 표시된 구체적인 옵션을 살펴보세요. TUN으로 트래픽을 처리해야 하는 경우에만 해당 권한을 부여하고, 컴퓨터 전체의 보안 설정을 완화하는 방법을 일반적인 설치 절차로 삼지 마세요.
설치 및 권한 안내 보기 →CLIENT DOWNLOADS
먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 해당 플랫폼의 설치 패키지를 선택하세요. 클라이언트는 로컬 설정 및 연결 인터페이스를 제공하지만 서버 매개변수나 구독은 별도로 준비해야 합니다. 설치를 마쳤다고 바로 연결할 수 있는 것은 아닙니다.
v2rayN · 데스크톱 버전 / 클래식 WPF 버전
데스크톱 버전은 크로스 플랫폼 UI를 사용하고, 클래식 WPF 버전은 익숙한 데스크톱 사용 방식을 유지합니다. 다운로드 전에 시스템 지원 조건을 확인하고 필요에 따라 둘 중 하나를 선택하세요. 두 버전의 프로그램과 설정 파일을 같은 위치에 섞어 두지 마세요. 이전하기 전에 구독 그룹과 사용자 지정 라우팅을 백업하세요.
처음 실행한 뒤 구독을 가져오고 서버 하나를 선택한 다음 ‘시스템 프록시 자동 설정’을 지정하세요. 브라우저 연결을 확인한 뒤 별도 프록시 설정이 필요한 앱을 점검하세요. 더 넓은 범위의 트래픽 처리가 꼭 필요한 경우에만 TUN을 켜세요. 로컬 네트워크 공유를 사용한다면 수신 주소, 방화벽, 접근 범위를 추가로 확인해야 합니다.
다운로드 페이지로 이동v2rayN · Apple Silicon / Intel
‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택합니다. 설치 패키지 아키텍처는 기기에 맞아야 합니다. 처음 실행할 때 안내가 표시되면 먼저 출처를 확인하고 시스템 설정에 표시된 구체적인 옵션에 따라 처리하세요. 다른 운영체제의 권한 설정 방법을 그대로 적용하지 마세요.
설치 후 시스템 프록시, 네트워크 권한, 로그인 항목을 각각 확인하세요. 창을 닫아도 클라이언트가 종료되지 않을 수 있으므로 실제 프로세스나 메뉴 막대 상태를 확인해야 합니다. 사용을 마칠 때는 시스템 프록시를 원래대로 되돌린 뒤 종료하세요. TUN 모드에서만 문제가 생긴다면 권한과 다른 네트워크 도구의 충돌을 먼저 확인하세요.
다운로드 페이지로 이동v2rayNG · Xray / v2flyNG · V2Fly
먼저 v2rayNG를 확인하고 V2Fly 코어가 필요할 때 v2flyNG를 살펴보세요. 최근 주류 기기는 보통 arm64를 선택합니다. 아키텍처를 확인할 수 없다면 범용 버전 안내를 확인하세요. 설치 전에 시스템 요구 사항을 확인하고, 가져온 설정의 프로토콜을 선택한 클라이언트와 코어가 지원하는지 점검하세요.
처음 연결할 때 시스템 VPN 권한을 요청합니다. 이 권한은 앱 트래픽을 받기 위한 것이며 서버 연결이 검증되었다는 뜻은 아닙니다. 연결 후 앱별 프록시 범위를 확인하고 필요한 앱을 테스트하세요. 화면이 잠긴 뒤 연결이 끊기면 배터리 최적화와 제조사 백그라운드 정책을 점검하세요. 필요한 권한만 유지하고 VPN 인터페이스를 두고 경쟁하는 도구를 여러 개 동시에 실행하지 마세요.
다운로드 페이지로 이동v2rayN · deb / rpm
배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택한 다음 x64와 arm64를 구분하세요. 설치 후 데스크톱 환경에서 GUI 클라이언트를 실행하고 일반 사용자 권한으로 구독 관리와 기본 연결을 먼저 확인하세요. 권한 확인을 피하려고 데스크톱 프로그램 전체를 장기간 높은 권한으로 실행하지 마세요.
데스크톱 환경마다 시스템 프록시를 읽는 방식이 다릅니다. 웹페이지는 열리는데 특정 프로그램이 연결되지 않는다면 해당 프로그램이 시스템 설정을 읽는지, 별도의 프록시 옵션이 있는지 먼저 확인하세요. TUN을 켜기 전에 가상 인터페이스 권한, 라우팅, 리졸버 설정을 점검하세요. 트래픽 처리를 중지한 뒤 네트워크 설정이 복원되었는지 확인해 다음 테스트에 이전 설정이 영향을 주지 않도록 하세요.
다운로드 페이지로 이동