클라이언트 설치 / 설정 파일 / 라우팅 규칙

V2Ray 설정 가이드

구독 가져오기부터 시작해 설정 파일과 라우팅을 살펴보세요.

  • JSON
  • Xray · V2Fly
  • 오픈 소스

CLIENT SETTINGS / 클라이언트 설정

V2Ray 사용법, 설정부터 시작하기

먼저 클라이언트 인터페이스와 프록시 코어의 역할을 구분한 뒤 항목별로 설정하세요. 클라이언트는 서버 정보를 저장하고 구독을 갱신해 실행 설정을 생성하며, 코어는 연결을 받고 라우팅 규칙을 적용해 트래픽을 전달합니다. 아래 다섯 가지 항목은 실제 사용 순서대로 정리했습니다. 화면 예시는 메뉴와 설정의 관계를 보여 주기 위한 것으로, 현재 기기의 실행 상태를 나타내지 않습니다.

v2rayN / 구독 그룹 설정 · 화면 예시
  • 서버
  • 구독 그룹
  • 설정
  • 라우팅 설정
그룹 이름일반 사용
구독 주소전체 URL 붙여넣기
구독 갱신직접 연결부터 시도

갱신이 끝나면 서버 목록에서 사용할 설정을 선택하세요.

구독 주소와 공유 링크

구독 주소는 여러 서버 설정을 가져오고 갱신할 때 사용하며, 공유 링크는 보통 하나의 설정만 담습니다. v2rayN에서는 구독 그룹 설정에 주소를 저장한 뒤 갱신하고, v2rayNG에서는 구독 그룹 메뉴에서 추가할 수 있습니다. 가져오기 전에 웹페이지 제목이나 로그인 페이지 주소가 아니라 전체 URL을 복사했는지 확인하세요. 처음 갱신할 때는 직접 연결을 우선 사용하세요. 구독 서비스에서 프록시 연결을 명시적으로 요구하는 경우에만 프록시를 통해 갱신해 보세요. 주소에 접근 자격 증명이 포함될 수 있으므로 공개 화면에 노출하지 않는 것이 좋습니다. 가져오기에 성공해도 사용할 설정을 직접 선택해야 합니다. 목록에 항목이 표시된다고 연결까지 완료된 것은 아닙니다.

설정 참고 보기 →

처음 설정할 때는 가장 단순한 연결 경로부터 확인하세요

사용 가능한 서버 설정이나 구독 주소를 준비하고, 가져온 뒤 설정 하나를 선택해 적절한 프록시 연결 방식을 켜세요. 먼저 브라우저에서 접속 가능한 것으로 확인된 대상에 연결하고, 클라이언트 로그에 해당 연결이 기록되는지 살펴보세요. 이 과정에서는 현재 설정과 현재 앱만 확인하면 됩니다. 복잡한 라우팅, 가상 인터페이스, 사용자 지정 DNS를 바로 켤 필요는 없습니다. 기본 연결 경로가 정상 작동한 다음 설정을 하나씩 추가하고, 변경할 때마다 되돌릴 수 있는 상태를 보관하세요.

테스트 결과는 종류별로 나눠서 봐야 합니다. 서버 항목이 표시되면 클라이언트가 형식을 받아들였다는 뜻입니다. 포트 테스트에 결과가 나오면 특정 단계의 연결이 가능할 수 있습니다. 실제 웹페이지에 접속돼야 도메인 조회, 전송 핸드셰이크, 앱 요청까지 확인할 수 있습니다. 테스트마다 측정 대상이 다릅니다. 결과가 서로 맞지 않을 때는 지연 시간 하나만 비교하기보다 테스트 방법과 로그를 기록하는 것이 도움이 됩니다.

설정 읽기: 트래픽 흐름을 따라 필드 확인하기

JSON을 이해하려면 인바운드, 라우팅, 아웃바운드 순서로 살펴보세요. 인바운드는 로컬 연결이 들어오는 지점을 설명하고, 라우팅은 처리 경로를 선택하며, 아웃바운드는 최종 전달 대상을 지정합니다. DNS는 관련 도메인을 조회하고, 정책 항목은 연결 관리 방식을 조정합니다. 가이드의 포트와 규칙은 문법을 보여 주는 예시일 뿐입니다. 실제 사용 시에는 클라이언트 설정을 기준으로 삼고, 모든 클라이언트가 같은 기본 포트를 사용한다고 가정하지 마세요.

그래픽 클라이언트는 시작할 때 설정 파일을 다시 생성할 수 있으므로 생성된 파일을 직접 수정해도 변경 내용이 계속 유지되지 않을 수 있습니다. 인터페이스에서 제공하는 사용자 지정 라우팅이나 설정 기능을 우선 사용하고, 수정 전에는 백업을 내보내세요. 필드 유형, 배열 구조, 태그 연결 관계를 확인하려면 V2Ray 설정 파일 참고 자료를 읽어 보세요. 인바운드, 아웃바운드, 전송 같은 용어가 익숙하지 않다면 용어집을 먼저 확인할 수 있습니다.

DOWNLOAD / 플랫폼 및 설치 파일

v2rayN 다운로드, 기기에 맞게 선택

데스크톱에서는 v2rayN을 선택하고, Android에서는 v2rayNG를 먼저 확인하세요. V2Fly 설정이 필요하다면 v2flyNG도 살펴볼 수 있습니다. 운영체제와 프로세서 아키텍처, 설치 파일 형식을 확인한 뒤 다운로드 페이지에서 파일을 선택하세요. 클라이언트 설치와 구독은 별개입니다. 클라이언트를 설치해도 서버 설정이 자동으로 제공되지 않으며, 구독을 가져와도 필요한 설치와 시스템 권한 설정을 대신할 수 없습니다.

Windows

v2rayN / Desktop · WPF

다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 이용할 수 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 데스크톱 사용 방식을 유지합니다. 시스템 환경과 사용 습관에 따라 선택하고, 같은 설정을 사용하려고 클라이언트 두 개를 동시에 실행할 필요는 없습니다. 설치 전에 이전 인스턴스를 종료해 로컬 수신 대기 포트가 이미 사용 중인 상황을 방지하세요.

처음 실행한 뒤 설정을 가져오고 로컬 서비스가 시작됐는지 확인한 다음 시스템 프록시를 설정하세요. 브라우저에서 자체 프록시 확장 프로그램이나 수동 설정을 계속 사용한다면 해당 연결 지점도 별도로 확인해야 합니다. 수신 대기 포트를 변경하면 그 포트에 의존하는 앱도 함께 수정하세요.

다운로드 Windows 클라이언트

macOS

v2rayN / Apple Silicon · Intel

먼저 시스템의 ‘이 Mac에 관하여’에서 칩 유형을 확인한 뒤 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 아키텍처 선택은 서버 프로토콜과 관계가 없으므로 구독 이름을 보고 판단해서는 안 됩니다. 설치 안내에 따라 앱을 배치하고 처음 실행할 때 시스템에 표시되는 권한 및 보안 안내를 확인하세요.

시스템 프록시와 TUN 모드는 필요한 권한 범위가 다르므로 일반 프록시로 먼저 연결을 확인하는 것이 좋습니다. 특정 앱만 접속되지 않는다면 전체 기기의 트래픽을 가로채기 전에 해당 앱이 시스템 프록시를 따르는지 확인하세요. 다운로드 페이지에서 아키텍처별 설치 파일과 설치 전에 확인할 사항을 살펴볼 수 있습니다.

다운로드 macOS 클라이언트

Android

v2rayNG / v2flyNG

v2rayNG는 Xray 코어를 사용하고, v2flyNG는 V2Fly 코어를 사용하므로 필요한 설정에 맞춰 대안으로 선택할 수 있습니다. 최신 기기라면 arm64 설치 파일부터 확인하고, 아키텍처를 모를 때는 범용 패키지를 살펴보세요. 설치 가능 여부는 운영체제와 앱 요구 사항에도 달려 있으므로 기기를 구입한 연도만으로 판단해서는 안 됩니다.

가져온 뒤 설정을 선택하고 연결을 시작하세요. 처음 실행할 때는 보통 시스템의 네트워크 연결 요청을 승인해야 합니다. 백그라운드 절전 제한으로 연결이 계속 유지되지 않을 수 있으므로 화면을 잠근 뒤 연결이 끊기면 앱의 백그라운드 권한을 확인하세요. 구독 주소와 QR 코드에 접근 자격 증명이 포함될 수 있으니 화면을 공유하기 전에 해당 내용을 가리세요.

다운로드 Android 클라이언트

Linux

v2rayN / deb · rpm

배포판의 패키지 관리 체계에 맞춰 deb 또는 rpm을 선택한 다음 기기의 아키텍처가 x64인지 arm64인지 확인하세요. 패키지 형식과 프로세서 아키텍처는 서로 별개의 조건입니다. 파일을 다운로드할 수 있다고 해서 현재 환경에 설치할 수 있는 것은 아닙니다. 데스크톱 환경과 관련 실행 종속성도 클라이언트 요구 사항을 충족해야 합니다.

데스크톱 환경마다 시스템 프록시 지원 방식이 다를 수 있고, 터미널 프로그램은 데스크톱 프록시 설정을 따르지 않을 수도 있습니다. 연결을 확인할 때는 브라우저와 명령줄에서 각각 어떤 프록시 연결 지점을 사용하는지 구분하세요. 먼저 그래픽 클라이언트와 로컬 수신 대기가 정상인지 확인한 뒤 가상 인터페이스 권한과 시스템 라우팅을 검토하세요.

다운로드 Linux 클라이언트

기기에 클라이언트가 이미 설치되어 있다면 업데이트 전에 구독 그룹, 사용자 지정 규칙, 필요한 앱 설정을 저장하세요. 설정 호환성을 확인하지 않은 채 유일하게 작동하는 환경을 덮어쓰지 마세요. 설치 파일은 프로그램 배포 문제를 해결합니다. 연결 문제는 설정, 프록시 연결 지점, 라우팅, 로그 순서로 단계별 점검해야 합니다.

클라이언트 전체 보기 →

PROJECT V / 코어 및 그래픽 클라이언트

V2Ray 오픈 소스 생태계, 프로젝트와 클라이언트 구분하기

V2Ray는 널리 검색되는 이름이자 Project V 생태계의 소프트웨어 및 설정 체계와 관련된 용어입니다. 일상적인 조작은 주로 그래픽 클라이언트에서 이루어지며, 실제 트래픽 전달은 사용 중인 코어가 담당합니다. 이 관계를 이해해야 가이드와 JSON 설정이 현재 설치된 클라이언트에 적용되는지 올바르게 판단할 수 있습니다.

생태계 배경

Project V

코어 계열

V2Fly / Xray

그래픽 클라이언트

v2rayN / v2rayNG / v2flyNG

Project V와 설정 구조

Project V는 모듈형 네트워크 프록시 기능을 기반으로 합니다. V2Ray 설정은 인바운드, 아웃바운드, 라우팅, DNS, 연결 정책 등의 항목으로 구성됩니다. 모듈형 구조에서는 하나의 로컬 연결 지점을 여러 아웃바운드와 조합할 수 있지만, 프로토콜 이름 하나만으로 연결 전체를 설명할 수는 없습니다. 설정을 읽을 때는 인증 정보, 전송 방식, 보안 계층을 함께 확인해야 하며 이름이 같은 항목이 있는지만 살펴봐서는 안 됩니다.

V2Fly 커뮤니티는 V2Ray 관련 구현과 유지 관리를 이어 가고 있으며, Xray는 관련 기술을 바탕으로 독자적으로 발전한 코어 프로젝트입니다. 두 프로젝트는 일부 개념과 설정 방식을 공유하지만 기능, 필드, 업데이트 주기가 완전히 같지는 않습니다. 한 코어에서 작동하는 설정을 다른 코어에 적용할 때도 지원 여부를 다시 확인해야 합니다. 특히 특정 전송 방식이나 보안 메커니즘에 관한 필드를 주의 깊게 살펴보세요.

그래픽 클라이언트와 오픈 소스

v2rayN, v2rayNG, v2flyNG는 모두 소스 코드가 공개된 그래픽 클라이언트 프로젝트입니다. 오픈 소스이므로 구현 방식, 변경 기록, 라이선스 조건을 공개적으로 검토할 수 있지만, 아무 설정이나 바로 가져와도 된다는 뜻은 아닙니다. 클라이언트는 설정을 관리하고 코어를 실행하며 로그를 보여 줍니다. 서버 매개변수가 유효한지, 구독 내용이 신뢰할 만한지는 출처를 확인해 판단해야 합니다.

데스크톱용 v2rayN은 구독, 시스템 프록시, 라우팅을 한곳에서 관리하기 편리합니다. Android용 v2rayNG와 v2flyNG는 모바일 운영체제의 연결 권한 및 백그라운드 실행에 맞춰 구성된 인터페이스를 제공합니다. 세 앱은 같은 프로그램의 이름만 다른 것이 아니므로 메뉴와 설정 항목이 하나씩 일치할 필요는 없습니다. 기기와 설정 요구 사항을 먼저 고려한 뒤 해당 클라이언트의 가이드를 확인하고, 데스크톱 메뉴를 모바일에 그대로 적용하지 마세요.

오픈 소스 라이선스와 구성 요소 구분

오픈 소스 라이선스는 코드의 사용, 수정, 배포 조건을 정하며 구독 서비스 이용 약관과는 다릅니다. 코어, 그래픽 클라이언트, 함께 제공되는 종속성은 서로 다른 라이선스를 적용할 수 있으므로 각 프로젝트에 포함된 안내를 확인해야 합니다. V2Ray 관련 핵심 구현의 MIT 라이선스와 Xray-core의 MPL 2.0은 각각 해당 코드의 이용 허가 조건을 뜻합니다. 이를 근거로 모든 구성 요소가 같은 라이선스를 사용한다고 추정해서는 안 됩니다.

사이트 이름과 프로젝트 정체성은 서로 다릅니다. 이 페이지는 Project V, V2Fly, Xray의 기술 관계를 소개하는 클라이언트 및 설정 안내 자료이며, 가이드 사이트와 코어 프로젝트를 같은 것으로 취급하지 않습니다. 특정 기능의 지원 여부는 검색 결과에 나온 제품 약칭만으로 판단하지 말고, 설치한 클라이언트의 인터페이스와 동봉 문서, 실제 실행 로그를 확인하세요.

업데이트 방식과 문제 진단

클라이언트, 코어, 구독, 라우팅 리소스 업데이트는 각각 다른 문제를 해결합니다. 클라이언트를 업데이트하면 인터페이스나 설정 생성 방식이 바뀔 수 있고, 구독을 갱신하면 서버 항목을 다시 가져옵니다. 라우팅 리소스를 업데이트하면 도메인이나 주소 목록의 매칭 결과가 달라질 수 있습니다. 구독을 갱신해도 클라이언트 프로그램이 교체되지는 않으며, 새 클라이언트를 설치해도 구독의 서버 매개변수가 자동으로 수정되지는 않습니다.

문제가 생기면 최근 변경 사항을 기록한 다음 로그를 확인하세요. 설정을 읽지 못한다면 필드, 형식, 코어 호환성을 먼저 살펴보고, 로컬 포트가 사용 중이라면 중복 실행 여부를 확인하세요. 핸드셰이크 실패 시에는 시간, 대상 주소, 보안 계층 매개변수를 점검해야 합니다. 로그를 공개하기 전에 구독 주소, 사용자 식별 정보, 인증 내용을 삭제하세요. 재설치, 코어 전환, 라우팅 재작성 등을 한꺼번에 하기보다 단계별로 점검해야 문제 원인을 추적하기 쉽습니다.

READING NOTES / 설정 주제별 가이드

V2Ray 기술 문서, 문제별로 살펴보기

기본 연결을 확인한 다음 구체적인 문제에 필요한 내용을 찾아보세요. 가져오기에 실패했다면 형식 설명부터 읽고, 설정을 고르려면 프로토콜 비교 자료를 확인하세요. 연결 문제가 생기면 실행 로그부터 살펴보는 것이 좋습니다. 각 주제별 문서는 하나의 문제를 다루므로 설정 참고 자료의 필드 설명과 함께 확인하기 편합니다.

클라이언트 다운로드