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

v2flyNG 공식 사이트 v2rayN 및 v2rayNG 다운로드

데스크톱 및 안드로이드 클라이언트 안내와 함께 구독 가져오기, 라우팅 규칙, TUN 모드 설정 순서를 설명합니다.

오픈 소스 Xray · V2Fly 한국어 설정 문서

운영체제에 맞는 클라이언트 선택

데스크톱에서는 v2rayN, 안드로이드 기기에서는 v2rayNG를 우선 선택하세요. 먼저 기기 아키텍처를 확인한 다음 알맞은 설치 파일을 고르세요. 클라이언트 이름이 비슷해도 설치 파일을 서로 바꿔 쓸 수 있는 것은 아닙니다.

Windows

v2rayN · 데스크톱 추천

데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 Windows의 기존 사용 방식을 유지합니다. 처음 설치한다면 두 버전의 차이를 먼저 살펴본 뒤 시스템 환경에 맞게 선택하세요. 일상적으로 사용하기 위해 두 버전을 모두 설치할 필요는 없습니다.

설치 전에 시스템 아키텍처와 실행 환경 요구 사항을 확인하세요. 압축을 푼 프로그램은 설정 저장과 로그 확인이 쉽도록 쓰기 권한이 있는 별도 폴더에 두는 것이 좋습니다. 다른 빌드로 바꾸기 전에는 설정을 백업하고, 실행 중인 기존 클라이언트를 종료해 로컬 포트가 충돌하지 않도록 하세요.

다운로드 페이지로 이동

macOS

v2rayN · 데스크톱 클라이언트

칩에 따라 Apple Silicon 또는 Intel용 설치 파일을 선택하세요. 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인할 수 있습니다. 설치 파일 이름의 arm64와 x64는 프로세서 아키텍처를 뜻하며 기능 등급을 의미하지 않습니다.

처음 실행할 때는 시스템 안내에 따라 필요한 권한을 허용하세요. 시스템 프록시와 TUN은 필요한 권한 범위가 다릅니다. 일반적인 웹 브라우징부터 확인하려면 시스템 프록시를 먼저 사용해 보세요. 특정 앱만 연결되지 않는다면 설치 파일을 바꾸거나 프록시 도구를 여러 개 켜기 전에 해당 앱이 시스템 프록시를 따르는지 확인하세요.

다운로드 페이지로 이동

Android

v2rayNG · Xray 코어

먼저 v2rayNG를 선택하고, V2Fly 코어와의 호환이 필요할 때 v2flyNG를 확인하세요. 두 클라이언트 모두 arm64 및 범용 설치 파일을 제공합니다. 대부분의 최신 기기에는 arm64가 적합합니다. 아키텍처를 모르겠다면 기기 정보나 다운로드 페이지의 안내를 먼저 확인하세요.

처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 이는 클라이언트가 기기 내 트래픽을 처리하도록 허용하는 것으로, 원격 서버 연결이 성공했다는 뜻은 아닙니다. 앱을 전환한 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한도 확인하세요. 구독 주소에는 로그인 정보가 포함될 수 있으므로 스크린샷에 표시하거나 공개된 곳에 올리지 마세요.

다운로드 페이지로 이동

Linux

v2rayN · 데스크톱 클라이언트

배포판의 패키지 형식에 맞춰 deb 또는 rpm을 고른 뒤 x64와 arm64 중에서 선택하세요. 데스크톱 환경, 트레이 지원, 권한 관리 방식은 배포판마다 다를 수 있습니다. 설치 후에는 먼저 창이 열리고 코어가 실행되는지 확인한 다음 기존 구독을 가져오세요.

브라우저, 데스크톱 앱, 터미널은 서로 다른 프록시 설정을 사용할 수 있습니다. 브라우저에서 접속된다고 터미널도 프록시를 사용 중인 것은 아닙니다. 앱 설정과 로컬 리스닝 포트를 각각 확인하세요. TUN을 켜기 전에는 필요한 권한과 기존 가상 네트워크 도구의 충돌 여부도 확인해 같은 트래픽 경로를 중복으로 처리하지 않도록 하세요.

다운로드 페이지로 이동

다운로드 페이지에서 설치 파일의 아키텍처와 지원 조건을 확인할 수 있습니다. 클라이언트는 설정을 읽어 연결을 구성하며, 구독과 원격 서비스는 별도로 준비해야 합니다. 프로그램만 설치한다고 사용할 수 있는 설정이 자동으로 만들어지지는 않습니다.

전체 클라이언트 보기 →

구독, 라우팅, 트래픽 처리

설정을 세 단계로 나눠 이해해 보세요. 구독은 연결 정보를 제공하고, 라우팅은 트래픽의 출구를 정하며, 시스템 프록시나 TUN은 어떤 앱의 트래픽을 클라이언트로 보낼지 결정합니다. 앞 단계가 정상인지 확인한 뒤 다음 설정을 조정하면 문제 해결에 필요한 단서를 놓치지 않을 수 있습니다.

주소를 저장한 뒤 구독을 업데이트하세요

구독 그룹은 서비스 제공자가 안내한 설정 주소를 모아 관리하는 기능입니다. 데스크톱에서는 별칭과 주소를 입력해 저장한 뒤 구독 업데이트를 실행하세요. 안드로이드에서도 구독 그룹 메뉴에서 같은 절차를 진행할 수 있습니다. 업데이트에 성공하면 설정을 가져온 것이므로, 사용할 구성을 선택하고 연결을 시작해야 합니다. 매번 항목을 직접 입력하는 것보다 구독을 이용하면 변경된 설정을 편리하게 반영할 수 있지만, 서비스 이용 권한을 대신하지는 않습니다. 주소에 접근 정보가 포함되는 경우가 많으니 빠짐없이 복사하고 안전하게 보관하세요. 업데이트에 실패하면 주소에 접속할 수 없는지, 콘텐츠 형식이 호환되지 않는지, 서비스가 종료됐는지부터 구분해 확인하세요.

자세히 보기 →

v2rayN 설정 3단계

먼저 반복해서 확인할 수 있는 기본 연결을 만든 뒤 필요한 규칙을 추가하세요. 아래 순서는 안드로이드 사용 흐름을 이해할 때도 참고할 수 있습니다. 메뉴 이름은 클라이언트 빌드에 따라 달라질 수 있으므로 현재 화면을 기준으로 확인하세요.

1단계 · 설정 가져오기

구독 그룹 추가

서비스 제공자가 안내한 유효한 구독 주소를 준비하세요. 구독 그룹 설정을 열고 알아보기 쉬운 별칭과 전체 주소를 입력한 뒤 저장하고 구독 업데이트를 실행하세요. 목록에 선택 가능한 설정이 나타나는지 확인합니다. 서비스 웹사이트의 로그인 주소를 구독 주소로 사용하거나 주소 일부만 복사하지 마세요.

설정이 가져와지지 않으면 업데이트 메시지를 확인해 네트워크 요청 실패인지 콘텐츠 해석 오류인지 구분하세요. 이 단계에서는 아직 프록시 모드를 선택하지 않았으므로 라우팅을 바꾸거나 TUN을 켜도 구독 형식 문제는 해결되지 않습니다. 개인 접근 정보가 포함된 주소는 본인 기기에 안전하게 보관하고, 문제 화면을 공유하기 전에는 민감한 내용을 가리세요.

구독 가져오기 안내 보기 →
2단계 · 트래픽 입력

설정과 프록시 방식 선택

가져온 설정 중 하나를 선택하고 코어가 실행되는지 확인하세요. 데스크톱에서는 시스템 프록시를 먼저 켠 다음 이를 따르는 브라우저로 접속을 테스트할 수 있습니다. 안드로이드에서는 연결을 시작할 때 시스템 안내에 따라 VPN 권한을 허용하세요. 처음에는 기본 설정을 유지하고 DNS, 라우팅, 리스닝 포트를 동시에 변경하지 않는 것이 좋습니다.

시스템 프록시는 앱이 요청을 클라이언트로 전달할지 결정하고, 라우팅 모드는 클라이언트에 들어온 요청이 어디로 나갈지 결정합니다. 서로 다른 설정입니다. 시스템 프록시를 따르지 않는 앱의 트래픽도 처리해야 한다면 TUN 설정을 확인하세요. 다른 프록시나 가상 네트워크 도구를 사용 중이라면 각각의 역할을 먼저 정리해 설정이 서로 덮어쓰지 않도록 하세요.

프록시 모드 안내 보기 →
3단계 · 단계별 확인

접속 상태와 연결 로그 확인

먼저 직접 연결되어야 하는 페이지에 접속한 다음 현재 규칙상 프록시를 사용해야 하는 대상에도 접속해 각각 결과를 확인하세요. 이후 실제로 사용할 앱을 테스트합니다. 브라우저가 정상이라고 브라우저의 연결 경로만 확인된 것입니다. 터미널, 다운로드 도구, 다른 앱은 각 앱의 프록시 동작에 맞춰 따로 점검해야 합니다.

실패가 발생하면 시간, 대상, 오류 메시지를 기록한 뒤 로컬 코어, 구독 설정, 라우팅 규칙, 원격 연결 순으로 확인하세요. 한 번에 설정 하나만 변경하고 정상 작동하던 상태를 비교 대상으로 남겨 두세요. 로그를 보면 도메인 조회 실패, 연결 시간 초과, 인증 오류를 구분하는 데 도움이 됩니다. 공개하기 전에는 개인 설정 정보도 삭제하세요.

연결 문제 해결 방법 보기 →

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

클라이언트, 코어, 프로토콜, 구독 서비스는 서로 다른 계층에 속합니다. 이 관계를 이해하면 클라이언트를 선택하기 쉽고, 서비스 문제를 프로그램 설치 문제로 오해하는 일도 줄어듭니다.

Project V로 이해하는 V2Ray

Project V는 네트워크 통신 도구를 중심으로 형성된 오픈 소스 프로젝트 생태계이며, V2Ray는 그중 널리 사용되는 핵심 구성 요소입니다. 코어는 인바운드, 라우팅, 아웃바운드를 통해 트래픽을 처리하고, 그래픽 클라이언트는 설정 파일의 매개변수를 폼, 목록, 스위치로 보여 줍니다. 따라서 일상적으로 말하는 ‘V2Ray 설치’는 실제로 그래픽 클라이언트를 설치한 뒤 클라이언트가 해당 코어를 실행하는 경우가 많습니다.

이처럼 계층을 나누면 데스크톱과 안드로이드가 서로 다른 인터페이스를 사용하면서도 프로토콜이 호환되는 설정을 함께 사용할 수 있습니다. 다만 프로토콜 이름이 같다고 설정 전체가 호환되는 것은 아닙니다. 전송 방식, 보안 계층, 세부 매개변수도 확인해야 합니다. 낯선 항목이 있다면 개념 빠른 참조를 먼저 살펴본 뒤 클라이언트나 코어를 바꿀지 결정하세요.

V2Fly와 Xray의 관계

V2Fly는 V2Ray의 커뮤니티 개발 흐름을 이어가며, Xray는 V2Ray에서 파생된 별도의 코어 개발 경로입니다. 두 프로젝트는 공통된 기술 배경을 갖지만 지원 기능과 설정 세부 사항은 각 개발 방향에 따라 달라집니다. 코어 이름만 보고 연결 성능을 판단하기보다 서비스 서버가 요구하는 설정과 클라이언트의 실제 지원 여부를 기준으로 선택하세요.

REALITY 같은 기능은 코어 지원 여부가 중요하며, 기존 설정도 특정 구현에 의존할 수 있습니다. 전환하기 전에 기존에 작동하던 설정을 보관하고 필요한 항목이 빠짐없이 들어 있는지 확인한 뒤 로그로 적용 결과를 점검하세요. 연결 속도는 원격 경로, 대상 서비스, 로컬 네트워크의 영향을 받습니다. 여러 코어를 선택할 수 있다는 것은 호환성을 위한 경로가 늘어나는 것이지, 성능 순위가 정해져 있다는 뜻은 아닙니다.

세 클라이언트의 사용 범위

v2rayN은 데스크톱용으로 구독, 로컬 포트, 시스템 프록시, 라우팅 설정을 통합 관리합니다. v2rayNG는 안드로이드 기기용이며 Xray 코어를 사용하고 시스템 권한을 통해 트래픽을 처리합니다. v2flyNG 역시 안드로이드용으로 V2Fly 기반 옵션을 제공합니다. 세 클라이언트 모두 오픈 소스이지만 인터페이스와 지원 범위가 완전히 같지는 않습니다.

클라이언트 자체는 구독 서비스가 아닙니다. 프로그램 설치, 설정 가져오기, 코어 실행, 원격 연결은 각각 따로 확인해야 하는 상태입니다. 서비스 만료, 원격 매개변수 변경, 기기 수 제한은 설정 제공자에게 문의하세요. 로컬 권한 부족, 포트 충돌, 앱의 프록시 미사용은 기기에서 확인해야 합니다. 각 문제의 범위를 구분하면 불필요한 재설치를 줄일 수 있습니다.

오픈 소스 라이선스와 업데이트

오픈 소스란 해당 라이선스의 조건에 따라 코드를 공개해 열람, 연구, 사용이 가능하다는 뜻입니다. 관련 프로젝트가 모두 같은 라이선스를 사용한다는 의미는 아닙니다. 클라이언트, 코어, 포함된 구성 요소마다 조건이 다를 수 있으므로 재배포, 수정, 통합을 하려면 프로젝트별 라이선스를 확인하세요. ‘무료 사용’이 자유로운 재배포를 뜻하는 것은 아닙니다.

일상적으로 업데이트하기 전에는 로컬 설정을 백업하고 인터페이스, 설정 형식, 코어 호환성이 달라졌는지 확인하세요. 업데이트 후에는 구독 불러오기, 코어 실행, 시스템 프록시, 자주 쓰는 앱을 차례로 테스트하세요. 모든 설정을 한꺼번에 바꾸지 않는 것이 좋습니다. 구독 업데이트는 서비스 설정을 동기화하고 클라이언트 업데이트는 프로그램 기능과 호환성을 개선하므로 두 작업을 따로 관리하고 필요한 변경 기록을 남기세요.

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

구체적인 증상에 맞는 글을 확인하세요. 시작 실패, 포트 충돌, 앱 프록시 미작동은 각각 점검 경로가 다릅니다. 현재 설정을 먼저 기록한 뒤 안내에 따라 하나씩 확인하면 부분적인 문제를 전체 설정 변경으로 키우지 않을 수 있습니다.

v2rayN 로컬 포트 충돌: 충돌 프로세스 찾기 및 리스닝 포트 변경

포트가 사용 중이라는 메시지가 표시되거나 코어가 시작되지 않으면 먼저 충돌하는 프로세스를 찾은 뒤 로컬 리스닝 설정을 변경하세요. 포트를 바꾼 후 브라우저와 터미널에서 어떤 설정을 함께 수정해야 하는지도 안내합니다. 프로그램은 복구됐는데 앱이 이전 포트를 계속 사용하는 상황을 방지할 수 있습니다.

V2Ray 시스템 프록시가 작동하지 않을 때: 브라우저와 터미널 명령줄을 따로 점검하는 방법

브라우저와 터미널은 서로 다른 프록시 설정을 사용할 수 있습니다. 브라우저 확장 프로그램, PAC 설정, 터미널 환경 변수, 로컬 포트를 각각 확인하세요. 어떤 경로의 트래픽이 클라이언트로 전달되지 않는지 파악한 뒤 더 넓은 범위의 트래픽 처리가 필요한지 결정하면 됩니다.

v2rayN TUN 모드 설정 방법: 가상 네트워크 어댑터로 전체 트래픽을 처리하는 원리와 단계

가상 네트워크 어댑터와 시스템 프록시의 차이부터 사용 상황, 실행 권한, DNS 설정까지 설명합니다. 기본 연결을 확인한 뒤 더 많은 앱의 트래픽을 클라이언트로 보내려는 사용자에게 적합합니다. 사용 전에 트래픽을 받아들이는 입구와 라우팅 규칙의 차이를 확인하세요.