Android · Windows · macOS · Linux 클라이언트

V2Ray 안드로이드 클라이언트v2rayNG 다운로드와 설정

모바일에서는 v2rayNG, 데스크톱에서는 v2rayN을 선택하세요. 구독 가져오기부터 시작한 뒤 필요에 따라 라우팅 규칙을 설정하면 됩니다.

  • 오픈소스
  • 그래픽 인터페이스
  • 한국어 가이드

설치 파일 선택

운영체제에 맞는 클라이언트 다운로드

먼저 운영체제와 CPU 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 설정이 저장된 기기라면 업데이트 전에 백업하세요.

Windows

먼저 v2rayN 데스크톱 버전을 권장합니다. 클래식 인터페이스에 익숙하다면 WPF 버전을 선택할 수 있습니다. 두 버전은 메뉴 위치가 다를 수 있으므로 가이드를 따라 하기 전에 화면을 확인하고 해당 메뉴를 찾으세요.

「설정 → 시스템 → 시스템 정보」에서 「시스템 종류」를 확인하세요. 구형 컴퓨터가 64비트 운영체제를 지원한다고 해서 현재 설치된 운영체제도 64비트인 것은 아닙니다. 업데이트 전에 사용 중인 버전과 데이터 폴더를 기록해 두면 기존 파일과 새 파일이 섞이는 일을 방지할 수 있습니다.

macOS

Apple 메뉴에서 「이 Mac에 관하여」를 여세요. 「칩」 항목에 Apple 칩이 표시되면 Apple Silicon 설치 파일을, 「프로세서」 항목에 Intel이 표시되면 Intel 설치 파일을 선택하세요.

디스크 이미지를 연 뒤 v2rayN을 「응용 프로그램」 폴더로 드래그하고 실행하세요. 이미지 안의 앱과 「응용 프로그램」 폴더의 앱을 번갈아 실행하지 마세요. 업데이트 후에도 이전 화면이 보이면 실제로 어느 위치의 프로그램을 실행했는지 확인하세요.

Android

일반적으로 v2rayNG를 먼저 선택하세요. V2Fly 호환이 필요한 경우에만 v2flyNG를 고려하면 됩니다. 시스템이 arm64를 지원하는지 확인한 뒤 해당 설치 파일을 선택하세요. 아키텍처를 모르겠다면 다운로드 페이지에서 범용 버전과 시스템 요구 사항을 확인하세요.

시스템에서 덮어쓰기 설치가 안 된다고 표시되면 설치 파일이 같은 클라이언트용인지, 시스템이 안내한 구체적인 원인이 무엇인지 먼저 확인하세요. 기존 앱을 먼저 삭제하지 마세요. 직접 입력한 설정이나 그룹 메모가 기존 앱에만 저장되어 있을 수 있습니다.

Linux

먼저 배포판에 맞는 패키지 형식을 선택하고 아키텍처를 확인하세요. Debian과 Ubuntu는 일반적으로 deb, Fedora는 rpm을 선택합니다. 패키지 형식이 맞더라도 아키텍처가 일치하는지 별도로 확인해야 합니다.

시스템의 「정보」 페이지에서 기기 아키텍처를 확인할 수 있습니다. 설치 도구에서 종속 항목이 없다는 오류가 나오면 오류에 표시된 라이브러리 이름을 기록하세요. 아키텍처가 맞지 않는다는 메시지가 나오면 다운로드 페이지로 돌아가 다른 파일을 선택하세요. 데스크톱 환경에 따라 시스템 프록시 설정을 읽는 앱이 다를 수 있습니다.

전체 클라이언트 보기

가져오기부터 라우팅까지

클라이언트 설정과 라우팅 규칙

먼저 설정 하나가 정상적으로 연결되는지 확인한 다음, 어떤 앱과 주소에 프록시를 적용할지 정하세요. 아래 네 가지 항목을 순서대로 확인하면 됩니다.

설정 가이드 보기

구독 가져오기와 그룹 관리

단일 공유 링크와 구독 주소는 입력 방법이 다릅니다. 단일 링크만 있다면 복사한 뒤 「클립보드에서 가져오기」를 사용해 설정 하나를 먼저 테스트하세요. 구독 주소를 받은 경우에는 출처를 알아볼 수 있는 이름으로 구독 그룹을 만들고 저장한 다음 업데이트하세요. 그룹을 사용하면 주소를 바꾸거나 문제를 확인할 때 전체 목록을 뒤질 필요 없이 해당 그룹만 살펴볼 수 있습니다. 업데이트 후 새 항목이 어느 그룹에 들어갔는지 확인하고 연결할 설정을 직접 선택하세요. 목록에 변화가 없다면 연결 버튼을 반복해서 누르기보다 구독 주소가 온전한지, 올바른 그룹을 업데이트했는지 먼저 확인하세요.

설정 하나 가져오기오른쪽 상단 + → 클립보드에서 가져오기
구독 저장 후 새로고침구독 그룹 설정 → 구독 업데이트

라우팅 규칙

라우팅은 코어로 전달된 트래픽을 어느 아웃바운드로 보낼지 결정합니다. 로컬 네트워크 프린터나 라우터 관리 페이지에 계속 접속해야 한다면 로컬 네트워크 우회 미리 설정된 규칙부터 적용하세요. 사용자 지정 규칙은 보통 위에서부터 순서대로 적용되므로, 구체적인 예외를 범위가 넓은 규칙보다 앞에 두세요. 오른쪽 예시는 사설 IP 주소만 직접 연결하는 규칙입니다. 실제 설정에는 규칙과 일치하는 태그를 가진 아웃바운드도 필요합니다. 변경한 뒤에는 로컬 서비스와 프록시를 거쳐야 하는 대상을 각각 테스트하세요. 한쪽에서만 문제가 생긴다면 라우팅 전체를 다시 작성하지 말고 해당 규칙부터 확인하세요.

사설 IP 직접 연결 · 단일 규칙
{
  "type": "field",
  "ip": ["geoip:private"],
  "outboundTag": "direct"
}
도메인 정책 예시

domainStrategy: AsIs 라우팅 매칭을 위해 도메인을 추가로 조회하지 않습니다.

Xray / V2Fly 듀얼 코어 선택

듀얼 코어란 이 생태계에서 선택할 수 있는 두 종류의 코어를 뜻하며, 모든 클라이언트에서 앱 안에서 전환할 수 있다는 의미는 아닙니다. 안드로이드용 v2rayNG는 Xray를, v2flyNG는 V2Fly를 사용합니다. 데스크톱용 v2rayN은 여러 코어 옵션을 관리하며, 사용할 수 있는 항목은 설치 파일에 따라 다릅니다. 서버에서 제공하는 프로토콜, 전송 방식, 보안 설정을 먼저 확인한 뒤 클라이언트를 선택하세요. 설정을 가져올 수 있다는 것은 클라이언트가 설정 항목을 읽었다는 뜻일 뿐, 해당 코어가 그 조합을 지원한다는 의미는 아닙니다. 특정 클라이언트에서만 연결이 실패한다면 기존 옵션을 기록하고 같은 설정으로 비교 테스트하세요.

안드로이드

v2rayNG → Xray
v2flyNG → V2Fly

데스크톱에서 설정 항목 비교

outbounds[].protocol은 프로토콜이고, streamSettings.network는 전송 방식입니다.

TUN과 시스템 프록시 모드

데스크톱에서는 먼저 시스템 프록시로 브라우저 연결을 확인하세요. 시스템 프록시 설정을 따르는 앱에만 적용되는 경우가 많습니다. 대상 프로그램이 이 설정을 읽지 않는다면 TUN을 고려하되, 시스템 권한과 기존 가상 네트워크 어댑터의 충돌 여부를 먼저 확인하세요. 안드로이드의 VPN 모드는 시스템 권한이 필요합니다. 「앱별 프록시」를 켰다면 대상 목록과 제외 방향도 확인해야 합니다. 문제를 해결할 때는 연결 방식을 한 번에 하나씩만 바꾸고 같은 앱으로 비교하세요. 연결 버튼이 켜졌다는 것은 서비스가 시작되었다는 뜻일 뿐입니다. 대상 앱의 실제 요청을 확인해야 프록시를 거치는지 알 수 있습니다.

v2rayN 데스크톱 메뉴시스템 프록시 → 시스템 프록시 자동 설정
v2rayNG 안드로이드 메뉴설정 → 앱별 프록시

오픈소스 프로젝트와 유지 관리

Project V와코어 계열

인터페이스는 설정을 관리하고, 코어는 연결을 만들고 라우팅을 처리합니다. 문제가 생기면 먼저 어느 계층의 문제인지 구분하세요.

프로젝트 소개 보기 고급 가이드 읽기

Project V에서 V2Fly와 Xray까지

Project V는 V2Ray를 중심으로 형성된 오픈소스 프록시 도구 생태계입니다. 프로토콜, 전송, 라우팅 등을 설정 가능한 구성 요소로 나누어 그래픽 클라이언트에서 사용할 수 있는 코어를 제공합니다. V2Fly 커뮤니티는 V2Ray의 유지 관리를 이어 왔고, Xray는 V2Ray 코드에서 분기되어 독립적인 유지 관리 방향으로 발전했습니다. 설정 항목이 비슷해 보여도 두 구현이 완전히 같다고 볼 수는 없습니다. 가이드를 읽을 때는 먼저 어떤 코어를 기준으로 작성했는지 확인하고, 예시의 설정 항목이 현재 클라이언트에서 실제로 생성되거나 읽히는 항목인지 살펴보세요.

세 클라이언트의 역할

v2rayN은 구독, 코어, 로컬 프록시 설정을 관리하는 데스크톱용 오픈소스 그래픽 클라이언트입니다. v2rayNG는 Xray를 사용하고 시스템 VPN 서비스로 트래픽을 연결하는 안드로이드용 오픈소스 그래픽 클라이언트입니다. v2flyNG도 안드로이드용 오픈소스 그래픽 클라이언트이며 V2Fly를 사용하므로 해당 코어가 필요한 설정에 적합합니다. 클라이언트 이름에 따라 인터페이스와 설치 방법은 달라지지만, 이름만으로 설정의 호환성을 판단할 수는 없습니다. 프로토콜, 전송 매개변수, 서버 요구 사항이 모두 맞아야 합니다. 가이드의 화면을 비교할 때는 기본 화면, 구독 편집 화면, 실행 설정 화면을 구분하세요.

오픈소스 라이선스의 의미

V2Fly의 V2Ray 코어는 MIT 라이선스를, Xray 코어는 MPL 2.0을 사용합니다. MIT 라이선스는 관련 고지를 유지하는 등의 조건으로 코드를 재사용할 수 있습니다. MPL 2.0은 해당 라이선스가 적용되는 파일을 수정해 배포할 때 소스 코드를 공개할 의무를 규정합니다. 코어, 클라이언트, 종속 항목에는 각각 다른 라이선스가 적용될 수 있으므로 코어의 라이선스를 설치 파일 전체에 그대로 적용하면 안 됩니다. 일반 사용자는 소프트웨어 사용과 코드 재배포가 서로 다른 문제라는 점을 참고할 수 있습니다. 수정하거나 재배포할 때는 해당 프로젝트의 라이선스 전문을 확인하세요.

업데이트할 때 클라이언트, 코어, 규칙을 따로 확인

클라이언트 업데이트는 메뉴나 설정 저장 방식을 바꿀 수 있고, 코어 업데이트는 프로토콜 지원이나 매개변수 검증 방식에 영향을 줄 수 있습니다. 라우팅 데이터 업데이트는 특정 대상의 매칭 결과를 바꿀 수 있습니다. 세 항목이 항상 함께 업데이트되는 것은 아닙니다. 업데이트 전에 자주 쓰는 그룹과 프록시 모드를 기록하고 사용자 지정 규칙을 저장하세요. 업데이트 후에는 기존에 연결되던 설정으로 먼저 테스트한 다음 앱별 프록시나 사용자 지정 라우팅을 적용하세요. 업데이트 이후에만 문제가 발생했다면 최근에 바뀐 항목을 기록하세요. 코어, 규칙, 프록시 모드를 동시에 바꾸면 전후 결과를 제대로 비교하기 어렵습니다.

증상으로 문제 발생 계층 구분

구독 업데이트가 실패하면 클라이언트가 구독 내용을 가져올 수 있는지 먼저 확인하세요. 항목을 가져왔지만 실행되지 않으면 코어 오류를 살펴보세요. 코어가 실행된 뒤 특정 앱만 연결되지 않으면 해당 앱의 트래픽이 프록시에 들어갔는지 확인하세요. 마지막 경우에는 시스템 프록시를 따르는 다른 앱으로 비교해 앱 자체의 네트워크 설정을 서버 문제로 오해하지 않도록 하세요. 문제를 제보할 때는 작업 순서, 오류가 발생한 위치, 오류 메시지 원문을 적으면 됩니다. 로그를 공유하기 전에 구독 주소, 로그인 정보, 계정을 식별할 수 있는 정보를 삭제하세요.

설정 관련 자주 묻는 질문

메뉴에 나온 용어가 헷갈린다면 V2Ray 용어집을 먼저 확인하세요.

구독을 업데이트하면 현재 사용 중인 설정도 자동으로 바뀌나요?

목록 업데이트와 설정 선택은 별개의 단계입니다. 새로고침한 뒤 기본 화면으로 돌아가 현재 항목을 확인하세요. 기존 항목이 삭제되었거나 이름이 바뀌었다면 다시 선택한 뒤 테스트하세요. 목록에 새 항목이 나타났다고 해서 현재 세션이 자동으로 전환된 것은 아닙니다.

앱별 프록시와 라우팅 규칙 중 무엇을 먼저 확인해야 하나요?

먼저 앱의 트래픽이 프록시에 들어가는지 확인한 다음 대상 주소에 어떤 라우팅 규칙이 적용되는지 살펴보세요. 앱이 대상 목록에서 제외되어 있다면 도메인이나 주소 규칙을 수정해도 해당 앱의 트래픽 경로는 바뀌지 않습니다.

연결 테스트는 통과했는데 앱이 열리지 않는 이유는 무엇인가요?

테스트 결과는 당시 조건에서 테스트한 설정을 통해 테스트 대상에 접속할 수 있었다는 뜻입니다. 실제로 문제가 발생하는 앱에서 다시 테스트해 시스템 프록시를 따르는지, 다른 라우팅 규칙이 적용되는지, 접속에 실패한 도메인이 조회되는지 확인하세요.

직접 추가한 설정도 구독과 함께 옮겨지나요?

구독과 함께 전달되지 않습니다. 구독에는 해당 구독 주소에서 제공하는 항목만 포함되며, 직접 추가한 설정은 별도로 내보내거나 다시 가져와야 합니다. 기기를 옮길 때는 그룹 메모, 사용자 지정 라우팅 규칙, 시스템 권한도 따로 확인하세요.

클라이언트 문제 해결 노트

최근사용 가이드

증상에 맞는 글을 선택하세요. 로딩이 느린 경우, 연결 후 전혀 열리지 않는 경우, 화면을 잠근 뒤 연결이 끊기는 경우는 각각 확인할 지점이 다릅니다.

V2Ray 속도 저하 원인 분석: 노드 부하·회선 품질·로컬 설정 3단계 점검

속도 저하가 항상 노드 문제인 것은 아닙니다. 노드, 회선, 로컬 환경으로 점검 범위를 나누고 실제 연결 테스트와 비교 실험으로 원인을 좁히는 방법, 전송 방식과 라우팅 규칙을 조정하는 방법을 안내합니다.

페이지는 열리지만 로딩이나 다운로드가 눈에 띄게 느린 경우에 적합합니다. 같은 기기와 테스트 대상을 사용해 비교하고, 특정 회선만 느린지 로컬 앱 전반에 영향이 있는지 먼저 구분하세요.

V2Ray 연결됨으로 표시되는데 웹페이지가 열리지 않을 때: 시스템 프록시·라우팅·DNS 점검 목록

클라이언트에는 연결됨으로 표시되지만 브라우저는 계속 로딩 중인가요? 로컬 프록시 포트, 시스템 프록시 상태, 라우팅 규칙, DNS 조회, 시간 동기화 순으로 확인해 어디서 막혔는지 빠르게 찾아보세요.

연결 버튼은 켜져 있지만 요청이 완료되지 않는 경우에 적합합니다. 구독을 삭제하기 전에 기기 자체부터 확인하세요. 어느 단계에서 실패하는지 기록한 다음 설정을 바꿀지 판단하면 됩니다.

v2rayNG 배터리 소모와 백그라운드 종료 문제: 배터리 최적화 예외 및 백그라운드 실행 설정

v2rayNG는 VPN 서비스로 백그라운드에서 실행됩니다. 배터리 소모량은 시스템의 배터리 정책과 클라이언트 설정에 따라 달라집니다. 제조사별 배터리 최적화 설정 위치와 자동 시작 권한, 백그라운드 깨우기 빈도를 줄이는 방법을 안내합니다.

화면이 켜져 있을 때는 정상인데 잠근 뒤 한동안 지나 연결이 끊긴다면 백그라운드 제한부터 확인하세요. 연결은 안정적이지만 배터리 소모가 늘었다면 시스템 배터리 사용량과 클라이언트의 깨우기 빈도를 먼저 확인하세요. 두 증상을 한꺼번에 점검하지 마세요.

전체 글 보기