오픈 소스 클라이언트데스크톱 및 안드로이드 설정 가이드

v2flyNG 공식 사이트 v2rayN 다운로드및 설정 가이드

v2rayN 다운로드 가이드 보기

기기에 맞는 무료 오픈 소스 클라이언트를 선택하고, 구독 가져오기부터 라우팅 설정까지 연결 설정을 하나씩 확인하세요.

Xray / V2Fly VLESS REALITY
  • CLIENTGUI로 설정 관리
  • COREXray · V2Fly 코어 생태계
  • ROUTING도메인 및 주소별 라우팅
  • SETUP가져오기 → 선택 → 연결

오른쪽 화면은 사용법을 설명하기 위한 예시입니다. 표시된 주소와 사용자 ID로는 연결할 수 없으며, 실제 설정에는 서버에서 제공한 전체 매개변수가 필요합니다.

DOWNLOAD / 기기별 선택

V2Ray 클라이언트 다운로드

먼저 운영체제를 선택한 뒤 CPU 아키텍처를 확인하세요. 데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 우선 살펴보세요. V2Fly 코어 설정이 필요하다면 v2flyNG를 선택할 수 있습니다.

Windows

v2rayN은 데스크톱 버전과 기존 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 UI를 사용하고, WPF 버전은 전통적인 Windows 창 환경에 익숙한 사용자에게 적합합니다. 실행 환경에 맞는 버전을 고른 다음 설정을 가져오세요. 연결 문제를 해결하려고 UI 버전을 계속 바꿀 필요는 없습니다.

다운로드하기

macOS

v2rayN을 선택했다면 먼저 ‘이 Mac에 관하여’에서 칩을 확인하세요. Apple Silicon과 Intel은 서로 다른 아키텍처의 설치 파일을 사용합니다. 앱 설치 후에는 시스템 프록시 설정도 확인해야 합니다. 창이 열렸다고 해서 브라우저가 프록시를 사용 중인 것은 아닙니다.

다운로드하기

Android

v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 대부분의 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 모르겠다면 범용 버전 안내를 확인하세요. 처음 연결할 때는 시스템 VPN 권한이 필요하며, 백그라운드 연결은 배터리 최적화 설정의 영향을 받을 수 있습니다.

다운로드하기

Linux

v2rayN은 배포판에 따라 deb 및 rpm 패키지를 제공하며 CPU 아키텍처도 구분합니다. 설치 전에 시스템의 패키지 형식을 확인하세요. 실행한 후에는 데스크톱 환경의 프록시와 앱 자체 프록시를 각각 점검해야 합니다. 프로그램마다 참조하는 네트워크 설정이 다를 수 있습니다.

다운로드하기

모든 클라이언트 보기 →

CONFIGURATION / 핵심 설정

구독, 라우팅 및 코어 설정

연결은 설정 출처, 트래픽 처리 경로, 코어의 매개변수 인식 여부, 앱의 실제 프록시 사용 여부 등 여러 요소에 따라 달라집니다. 여러 옵션을 한꺼번에 바꾸기보다 아래 네 가지를 차례대로 확인하면 문제를 더 쉽게 찾을 수 있습니다.

ROUTING

라우팅: 먼저 경로를 정하고 규칙을 확인하세요

라우팅은 요청을 프록시로 보낼지, 직접 연결할지, 차단할지 결정합니다. v2rayN의 라우팅 설정과 시스템 프록시는 별개의 기능입니다. 시스템 프록시는 호환되는 앱의 요청을 클라이언트로 전달하고, 라우팅은 요청의 출구를 결정합니다. 처음에는 용도에 맞는 프리셋을 선택하고 웹페이지가 정상적으로 열리는지 확인한 뒤 특정 도메인이나 주소 규칙을 추가하세요.

특정 사이트의 문제를 확인할 때는 도메인이 예상한 규칙에 해당하는지 먼저 살펴본 다음 규칙 순서와 DNS 조회를 점검하세요. ‘연결됨’만 보고 모든 트래픽이 프록시를 통한다고 판단하지 마세요. 다른 클라이언트의 규칙 파일을 그대로 가져다 쓰는 것도 피해야 합니다. 데스크톱 클라이언트와 안드로이드 클라이언트는 설정 메뉴가 다르며, 앱별 프록시 설정이 적용 범위에 영향을 줄 수도 있습니다. 자세한 확인 순서는 v2rayN 설정 가이드를 참고하세요.

SUBSCRIPTION

구독 가져오기: 그룹에 저장하고 필요할 때 업데이트

구독 주소로 서버 설정 여러 개를 가져올 수 있으며, 단일 공유 링크에는 보통 설정 하나가 포함됩니다. 가져오기 전에 형식을 확인하세요. 구독 그룹에 주소를 입력한 뒤 업데이트를 실행하고, 단일 서버 링크라면 클립보드에서 가져오기 등 해당 메뉴를 사용하세요. 가져온 뒤에는 서버를 선택해 활성 서버로 설정해야 합니다.

업데이트에 실패하면 주소 접속 불가, 응답 내용 없음, 형식 해석 실패를 구분하세요. 그룹 전체를 바로 삭제하지 말고, 기존에 사용 가능한 설정은 보존한 채 주소가 온전한지와 접속 조건이 바뀌었는지 확인한 다음 다시 업데이트하세요. 구독 주소에 접속 정보가 포함될 수 있으므로 스크린샷이나 로그를 공유하기 전에 가리세요. 추가로 확인하려면 구독 업데이트 실패 문제 해결을 참고하세요. 매개변수를 확인하는 대신 앱을 반복해서 재설치하지 마세요.

CORE

Xray와 V2Fly: 설정에 맞는 코어 선택

코어는 프로토콜과 연결을 실제로 처리하고, GUI 클라이언트는 설정을 표시하고 관리합니다. Xray와 V2Fly는 모두 Project V 관련 오픈 소스 생태계에 속하지만 기능과 설정 문법이 완전히 같지는 않습니다. REALITY나 XTLS Vision을 사용할 때는 선택한 클라이언트와 코어가 해당 기능을 지원하는지 확인하세요. 서버 항목이 가져와졌다는 사실만으로는 충분하지 않습니다.

v2rayN의 코어 지원 여부는 선택한 빌드와 설정에 따라 다릅니다. 안드로이드에서는 Xray를 사용하는 v2rayNG와 V2Fly를 사용하는 v2flyNG를 구분해 선택할 수 있습니다. 이전할 때는 흐름 제어, 전송 계층 보안, 서버 이름과 기타 필수 매개변수를 하나씩 확인하세요. 두 코어를 단순히 상위 버전과 하위 버전 관계로 보아서는 안 됩니다. 아래에서 두 설정 유형의 확인 사항을 전환해 살펴볼 수 있습니다.

REALITY 설정 확인 사항: 공개 키, 서버 이름, 짧은 ID와 서버에서 요구하는 지문을 확인하세요. Vision을 사용한다면 흐름 제어도 서버 설정과 일치해야 합니다. 보안 방식은 임의로 바꿔도 되는 외형 옵션이 아닙니다.

코어별 차이 알아보기 →

LAN

LAN 공유: 주소, 포트 및 방화벽

같은 LAN에 연결된 다른 기기는 호스트의 프록시 수신 포트를 통해 프록시에 접속할 수 있습니다. 먼저 v2rayN에서 수신 설정을 확인하고, 필요한 경우 ‘LAN 연결 허용’을 켜세요. 다른 기기에는 호스트의 LAN 주소와 실제 수신 포트를 입력해야 하며, 해당 기기 자체의 루프백 주소를 입력하면 안 됩니다. 호스트가 절전 모드에 들어가거나 주소가 바뀌거나 방화벽에 차단되면 연결이 끊길 수 있습니다.

LAN 공유는 신뢰할 수 있는 네트워크에서만 사용하고, 방화벽 허용 범위는 필요한 네트워크나 기기로 제한하세요. 시스템 프록시가 모든 연결 방식을 자동으로 전달하는 것은 아니므로 TV, 휴대폰, 다른 PC도 각각 설정해야 합니다. 이 기기에서만 사용할 경우 LAN 연결을 꺼 두면 됩니다. 자세한 절차는 v2rayN LAN 연결 허용 안내를 참고하세요. 먼저 호스트에서 연결되는지 확인한 뒤 기기 간 통신을 점검하세요.

QUICKSTART / 3단계 시작하기

v2rayN 사용 가이드 미리보기

먼저 설정 하나를 연결해 확인한 다음 라우팅과 백그라운드 동작을 조정하세요. 데스크톱과 안드로이드는 메뉴 위치가 다르지만 ‘설정 준비, 서버 선택, 트래픽 경로 확인’ 순서는 같습니다.

  1. 구독 또는 서버 링크 가져오기

    클라이언트를 열고 제공받은 정보가 구독 주소, 공유 링크, 수동 매개변수 중 무엇인지 확인하세요. 구독 주소는 구독 그룹에 넣고 업데이트를 실행하며, 공유 링크는 해당 가져오기 메뉴를 사용합니다. 수동 설정이라면 프로토콜, 주소, 포트, 인증 정보를 하나씩 입력하세요. 목록에 항목이 표시되면 프로토콜과 전송 방식이 원래 안내와 일치하는지 확인하고, 설명 화면의 예시 값을 복사하지 마세요.

    구독 업데이트와 클라이언트 업데이트는 서로 다른 작업입니다. 전자는 서버 목록을 새로 고치고, 후자는 앱을 교체합니다. 구독 업데이트에 실패하면 기존 항목을 보존한 채 주소와 네트워크 접속 조건부터 확인하세요. 모든 설정을 먼저 지울 필요는 없습니다.

  2. 활성 서버와 프록시 적용 범위 선택

    목록에서 설정 하나를 선택해 활성 서버로 지정하세요. 데스크톱에서는 시스템 프록시 모드를 확인하고 적절한 라우팅 프리셋을 선택합니다. 안드로이드에서는 연결을 시작할 때 시스템 VPN 권한을 허용하고 앱별 프록시가 켜져 있는지 확인하세요. 앱이 프록시 적용 범위에서 제외되어 있다면 해당 앱의 접속 결과로 서버 작동 여부를 판단할 수 없습니다.

    처음 설정할 때는 시스템 네트워크를 제어하는 클라이언트를 하나만 실행하세요. 프록시 도구 여러 개가 시스템 설정을 동시에 변경하면 브라우저가 이전 포트를 가리킬 수 있습니다. 앱을 전환한 뒤에는 작업 표시줄에 아이콘이 있는지만 보지 말고 프록시 주소를 다시 확인하세요.

  3. 접속을 확인하고 증상에 따라 문제 해결

    연결을 시작한 뒤 프록시 적용 범위에 포함된 앱으로 테스트할 페이지에 접속하고 클라이언트 로그도 확인하세요. 서버 연결, 도메인 조회, 웹페이지 로딩은 각각 다른 점검 항목입니다. 연결 테스트에 한 번 성공했다고 해서 모든 앱이 올바르게 설정된 것은 아닙니다. 평소 직접 연결해야 하는 대상과 프록시를 사용해야 하는 대상을 각각 테스트해 라우팅이 의도대로 작동하는지 확인하세요.

    시간 초과가 발생하면 로컬 네트워크와 서버 매개변수를 먼저 확인하세요. 브라우저에서만 실패하면 시스템 프록시와 브라우저 설정을 살펴보고, 화면을 잠근 뒤 연결이 끊기면 백그라운드 제한을 확인하세요. 변경한 항목을 매번 기록하고 한 번에 하나씩 바꾸면 실제 원인을 파악하기 쉽습니다.

전체 가이드 보기 →

OPEN SOURCE / 클라이언트와 코어

Project V, V2Fly 및 Xray 생태계

클라이언트와 코어의 역할을 이해하면 설치 파일, 설정, 가이드가 현재 환경에 맞는지 판단하기 쉽습니다. 이름이 비슷하다고 기능까지 같은 것은 아니며, 프로토콜 지원 여부도 구체적인 빌드에 따라 확인해야 합니다.

GUI로 설정을 관리하고 코어로 연결 처리

Project V는 네트워크 프록시 도구와 관련 기술을 중심으로 형성된 오픈 소스 생태계입니다. V2Ray는 그 안에서 널리 쓰이는 핵심 프로젝트 이름이며, V2Fly 커뮤니티는 관련 프로젝트의 개발과 유지 관리를 이어 왔습니다. Xray는 관련 코드 기반에서 독립적인 코어 분기로 발전해 자체적인 기능 개발 방향을 갖추었습니다. 두 프로젝트는 일부 개념을 공유하지만 설정 필드, 전송 기능, 업데이트 주기가 항상 일치하는 것은 아닙니다.

v2rayN, v2rayNG, v2flyNG는 사용자를 위한 GUI 클라이언트입니다. 서버 목록, 구독, 라우팅, 실행 상태를 조작 가능한 화면에 표시하고, 실제 트래픽 처리는 해당 코어에 맡깁니다. 따라서 클라이언트 이름, 앱 빌드, 코어 기능을 구분해서 살펴봐야 합니다. 화면에 특정 프로토콜 이름이 표시된다고 해서 어떤 조합에서든 모든 추가 매개변수를 사용할 수 있는 것은 아닙니다. 서버 설정도 서버 측과 일치해야 합니다.

오픈 소스 프로젝트는 코드를 살펴보고 논의하거나 개선할 수 있다는 뜻입니다. 재사용하거나 배포할 때는 각 프로젝트의 라이선스를 준수해야 하며, 클라이언트와 포함된 구성 요소에 서로 다른 라이선스 조건이 적용될 수도 있습니다. 일상적인 사용에서는 ‘오픈 소스’라는 이유만으로 모든 설정이 호환된다고 판단하기보다 앱 안내, 코어 변경 사항, 설정 호환성을 확인하는 것이 중요합니다.

v2rayN: 데스크톱 설정 관리

서버 관리, 구독 그룹, 라우팅, 시스템 프록시 설정을 지원하는 오픈 소스 데스크톱 클라이언트입니다. 데스크톱 버전과 WPF 버전은 주로 UI 기술, 플랫폼 지원, 실행 환경이 다릅니다. 운영체제와 사용 습관에 맞춰 선택하고, 실제 연결 기능은 사용하는 코어와 설정에 따라 확인하세요.

v2rayNG: 안드로이드 및 Xray 코어

안드로이드 기기용 오픈 소스 클라이언트로, 시스템 VpnService를 통해 선택한 앱의 트래픽을 처리합니다. 데스크톱의 시스템 프록시와 작동 방식이 다르며, 처음 권한을 허용하는 과정과 앱별 적용 범위, 백그라운드 배터리 정책도 사용에 영향을 줍니다. Xray 관련 기능이 필요하다면 클라이언트 코어와 서버 매개변수를 확인하세요.

v2flyNG: V2Fly 코어를 사용하는 대안

V2Fly 코어 설정이 필요한 경우에 적합한 안드로이드용 오픈 소스 클라이언트입니다. 이름이 비슷한 두 안드로이드 클라이언트를 완전히 대체 가능한 제품으로 간주하지 말고, 설정 호환성을 기준으로 선택하세요. 이전하기 전에 기존 설정을 보존하고 프로토콜, 전송 방식, 보안 설정이 지원되는지 확인하세요.

세 클라이언트의 사용 환경 비교 →

FIELD NOTES / 사용 팁

클라이언트 설정 및 문제 해결 글

기본 연결을 마친 뒤 LAN 공유, 데스크톱 버전 선택, 안드로이드 백그라운드 실행을 살펴보세요. 각 글은 실제 설정 하나를 중심으로 구성되어 현재 겪는 문제에 맞춰 찾아보기 쉽습니다.

모든 글 보기 →