• 오픈 소스 클라이언트
  • Xray · V2Fly
  • 한국어 설정 가이드

V2Ray 설정 가이드

구독 가져오기부터 시작해 시스템 프록시와 라우팅 분할의 차이를 확인하세요. 데스크톱에서는 v2rayN을, Android에서는 필요한 코어에 맞는 클라이언트를 사용하면 됩니다.

기능별 클라이언트 설정

먼저 설정을 가져온 뒤 어떤 앱을 연결하고 어떤 연결을 직접 연결할지 정하세요. 한 번에 한 단계씩 변경하면 결과를 확인하기 쉽습니다.

SUBSCRIPTION

구독 그룹 설정

구독 주소는 설정을 한꺼번에 가져올 때 사용하는 주소이며, 브라우저 프록시 주소가 아닙니다. v2rayN의 구독 그룹 설정에서 새 그룹을 만들고 알아보기 쉬운 별칭을 입력한 뒤, 전체 링크를 주소란에 붙여 넣으세요. 저장 후 현재 구독을 업데이트하면 됩니다. 항목을 하나씩 직접 입력하는 것보다 그룹 업데이트를 이용하면 서버 측 변경 사항을 반영하기 편하지만, 직접 수정한 내용은 다음 업데이트에서 덮어써질 수 있습니다. v2rayNG에서도 메뉴의 구독 그룹 설정에서 같은 작업을 할 수 있습니다. 업데이트 후에도 목록이 비어 있다면 링크에 공백이 들어갔는지, 만료되지는 않았는지 먼저 확인하고 로그에서 요청 오류를 살펴보세요. 설정을 전부 삭제하는 일을 반복하지 마세요.

구독 가져오기 단계 보기 →
구독 그룹 설정
별칭: 일반 설정 / 업데이트 사용: 켜짐

V2Ray 클라이언트 다운로드

먼저 운영체제를 확인하고 프로세서 아키텍처를 살펴보세요. 데스크톱에서는 v2rayN을, Android에서는 Xray 또는 V2Fly 설정 요구사항에 맞춰 클라이언트를 선택하면 됩니다. 설치 패키지 종류와 시스템 요구사항은 다운로드 센터에서 확인할 수 있습니다.

Windows

v2rayN으로 구독 그룹, 시스템 프록시, 라우팅 규칙을 관리할 수 있습니다. 다운로드 페이지에는 데스크톱 버전과 클래식 WPF 버전이 있습니다. 데스크톱 버전은 새로운 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 데스크톱 인터페이스를 유지합니다. 튜토리얼의 메뉴 위치는 다소 다를 수 있지만 설정 목적은 같습니다.

설치 전에 운영체제와 아키텍처 요구사항을 확인하세요. 처음 실행하면 설정을 가져오고 브라우저 접속을 확인한 뒤 TUN을 켤지 결정하세요. 실행 권한 부족과 구독 주소 만료는 서로 다른 문제입니다. 기존 설정이 있는 컴퓨터라면 클라이언트 버전을 바꾸기 전에 먼저 설정을 내보내 백업하세요.

다운로드

macOS

v2rayN을 선택하기 전에 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon과 Intel은 아키텍처가 다른 설치 파일을 사용하므로 컴퓨터 외관이나 구매 연도만으로 판단하면 안 됩니다. 다운로드 센터에서 두 종류의 파일을 구분해 제공하며, 설치 후에는 시스템의 네트워크 및 실행 권한 설정을 확인하세요.

같은 서비스 제공업체의 호환 구독 주소는 계속 사용할 수 있지만, 데스크톱 설정 파일을 다른 플랫폼에 그대로 덮어쓰는 것은 권장하지 않습니다. 브라우저와 다른 앱의 동작이 다르면 해당 앱이 시스템 프록시를 읽는지 먼저 확인하세요. 연결 범위를 넓혀야 한다면 전체 가이드에서 TUN 지원과 권한 조건을 확인하세요.

다운로드

Android

먼저 v2rayNG를 사용하고, V2Fly 설정이 필요할 때 v2flyNG를 고려하세요. 두 앱 모두 arm64와 범용 버전을 제공합니다. 아키텍처를 모른다면 기기 정보를 확인하세요. 범용 버전은 여러 아키텍처를 지원해야 할 때 사용할 수 있습니다. 클라이언트 이름이 비슷해도 프로토콜 확장 지원까지 같은 것은 아닙니다.

처음 연결할 때 시스템에서 VPN 권한을 요청합니다. 방금 설치한 클라이언트의 요청인지 확인한 뒤 승인하세요. 연결 후에는 앱별 라우팅과 백그라운드 배터리 제한을 살펴보세요. 화면을 잠근 뒤 연결이 자주 끊긴다면 구독을 모두 다시 만들기보다 시스템의 백그라운드 실행 정책부터 확인하세요. QR 코드를 가져오기 전에도 출처를 확인해야 합니다.

다운로드

Linux

v2rayN은 여러 배포판용 패키지를 제공합니다. 먼저 deb와 rpm을 구분하고, 다음으로 x64와 arm64를 확인하세요. 패키지 형식은 배포판에 따라 결정되고 프로세서 아키텍처는 기기에 따라 달라집니다. 두 조건이 모두 맞아야 설치에 적합합니다. 그래픽 인터페이스가 정상적으로 실행된 뒤 프록시 연결과 데스크톱 환경의 시스템 프록시를 설정하세요.

데스크톱 환경, 브라우저, 터미널 프로그램마다 프록시를 사용하는 방식이 다를 수 있습니다. 브라우저에서 연결된다고 모든 앱도 연결된 것은 아닙니다. 문제를 확인할 때는 먼저 기준이 될 앱 하나를 정하고 프록시가 어디에서 설정되는지 파악하세요. 가상 네트워크 어댑터를 사용하는 경우에는 권한과 기존 네트워크 서비스의 관계도 따로 확인해야 합니다.

다운로드

구독에서 연결까지, 3단계 설정

먼저 연결 경로를 하나씩 검증한 뒤 라우팅 분할과 트래픽 처리 범위를 넓히세요. 아래에서는 데스크톱 v2rayN을 기준으로 설명합니다. Android v2rayNG도 가져오기 절차는 비슷하지만 연결 권한을 승인하는 방식은 다릅니다.

  1. 그룹 추가 후 구독 업데이트

    클라이언트를 설치하고 실행한 뒤 구독 그룹 설정에서 새 항목을 추가하세요. 별칭은 설정 출처를 구분하는 데 사용합니다. 주소란에 서비스 제공업체의 전체 구독 링크를 입력하고 저장한 뒤 업데이트를 실행하세요. 설정 항목이 표시되면 하나를 선택해 활성 서버로 지정합니다. 링크를 클립보드에 복사하는 것만으로는 가져오기가 완료되지 않습니다.

    단일 공유 링크를 받았다면 클립보드에서 가져오기에 해당하는 기능을 사용하세요. 구독 주소로 취급할 필요는 없습니다. QR 코드도 단일 설정만 담고 있을 수 있습니다. 구독은 다시 가져와 업데이트할 수 있지만, 단일 설정은 보통 다시 공유받아야 합니다. 구독 주소에는 접근 권한이 포함되어 있으므로 스크린샷을 찍기 전에 전체 주소를 가리고, 정체를 알 수 없는 온라인 변환 페이지에 입력하지 마세요.

  2. 설정 선택 후 연결 방식 켜기

    데스크톱에서는 먼저 활성 설정을 선택하고 시스템 프록시 자동 설정을 켠 다음 이해하기 쉬운 라우팅 프리셋을 사용하세요. Android에서는 설정을 선택한 뒤 연결을 시작하고 시스템 VPN 권한 요청을 확인해 승인합니다. 버튼 상태가 바뀌는 것은 클라이언트가 시작을 시도했다는 뜻일 뿐입니다. 로그에서 설정 구문 분석, 포트 사용 중, 권한 관련 오류가 있는지 확인하세요.

    시스템 프록시와 라우팅 모드는 서로 다른 설정 단계입니다. ‘시스템 프록시 자동 설정’이 모든 연결을 프록시로 보낸다는 뜻은 아닙니다. 전자는 앱이 연결되는 방식을, 후자는 연결 이후 트래픽이 나갈 경로를 정합니다. 컴퓨터에 다른 프록시 도구나 네트워크 가속 프로그램이 있다면 먼저 하나를 일시 중지하고 확인하세요. 여러 프로그램이 같은 시스템 설정을 반복해서 바꾸는 상황을 피할 수 있습니다.

  3. 접속을 확인한 뒤 규칙 추가

    시스템 프록시를 따르는 브라우저 하나로 접속이 확인된 사이트를 열고, 직접 연결해야 하는 로컬 네트워크 서비스도 정상인지 확인하세요. 오류가 생기면 발생 시각, 연결 방식, 로그 메시지를 기록하고 구독 업데이트 실패, 연결 수립 실패, 도메인 이름 조회 실패를 구분하세요. 각각 확인해야 할 위치가 다릅니다.

    기본 연결을 확인한 다음 라우팅, 앱별 분할, TUN을 조정하세요. 한 번에 하나만 바꾸고 바로 다시 확인하며, 복구 가능한 설정을 남겨 두세요. 데스크톱 사용을 마치기 전에는 시스템 프록시가 해제됐는지 확인하세요. 장기간 사용한다면 구독 업데이트, 백그라운드 권한, 로그 상태를 주기적으로 살펴보세요. 이렇게 기록을 쌓으면 클라이언트를 계속 바꾸는 것보다 문제를 찾기 쉽습니다.

전체 설정 가이드 보기

Project V, 코어, 클라이언트

각 이름의 역할을 구분하세요. 생태계는 기술적 배경을 제공하고, 코어는 연결을 처리하며, 그래픽 클라이언트는 일상적인 설정을 관리합니다. 이름만 보고 기능을 추측하지 말고 호환 조건을 확인하세요.

PROJECT / BACKGROUND

Project V는 생태계의 배경이며 단일 설치 프로그램이 아닙니다

V2Ray는 Project V 생태계에서 시작해 프록시 프로토콜, 전송 방식, 라우팅 기능과 함께 발전해 왔습니다. 일상적인 검색에서 ‘V2Ray 클라이언트’는 관련 기술을 사용하는 그래픽 앱을 두루 가리키는 경우가 많으며, 특정 데스크톱 창 하나를 뜻하지는 않습니다. 이 차이를 이해하면 다운로드 페이지의 클라이언트 이름, 설정 파일의 프로토콜 이름, 로그에 표시되는 코어 이름을 구분할 수 있습니다.

V2Fly는 V2Ray 관련 프로젝트의 커뮤니티 개발을 이어가고, Xray는 같은 계통에서 발전한 별도의 코어입니다. 기술적 배경의 일부를 공유하지만 기능, 매개변수, 확장 지원이 항상 일치하는 것은 아닙니다. 같은 구독이 클라이언트마다 다르게 표시되더라도 가져오기 형식, 코어 기능, 클라이언트의 설정 생성 방식 차이일 수 있으며 주소 자체가 만료된 것은 아닐 수 있습니다.

이 사이트는 다운로드와 사용 가이드를 구분합니다. 다운로드 센터에서는 플랫폼과 설치 파일을 선택하고, 튜토리얼에서는 화면 조작을 안내하며, 전체 가이드에서는 개념과 문제 해결 방법을 설명합니다. 이 사이트는 설정 정보를 제공할 뿐 프록시 서비스나 구독 계정을 제공하지 않습니다. 연결을 확인하려면 클라이언트를 설치한 뒤 사용 권한이 있고 클라이언트와 호환되는 설정을 준비해야 합니다.

CORE / COMPATIBILITY

V2Ray 코어 차이, 프로토콜 지원부터 확인

코어는 프로토콜 처리, 연결 수립, DNS 및 라우팅 실행을 맡고, 그래픽 인터페이스는 입력한 내용을 코어 설정으로 변환합니다. 호환성을 판단할 때는 프로토콜, 전송 방식, 보안 설정을 함께 확인해야 합니다. ‘VLESS 지원’만 보고 관련 조합을 모두 사용할 수 있다고 단정하지 마세요. 설정 항목이 없다면 현재 클라이언트와 선택한 코어에서 해당 기능을 지원하는지 먼저 확인하세요.

v2rayN의 멀티 코어 관리 기능은 데스크톱에서 다양한 설정을 지원하는 데 유용하지만, 코어를 바꾼다고 모든 매개변수가 자동으로 변환되는 것은 아닙니다. Android에서 v2rayNG와 v2flyNG를 선택할 때도 서비스 제공업체의 설정 요구사항을 기준으로 삼으세요. 안정적으로 연결되고 있다면 이름이 다르다는 이유만으로 옮길 필요는 없습니다. 특정 기능이 필요할 때 목적을 정해 테스트하고 기존에 작동하던 방법을 남겨 두세요.

시작 오류가 발생하면 실패 시각에 가장 가까운 로그 메시지를 먼저 읽고 지원되지 않는 필드, 설정 구문 분석 실패, 원격 연결 실패를 구분하세요. 앞의 두 경우는 로컬 호환성 문제일 가능성이 크고, 마지막 경우에는 네트워크 경로나 서비스 상태도 원인일 수 있습니다. 오류 유형을 파악한 뒤 코어를 바꿔야 변경이 실제로 효과가 있었는지 판단하기 쉽습니다.

코어와 생태계 설명 보기 →
PROTOCOL / TRANSPORT / SECURITY

프로토콜, 전송 방식, REALITY를 구분해 이해하기

VMess, VLESS, Trojan은 설정에 자주 등장하는 프로토콜 이름이며 전송 방식과 보안 계층에는 각각 별도의 매개변수가 있습니다. REALITY는 관련 보안 메커니즘으로, 서버 주소, 포트, 사용자 식별 정보를 대신할 수 없습니다. 가져온 뒤 화면에 설정 이름이 표시되는데도 연결에 실패한다면 이름을 바꾸기보다 전송 및 보안 매개변수가 제대로 인식됐는지 확인하세요.

구독 변환은 형식을 맞추는 작업이며 코어에 없는 기능을 새로 추가하지는 않습니다. 변환 과정에서 일부 확장 필드가 빠질 수 있으므로 출처가 분명하고 현재 클라이언트에 직접 맞는 구독을 우선 사용하세요. 꼭 변환해야 한다면 도구가 정보를 처리하는 방식과 민감한 데이터가 어디로 전송되는지 확인하세요. 접근 권한이 포함된 전체 링크를 잘 모르는 제3자 페이지에 입력하지 마세요.

처음 설정할 때는 클라이언트가 바로 인식할 수 있는 공유 링크나 QR 코드를 사용해 직접 입력으로 인한 누락을 줄이세요. 수동으로 수정해야 한다면 설정 제공업체의 안내와 항목을 하나씩 대조하세요. 특히 도메인, 보안 계층, 전송 경로가 어떤 설정에 속하는지 주의해야 합니다. 클라이언트의 옵션은 많을수록 좋은 것이 아니라 서버 매개변수와 일치해야 의미가 있습니다.

프로토콜 및 매개변수 설명 보기 →
MAINTENANCE / RECOVERY

업데이트, 백업, TUN 유지 관리 순서

오픈 소스는 프로젝트 라이선스가 정한 조건에 따라 코드를 확인하고 사용하거나 수정할 수 있다는 뜻입니다. 파생 빌드마다 기능이 동일하다는 의미는 아닙니다. 세 클라이언트 모두 오픈 소스 생태계에 속하지만 무료 사용, 배포, 수정에 관해 이야기할 때는 클라이언트, 코어, 관련 구성요소의 라이선스를 각각 구분해야 합니다. 프록시 서비스의 사용 조건은 서비스 제공업체와 별도로 확인하세요.

업데이트 전에 현재 플랫폼, 클라이언트 종류, 코어 선택을 기록하고 필요한 설정을 내보내세요. 구독 업데이트는 서버 설정을 동기화하고, 클라이언트 업데이트는 인터페이스와 기능을 변경하며, 규칙 데이터 업데이트는 별도의 유지 관리 작업입니다. 이 세 가지를 하나의 작업으로 혼동하지 마세요. 구독 동기화는 로컬 백업을 대신하지 않습니다. 라우팅, 사용자 지정 DNS, 인터페이스 설정은 구독에 포함되지 않을 수 있습니다.

TUN은 시스템 네트워크 경로 구성에 관여하므로 기본 연결을 확인한 뒤 사용해야 합니다. 활성화 전에 끄는 방법, 기존 시스템 프록시를 복구하는 방법, 다른 가상 네트워크 어댑터가 있는지 확인하세요. 문제가 발생하면 먼저 TUN을 종료하고 일반 프록시를 확인하세요. 일반 프록시가 작동한다면 클라이언트를 다시 설치하지 않고 연결 처리, 라우팅, DNS로 점검 범위를 좁힐 수 있습니다.

TUN 및 일상 유지 관리 알아보기 →

사용 팁과 문제 해결 노트

기본 연결을 넘어 로컬 네트워크 공유, DNS 조회 경로, 여러 기기 동기화 방법을 살펴봅니다. 각 글은 하나의 설정 문제를 다루며 적용 조건을 확인한 뒤 설정을 변경합니다.