읽기 시작 / CONFIG
클라이언트는 설정을 관리하고 코어는 연결을 실행합니다. 시스템 프록시는 트래픽 진입점을, 라우팅 규칙은 목적지를 정합니다.
V2Ray 공식 다운로드는 이 흐름에 맞춰 다운로드와 가이드를 구성했습니다. 먼저 기기에 맞는 클라이언트를 선택하고, 서비스 제공자가 안내한 구독이나 서버 설정을 가져온 뒤, 앱 트래픽이 실제로 프록시를 통과하는지 확인하세요. 프로그램을 설치해도 연결에 필요한 매개변수가 자동으로 생기지는 않습니다. 화면에 실행 중이라고 표시되어도 모든 앱이 프록시를 사용하는 것은 아닙니다.
위 편집기에는 Xray 설정 구조의 일부가 표시되어 있습니다. 아웃바운드 프로토콜, 전송 보안, 라우팅 규칙을 구분하기 위한 예시입니다. 예시의 도메인과 식별자는 필드 설명용이며 REALITY에 필요한 다른 매개변수는 생략했습니다. 그래픽 클라이언트를 사용할 때는 보통 인터페이스가 코어 설정을 생성하므로 이 내용을 설정 파일에 복사할 필요가 없습니다.
자주 쓰는 설정 메뉴 6곳을 ‘설정 출처 → 트래픽 진입점 → 매칭 규칙 → 연결 진단’ 순서로 살펴봅니다. 화면 구성에 따라 메뉴 이름은 조금 다를 수 있습니다. 설정 필드는 개념을 비교하기 위한 것으로, 모든 코어가 동일한 형식을 사용하는 것은 아닙니다.
구독 그룹 → 구독 그룹 설정
구독 주소는 원격 설정 목록에 접근하는 주소이지, 개별 노드 주소가 아닙니다. 그룹을 추가하고 구독 링크를 입력한 다음 저장 후 업데이트하세요. 목록에서 사용할 서버를 선택하면 됩니다. 그룹을 이용하면 설정 출처를 구분하고 각각 업데이트 주기를 지정할 수 있습니다. 공유 링크를 하나씩 붙여 넣는 방식과 달리 구독은 서버 목록의 추가·삭제 사항을 동기화할 수 있지만, 구독 항목을 직접 수정한 내용은 업데이트 과정에서 덮어쓰일 수 있습니다. 업데이트에 실패하면 먼저 링크가 유효한지 확인하고, 직결 업데이트와 프록시를 통한 업데이트 결과를 비교하세요. 아직 사용할 수 없는 노드에 의존하지 않도록 주의해야 합니다.
메인 화면 또는 트레이 메뉴 → 시스템 프록시
시스템 프록시를 설정하면 클라이언트가 로컬 수신 주소를 운영체제의 프록시 설정에 기록합니다. 브라우저처럼 해당 설정을 읽는 앱은 요청을 로컬 진입점으로 전달합니다. 이는 코어 라우팅의 전역 프록시와 다른 설정이며 모든 프로그램에 자동으로 적용되지는 않습니다. 처음 연결할 때는 시스템 프록시로 브라우저부터 테스트하세요. 클라이언트를 종료하기 전 시스템 프록시를 해제할 수 있습니다. 프로그램을 닫았는데도 브라우저가 로컬 포트를 가리켜 일반 웹페이지까지 열리지 않는다면 시스템 네트워크 설정을 먼저 복구하세요.
메인 화면 → TUN 모드 활성화
TUN은 가상 네트워크 인터페이스를 통해 IP 트래픽을 처리하므로 시스템 프록시를 읽지 않는 앱에 적합합니다. 데스크톱에서는 관련 권한이 필요한 경우가 많으며, 실제 트래픽 처리 범위는 라우팅, 제외 항목, DNS 설정에 따라 달라집니다. 시스템 프록시를 빠르게 만드는 기능도 아니고 모든 연결이 원격으로 전달된다고 보장하지도 않습니다. 활성화하기 전에 일반 프록시가 작동하는지 확인하고 로그와 로컬 네트워크 접속 상태를 살펴보세요. 다른 가상 네트워크 어댑터, 기업용 네트워크 도구, 기존 VPN과 충돌한다면 한 번에 하나씩 비활성화해 비교하세요. 네트워크 진입점을 여러 개 동시에 바꾸면 문제 원인을 찾기 어렵습니다.
설정 → 라우팅 설정 → 사전 정의 규칙 세트
라우팅 규칙은 도메인, IP, 포트 조건을 프록시나 직결 같은 아웃바운드에 연결합니다. 대부분의 규칙은 순서대로 적용되므로 구체적인 예외를 포괄적인 규칙보다 앞에 배치해야 합니다. GeoSite는 도메인 목록을, GeoIP는 IP 목록을 제공합니다. 두 데이터는 용도가 다릅니다. 사전 정의 규칙 세트를 선택한 뒤에는 모드 이름만 볼 것이 아니라 로컬 네트워크, 내부 도메인, 대상 사이트가 실제로 어디로 연결되는지 확인하세요. 모든 트래픽을 하나의 아웃바운드에 맡기는 대신 라우팅을 나누면 로컬 서비스에 직접 접속할 수 있습니다. 규칙 파일이 없거나 태그 이름이 잘못된 경우에는 먼저 데이터베이스 참조를 바로잡아야 합니다.
설정 → DNS 설정
DNS는 도메인을 IP 주소로 변환하지만, DNS 요청이 통과하는 네트워크 경로와 웹 연결 경로는 다를 수 있습니다. 브라우저의 보안 DNS, 운영체제 캐시, 코어 DNS가 같은 접속에 함께 관여하기도 합니다. 도메인으로는 접속되지 않지만 IP로는 연결된다면 먼저 어떤 구성 요소가 DNS를 조회하는지 확인하고 상위 DNS 서버에 연결할 수 있는지 살펴보세요. 라우팅의 도메인 조회 전략도 IP 규칙이 매칭되는 방식에 영향을 줍니다. DNS 주소만 바꾼 뒤 문제가 해결됐다고 판단하지 말고, 같은 도메인으로 다시 테스트하면서 캐시 결과와 새 조회 결과를 구분하세요.
메인 화면 → 로그; 설정 → 매개변수 설정 → 로그 수준
로그를 보면 코어 시작, 도메인 조회, 서버 연결, 프로토콜 핸드셰이크 단계를 구분할 수 있습니다. 먼저 접속 실패 시각을 기록한 뒤 해당 시각 전후의 오류를 찾으면 로그 전체에서 ‘실패’를 검색하는 것보다 원인을 파악하기 쉽습니다. 연결 거부, 연결 시간 초과, 인증서 이름 불일치는 서로 다른 문제이므로 해결 방법도 다릅니다. 진단할 때 로그 상세 수준을 잠시 높였다가 확인 후 평소 수준으로 되돌리세요. 로그를 공유하기 전에 구독 주소, 식별 정보, 비공개 서버 정보를 삭제해야 합니다. 로그는 문제 해결의 단서일 뿐이므로 브라우저 접속 결과와 현재 선택된 서버 상태도 함께 확인하세요.
처음 사용할 때는 기본 라우팅과 DNS를 유지하고 구독을 가져온 뒤 사용할 서버를 선택하세요. 실제 연결 테스트로 해당 서버를 통해 요청이 처리되는지 확인한 다음 시스템 프록시를 설정하고, 브라우저에서 접속 가능한 페이지를 열어 보세요. 이 최소 연결 경로가 확인된 뒤에 TUN을 켜거나 사용자 지정 라우팅 규칙을 추가하고 DNS 조회 전략을 조정하세요. 검증되지 않은 설정을 한꺼번에 적용하면 서버 문제인지 로컬 네트워크 문제인지 판단하기 어렵습니다.
‘전역 프록시’는 사용되는 위치에 따라 의미가 다릅니다. 시스템 설정의 전역 프록시는 보통 앱이 로컬 프록시로 트래픽을 보내는 방식을 가리킵니다. 클라이언트 라우팅의 전역 모드는 코어에 들어온 트래픽이 아웃바운드를 선택하는 방식을 뜻합니다. 프로그램이 트래픽을 클라이언트에 전달하지 않는다면 라우팅을 전역으로 설정해도 해당 프로그램은 처리되지 않습니다. 반대로 앱이 TUN으로 들어와도 직결 규칙에 매칭될 수 있습니다. 프록시 적용 여부를 판단할 때는 상태 아이콘 하나만 보지 말고 진입점과 아웃바운드 양쪽을 확인하세요.
특정 사이트나 앱에서만 문제가 발생한다면 클라이언트를 바로 다시 설치할 필요는 없습니다. 같은 서버로 다른 페이지에 접속해 본 뒤 다른 서버 설정으로 바꿔 비교하세요. 이어서 해당 도메인의 규칙 매칭과 DNS 결과를 확인하면 됩니다. 한 번에 조건 하나만 바꾸고 변경 전후의 로그를 보관하면 ‘전혀 연결되지 않는 문제’와 ‘일부 규칙의 문제’를 구분할 수 있습니다. 자세한 절차는 문제 해결 가이드를, 필드 설명은 용어집을 참고하세요.
데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 먼저 살펴보세요. 기존 V2Fly 설정이 있다면 v2flyNG와 비교할 수 있습니다. 아래 링크에서 플랫폼별 다운로드 옵션을 확인하세요. 설치 파일의 아키텍처, 시스템 요구 사항, 파일 설명은 다운로드 페이지에 정리되어 있습니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 창과 메뉴 구성을 유지합니다. 두 버전 모두 설정을 관리하고 코어를 실행하는 데 사용됩니다. 사용 방식과 시스템 요구 사항을 기준으로 선택하면 되며, 같은 구독을 위해 두 클라이언트를 동시에 실행할 필요는 없습니다.
설치 전에 시스템의 ‘정보’에서 프로세서 아키텍처를 확인하세요. 처음 실행한 뒤 로컬 수신 포트와 시스템 프록시 상태를 살펴보세요. 다른 프록시 프로그램이 있다면 포트 충돌이나 시스템 설정 덮어쓰기를 피하도록 먼저 종료한 뒤 테스트하세요. TUN이 필요하다면 권한과 가상 네트워크 어댑터를 별도로 설정하세요.
다운로드v2rayN의 macOS 설치 파일은 Apple Silicon과 Intel용으로 나뉩니다. ‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 해당 아키텍처에 맞는 파일을 선택하세요. 설정 출처는 다른 데스크톱 플랫폼과 같지만 시스템 네트워크 설정, 실행 권한, 메뉴 위치는 현재 macOS 화면을 기준으로 확인해야 합니다.
구독을 가져온 뒤 사용할 서버를 확인하고 현재 네트워크 서비스의 프록시 설정을 살펴보세요. 브라우저는 연결되는데 터미널 명령은 직결된다면 두 환경이 서로 다른 프록시 진입점을 사용하고 있을 가능성이 큽니다. 이를 곧바로 서버 문제로 판단하지 마세요. 무선 네트워크를 바꾼 뒤에는 네트워크 환경이 달라졌는지도 다시 확인해야 합니다.
다운로드v2rayNG는 Xray 코어를 사용하며 Android에서 우선적으로 살펴볼 수 있습니다. v2flyNG는 V2Fly 코어를 사용하므로 해당 설정이 있는 경우에 적합합니다. 대부분의 최신 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 확인하기 어렵다면 범용 패키지 안내를 참고하세요. 프로토콜 지원 여부는 클라이언트와 코어에 따라 달라지므로 공유 링크의 이름만으로 판단할 수 없습니다.
처음 연결할 때 시스템 VPN 권한을 확인해야 합니다. 화면을 잠근 뒤 연결이 끊기면 서버를 점검하기 전에 배터리 최적화, 백그라운드 실행, 네트워크 전환 동작을 확인하세요. 앱별 라우팅 설정에 따라 실제 트래픽 처리 범위도 달라집니다. 테스트할 때 브라우저가 제외 목록에 들어 있지 않은지 확인하고 다른 VPN 서비스는 동시에 실행하지 마세요.
다운로드v2rayN은 deb 및 rpm 설치 옵션과 x64, arm64 아키텍처를 제공합니다. 배포판의 패키지 형식과 프로세서 종류를 확인한 뒤 파일을 선택하세요. 그래픽 클라이언트는 데스크톱 세션에서 사용할 수 있습니다. 앱이 시스템 프록시를 읽을 수 있는지는 데스크톱 환경과 앱 자체의 구현에 따라 달라집니다.
데스크톱 브라우저, 명령줄 도구, 백그라운드 서비스는 서로 다른 프록시 설정을 사용할 수 있습니다. 브라우저 테스트가 성공해도 모든 프로세스의 트래픽이 처리된다고 볼 수는 없습니다. TUN을 활성화할 때는 권한, 시스템 라우팅, 다른 가상 네트워크 인터페이스를 확인하세요. 로컬 네트워크 접속에 문제가 생기면 서버를 반복해서 바꾸기보다 제외 대역을 먼저 살펴보세요.
다운로드클라이언트는 로컬 설정 관리, 프로토콜 처리, 트래픽 전달 기능을 제공하지만 원격 서버를 자동으로 만들어 주지는 않습니다. 연결에 필요한 주소, 포트, 인증 정보, 전송 설정은 서비스 제공자가 안내해야 합니다. 구독 링크에는 접속 정보가 포함될 수 있으므로 비공개 설정으로 안전하게 보관하세요. 공개 스크린샷이나 제3자 온라인 변환 사이트에 붙여 넣지 마세요. 기기를 바꿀 때는 내보내는 항목이 개별 서버 설정인지, 구독 주소인지, 클라이언트 전체 설정인지 먼저 확인해야 합니다.
기존 설정이 있다면 클라이언트를 업그레이드하거나 플랫폼을 옮기기 전에 현재 선택된 서버, 라우팅 모드, 로컬 포트를 기록해 두세요. 복원 가능한 설정 사본이 있으면 새 환경의 차이를 파악하는 데 도움이 됩니다. 프로토콜 필드를 인식하지 못한다면 코어 지원 범위와 설정 형식을 비교하세요. Project V 생태계에 속한다고 해서 모든 클라이언트가 서로의 전체 설정 파일을 바로 읽을 수 있는 것은 아닙니다.
오픈 소스 생태계는 역할을 나눠 이해해야 합니다. 프로젝트, 실행 코어, 그래픽 클라이언트, 원격 서비스는 각각 담당 기능이 다릅니다. 명칭을 혼동하면 설치와 설정을 잘못 판단하기 쉽습니다.
설정 인터페이스 → 코어 실행 → 원격 서비스
Project V는 V2Ray 관련 도구를 이해하는 데 필요한 배경입니다. V2Fly는 V2Ray의 커뮤니티 개발 흐름을 이어가며, Xray는 관련 기술을 바탕으로 독립적인 코어 개발 방향을 발전시켜 왔습니다. v2rayN, v2rayNG, v2flyNG는 사용자를 위한 그래픽 클라이언트로, 구독과 서버 매개변수, 모드 선택을 코어가 실행할 수 있는 설정으로 변환합니다. 서버에서 사용하는 프로토콜은 클라이언트의 코어가 지원하는 기능과 맞아야 합니다.
코어는 인바운드 트래픽을 받아 라우팅 규칙을 적용하고, 아웃바운드 설정에 따라 연결을 구성합니다. V2Fly와 Xray는 일부 역사적 배경과 설정 개념을 공유하지만 기능과 설정을 각각 발전시키므로 설정 파일을 자유롭게 바꿔 쓸 수는 없습니다. 특히 VLESS, REALITY, Vision을 조합할 때는 클라이언트 이름만 확인하지 말고 실제 실행 중인 코어를 먼저 확인하세요.
프로토콜, 전송, 보안 계층은 서로 같은 뜻이 아닙니다. VLESS는 프록시 프로토콜이고, REALITY는 전송 보안 방식이며, Vision은 특정 조건에서 사용하는 흐름 제어 방식입니다. 매개변수를 입력할 때는 서버에서 제공한 조합을 클라이언트 설정에 맞춰 적용하세요. VLESS만 선택하고 보안 계층이나 흐름 제어 설정을 빠뜨리면 핸드셰이크 단계에서 실패할 수 있습니다. 포트만 바꿔서는 이런 불일치를 해결할 수 없습니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 클라이언트이며, 주요 클라이언트 코드는 GPL 계열 라이선스를 따릅니다. V2Fly와 Xray 코어는 주로 MPL 2.0 라이선스를 사용합니다. 클라이언트 인터페이스, 코어, 함께 제공되는 구성 요소에는 각각 해당 라이선스가 적용됩니다. 무료 사용, 소스 코드 열람, 재배포 권한은 서로 다른 개념입니다. 수정, 배포, 통합 시에는 해당 프로젝트의 라이선스 전문을 확인하세요.
기기와 설정을 기준으로 선택하세요. 데스크톱에서는 v2rayN으로 서버, 구독, 라우팅을 관리합니다. Android에서는 v2rayNG가 Xray 생태계에, v2flyNG가 V2Fly 계열에 대응합니다. 여기서 ‘우선’과 ‘대안’은 이 사이트에서 안내하는 사용 순서를 뜻합니다. 다른 클라이언트의 개발이 중단됐다는 의미도, 특정 코어가 모든 네트워크 환경에서 더 빠르다는 의미도 아닙니다.
클라이언트 업그레이드, 구독 새로고침, Geo 데이터베이스 업데이트는 서로 다른 관리 작업입니다. 클라이언트 업그레이드는 인터페이스나 포함 구성 요소를 바꾸고, 구독 새로고침은 서비스 제공자에게서 서버 목록을 다시 가져옵니다. Geo 데이터베이스 업데이트는 도메인 및 IP 목록을 변경합니다. 구독을 새로고침했다고 라우팅 파일까지 업데이트된 것은 아니며, 규칙 파일을 업데이트해도 만료된 구독 주소가 복구되지는 않습니다.
업데이트 전후를 비교할 수 있도록 같은 서버, 같은 라우팅 모드, 같은 테스트 도메인 등 조건을 유지하세요. 변경 후 문제가 생기면 시작 로그와 실제 설정을 먼저 확인한 뒤 설정을 되돌릴지 결정하세요. 자동 새로고침 주기를 지나치게 짧게 설정하지 마세요. 설정 출처의 요구에 맞춰 주기를 정해야 합니다. 요청이 너무 잦으면 서버 측 제한에 걸려 오히려 정상적인 업데이트가 어려워질 수 있습니다.
이 사이트는 클라이언트 다운로드 경로와 한국어 사용 안내를 정리합니다. 브랜드명은 사이트를 식별하기 위한 것이며, 이 사이트가 Project V, V2Fly, Xray 또는 각 클라이언트 개발 프로젝트를 운영한다는 뜻은 아닙니다. 소프트웨어 기능과 라이선스는 해당 프로젝트가 정하며, 구독 서비스와 서버 가용성은 서비스 제공자가 결정합니다. 가이드는 로컬 설정과 네트워크 흐름을 설명하며 서버 측 매개변수 안내를 대신하지 않습니다.
설정 예시를 볼 때는 설명용 필드와 실제 연결 정보를 구분해야 합니다. 도메인, 식별자, 보안 매개변수는 서버 설정과 일치해야 하며 필드 이름만 보고 추측해서는 안 됩니다. 설정을 가져온 뒤 오류가 발생하면 형식 인식 실패, 코어 시작 실패, 원격 연결 실패 중 어느 문제인지 먼저 파악한 다음 해당 절차에 따라 점검하세요. 프로젝트 이름과 프로토콜 계층에 대한 자세한 설명은 용어집을, 증상별 문제 해결은 문제 해결 가이드를 참고하세요.
최근 글 세 편에서는 실제 설정 문제를 순서대로 다룹니다. 먼저 구독 요청 성공 여부를 확인하고, 다음으로 규칙 데이터베이스를 점검한 뒤, 선택한 서버와 시스템 프록시를 확인합니다. 문제별 설정 절차와 개념 설명을 나누어 현재 필요한 내용을 쉽게 찾을 수 있습니다.
링크 만료, 네트워크 연결 실패, 프록시 루프, 응답 형식 오류의 네 가지 원인으로 구독 업데이트 실패를 살펴보고 구독 그룹에서 자동 업데이트 간격을 설정하는 방법을 안내합니다.
‘노드는 그대로인데 새로고침이 실패하는’ 경우에 적합합니다. 먼저 유효한 설정 내용이 응답으로 도착했는지 확인한 다음 업데이트 방식과 주기를 살펴보세요. 원격 서버가 반환한 오류 페이지를 구독 설정으로 가져오지 않도록 주의하세요.
구독 문제 해결 방법 보기 →라우팅에서 GeoIP와 GeoSite 데이터베이스가 하는 역할을 설명하고, 클라이언트에서 규칙 파일을 업데이트하는 방법과 geosite:cn, geoip:private 같은 태그를 규칙에 사용하는 방법을 안내합니다.
‘클라이언트는 연결되지만 일부 트래픽이 예상과 다르게 라우팅되는’ 경우에 적합합니다. 태그 유형과 데이터베이스가 있는지 확인한 뒤 규칙 순서를 살펴보세요. 도메인 목록과 IP 목록은 이름이 비슷하다는 이유만으로 서로 바꿔 쓸 수 없습니다.
규칙 파일 설명 보기 →구독을 가져온 다음 실제 연결 테스트로 사용할 서버를 선택하고, 시스템 프록시 모드를 전환한 뒤 브라우저와 명령줄에서 트래픽이 프록시를 통과하는지 확인하세요.
서버 목록은 보이지만 다음에 무엇을 해야 할지 모르는 경우에 적합합니다. 테스트 결과는 당시의 연결 상태만 보여 주며 실제 앱에서의 동작을 보장하지 않습니다. 서버를 선택한 뒤에도 트래픽 진입점이 올바르게 설정됐는지 확인해야 합니다.
첫 연결 절차 보기 →