클라이언트 다운로드 · 구독 및 라우팅 설정

V2Ray 설정 가이드v2rayN 다운로드와 고급 설정

먼저 구독 가져오기를 한 뒤 라우팅과 DNS를 차례로 설정하세요.

VMessVLESSTrojanShadowsocks

v2rayN 주요 설정

먼저 구독 출처, 트래픽 유입 경로와 아웃바운드 규칙을 구분한 다음 DNS 해석 방식을 조정하세요. 아래는 설정 항목을 이해하기 위한 예시이며, 실제 명칭과 사용 가능한 옵션은 클라이언트와 코어에 따라 다릅니다.

구독 그룹 설정

별칭일상용
자동 업데이트 간격사용 패턴에 맞게 설정
구독 업데이트현재 그룹

구독 그룹을 사용하면 출처가 다른 서버 설정을 따로 관리할 수 있어 일상용 연결과 예비 설정을 함께 보관하기 좋습니다. 구독 그룹 설정에서 알아보기 쉬운 별칭과 유효한 구독 주소를 입력한 뒤 현재 그룹만 업데이트하세요. 서버를 필터링해야 한다면 새로고침 후 목록이 비어 보이지 않도록 먼저 필터 조건을 확인하세요. 개별 링크를 반복해서 붙여 넣는 것보다 그룹을 사용하면 출처를 추적하고 업데이트 오류를 찾기 쉽습니다. 다만 구독 내용은 제공업체가 관리하므로 클라이언트의 그룹 설정이 원격 서비스 상태를 바꾸거나 누락된 프로토콜 매개변수를 자동으로 채워 주지는 않습니다.

구독 그룹 안내 보기 →

설정은 연결 과정을 세 단계로 나누어 이해하면 쉽습니다. 앱이 시스템 프록시나 TUN을 통해 요청을 전달하면 코어가 규칙에 따라 직접 연결 또는 프록시 아웃바운드를 선택하고, DNS는 도메인 조회가 필요한 단계에 결과를 제공합니다. 세 설정은 서로 연관되어 있지만 서로를 대신하지는 않습니다. 브라우저에서 사이트가 열린다고 해서 모든 앱이 같은 경로를 사용하는 것은 아니며, 프록시 아웃바운드를 켜도 모든 도메인 조회가 같은 경로를 따르는 것은 아닙니다.

먼저 정상 작동하는 기본 설정을 저장한 뒤 라우팅, 원격 DNS, 가상 네트워크 어댑터를 추가하는 것이 좋습니다. 한 번에 한 항목만 변경하고 전후 증상을 기록하세요. 문제가 생기면 여러 옵션을 동시에 켜기보다 기본 설정으로 되돌려 재현한 다음 로그를 확인하세요. 클라이언트별 인터페이스와 코어, 사용 환경을 비교하려면 먼저 클라이언트 비교를 읽고 설정을 옮길지 결정하세요.

플랫폼별 V2Ray 클라이언트 선택

데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 우선 확인하세요. V2Fly 코어가 필요하다면 v2flyNG를 고려할 수 있습니다. 설치 파일의 CPU 아키텍처와 시스템 형식, 인터페이스 유형은 다운로드 페이지에서 안내합니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 클래식 창 조작 방식을 유지합니다. 시스템과 CPU가 호환되는지 먼저 확인한 뒤 인터페이스 선호도를 고려하세요. 처음 실행한 후 구독을 가져와 서버가 작동하는지 확인하고, 기존 설정 디렉터리를 바로 덮어쓰지 마세요.

다운로드 페이지로 이동

macOS

v2rayN 설치 파일은 Apple Silicon과 Intel 칩에 맞춰 각각 제공됩니다. 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 알맞은 아키텍처를 선택하세요. 설치 후 앱이 정상 실행되는지 먼저 확인하고 시스템 프록시를 설정하세요. 다른 네트워크 도구가 프록시나 라우팅을 제어하고 있다면 겹치는 기능을 중지한 후 테스트하세요.

다운로드 페이지로 이동

Android

v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 대부분의 기기에서는 arm64를 선택하면 됩니다. CPU 아키텍처를 확인하기 어렵다면 범용 패키지 안내를 참고하세요. 처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 백그라운드 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요.

다운로드 페이지로 이동

Linux

v2rayN은 배포판의 패키지 관리 방식에 따라 deb와 rpm 패키지를 제공하며 CPU 아키텍처도 구분합니다. 먼저 배포판 종류와 하드웨어 아키텍처를 확인한 뒤 시스템 소프트웨어 설치 도구로 의존성을 처리하세요. 그래픽 데스크톱의 시스템 프록시를 앱에서 사용하는지는 앱 자체에 따라 다릅니다. 더 넓은 범위의 트래픽을 처리해야 한다면 TUN 사용을 검토하세요.

다운로드 페이지로 이동

클라이언트 다운로드와 프록시 서비스 설정은 별개의 단계입니다. 클라이언트를 설치하면 관리 및 연결 도구가 준비될 뿐, 실제 사용에는 유효한 서버 매개변수나 구독 주소가 필요합니다. 구독에는 인증 정보가 포함되는 경우가 많으므로 공개 게시판에 붙여 넣거나 출처가 불분명한 온라인 변환 사이트에 입력하지 마세요. 다른 클라이언트로 가져오지 못한다면 먼저 원본 형식과 코어 지원 여부를 확인하고, 변환이 꼭 필요한지 판단하세요.

플랫폼을 바꾸기 전에 구독 그룹 이름, 라우팅 정책, DNS 설정을 기록해 두세요. 실행 디렉터리 전체를 그대로 복사하는 방식은 피하는 것이 좋습니다. 운영체제마다 설정 경로와 권한 체계, 네트워크 연결 방식이 다르므로 항목별로 옮기면 문제가 발생한 계층을 찾기 쉽습니다. 기존 연결이 작동한다면 새 환경 검증을 마칠 때까지 기존 클라이언트와 설정을 유지하세요.

전체 클라이언트 보기 →

빠른 시작: 구독·모드·연결 확인

먼저 재현 가능한 기본 연결을 만든 뒤 라우팅과 DNS를 설정하세요. 다음 세 단계는 작업 순서를 이해하기 위한 안내이며, 실제 메뉴와 권한 안내는 전체 사용법을 참고하세요.

전체 사용법 보기 →
STEP 01여기서 시작

구독을 가져와 그룹 업데이트

구독 그룹 설정에서 새 출처를 추가하고 별칭과 전체 구독 주소를 입력한 뒤 저장하고 현재 그룹을 업데이트하세요. 가져오기에 성공했다는 것은 주소가 저장됐다는 뜻일 뿐입니다. 그룹에 식별 가능한 서버 설정이 표시되는지 확인해야 합니다. 목록이 비어 있다면 필터 조건, 구독 유효 기간, 업데이트 로그를 먼저 살펴보세요.

개별 공유 링크와 구독 주소는 서로 다른 입력 형식입니다. 개별 링크를 가져오면 보통 설정 하나만 추가되며, 이후 매개변수가 바뀌어도 구독 새로고침으로 자동 반영되지 않습니다. 구독 주소를 서버 주소 입력란에 넣지 마세요. 형식 오류가 발생하면 원본 출처에서 링크 유형을 확인하세요.

STEP 02유입 경로와 아웃바운드

서버 및 프록시 모드 선택

설정 하나를 활성 서버로 지정해 연결을 시작하고 필요에 따라 시스템 프록시를 사용하세요. 데스크톱에서는 시스템 프록시를 따르는 브라우저로 먼저 테스트하고, Android에서는 VPN 권한이 허용됐는지 확인하세요. 유입 경로 설정은 요청을 클라이언트로 전달하고, 라우팅 정책은 전달된 요청의 아웃바운드를 결정합니다.

‘전역 프록시’는 시스템 프록시 경로를 뜻할 수도 있고, 라우팅의 모든 트래픽 프록시 정책을 뜻할 수도 있습니다. 사용법을 읽을 때는 어떤 메뉴를 가리키는지 확인하세요. 처음에는 기본 라우팅을 유지하고 TUN, FakeDNS, 사용자 지정 아웃바운드를 동시에 바꾸지 마세요. 문제가 생겼을 때 원인을 찾기 어려워집니다.

STEP 03확인 및 기록

접속 결과와 실행 로그 확인

프록시가 필요한 사이트, 직접 연결할 사이트, LAN 리소스를 각각 테스트해 예상대로 동작하는지 확인하세요. 시간 초과, 핸드셰이크 실패, DNS 오류가 발생하면 해당 시간대의 로그를 기록하세요. 구독을 가져올 수 있다고 서버 연결까지 성공한 것은 아니며, 웹페이지 한 번이 열린다고 모든 라우팅 규칙이 검증된 것도 아닙니다.

기본 연결이 정상인지 확인한 다음 DNS와 라우팅을 하나씩 조정하세요. 테스트가 끝나면 클라이언트를 종료한 뒤 네트워크가 정상 복구되는지도 확인해야 합니다. 특정 앱에서만 문제가 발생하면 해당 앱이 시스템 프록시를 사용하는지 먼저 확인한 뒤 앱 내부 프록시를 설정할지 다른 트래픽 유입 방식을 사용할지 결정하세요.

Project V, V2Fly 및 Xray

클라이언트 이름, 코어 계열, 프록시 프로토콜은 서로 다른 계층에 속합니다. 각 요소가 담당하는 설정 범위를 이해하면 이름 하나만 외우는 것보다 설정 이전과 문제 해결에 도움이 됩니다.

Project V 생태계와 그래픽 클라이언트

Project V는 네트워크 프록시 도구와 관련 기능을 중심으로 형성된 오픈 소스 생태계이며, V2Ray는 널리 사용되는 프로젝트 중 하나입니다. 일반적으로 사용하는 그래픽 클라이언트는 이런 코어 기능을 바탕으로 구독 관리, 서버 선택, 매개변수 설정 인터페이스를 제공합니다. 인터페이스에 저장되는 것은 설정이며, 실제 연결과 라우팅, DNS 처리는 실행 중인 코어가 담당합니다. 따라서 클라이언트 화면에 프로토콜 이름이 표시된다고 해서 현재 코어가 모든 전송 조합을 지원하는 것은 아닙니다.

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 클라이언트 프로젝트지만 같은 프로그램의 스킨만 다른 것은 아닙니다. 데스크톱과 Android는 권한, 네트워크 연결, 백그라운드 실행 방식이 서로 다르므로 설정 항목도 완전히 일치하지 않습니다. 설정 안내를 확인할 때는 클라이언트 이름과 사용 중인 코어, 해당 기능을 함께 확인하세요. 한 클라이언트의 설정 파일을 다른 클라이언트에 그대로 가져오지 않도록 주의해야 합니다.

V2Fly와 Xray의 지원 범위

V2Fly 커뮤니티는 V2Ray 관련 구현을 계속 유지보수하고 있으며, Xray는 V2Ray에서 파생된 별도의 코어 프로젝트입니다. 두 코어는 일부 프로토콜과 설정 개념을 공유하지만 각자 발전한 기능과 설정 항목도 있습니다. 이름이 비슷하다는 이유로 완전히 호환된다고 가정하지 말고 서버 요구 사항에 따라 프로토콜, 전송 방식, 보안 계층, 도메인 매개변수와 기타 옵션을 현재 코어가 지원하는지 확인하세요.

데스크톱용 v2rayN은 여러 코어 관련 설정을 제공합니다. Android용 v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용하므로 기존 설정에 맞춰 선택할 수 있습니다. 특정 프로토콜 확장 기능이 필요하다면 클라이언트를 고르기 전에 코어 지원 여부를 확인하세요. 기본 구독과 일상적인 연결만 필요한 경우에는 구독과 호환되는 기본 조합을 사용하는 편이 코어를 자주 바꾸는 것보다 관리하기 쉽습니다.

오픈 소스 라이선스와 구독 정보 보호

오픈 소스란 프로젝트 코드가 해당 라이선스에 따라 공개된다는 의미이며, 사용·수정·배포 시 각 프로젝트의 라이선스 조건을 따라야 합니다. V2Fly의 V2Ray와 Xray-core는 MPL-2.0을 사용합니다. 클라이언트 프로젝트도 각각 라이선스가 있으므로 코어 라이선스가 모든 인터페이스 프로그램과 포함된 구성 요소에 동일하게 적용된다고 볼 수는 없습니다. 재배포하거나 수정하려면 실제 사용하는 프로젝트와 타사 구성 요소의 라이선스를 각각 확인하세요.

코드가 공개되어 있는지와 원격 서비스가 신뢰할 만한지는 별개의 문제입니다. 클라이언트 자체는 구독 제공업체가 계정, 연결, 서비스 기록을 어떻게 처리하는지 결정하지 않으며, 사용 가능한 서버를 보장하지도 않습니다. 구독 링크는 계정 인증 정보처럼 안전하게 보관하세요. 화면을 공유하거나 설정을 내보내고 로그를 제출하기 전에 인증 항목, 구독 주소, 계정을 식별할 수 있는 정보를 제거하세요. 사이트의 설정 예시는 설정 간 관계를 설명하기 위한 것으로 실제 연결 가능한 서버 정보는 포함하지 않습니다.

업데이트 순서와 설정 관리

클라이언트 업데이트, 코어 업데이트, 규칙 데이터 업데이트, 구독 새로고침은 각각 다른 문제를 해결합니다. 클라이언트 업데이트는 인터페이스와 설정 생성 로직에 영향을 주고, 코어 업데이트는 프로토콜 지원이나 동작을 바꿀 수 있습니다. 규칙 데이터 업데이트는 분류 및 일치 결과에 영향을 주며, 구독 새로고침은 원격 서버 매개변수를 동기화합니다. 한 항목을 업데이트했다고 나머지도 완료된 것은 아닙니다. 문제를 찾을 때는 최근에 실제로 무엇이 바뀌었는지 확인하세요.

업데이트 전에는 현재 정상 작동하는 설정과 사용자 지정 규칙을 기록하세요. 업데이트 후에는 코어가 시작되는지 먼저 확인하고 기존 연결과 주요 서비스를 테스트하세요. 새 규칙을 추가한 뒤에만 문제가 생겼다면 해당 규칙부터 되돌리고, 코어가 시작되지 않는다면 오류 로그에 언급된 항목과 파일 경로를 확인하세요. 모든 문제를 구독 탓으로 돌리지 마세요. 구독·라우팅·DNS·사용자 지정 아웃바운드를 체계적으로 기록하려면 고급 설정 가이드를 참고하세요. 구체적인 사용법이 궁금하다면 분류별 자주 묻는 질문을 확인할 수 있습니다.

최신 설정 가이드

하나의 설정 항목을 중심으로 적합한 사용 환경을 살펴보고 변경 절차와 확인 방법을 안내합니다. 문서의 설정 방법은 실제 클라이언트 인터페이스, 코어 지원 여부, 네트워크 환경에 맞춰 적용하세요.

전체 글 보기 →