클라이언트 선택 · 설정 가이드

V2Ray 가이드다운로드 및 설정

v2rayN 클라이언트 다운로드 및 설정 안내입니다. 오픈 소스 클라이언트를 선택하고 구독을 가져온 다음 라우팅을 설정하는 순서로 진행하며, 각 설정의 역할을 알아보세요.

  • VMess
  • VLESS
  • Trojan
  • REALITY

V2Ray 설정 가이드 목차

먼저 클라이언트와 코어의 차이를 파악한 뒤 구독, 트래픽 유입 경로와 라우팅 규칙을 확인하세요. 현재 겪는 문제에 해당하는 항목부터 살펴보면 됩니다.

클라이언트 인터페이스와 프록시 코어

v2rayN 등의 클라이언트는 구독과 설정을 관리하고 실행을 제어하며, 실제 연결 처리는 선택한 코어가 담당합니다. V2Fly는 Project V의 기술 체계를 이어 가고, Xray는 관련 기반에서 독자적으로 발전했습니다. 클라이언트 이름만 볼 것이 아니라 서버에서 사용하는 프로토콜, 전송 방식, 보안 설정을 확인해 선택해야 합니다. REALITY나 XTLS Vision 설정을 사용할 때는 해당 코어의 지원 여부를 확인하세요. 코어를 교체하기 전에는 기존 설정을 백업하고, 정상 작동이 확인된 연결로 먼저 테스트하는 것이 좋습니다.

{
  "log": {
    "loglevel": "warning"
  },
  "outbounds": [
    { "tag": "direct", "protocol": "freedom" }
  ]
}
코어 계열 가이드 읽기

설정 예시는 해당 항목에서 사용하는 일부 구성으로 봐야 하며, 전체 설정 파일을 그대로 대체하는 용도가 아닙니다. 연결 설정에는 서버 주소, 인증 정보, 전송 매개변수도 포함되며 각 값이 서버 설정과 일치해야 합니다. 클라이언트가 자동 생성하는 내용은 선택한 코어에 따라 달라질 수 있습니다. 수정 전에 백업을 내보내고, 서로 다른 코어의 설정 항목을 한 파일에 섞지 마세요.

문제를 해결할 때는 순서를 정해 확인하세요. 먼저 코어가 시작되는지, 다음으로 로컬 앱이 수신 포트에 실제로 연결되는지, 마지막으로 요청이 어느 아웃바운드에 연결되는지 살펴봅니다. 한 번에 설정 하나만 바꾸고 결과를 기록하면 연결 자체가 안 된 것인지 규칙이 예상대로 적용되지 않은 것인지 구분하기 쉽습니다. 브라우저에서는 접속되지만 다른 프로그램에서는 안 된다면 구독을 바로 바꾸기보다 트래픽 유입 경로부터 확인하세요.

설정 전체 과정: 기본 개념, 클라이언트 설치, 구독 관리, 라우팅, 일상적인 유지 관리.

전체 설정 가이드 읽기

V2Ray 클라이언트 다운로드

데스크톱에서는 v2rayN, Android 기기에서는 v2rayNG를 먼저 살펴보세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 알맞은 설치 파일을 선택하면 됩니다.

설치 파일을 고를 때는 기기의 외관보다 프로세서 아키텍처를 확인하는 것이 중요합니다. 데스크톱에서는 시스템 정보에서 칩 종류를 확인하고, Android 기기에서는 arm64와 범용 패키지 중 알맞은 것을 선택하세요. 같은 클라이언트가 다른 기기에서 실행된다고 해서 설치 파일을 그대로 사용해도 되는 것은 아닙니다. 설치에 실패하면 다른 파일을 연달아 시도하기보다 패키지 형식과 아키텍처를 먼저 확인한 뒤 시스템 안내를 살펴보세요.

데스크톱 버전과 클래식 WPF 버전은 v2rayN의 서로 다른 인터페이스이며, 서버 프로토콜이 서로 독립적인 두 종류라는 뜻은 아닙니다. 기존 사용자가 인터페이스를 전환할 때는 구독 그룹, 활성 노드, 시스템 프록시 상태와 사용자 지정 규칙이 유지되는지 확인하세요. 처음 사용하는 경우 다운로드 페이지의 안내를 참고해 선택한 뒤 기본 연결부터 설정하고 라우팅과 네트워크 트래픽 가로채기 기능을 차례로 추가할 수 있습니다.

여러 기기에서 사용할 때 호환되는 구독은 함께 이용할 수 있지만, 기기별 로컬 설정을 전부 복사해서는 안 됩니다. 로컬 포트, 네트워크 권한, 가상 인터페이스, 시스템 프록시 방식은 실행 환경에 따라 달라집니다. Android 클라이언트가 네트워크 연결을 설정할 때는 관련 시스템 권한을 요청하며, 데스크톱에서 트래픽 가로채기를 활성화할 때도 관리자 권한이 필요할 수 있습니다. 권한 요청이 표시되면 어떤 기능을 켜려는 것인지 확인한 뒤 진행하세요.

Project V, V2Fly, Xray 생태계

각 프로젝트의 역할을 이해하면 클라이언트, 코어, 프로토콜을 같은 이름으로 뭉뚱그리는 것보다 선택과 문제 해결이 쉬워집니다.

기술 생태계Project V
프록시 코어, 전송, 라우팅 기능을 중심으로 형성된 프로젝트 생태계입니다.
연결 처리V2Fly / Xray
프로토콜을 처리하고 연결을 전달합니다. 지원 기능과 범위는 각각 확인해야 합니다.
그래픽 인터페이스v2rayN / v2rayNG / v2flyNG
사용자 설정, 구독 관리, 실행 제어를 담당합니다.

V2Ray에서 코어 계열까지

V2Ray는 Project V 생태계에서 널리 사용되는 이름입니다. 프로젝트가 발전하면서 V2Fly는 관련 코어의 유지 관리를 이어 갔고, Xray는 공통 기술 기반에서 독자적인 발전 경로를 만들어 왔습니다. 따라서 ‘V2Ray 클라이언트’는 보통 특정한 설정 도구 유형을 가리키며, 모두 같은 코어를 실행한다는 뜻은 아닙니다. 가이드를 읽을 때 클라이언트, 코어, 프로토콜 이름을 구분해 기록해야 특정 설정 항목이 적용되는지 정확히 판단할 수 있습니다.

VLESS, VMess, Trojan은 연결 프로토콜이고 REALITY는 연결 보안 방식과 관련된 기술입니다. 각 용어는 같은 계층에 속하지 않습니다. 서버 설정에는 프로토콜, 전송 방식, 보안 계층과 추가 매개변수가 함께 들어갈 수 있으며, 이 중 하나라도 누락되면 연결에 실패할 수 있습니다. 특정 프로토콜을 지원하는 클라이언트를 선택하는 것은 첫 단계일 뿐입니다. 실제로 사용하는 코어가 모든 매개변수를 처리할 수 있는지도 확인해야 합니다.

세 클라이언트의 용도와 차이

v2rayN은 데스크톱용으로, 구독을 한곳에서 관리하고 활성 설정을 전환하며 라우팅을 관리하는 데 적합합니다. v2rayNG는 Xray 코어를 사용하는 Android용 클라이언트이고, v2flyNG는 V2Fly 코어를 사용하는 Android 대안입니다. 세 클라이언트 모두 오픈 소스로 제공되지만 인터페이스 구성, 설정 항목 위치, 시스템 연동 방식은 서로 다릅니다. 가이드의 절차를 따라 할 때는 기기마다 버튼 이름이 완전히 같을 것으로 기대하기보다 같은 기능을 기준으로 찾아보세요.

코어가 여러 개라고 해서 모든 설정을 서로 바꿔 쓸 수 있는 것은 아닙니다. 한 코어에서 지원하는 확장 항목을 다른 코어는 인식하지 못할 수 있습니다. 같은 공유 링크를 여러 클라이언트에서 해석하더라도 전송 매개변수를 다시 확인해야 합니다. 이미 작동하는 연결이 있다면 참조용으로 유지하면서 새 설정을 테스트하세요. 이렇게 하면 호환성 문제와 로컬 네트워크 문제를 구분할 수 있고, 문제 해결에 사용할 수 있는 연결을 모두 잃는 상황을 피할 수 있습니다.

오픈 소스 라이선스와 사용 책임

오픈 소스는 해당 라이선스에 따라 소스 코드를 공개해 사용자가 허용된 범위에서 구현을 살펴보고 사용하거나 연구할 수 있다는 뜻입니다. 모든 구성 요소가 같은 라이선스를 적용받거나 구독 제공자와 클라이언트 프로젝트가 같은 주체라는 의미는 아닙니다. 예를 들어 Xray-core는 MPL-2.0, v2rayN은 GPL-3.0을 따릅니다. 코드를 재배포하거나 수정해 공개할 때는 ‘무료’라는 이유만으로 사용 범위를 판단하지 말고 각 프로젝트와 종속성의 라이선스 조건을 확인하세요.

클라이언트, 코어, 연결 서비스의 역할은 서로 다릅니다. 클라이언트는 로컬 설정을 실행하며, 연결 성공 여부는 서버 매개변수, 계정 상태, 네트워크 환경에도 영향을 받습니다. 클라이언트를 무료로 설치해도 구독이나 원격 서비스가 자동으로 제공되는 것은 아닙니다. 처음 설치하기 전에 사용할 권한이 있는 연결 정보를 준비하세요. 가져오는 과정에서 구독 주소, 인증 정보, 전체 설정 화면을 다른 사람에게 공개하지 않으면 계정 정보 유출 위험을 줄일 수 있습니다.

업데이트와 설정 관리

클라이언트 업데이트, 코어 업데이트, 구독 업데이트, 규칙 데이터 업데이트는 각각 별개의 작업입니다. 구독을 업데이트하면 연결 목록은 새로고침되지만 호환되지 않는 코어 설정이 자동으로 수정되지는 않습니다. 규칙 데이터를 업데이트하면 도메인 및 주소 목록에 영향을 주지만 클라이언트 프로그램이 교체되는 것은 아닙니다. 문제가 생기면 먼저 어느 계층이 바뀌었는지 확인하고 필요한 항목만 업데이트하세요. 여러 구성 요소를 한꺼번에 바꾸면 원인을 추적하기 어려워집니다.

일상적인 관리를 위해 작동하는 설정을 백업하고 선택한 코어, 프록시 모드, 사용자 지정 규칙을 간단히 기록해 두세요. 업그레이드한 뒤에는 기본 연결부터 테스트하고 로컬 네트워크 접속, 직결 대상, 프록시 대상이 예상대로 처리되는지 확인합니다. 로그는 설정이 정상적으로 로드됐는지 확인하는 데 도움이 되지만, 공유하기 전에는 구독 주소와 인증 정보를 삭제하세요. 복잡한 규칙을 장기간 관리해야 한다면 전체 설정 가이드를 참고해 각 규칙의 목적과 적용 조건도 함께 기록하세요.

세 클라이언트 비교 및 선택 가이드 보기 →

처음 설정할 때 자주 묻는 질문

먼저 기본 연결이 반복해서 정상 작동하는지 확인한 다음 규칙과 트래픽 가로채기 기능을 추가하세요. 아래 질문을 참고하면 다음에 확인할 항목을 찾을 수 있습니다.

클라이언트를 설치했는데 왜 구독이나 연결 설정이 필요한가요?

클라이언트는 로컬 설정과 실행 화면을 제공할 뿐, 원격 연결 정보는 포함하지 않습니다. 사용할 권한이 있는 구독 주소나 공유 링크를 준비해 가져온 뒤 활성 노드를 선택하고 연결을 시작해야 합니다. 가져온 뒤 목록이 비어 있다면 네트워크 기능을 모두 켜기 전에 반환된 내용과 형식부터 확인하세요. 구독 가져오기 단계 보기 →

노드를 선택했는데 브라우저가 프록시를 사용하지 않는 이유는 무엇인가요?

노드를 선택하면 연결 설정이 정해지지만, 트래픽이 클라이언트로 들어오는지는 시스템 프록시나 앱 자체의 프록시 설정에 따라 달라집니다. 먼저 코어가 실행 중인지 확인한 뒤 브라우저의 주소와 포트가 클라이언트의 수신 설정과 일치하는지 살펴보세요. 브라우저에 별도의 프록시 관리 확장 프로그램이 설치되어 있다면 시스템 설정을 덮어쓰는지도 확인해야 합니다. 프록시 모드 설정 단계 보기 →

처음부터 TUN을 켜도 되나요?

먼저 일반 프록시로 노드가 작동하는지 확인한 다음 앱의 필요에 따라 TUN을 사용할지 결정하는 것이 좋습니다. 이렇게 하면 서버 연결 문제와 로컬 권한 또는 인터페이스 라우팅 문제를 구분할 수 있습니다. 대상 앱에서 프록시를 직접 설정할 수 있다면 로컬 프록시 주소를 지정해 확인하는 편이 쉽습니다. 다른 트래픽까지 처리해야 할 때는 운영체제별 가이드에 따라 네트워크 인터페이스와 DNS를 점검하세요. 기본 연결 절차 보기 →

연결 속도가 느리면 노드와 DNS 중 무엇부터 바꿔야 하나요?

먼저 지연이 발생하는 단계를 확인하세요. 도메인 해석, 연결 수립, 데이터 전송 중 어느 부분이 느린지 살펴봅니다. 같은 대상에 직결과 프록시를 각각 시도하고, 설정은 그대로 둔 채 다른 작동 가능한 노드와 비교하면 DNS, 전송 방식, 라우팅을 한꺼번에 바꾸는 것보다 원인을 파악하기 쉽습니다. DNS 문제로 보이는 증상이 있을 때만 DNS 설정을 확인하고, 변경 사항을 기록한 뒤 다시 테스트하세요. 연결 확인 단계 보기 →

다른 사람에게 문제를 설명해야 한다면 클라이언트와 코어 이름, 문제가 발생한 앱, 그리고 가져오기·시작·접속 중 어느 단계에서 문제가 생겼는지 먼저 정리하세요. 민감한 정보를 지운 짧은 오류 메시지를 함께 제공하면 ‘작동하지 않는다’는 설명만 하는 것보다 원인을 찾기 쉽습니다. 설정을 되돌릴 때도 변경 전 단계로 차례로 돌아가세요. 최근 수정한 규칙을 먼저 취소하고, 프록시 유입 설정을 복구한 뒤 시스템 네트워크 연결을 확인하면 별개의 문제를 혼동하지 않을 수 있습니다.

설정 및 문제 해결 가이드

코어 차이, 연결 속도, 시작 로그를 중심으로 살펴봅니다. 기본 설정을 완료했다면 클라이언트를 다시 설치할 필요 없이 증상에 맞는 글을 확인하세요.