클라이언트 및 코어 참고 자료

V2Ray Zen 가이드클라이언트와 프로토콜 선택

운영체제에 맞는 오픈소스 클라이언트를 선택하고 구독 가져오기부터 설정한 뒤, 프로토콜 안내서에서 코어와 전송 방식의 호환 조건을 확인하세요.

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

프로토콜 계보도: V2Fly와 Xray는 모두 VMess, VLESS, Trojan, Shadowsocks를 구현합니다. 그림에 표시된 두 코어 중 REALITY를 구현한 것은 Xray뿐입니다.

01 설정 안내

클라이언트 설정 핵심

코어는 연결을 처리하고, 구독은 항목을 정리하며, 라우팅은 트래픽이 나갈 경로를 선택합니다. 접속 방식은 어떤 앱의 트래픽이 클라이언트로 들어올지를 결정합니다.

클라이언트는 가져오기, 그룹 관리, 실행 상태를 담당하고, 코어는 구성을 해석해 연결을 수립하고 라우팅을 수행합니다. 항목을 가져온 뒤에는 프로토콜, 전송 방식, 연결 보안 설정을 확인하고 해당 항목에 어떤 코어가 사용되는지 살펴보세요. V2Fly와 Xray 중 REALITY를 사용하는 항목에는 Xray가 필요합니다. 데스크톱용 v2rayN은 설정에 따라 여러 코어를 사용할 수 있지만, v2rayNG와 v2flyNG의 주요 차이 중 하나는 기본 코어입니다. 필드가 호환되지 않으면 화면 구성이 비슷한 클라이언트로 바꾸기보다 먼저 코어와 구성 형식을 확인하세요.

플랫폼
데스크톱 및 모바일
코어
V2Fly / Xray

02 플랫폼별 안내

운영체제에 맞는 설치 파일 찾기

운영체제에 따라 설치 파일의 종류가 정해지고, CPU 아키텍처에 따라 구체적인 파일이 달라집니다. 새 기기로 옮길 때는 먼저 운영체제 정보를 확인한 뒤 알맞은 패키지를 선택하세요.

Windows

데스크톱에서는 v2rayN을 사용하며, 크로스플랫폼 데스크톱 버전과 기존 WPF 버전 중에서 선택할 수 있습니다. 두 버전은 화면과 메뉴 위치가 다르므로 스크린샷을 따라 하기 전에 안내서가 어느 버전을 기준으로 작성됐는지 확인하세요.

기존 설치 환경을 옮길 때는 먼저 구성 폴더와 실행 방식을 확인하세요. 새 버전을 처음 실행한 뒤에는 구독 그룹과 로컬 수신 포트를 점검하고, 시작 프로그램 등록은 서두르지 마세요. 이전 클라이언트가 백그라운드에서 실행 중이면 먼저 종료한 다음 테스트하세요. 두 프로세스가 포트를 함께 사용하거나 시스템 프록시 설정을 번갈아 변경하는 상황을 막을 수 있습니다.

macOS

v2rayN은 칩에 따라 별도의 설치 파일을 제공합니다. ‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택하면 됩니다. 컴퓨터 외관이나 구입 연도로 아키텍처를 추측하지 마세요.

설치 후 기본 화면은 열리지만 연결이 되지 않는다면, 운영체제가 앱 실행을 차단하는지, 코어가 실행 중인지, 현재 네트워크 앱이 프록시 설정을 읽는지부터 구분해 확인하세요. 세 문제는 비슷하게 보일 수 있습니다. 운영체제의 보안 경고가 표시되면 앱 출처와 시스템 요구 사항을 확인하고, 문제 해결을 위해 전체 보안 설정을 변경하지 마세요.

Android

v2rayNG는 기본적으로 Xray를 사용합니다. V2Fly 구성을 주로 사용한다면 v2flyNG와 비교해 보세요. 두 클라이언트는 arm64 및 범용 설치 파일을 제공하므로 기기가 지원하는 아키텍처에 맞춰 선택해야 합니다.

연결을 켤 때 운영체제에서 권한을 요청하면 테스트 중인 클라이언트가 요청을 시작했는지 먼저 확인하세요. 기기에 다른 가상 사설망 연결이 이미 있다면 새 연결로 대체되는지도 확인해야 합니다. 앱 업데이트와 다른 클라이언트로 전환하는 것은 별개의 작업입니다. 후자의 경우 구독을 다시 가져오고 분할 설정을 확인해야 하는 경우가 많습니다.

Linux

v2rayN은 deb 및 rpm 패키지를 제공하며, 각각 x64와 arm64 버전으로 나뉩니다. 먼저 배포판이 사용하는 패키지 형식을 확인한 뒤 하드웨어 아키텍처를 살펴보세요. 패키지 형식과 CPU 아키텍처는 서로 별개의 조건입니다.

설치 후 클라이언트는 실행되지만 앱에 시스템 프록시가 적용되지 않는다면 데스크톱 환경과 대상 앱의 프록시 설정부터 확인하세요. 앱이 자체 네트워크 설정을 사용할 수 있으며, 터미널 프로그램은 그래픽 데스크톱의 설정을 읽지 않을 수도 있습니다. 클라이언트의 로컬 포트가 작동하는지 확인한 다음 앱별로 접속 여부를 테스트하세요. 데스크톱 연동 문제를 원격 연결 장애로 오해하지 않도록 주의하세요.

전체 클라이언트 보기 →

03 시작 순서

구독 가져오기, 접속 설정 및 확인

처음 설정할 때는 용도를 알고 있는 연결 하나만 선택하세요. 각 단계가 제대로 작동하는지 따로 확인한 뒤 자동 업데이트를 켜거나 분할 규칙을 변경하세요.

  1. 항목 가져오기 및 확인

    신뢰할 수 있는 출처에서 공유 링크 하나를 받거나 해당 구독 메뉴에 구독 주소를 입력하세요. 데스크톱용 v2rayN은 보통 그룹을 만든 뒤 해당 그룹을 업데이트합니다. v2rayNG에서는 구독 관리에서 출처를 추가하고 업데이트합니다. 가져온 후에는 항목 이름만 보지 말고 프로토콜 종류, 전송 방식, 연결 보안 필드가 제공자의 안내와 일치하는지 확인하세요.

    목록이 계속 비어 있다면 구독 주소를 단일 항목 가져오기 메뉴에 붙여 넣었거나, 단일 공유 링크를 구독 주소로 입력하지 않았는지 먼저 확인하세요. 항목은 있지만 시작 중 오류가 난다면 오류 유형을 기록하고 코어 지원 여부를 점검하세요. 이때 구독을 반복해서 새로 고쳐도 구성 필드 자체의 문제는 해결되지 않는 경우가 많습니다.

  2. 접속 방식 선택

    항목을 선택하고 클라이언트를 시작하세요. 데스크톱에서는 시스템 프록시를 사용하는 앱 하나로 먼저 확인하고, 모바일에서는 운영체제 안내에 따라 연결 권한을 승인하세요. 접속 방식과 아웃바운드 모드는 서로 다른 설정입니다. 전자는 앱 트래픽이 클라이언트에 들어올지를 결정하고, 후자는 들어온 트래픽이 규칙에 따라 어떤 경로로 나갈지를 결정합니다.

    접속 후 특정 앱만 기존 연결을 계속 사용한다면 해당 앱이 별도의 프록시를 쓰는지 먼저 확인하세요. 바로 서버를 바꾸거나 규칙을 다시 작성할 필요는 없습니다. TUN을 켜야 한다면 현재 설정을 기록한 뒤 로컬 네트워크와 이름 조회가 예상대로 작동하는지 확인하세요. 한 번에 옵션 하나만 변경하면 차이를 파악하기 쉽습니다.

  3. 연결 확인 및 원상 복구

    테스트할 대상을 명확히 정해 열고, 클라이언트 로그에 해당 연결이 나타나는지 확인한 다음 대상 앱에서 실제 요청이 완료되는지 살펴보세요. 화면에 코어가 실행 중이라고 표시되는 것은 프로세스가 시작됐다는 뜻일 뿐이며, 지연 시간 테스트에 성공해도 모든 앱이 클라이언트에 접속됐다는 의미는 아닙니다. 로그에 요청이 전혀 없다면 로컬 설정을 먼저 점검하고, 요청은 있지만 핸드셰이크에 실패한다면 원격 설정을 확인하세요.

    확인이 끝나면 클라이언트를 종료하고 기존 네트워크 경로를 다시 테스트해 앱이 닫힌 로컬 포트에 계속 요청하지 않는지 확인하세요. 연결을 정상적으로 켜고 원상 복구할 수 있는지 확인한 뒤 자동 실행을 고려하세요. 사용한 클라이언트, 코어, 접속 방식을 기록해 두면 나중에 업데이트하거나 기기를 옮길 때 구성을 재현하기 쉽습니다.

전체 사용 가이드 보기 →

04 오픈소스 계보

Project V와 두 가지 코어

프로토콜 이름이 같아도 구성을 통째로 서로 바꿔 쓸 수 있는 것은 아닙니다. 클라이언트, 코어, 전송 방식, 구독 형식의 호환성을 각각 확인하세요.

V2Fly
V2Ray 코어의 유지보수 계승
Xray
V2Ray 코드에서 분기해 발전
REALITY
두 코어 중 Xray만 구현

프로토콜 안내서 읽기

Project V에서 커뮤니티 유지보수까지

Project V는 네트워크 프록시를 구축하기 위한 도구 모음을 제공합니다. V2Ray는 이 생태계에서 연결을 처리하며 트래픽 접속, 프로토콜 처리, 라우팅 경로를 분리합니다. 이 구조는 오늘날의 그래픽 클라이언트에도 이어집니다. 화면에서 항목을 편집하면 코어가 연결을 수립하는 데 쓰는 필드가 바뀌고, 라우팅을 전환하면 트래픽이 코어에 들어온 뒤 향하는 경로가 달라집니다.

V2Fly는 V2Ray 코어를 이어받아 커뮤니티에서 유지보수합니다. 프로젝트의 역사를 알면 안내서나 메뉴에 비슷한 이름이 자주 등장하는 이유를 이해할 수 있지만, 기능을 판단하는 기준으로 삼아서는 안 됩니다. 문서를 읽을 때 제목의 V2Ray가 생태계, 특정 코어, 클라이언트 분류 중 무엇을 뜻하는지 먼저 구분하세요. 안내서에 ‘V2Ray를 여세요’라고만 적혀 있다면 화면 이름과 구성 내용을 보고 어느 계층에 해당하는지 확인해야 합니다.

공통 프로토콜과 분기별 차이

Xray는 V2Ray 코드에서 분기해 발전했으며, V2Fly와 함께 VMess, VLESS, Trojan, Shadowsocks를 구현합니다. 프로토콜 이름이 같다는 것은 두 코어 모두 해당 연결 유형을 구현한다는 뜻일 뿐입니다. 양쪽 설정에서 전송 방식, 연결 보안 설정, 구현에 필요한 매개변수까지 맞춰야 합니다. REALITY는 연결 보안 방식으로, 보통 VLESS와 함께 사용되며 그림에 표시된 두 코어 중 Xray가 구현합니다. 구성을 옮길 때는 항목의 관련 필드를 확인하고 ‘VLESS 지원’만으로 호환된다고 판단하지 마세요.

먼저 작동이 확인된 구성 하나를 옮긴 뒤 구독 그룹과 라우팅을 처리하는 편이 좋습니다. 공유 링크를 인식하는지, 코어가 시작되는지, 실제 연결이 수립되는지는 서로 다른 확인 단계입니다. 첫 단계에서 실패하면 형식을, 두 번째에서 실패하면 코어 로그를 확인하세요. 세 번째 단계에서는 원격 설정 문제와 로컬 네트워크 문제를 구분해야 합니다. 전체 구성을 복사한 뒤 하나씩 추측하는 것보다 이렇게 진행하면 원인을 찾기 쉽습니다.

오픈소스 클라이언트와 코어는 각각 유지보수됩니다

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 클라이언트이며 화면 코드는 사용하는 코어와 별도로 유지보수됩니다. v2rayN은 데스크톱에서 서버 관리와 시스템 접속을 지원하는 데 중점을 둡니다. v2rayNG는 주로 Xray를 코어로 사용하고, v2flyNG는 V2Fly를 사용하는 모바일 구성을 대상으로 합니다. 그래픽 인터페이스는 설정을 코어가 사용하는 데이터로 변환하므로 같은 항목을 가져와도 클라이언트에 따라 이름이나 기본값이 다르게 표시될 수 있습니다.

오픈소스 라이선스와 프로토콜 호환성은 서로 다른 개념입니다. 라이선스는 프로젝트 코드를 어떻게 사용·수정·재배포할 수 있는지 설명하고, 프로토콜 규격은 연결 양쪽이 데이터를 어떻게 주고받아야 하는지 설명합니다. 프로젝트 안내를 확인할 때는 클라이언트와 코어의 라이선스 고지를 따로 읽으세요. 클라이언트를 비교할 때는 메뉴에 표시된 프로토콜 수보다 기존 구성에 필요한 필드를 모두 설정할 수 있는지를 먼저 확인하세요.

인터페이스, 코어 및 규칙 데이터 업데이트

클라이언트 업데이트는 구독 메뉴, 가져오기 동작, 시스템 접속 방식을 바꿀 수 있습니다. 코어 업데이트는 지원 필드, 기본 동작, 오류 메시지에 영향을 줄 수 있습니다. 규칙 데이터 업데이트는 특정 대상의 매칭 결과를 바꿀 수 있습니다. 이 세 가지가 항상 함께 배포되는 것은 아니므로 동작이 달라졌다면 마지막으로 업데이트한 계층부터 확인하세요. 업데이트 전부터 문제가 있었다면 당시 오류 정보를 보관해 두어 기존 문제를 업데이트로 인한 회귀로 오해하지 않도록 하세요.

업데이트 전에 주요 설정을 기록하고 필요에 따라 구독 그룹과 사용자 지정 규칙을 백업하세요. 접속 정보가 포함된 백업은 안전하게 보관해야 합니다. 업데이트 후에는 같은 대상을 사용해 순서대로 다시 테스트하세요. 클라이언트가 시작되는지, 항목을 가져올 수 있는지, 연결이 수립되는지, 분할 규칙이 적용되는지 확인합니다. 일부만 이상하다면 클라이언트와 구독을 한꺼번에 다시 설치하거나 작성하기보다 영향을 받은 계층부터 점검하는 편이 원인을 찾기 쉽습니다.

실제 호환 조건에 맞춰 선택하세요

서버 구성이 이미 있다면 상대편의 설정부터 확인해 클라이언트를 선택하세요. 프로토콜과 전송 방식을 점검한 뒤 코어 지원 여부, 가져오기 형식, 로컬 접속 방식을 확인합니다. 구독은 항목을 전달하는 방식이지 연결 프로토콜이 아닙니다. 같은 구독 주소를 여러 클라이언트에서 열 수 있는지는 응답 데이터를 올바르게 해석할 수 있는지에 달려 있습니다. 해석에 성공한 뒤에도 연결 조건을 항목별로 확인해야 합니다.

속도와 모바일 배터리 소모를 비교할 때 프로토콜 이름만으로 순위를 매겨서는 안 됩니다. 서버 경로, 전송 방식, 재연결 빈도, 백그라운드 실행 방식이 모두 결과에 영향을 줍니다. 같은 기기와 비슷한 네트워크 환경에서 실제 작업을 비교하고, 최초 핸드셰이크와 지속 전송, 유휴 연결 유지를 나누어 살펴보세요. 기기만 바꾸는 경우에는 기존 연결 매개변수를 유지하고 클라이언트에 필요한 표현 방식만 변경하는 것이 좋습니다. 다른 설정 문제는 문제 해결 안내를 확인하세요.

05 글 모음

연결 테스트와 서버 관리

세 편의 주제별 글에서 테스트 결과의 의미, LAN 접속의 범위, 서버 선택 시 함께 비교해야 할 조건을 살펴봅니다.

전체 글 보기 →

V2Ray 클라이언트 다운로드