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

V2Ray 안드로이드 다운로드

데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 우선 선택하세요. 설치 파일을 고른 다음 구독을 가져오고 라우팅을 설정하면 됩니다.

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

연결 문제와 관련 설정

먼저 문제가 어느 단계에서 발생했는지 확인하세요. 구독 업데이트는 설정을 가져오는 단계이고, 시스템 프록시를 켜야 일부 앱의 연결 경로가 바뀝니다. 라우팅 규칙은 클라이언트로 들어온 트래픽의 경로를 정합니다. 이 세 단계는 서로 대체할 수 없습니다. 문제를 확인할 때는 한 번에 하나의 설정만 바꾸고 같은 앱에서 다시 시도해야 어떤 설정이 영향을 줬는지 파악하기 쉽습니다.

자주 발생하는 문제

  • 시스템 프록시를 켰는데 브라우저가 직접 연결됩니다. 브라우저 자체 프록시 설정을 확인한 다음, 요청이 클라이언트에 전달되지 않은 것인지 전달된 뒤 직접 연결 규칙에 매칭된 것인지 구분하세요.
  • 구독을 업데이트한 뒤 목록이 비어 있습니다. 주소를 저장하면 그룹 항목만 만들어집니다. 업데이트가 실패했거나 다른 그룹에 저장됐을 수 있습니다.
  • 안드로이드 화면을 잠그면 잠시 뒤 연결이 끊깁니다. 앱으로 돌아왔을 때 연결이 복구된다면 연결 설정을 바꾸기 전에 시스템의 백그라운드 제한부터 확인하세요.

관련 설정

  • v2rayN에서 「시스템 프록시 자동 설정」을 선택하고 브라우저가 시스템 설정을 따르는지 확인하세요. 그런 다음 「라우팅 설정」에서 해당 대상이 직접 연결 규칙에 매칭되는지 확인합니다.
  • 「구독 그룹」을 열고 방금 저장한 그룹을 선택해 현재 구독을 업데이트하세요. 파싱 오류가 표시되면 구독 주소를 받은 것이 맞는지, 계정 로그인 페이지 주소가 아닌지 먼저 확인하세요.
  • 안드로이드 시스템의 v2rayNG 앱 정보에서 배터리 설정을 확인하세요. 「제한 없음」 옵션이 있다면 화면 잠금 상태에서 연결을 비교할 수 있도록 잠시 선택해 보고, 개선되면 그대로 유지하세요.

라우팅 규칙 예시: 대상이 사설 IP 주소 목록에 매칭되면 direct로 표시된 아웃바운드를 통해 전송합니다. 이 표시는 기존 아웃바운드의 이름과 일치해야 합니다.

{
  "type": "field",
  "ip": ["geoip:private"],
  "outboundTag": "direct"
}

다섯 가지클라이언트 설정

구독 그룹 및 목록 새로고침

구독 그룹은 여러 연결 설정을 관리할 때 적합하고, 단일 링크는 한 번에 하나만 가져올 때 편리합니다. 데스크톱 v2rayN에서는 「구독 그룹」에 주소를 저장한 뒤 현재 그룹을 업데이트하세요. 안드로이드 v2rayNG에서는 사이드 메뉴에서 구독 그룹 설정으로 이동해 주소를 저장한 다음, 메인 목록으로 돌아와 업데이트합니다. 새 항목이 올바른 그룹에 나타나는지 확인하고 연결 설정을 하나 직접 선택하세요. 새로고침 후 사용자 지정 항목이 덮어써진다면 구독 그룹에서 계속 수정하지 말고 별도 그룹에 로컬 항목을 저장하세요.

구독 그룹현재 구독 업데이트

화면 예시는 흩어진 설정을 한곳에 모아 비교하기 쉽게 보여 주며, 실제 메뉴 순서를 나타내지는 않습니다. 현재 클라이언트의 용어가 다르다면 먼저 개념 빠른 찾기를 확인하세요. 조정할 항목이 트래픽 진입 경로인지, 대상 매칭인지, 연결 설정 자체인지 파악한 뒤 해당 메뉴로 이동하면 됩니다.

시스템에 맞는 설치 파일 선택

먼저 설치할 기기를 정한 뒤 운영체제 종류와 프로세서 아키텍처를 확인하세요. 아키텍처가 같아도 설치 파일을 다른 운영체제에서 사용할 수는 없습니다. 이미 설치한 기기를 업데이트할 때는 현재 사용 중인 클라이언트와 배포 형식도 확인해야 합니다.

v2rayN에는 여러 플랫폼에서 사용할 수 있는 데스크톱 버전과 기존 WPF 버전이 있습니다. 처음 사용하는 경우 데스크톱 버전부터 살펴보세요. 기존 화면 기준의 안내를 참고해야 한다면 WPF 버전이 따라 하기 쉽습니다. 시스템의 「정보」에서 「시스템 종류」를 확인하고 기기에 맞는 아키텍처를 다운로드 페이지에서 선택하세요.

창이 뜨기 전에 앱이 종료된다면 먼저 릴리스 안내에 기재된 데스크톱 런타임 환경을 확인하세요. 아직 구독이나 연결 단계에 진입하지 않았으므로 노드 매개변수를 바꿔도 실행 오류는 해결되지 않습니다.

다운로드

「이 Mac에 관하여」에서 「칩」 또는 「프로세서」를 확인하세요. Apple 칩이라고 표시된 모델은 Apple Silicon 패키지를, Intel 프로세서라고 표시된 모델은 Intel 패키지를 선택합니다. 구매 연도로 추측하지 마세요. 같은 시기에 출시된 모델도 아키텍처가 다를 수 있습니다.

디스크 이미지를 연 다음 설치 안내에 따라 앱을 「응용 프로그램」 폴더로 옮기세요. 이미지 창에서 클라이언트를 바로 실행해 봤다면 먼저 종료하고 실제 설치 위치에서 다시 실행해야 설치본과 테스트 실행본이 달라지는 일을 방지할 수 있습니다.

다운로드

Xray 기반 v2rayNG를 우선 살펴보세요. V2Fly 설정이 필요한 경우 v2flyNG와 비교해 선택하면 됩니다. 최근 출시된 기기는 대부분 arm64 패키지를 사용할 수 있습니다. 지원 아키텍처를 잘 모르겠다면 범용 패키지를 확인하고 최소 시스템 요구 사항도 살펴보세요.

시스템에서 설치된 앱과 충돌한다는 메시지가 표시되면 먼저 기존 앱 위에 설치하는 과정이 실패했는지 확인하세요. 앱을 삭제하면 로컬 설정이 지워질 수 있으므로 문제를 확인하기 전에 구독 그룹과 직접 추가한 항목을 백업하세요. 삭제부터 시도하지 마세요.

다운로드

데스크톱 v2rayN을 설치할 때는 먼저 배포판의 패키지 관리 방식에 맞춰 deb 또는 rpm을 선택한 뒤 아키텍처를 확인하세요. Debian과 Ubuntu는 일반적으로 deb, Fedora는 rpm을 사용합니다. ARM 기기에서는 해당 아키텍처에 맞는 패키지를 선택하세요.

클라이언트가 실행된다고 해서 데스크톱 앱이 시스템 프록시를 사용한다는 뜻은 아닙니다. 설치 후 현재 데스크톱 환경의 네트워크 프록시 설정을 확인하고, 해당 설정을 따르는 앱으로 테스트하세요. 일부 앱은 자체 설정에서 연결 방식을 지정해야 합니다.

다운로드

모든 클라이언트 보기 →

가져오기부터 연결 확인까지 3단계

처음 연결할 때는 기본 설정을 유지하고 정상 작동이 확인된 설정 하나로 기준을 잡으세요. 연결이 확인된 다음 라우팅, 앱별 목록, 백그라운드 설정을 조정하면 이후 문제가 생겨도 이전 단계로 돌아가 재시도하기 쉽습니다.

  1. 설정을 가져와 항목 선택

    구독 주소가 있다면 클라이언트에서 그룹을 새로 만들고 알아보기 쉬운 이름과 구독 주소를 입력한 다음 저장하고 업데이트하세요. 공유 링크가 하나뿐이라면 구독을 만들 필요 없이 클립보드에서 가져오기 기능을 사용하면 됩니다. 가져온 뒤 메인 목록에 예상한 항목이 표시되는지 확인하고 테스트할 항목을 선택하세요. 설정을 찾을 수 없다는 메시지가 나오면 복사한 내용이 온전한 주소나 공유 링크인지 확인하세요. QR 코드 옆의 설명 문구를 복사한 것은 아닌지 살펴보면 됩니다. 구독 주소에는 접근 정보가 포함될 수 있으므로 공개 스크린샷이나 문의 글에 전체 주소를 올리지 마세요.

  2. 테스트 앱 하나 연결

    데스크톱에서는 v2rayN에서 설정을 선택하고 「시스템 프록시 자동 설정」을 적용한 뒤 시스템 프록시를 사용하는 브라우저를 여세요. 안드로이드에서는 v2rayNG에서 연결을 누르고, 처음 표시되는 시스템 VPN 권한 요청을 어느 앱이 보냈는지 확인한 뒤 허용하세요. 테스트 중에는 앱별 목록을 바꾸지 말고, 필요하면 다른 VPN이 시스템 연결을 점유하고 있지 않은지도 확인하세요. 프록시를 켜거나 시스템 권한을 허용하기 전에 오류가 발생했다면 라우팅 규칙을 바꾸기보다 클라이언트 실행, 런타임 환경 또는 권한 문제부터 해결하세요.

  3. 실제 요청으로 문제 단계 확인

    평소 방문하는 페이지를 열어 새 요청을 보내고 시간을 기록한 뒤, 클라이언트로 돌아와 해당 시각의 실행 로그를 확인하세요. 관련 기록이 없다면 테스트 앱이 연결 경로에 들어왔는지 먼저 점검합니다. 로그에 직접 연결로 표시됐지만 프록시를 사용해야 하는 요청이라면 규칙 매칭을 확인하세요. 연결 시도 후 시간 초과가 발생하면 로컬 네트워크, 연결 설정, 서버 상태 순서로 살펴봅니다. 확인이 끝난 뒤 시스템 프록시 설정을 원래대로 돌리거나 안드로이드 VPN 연결을 끊고 같은 앱에서 다시 시도해 설정 변경에 따라 연결 상태가 달라지는지 확인하세요.

전체 가이드 보기 →

Project V 생태계와 클라이언트 라이선스

프로젝트, 코어, 클라이언트는 서로 다른 계층입니다. 문서가 어느 계층을 다루는지 먼저 파악해야 기능이 연결 프로토콜, 코어 구현, 인터페이스 설정 중 어디에 속하는지 판단할 수 있습니다.

Project V와 커뮤니티 유지 관리

Project V는 V2Ray가 초기에 속했던 프로젝트 생태계입니다. V2Ray 코어는 인바운드, 아웃바운드, 라우팅을 처리합니다. V2Fly 커뮤니티는 V2Ray 코어를 이어서 관리하고, Xray는 같은 코드 계보에서 분기해 독자적인 방향으로 발전했습니다. 일상적인 대화에서 「V2Ray」는 코어를 가리키기도 하고 이 계열 도구를 통칭하기도 합니다. 안내 문서에서 「V2Ray 지원」이라고 할 때는 특정 공유 형식을 가져올 수 있다는 뜻인지, 사용 중인 프로토콜과 전송 매개변수로 실제 연결할 수 있다는 뜻인지 확인해야 합니다.

Xray와 V2Fly의 호환 범위

두 코어 계열은 일부 설정 개념을 공유하지만 프로토콜 이름이 같다고 모든 전송 및 보안 설정이 호환되는 것은 아닙니다. 특히 프로토콜 종류와 추가 필드를 구분해 확인해야 합니다. VLESS를 사용하는 설정에도 특정 전송 방식이나 보안 옵션이 필요할 수 있습니다. 코어를 바꾼 뒤 항목은 표시되지만 실행이나 핸드셰이크에 실패한다면 원래 설정을 지원되는 필드와 하나씩 대조하고 서버 측 요구 사항도 확인하세요. 「가져오기 완료」를 「호환 확인」으로 간주해서는 안 됩니다.

오픈 소스 GUI 클라이언트 3종

v2rayN은 데스크톱에서 구독, 매개변수, 시스템 프록시를 관리합니다. v2rayNG는 Xray 기반 연결을 안드로이드 시스템 VPN 서비스에 연결합니다. v2flyNG는 V2Fly 코어를 사용하며 관련 설정이 필요한 안드로이드 기기에서 선택할 수 있습니다. 세 GUI 클라이언트는 모두 GPL-3.0 오픈 소스 라이선스로 배포되며 무료로 사용할 수 있습니다. 클라이언트 라이선스는 코어 및 다른 구성 요소의 라이선스와 다르며, 사용할 수 있는 서버나 구독 서비스가 포함되는 것도 아닙니다. 기존 설정이 있다면 실제 매개변수에 맞는 클라이언트를 선택하세요.

업데이트 전후 확인 순서

클라이언트, 코어, 라우팅에 사용하는 규칙 데이터는 각각 업데이트될 수 있습니다. 클라이언트 업데이트는 인터페이스나 시스템 연결 방식에 영향을 줄 수 있고, 코어 업데이트는 설정 해석과 연결 동작을 바꿀 수 있습니다. 특정 도메인의 아웃바운드만 예상과 다르다면 클라이언트와 코어를 동시에 바꾸기보다 현재 사용 중인 라우팅 규칙과 데이터를 먼저 확인하세요. 업데이트 전에 활성화된 그룹, 라우팅 프리셋, 앱 적용 범위를 기록하세요. 업데이트 후에는 기존에 작동하던 연결을 먼저 재현한 다음 새 설정을 테스트하면 마이그레이션 문제와 기존 문제를 구분하기 쉽습니다.

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

실행 로그 및 문제 해결

창이 열리지 않는 문제, 특정 연결의 시간 초과, 로그에 표시되는 핸드셰이크 오류는 각각 확인을 시작할 지점이 다릅니다. 현재 증상과 가장 가까운 안내를 선택하세요. 여러 앱에서 동시에 문제가 발생한다면 문제 해결 가이드에서 증상별로 확인하는 것을 권장합니다.

모든 글 보기 →