오픈소스 클라이언트 가이드

V2Ray 안드로이드 v2rayNG 설정 가이드

운영체제에 맞는 오픈소스 클라이언트를 선택하고, 설정 경로를 따라 구독 가져오기, VPN 권한 허용, 앱별 프록시를 설정하세요.

  • VLESS
  • VMess
  • Trojan
  • REALITY

PLATFORM / CLIENT

플랫폼별 V2Ray 클라이언트 다운로드

먼저 운영체제를 확인한 다음 CPU 아키텍처와 설치 파일 형식을 선택하세요. 클라이언트는 구성을 읽고 연결을 설정합니다. 설치 후에는 기존 구독이나 개별 구성을 가져와야 합니다. 사용할 수 있는 구독이 있다면 기기를 바꿔도 다시 가져오면 되므로 노드를 하나씩 복사할 필요는 없습니다. 다만 앱별 프록시 목록, 로컬 포트, 라우팅 규칙은 새 기기에서 다시 확인해야 합니다.

Windows

v2rayN 데스크톱 버전이나 클래식 WPF 버전을 선택하세요. 처음 사용한다면 데스크톱 버전부터 시작하는 것이 좋습니다. 기존 가이드가 클래식 화면의 메뉴를 기준으로 한다면 WPF 버전을 선택해 참고하세요. 버전을 바꾸기 전에 구성을 백업하고 구독 그룹과 사용자 지정 규칙을 보관하세요. 그런 다음 기존 프로그램을 종료해 두 프로그램이 동시에 시스템 프록시를 변경하지 않도록 하세요.

macOS

‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인하세요. Apple 칩에는 arm64 설치 파일을, Intel 프로세서에는 x64 설치 파일을 사용합니다. 구성을 옮긴 뒤에는 클라이언트의 시스템 프록시 스위치를 확인하세요. 이전 기기의 시스템 프록시 상태와 다른 앱의 프록시 설정은 구독과 함께 이전되지 않습니다.

Android

일반적으로 v2rayNG를 먼저 선택하고, 구성이 V2Fly 코어를 명시적으로 요구할 때 v2flyNG를 선택하세요. 기기가 64비트 ARM 앱을 지원하면 arm64를 선택하고, 아키텍처를 모르면 먼저 범용 버전을 확인하세요. 이미 클라이언트가 설치되어 있다면 덮어쓰기 업데이트인지 앱 전환인지 구분해야 합니다. 앱을 전환하면 VPN 권한을 다시 허용해야 하는 경우가 많습니다.

Linux

v2rayN은 deb 및 rpm 설치 파일을 제공합니다. 먼저 배포판의 패키지 관리 방식에 맞는 형식을 선택한 다음 x64 또는 arm64를 고르세요. 설치 후 클라이언트에서 연결을 테스트하세요. 데스크톱 환경과 앱마다 시스템 프록시를 읽는 방식이 다르므로, 특정 앱만 프록시를 사용하지 않는다면 해당 앱의 네트워크 설정부터 확인하세요.

세 클라이언트의 차이가 궁금하신가요? 플랫폼, 코어, 라우팅 기능을 비교하거나 전체 클라이언트 보기 →

SETTINGS / ANDROID

v2rayNG 설정 항목과 구성 경로

먼저 세 가지를 구분하세요. 시스템 VPN은 클라이언트로 들어오는 트래픽을 정하고, 앱별 프록시는 VPN에 포함하거나 제외할 앱을 선택하며, 라우팅 규칙은 클라이언트에 들어온 연결의 출구를 결정합니다. 예를 들어 브라우저를 제외했다면 도메인 규칙을 바꿔도 브라우저 트래픽이 VPN에 들어오지 않습니다. 라우팅 규칙을 브라우저에 적용하려면 먼저 앱별 목록을 확인하세요. 아래 경로는 설정 위치를 찾기 위한 안내이며, 모든 스위치를 그대로 따라 설정할 필요는 없습니다.

VpnService 전체 트래픽 처리

v2rayNG 메인 화면에서 처음 연결을 시작하면 시스템에 VPN 연결 요청이 표시됩니다. 앱 이름을 확인한 뒤 ‘확인’을 누르세요. 데스크톱의 시스템 프록시와 달리 Android는 VpnService를 통해 조건에 맞는 트래픽을 클라이언트로 전달하므로 앱에서 프록시 주소를 직접 설정할 필요가 없습니다. 시스템 상태 표시줄의 VPN 아이콘은 기기 내부의 VPN 터널이 연결되었다는 뜻일 뿐, 원격 노드의 사용 가능 여부를 나타내지는 않습니다. 다른 VPN이 실행 중이라면 시스템 설정에서 연결을 끊은 뒤 클라이언트에서 다시 연결하세요.

메인 화면 → 연결 시작 → 시스템 ‘VPN 연결 요청’ → 확인

여러 설정을 함께 조정해야 한다면 고급 설정의 주제별 안내를 따라 하나씩 확인하세요. 기본 연결을 유지한 상태에서 라우팅이나 DNS를 변경하면 문제가 생겼을 때 전체 구성을 다시 만들지 않고 마지막 변경만 되돌릴 수 있습니다.

QUICKSTART / THREE STEPS

구독 가져오기, 연결 및 확인

처음 사용할 때는 기본 연결을 먼저 설정한 다음 앱별 프록시, 라우팅, 백그라운드 실행을 조정하세요. 아래는 v2rayNG 기준입니다. 데스크톱도 가져오는 순서는 비슷하지만 서비스를 시작하는 것과 시스템 프록시를 켜는 것은 별개의 작업입니다. 연결이 끊기거나 특정 앱을 사용할 수 없을 때는 다음 세 단계를 거슬러 확인하면 구성을 읽지 못한 문제인지, 시스템 트래픽을 처리하지 못한 문제인지, 원격 연결 문제인지 구분할 수 있습니다.

  1. 구성을 가져와 노드 선택

    구독 주소가 있다면 ‘구독 그룹 설정’을 열어 새 그룹을 만들고 주소를 붙여넣은 뒤 저장하세요. 구성 목록으로 돌아와 ‘구독 업데이트’를 실행하고 해당 그룹에서 노드를 선택합니다. 개별 구성 링크를 받았다면 목록의 추가 메뉴에서 해당 출처에 맞게 가져오세요. 구독 주소 입력란에 붙여넣으면 안 됩니다. 목록이 비어 있다면 주소가 온전히 붙여넣어졌는지, 현재 네트워크에서 구독 출처에 접속할 수 있는지, 올바른 그룹을 보고 있는지 확인하세요.

    직접 관리해 온 구성이 이미 있다면 새 항목이 별도 그룹에 가져와졌는지 확인하세요. 이전 출처와 구분할 수 있도록 그룹 이름을 알아보기 쉽게 지정하세요. 같은 이름의 항목이 반복해서 보이면 표시 이름만 보고 삭제하지 말고 먼저 어느 그룹에 속하는지 확인하세요.

  2. 연결을 시작하고 시스템 권한 허용

    선택한 항목을 확인한 뒤 메인 화면에서 연결을 시작하세요. 처음 ‘VPN 연결 요청’이 표시되면 방금 실행한 클라이언트의 요청이 맞는지 확인한 다음 시스템 대화상자에서 허용하세요. 다른 VPN이 사용 중이라면 시스템 설정에서 기존 연결의 용도를 먼저 확인하고, 테스트를 위해 업무용 구성의 정책을 끄지 마세요. 데스크톱에서는 클라이언트를 먼저 실행한 다음 필요에 따라 시스템 프록시를 켤 수 있습니다. 시스템 프록시 설정을 읽는 앱에만 이 스위치가 적용됩니다.

    클라이언트를 시작하자마자 연결 해제 상태로 돌아간다면 시스템에서 VPN 연결을 허용하는지, 현재 노드가 여전히 있는지 먼저 확인한 다음 시작 로그를 살펴보세요. 이때 여러 노드를 한꺼번에 바꾸거나 DNS까지 동시에 변경하면 원인을 구분하기 어려워집니다.

  3. 실제 요청으로 연결 확인

    프록시 범위에 포함되어야 하는 앱에서 평소 접속할 수 있는 페이지를 연 다음 클라이언트 로그를 확인하세요. VPN 아이콘은 시스템 터널이 연결되었다는 뜻일 뿐입니다. 클라이언트에서 특정 원격 포트를 테스트할 수 있어도 앱의 도메인 조회와 페이지 요청이 정상이라는 뜻은 아닙니다. 문제가 생기면 모든 앱이 실패하는지, 특정 앱이나 도메인 유형만 실패하는지 먼저 구분하세요.

    특정 앱 하나만 실패한다면 앱별 목록에서 제외되어 있는지 확인하고 앱 자체의 프록시 설정도 살펴보세요. 모든 앱이 실패한다면 기본 네트워크 접속을 확인한 뒤 같은 노드로 Wi-Fi와 모바일 데이터를 각각 테스트하세요. 매번 조건 하나만 바꾸고 테스트 시간과 로그에 표시된 오류 유형을 기록하면 결과를 비교하기 쉽습니다.

PROJECT V / CORE LINEAGE

Project V 생태계와 오픈소스 클라이언트

클라이언트, 코어, 서버 구성은 서로 다른 계층입니다. 클라이언트는 구성 가져오기와 전환, 시스템 연동을 담당하고 코어는 실제 프로토콜 처리와 주소 조회, 트래픽 전달을 맡습니다. 서버 구성은 연결 양쪽에서 사용할 매개변수를 정합니다. 그래픽 클라이언트를 바꿔도 노드의 프로토콜이 자동으로 바뀌거나 기존 서버 설정이 변환되지는 않습니다.

Project V에서 독립적으로 발전한 코어까지

Project V 생태계는 조합해 사용할 수 있는 네트워크 프록시 도구를 중심으로 발전했습니다. V2Ray는 이 생태계에서 핵심 트래픽 전달을 담당하며, 구성에서 인바운드와 아웃바운드, 라우팅을 분리해 로컬에서 트래픽을 받는 방식과 원격지에 연결하는 방식을 각각 조정할 수 있습니다. V2Fly 커뮤니티는 V2Ray의 유지 관리와 개발을 이어가고, Xray는 기존 V2Ray 코어에서 발전해 독자적인 일정으로 유지 관리됩니다. 일부 구성 개념은 공유하지만 서로 다른 커뮤니티가 각각 배포하므로 한 프로젝트의 업데이트 안내만으로 다른 프로젝트의 동작을 판단할 수 없습니다.

문제 해결에서는 이 구분이 유용합니다. 버튼을 찾을 수 없다면 그래픽 클라이언트의 화면 안내를 확인하고, 로그에 알 수 없는 필드가 표시된다면 코어의 지원 여부를 살펴보세요. 양쪽에서 구성을 읽었는데도 연결에 실패한다면 서버 주소와 전송, 보안 매개변수를 확인해야 합니다.

프로토콜 이름만으로 전체 구성이 정해지지는 않습니다

오픈소스 생태계에서는 프로토콜 문서와 구현을 확인해 같은 구성이 두 코어에서 다르게 동작하는 이유를 살펴볼 수 있습니다. VMess, VLESS, Trojan은 각각 구성이 다릅니다. REALITY는 전송 보안을 처리하므로 이 프록시 프로토콜들과 서로 바꿔 쓸 수 있는 옵션이 아닙니다. 클라이언트를 선택할 때는 기존 구성이 요구하는 프로토콜과 전송 방식, 보안 방식을 먼저 확인한 다음 클라이언트와 코어가 해당 필드를 함께 처리할 수 있는지 살펴보세요.

마이그레이션할 때는 ‘링크를 가져올 수 있음’과 ‘연결을 설정할 수 있음’을 구분해야 합니다. 전자는 클라이언트가 입력을 적어도 해석할 수 있다는 뜻이고, 후자는 코어의 동작과 양쪽 매개변수, 현재 네트워크 상태에도 달려 있습니다. 익숙하지 않은 필드가 있다면 개념 빠른 확인에서 어느 계층에 속하는지 먼저 살펴본 뒤 클라이언트 설정과 코어 문서 중 어디를 확인할지 결정하세요.

세 클라이언트의 역할

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 그래픽 클라이언트입니다. v2rayN은 데스크톱용으로 구독 관리와 로컬 프록시, 시스템 프록시 설정을 제공하며, 지원하는 코어와 모드는 빌드와 구성에 따라 달라집니다. v2rayNG는 안드로이드에서 Xray 코어로 연결하고 시스템 VpnService를 통해 트래픽 처리 범위를 설정합니다. v2flyNG는 안드로이드에서 사용할 수 있는 V2Fly 코어 옵션으로, V2Fly 구성과 동작을 비교해야 하는 경우에 적합합니다.

두 안드로이드 클라이언트 사이를 전환하기 전에 구성 출처와 코어 요구 사항을 확인하고 앱별 목록과 라우팅 설정을 기록해 두세요. 이런 설정은 클라이언트 로컬에 저장되므로 구독 링크만 보관해서는 복원할 수 없습니다. 같은 기기에 두 앱이 모두 설치되어 있다면 전환 전에 사용 중인 VPN을 먼저 끊고 다른 앱을 실행하세요. 그러면 실제로 어느 앱이 트래픽을 처리하는지 확인하기 쉽습니다.

클라이언트, 코어, 구독은 각각 따로 업데이트됩니다

클라이언트 업데이트는 메뉴 위치나 시스템 호환성을 바꿀 수 있고, 코어 업데이트는 새 필드를 지원하거나 기본 동작을 조정할 수 있습니다. 구독 업데이트는 출처에서 구성 항목을 다시 가져옵니다. 세 작업은 서로 독립적입니다. 구독 업데이트 후 노드가 사라졌다면 먼저 출처가 반환한 목록을 확인하세요. 클라이언트를 업데이트한 뒤 구성 오류가 발생했다면 기존 그룹을 무작정 덮어쓰기보다 코어와 오류가 발생한 필드를 먼저 살펴보세요.

변경하기 전에 현재 작동하는 구성의 그룹과 연결 모드, 주요 라우팅 규칙을 기록하세요. 업데이트 후에는 기존에 작동하던 구성으로 먼저 연결한 다음 새 기능을 테스트합니다. 추가로 문제를 확인해야 한다면 가져오기, 연결 시작, 요청 중 어느 단계에서 실패했는지 기록하세요. 로그를 정리해 공유할 때는 계정 식별 정보와 전체 구독 주소, 노드 인증 정보를 가리고 문제를 파악하는 데 필요한 오류만 남기세요.

FIELD NOTES

V2Ray 기술 노트

전체 글 보기 →