v2rayN
Windows, macOS, Linux용 데스크톱 클라이언트로 구독, 서버, 라우팅을 한곳에서 관리하세요.
v2rayN 다운로드 설정 안내 보기 →오픈 소스 클라이언트 · 다운로드 및 설정 안내
오픈 소스 클라이언트의 다중 플랫폼 다운로드 경로와 한국어 설정 가이드를 제공합니다. 구독 가져오기부터 라우팅, DNS, TUN 설정까지 확인하세요.
Windows, macOS, Linux용 데스크톱 클라이언트로 구독, 서버, 라우팅을 한곳에서 관리하세요.
v2rayN 다운로드 설정 안내 보기 →두 Android 클라이언트는 각각 Xray와 V2Fly 코어를 사용합니다. 사용 중인 노드의 설정 요구사항에 맞춰 선택하세요.
Android 클라이언트 다운로드 설정 안내 보기 →설치 파일 선택
먼저 운영체제를 확인한 다음 프로세서 아키텍처를 확인하세요. 데스크톱에서는 v2rayN부터 살펴보고, Android에서는 v2rayNG를 우선 확인하세요. V2Fly 코어가 필요하다면 v2flyNG를 고려하면 됩니다. 설치 파일은 클라이언트를 실행하기 위한 시작점일 뿐입니다. 서버 주소, 포트, 인증 정보와 구독 링크는 서비스 제공자가 제공해야 하며, 저장해 둔 설정이 선택한 코어와 호환되는지도 확인해야 합니다.
v2rayN은 크로스 플랫폼 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 처음 설치한다면 데스크톱 버전부터 살펴보고, 클래식 인터페이스에 익숙하다면 WPF 버전 안내와 비교해 보세요. 인터페이스 버전을 바꾸기 전에는 기존 구독 그룹과 라우팅 설정을 백업해 서로 다른 폴더의 설정을 잘못 사용하는 일을 방지하세요.
다운로드 페이지로 이동 →v2rayN은 Apple Silicon과 Intel 칩에 맞는 설치 경로를 각각 제공합니다. ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 선택하세요. 처음 실행할 때 시스템 보안 알림이 표시되면 다운로드 출처와 알림 내용을 확인하고, 시스템에서 허용하는 방법으로 권한을 부여하세요.
다운로드 페이지로 이동 →v2rayNG는 Xray, v2flyNG는 V2Fly 코어를 사용합니다. 대부분의 최신 기기에서는 arm64 패키지를 먼저 확인하고, 아키텍처를 모른다면 범용 버전 안내를 참고하세요. 처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다. 백그라운드 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요.
다운로드 페이지로 이동 →v2rayN은 deb 및 rpm 설치 파일을 제공하며 x64와 arm64를 구분합니다. 배포판의 패키지 관리 방식에 맞는 형식을 선택하고 기기의 아키텍처도 확인하세요. 데스크톱 환경이 시스템 프록시 설정을 읽는지에 따라 앱 동작이 달라질 수 있습니다. TUN을 사용하기 전에는 권한과 가상 네트워크 어댑터 조건을 확인하세요.
다운로드 페이지로 이동 →처음 사용한다면 서비스 제공자가 안내한 구독 링크, 노드 프로토콜, 지원 클라이언트 정보를 함께 확인하세요. 구독은 설정을 배포하는 방식이지 클라이언트 계정이 아닙니다. 가져오기에 성공했다는 것은 내용을 해석할 수 있다는 뜻일 뿐, 원격 서버에 연결할 수 있다는 의미는 아닙니다. 공유 링크 하나만 있다면 우선 해당 서버 설정만 가져와 연결을 확인하세요. 복잡한 그룹을 만들 필요는 없습니다.
다른 기기의 설정을 사용 중이더라도 모든 항목을 그대로 옮기지는 마세요. 데스크톱 시스템 프록시, Android VPN 연결, 운영체제별 권한 모델은 서로 다르므로 기기에 맞춰 설정을 확인해야 합니다. 기본 라우팅으로 먼저 연결한 뒤 사용자 지정 DNS, 분할 라우팅 규칙 및 고급 항목을 옮기세요. 문제가 생겼을 때 어느 단계에서 변경이 시작됐는지 찾기 쉬워집니다.
클라이언트 설정
클라이언트는 세부 설정을 조작하기 쉬운 항목으로 정리하지만 플랫폼마다 메뉴 이름과 기능 범위가 다를 수 있습니다. 아래에서는 실제 작업 순서에 따라 서버 출처를 정리하고, 요청이 어떤 아웃바운드로 나갈지 결정한 다음, 앱의 프록시 설정 준수 여부에 따라 트래픽 처리 방식을 선택합니다. 항목을 전환해 각 설정 상황을 확인하세요.
구독은 서버 설정을 한곳에서 업데이트하는 방식으로, 노드 정보가 바뀌는 환경에 유용합니다. 먼저 v2rayN에서 구독 그룹을 만들고 링크를 입력해 업데이트한 다음 프로토콜, 메모, 사용 가능 상태를 확인하세요. Android 클라이언트에서도 가져온 결과를 확인해야 합니다. 출처별로 그룹을 나누면 중복 항목과 잘못된 선택을 줄일 수 있습니다. 직접 수정한 설정은 업데이트로 덮어쓰이지 않도록 따로 저장하는 편이 좋습니다. 공유 링크를 하나씩 붙여 넣는 것보다 관리하기 쉽지만, 구독을 정상적으로 불러왔다고 연결까지 성공한 것은 아닙니다. 서버를 선택한 뒤 실제 요청을 테스트하세요.
라우팅은 도메인이나 IP 등의 조건에 따라 요청을 프록시, 직접 연결 또는 다른 아웃바운드로 보냅니다. 로컬 리소스와 원격 서비스를 함께 이용할 때 유용합니다. 먼저 클라이언트의 기본 규칙 구성을 사용하고 꼭 필요한 예외만 적절한 위치에 추가하세요. 모든 요청을 같은 아웃바운드로 보내는 것보다 분할 라우팅을 사용하면 접속 목적을 더 세밀하게 설정할 수 있지만, 규칙 순서와 DNS 조회 방식도 결과에 영향을 줍니다. DNS는 라우팅과 함께 조정해야 합니다. 변경 후에는 로그에서 도메인 매칭과 실제 아웃바운드를 확인하세요. 페이지가 열리는지만으로 규칙 적용 여부를 판단하지 마세요.
TUN은 가상 네트워크 어댑터를 통해 트래픽을 처리하므로 시스템 프록시 설정을 따르지 않는 앱에 적합합니다. 먼저 일반 프록시 연결이 정상인지 확인한 뒤 시스템 요구사항에 따라 권한을 부여하고 TUN을 활성화하세요. 이후 로컬 네트워크, DNS, 대상 앱의 동작을 확인해야 합니다. 시스템 프록시보다 더 많은 트래픽을 처리할 수 있지만, 모든 트래픽이 원격 노드를 거치는 것은 아닙니다. 최종 경로는 라우팅 규칙이 결정합니다. 연결 문제가 발생하면 다른 네트워크 트래픽 처리 도구를 종료하고 인터페이스 및 라우팅 충돌을 확인하세요. 설정을 되돌리려면 TUN을 끈 뒤 시스템 네트워크 상태가 원래대로 복구됐는지 확인하세요.
코어는 실제 연결과 프로토콜 처리를 담당하고, 그래픽 클라이언트는 설정과 조작 기능을 제공합니다. v2rayN은 설정 요구사항에 맞는 코어를 사용할 수 있습니다. Android의 v2rayNG와 v2flyNG는 각각 Xray와 V2Fly에 맞춰져 있습니다. 클라이언트 이름만 보는 것보다 코어를 확인하는 편이 프로토콜 및 매개변수 호환성 문제를 파악하는 데 도움이 됩니다. 전환 전 서비스 제공자의 설정 요구사항을 확인하고 작동하는 설정을 보관하세요. 전환 후에는 클라이언트를 다시 시작해 테스트해야 합니다. 코어마다 지원 기능이 다르므로 같은 사용자 지정 설정이 양쪽에서 그대로 작동한다고 가정하면 안 됩니다.
설정은 개수보다 순서가 중요합니다. 처음 연결할 때는 서버 설정, 현재 선택된 항목, 프록시 트래픽 처리 방식을 먼저 확인하고 라우팅과 DNS는 기본값으로 유지하세요. 브라우저에서 정상적으로 접속한 다음 다른 앱이 시스템 프록시를 따르는지 확인하세요. 트래픽을 추가로 처리해야 하는 경우에만 TUN을 시도하면 됩니다. 한 번에 하나씩 변경하고 변경 전후 동작을 기록하면 여러 기능을 동시에 켜는 것보다 원인을 찾기 쉽습니다.
시스템 프록시와 라우팅 모드는 서로 다른 두 단계의 설정입니다. 시스템 프록시는 앱이 요청을 클라이언트로 전달할지 결정하고, 라우팅 모드는 클라이언트가 받은 요청을 어떤 아웃바운드로 보낼지 결정합니다. 시스템 프록시가 켜져 있어도 앱이 해당 설정을 전혀 사용하지 않는다면 도메인 분할 규칙을 바꿔도 트래픽 처리 문제는 해결되지 않습니다. 반대로 요청이 클라이언트에 도달했지만 잘못된 아웃바운드로 나간다면 규칙, DNS 조회 결과, 현재 모드를 확인해야 합니다.
DNS 설정은 특정 DNS 서버 주소 하나를 목표로 하는 작업이 아닙니다. 어떤 도메인을 어떤 경로로 조회할지, DNS 요청 자체를 프록시 또는 직접 연결 중 어느 쪽으로 보낼지, 라우팅이 조회된 IP에 의존하는지 먼저 확인해야 합니다. 서버에 연결할 수 없는 것처럼 보여도 실제 원인은 도메인 조회 단계일 수 있습니다. 문제를 확인할 때는 정상 작동하는 기본 설정을 유지하고 로그에서 DNS 조회 실패와 연결 실패를 구분한 다음, DNS 또는 아웃바운드 설정을 필요한 부분만 조정하세요.
FakeDNS, 사용자 지정 아웃바운드, 여러 구독의 필터링을 사용하는 경우 고급 활용의 관련 내용을 먼저 읽는 것이 좋습니다. 이런 기능은 함께 갖춰야 할 조건이 있어 설정 일부만 복사하면 맥락을 놓치기 쉽습니다. 안정적으로 작동하는 설정은 복구 기준으로 보관하세요. 변경 후에는 자주 이용하는 웹페이지, 로컬 리소스, 대상 앱을 각각 테스트하고 예상대로 동작하는지 확인한 다음 다음 항목으로 넘어가세요. 문제를 공유할 때는 오류 유형만 남기고 구독 주소와 인증 정보는 숨겨야 합니다.
오픈 소스 코어 생태계
Project V
프록시 코어와 설정 생태계
V2Ray의 커뮤니티 유지보수 방향
V2Ray에서 파생된 코어 브랜치
그래픽 클라이언트에서 설정한 서버, 라우팅, DNS를 해당 코어가 처리합니다.
일상적으로 말하는 “V2Ray”는 프록시 생태계를 뜻하기도 하고 특정 코어 프로그램을 가리키기도 합니다. Project V는 모듈형 프록시 설계를 제시하며, V2Ray는 이러한 배경에서 나온 핵심 프로젝트입니다. V2Fly는 V2Ray의 커뮤니티 유지보수를 이어가고, Xray는 V2Ray에서 파생되어 프로토콜과 기능을 자체적으로 발전시켜 왔습니다. 이 관계를 이해하면 그래픽 클라이언트 이름, 노드 프로토콜, 실제로 작동하는 코어를 혼동하지 않을 수 있습니다.
v2rayN, v2rayNG, v2flyNG는 사용자가 조작하는 클라이언트입니다. 서버 추가, 구독 업데이트, 라우팅 선택 등의 작업은 최종적으로 코어가 사용할 설정으로 변환됩니다. 클라이언트가 실행됐다는 것은 인터페이스가 작동한다는 뜻일 뿐입니다. 코어가 시작됐는지, 설정이 적용됐는지, 연결에 성공했는지는 상태와 로그를 확인해야 합니다. 같은 인터페이스처럼 보여도 코어를 바꾸면 연결 결과가 달라질 수 있는 이유입니다.
데스크톱에서는 먼저 v2rayN을 살펴보세요. Windows, macOS, Linux에서 사용할 수 있으며 그래픽 인터페이스로 서버와 구독을 한곳에서 정리하기 좋습니다. 크로스 플랫폼 데스크톱 인터페이스와 클래식 WPF 인터페이스는 구성이 다르므로 기존 사용자는 화면 캡처만으로 기능을 판단하지 말고 사용 습관과 시스템 환경을 고려해 선택하세요. 다른 운영체제로 옮길 때는 먼저 서버 정보를 옮긴 뒤 시스템 프록시, 권한, TUN 동작을 각각 확인하세요. 특정 시스템의 환경 설정을 공통 설정으로 간주하지 않도록 주의해야 합니다.
Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 살펴보세요. 기존 설정에서 V2Fly를 명시적으로 요구한다면 v2flyNG를 확인하면 됩니다. 두 클라이언트 모두 그래픽 인터페이스를 제공하지만 코어의 기능과 설정 지원 범위가 같다고 볼 수는 없습니다. 특히 REALITY 같은 기능을 사용할 때는 서버 측에서 안내한 전체 설정 요구사항을 확인하세요. 프로토콜 이름만 다른 항목으로 바꾸면 안 됩니다. 공유 링크를 가져올 수 있어도 현재 코어가 확장 매개변수를 모두 올바르게 처리한다는 보장은 없습니다.
클라이언트를 선택할 때는 세 가지를 차례로 확인하세요. 기기의 운영체제, 현재 노드에서 요구하는 코어, 자주 사용하는 앱에 필요한 트래픽 처리 방식입니다. 앞의 두 항목은 설치 경로와 호환성을 결정하고, 마지막 항목은 연결 후 사용할 설정을 결정합니다. 조건이 이미 맞는다면 이름이 비슷하다는 이유로 클라이언트를 자주 바꿀 필요는 없습니다. 특정 노드 하나만 작동하지 않는다면 먼저 해당 설정과 네트워크 환경을 확인하세요. 실패 원인을 클라이언트 전체의 문제로 단정해서는 안 됩니다.
세 클라이언트는 모두 오픈 소스 프로젝트로 공개되어 코드와 변경 내역을 커뮤니티에서 검토하고 논의할 수 있습니다. v2rayN, v2rayNG, v2flyNG는 GPL-3.0 라이선스를 따르며 V2Fly와 Xray의 코어 코드는 MPL-2.0 라이선스를 따릅니다. 클라이언트와 호출되는 코어는 서로 다른 소프트웨어 구성요소이므로 각각 해당 라이선스가 적용됩니다. 개인적인 일상 사용과 수정 후 재배포는 다른 상황입니다. 재배포할 때는 각 구성요소의 라이선스 전문과 고지 사항을 확인하세요.
오픈 소스는 소프트웨어의 개발 및 배포 방식을 설명할 뿐, 구체적인 네트워크 설정이 적절한지 판단해 주지는 않습니다. 실제 요청은 기기, 서버, 대상 서비스 등을 거치며 개인정보 보호와 보안은 설정 출처, 접속 프로토콜, 실행 환경에 따라서도 달라집니다. 구독 링크에는 실제로 사용할 수 있는 서비스 인증 정보가 포함될 수 있으므로 계정 정보처럼 안전하게 보관하세요. 다른 사람에게 도움을 요청할 때 전체 링크, QR 코드, 인증 항목을 스크린샷에 그대로 포함하지 마세요.
커뮤니티 유지보수에는 인터페이스, 코어 호환성, 운영체제 지원, 오류 수정이 함께 포함될 수 있습니다. 각 영역의 업데이트 주기가 다를 수 있으므로 무조건 최신 버전을 찾기보다 릴리스 노트를 확인하는 것이 유용합니다. 변경 사항이 사용하는 플랫폼과 설정에 관련되는지 살펴본 뒤 업데이트 여부를 결정하세요. 사용자 지정 라우팅이나 아웃바운드 설정에 의존하는 환경이라면 현재 설정을 먼저 보관하고 자주 사용하는 접속 상황에서 새 조합을 테스트하세요.
클라이언트 업데이트는 프로그램을 교체하고, 구독 업데이트는 서버 설정을 교체하거나 보완합니다. 두 업데이트가 해결하는 문제는 다릅니다. 새로운 프로토콜 지원, 인터페이스 변경, 운영체제 호환성 개선은 보통 클라이언트 또는 코어 업데이트에 해당합니다. 서버 주소, 인증 매개변수, 서버 설정 변경은 대개 구독 업데이트로 반영됩니다. 구독만 업데이트해도 오래된 코어가 새 기능을 지원하게 되는 것은 아닙니다. 클라이언트만 업데이트해도 이미 만료된 구독 주소가 복구되지는 않습니다.
구독을 업데이트한 뒤에는 그룹이 그대로 있는지, 현재 서버가 계속 선택되어 있는지, 직접 편집한 항목이 덮어쓰이지 않았는지 먼저 확인하세요. 이름이 같은 항목도 주소나 전송 매개변수가 달라졌을 수 있으므로 필요하면 서비스 제공자의 안내와 대조하세요. 업데이트에 실패했다면 링크 유효 기간, 현재 네트워크에서 구독 내용을 가져올 수 있는지, 응답 형식이 클라이언트에서 지원되는지를 각각 확인하세요. 원인을 확인하기 전에 모든 그룹을 반복해서 삭제하지 마세요.
소프트웨어를 업데이트하기 전에 현재 구독 정보와 사용자 지정 설정을 저장해 둘 수 있습니다. 업데이트를 마친 뒤에는 현재 코어, 시스템 프록시 상태, 라우팅 모드를 확인하세요. 시스템 재시작, 권한 변경, 여러 도구의 동시 실행으로 설정이 달라질 수 있으므로 인터페이스에 스위치가 켜져 있다는 이유만으로 실제 트래픽 경로를 판단해서는 안 됩니다. 문제를 설명할 때는 한 번의 구체적인 실패 과정이 담긴 로그를 사용하고 주소와 인증 정보 등 민감한 내용은 숨기세요.
설정 및 문제 해결 자료
입문, 구독 오류, 연결 시간 초과는 각각 문제 해결 순서가 다릅니다. 먼저 문제가 설치, 설정 가져오기, 실제 연결 중 어느 단계에서 발생했는지 판단한 다음 관련 글을 선택하세요. 전체 작업 과정을 한 번 기록하고 오류 메시지를 구체적으로 확인하는 편이 모드를 반복해서 바꾸는 것보다 문제를 찾기 쉽습니다. 정상적으로 작동하는 설정은 유지하고 테스트를 위해 모든 설정을 지울 필요는 없습니다.
V2Ray와 Xray의 관계부터 클라이언트 선택, 구독 제공 주체, 시스템 프록시와 TUN의 차이까지 정리했습니다. 다운로드 경로는 찾았지만 설정 순서를 잘 모르는 사용자가 기본 개념을 익힌 뒤 첫 연결까지 진행할 수 있도록 순서대로 안내합니다.
글 읽기 →업데이트 결과가 비어 있거나 파싱되지 않고 서버 항목도 생성되지 않는다면 먼저 가져오기 실패와 콘텐츠 형식 문제를 구분하세요. 링크 유효성, 업데이트 경로, 응답 내용, 클라이언트 호환성을 차례로 확인해 기존에 작동하던 설정은 유지하면서 실패 단계의 원인을 찾을 수 있도록 안내합니다.
글 읽기 →기기 네트워크와 시스템 시간부터 확인한 뒤 클라이언트 모드, 노드 매개변수, 전송 보안, DNS, 코어 로그를 살펴보세요. 연결 시간 초과뿐 아니라 연결됨으로 표시되는데 웹페이지가 열리지 않는 경우에도 적용할 수 있습니다. 설정은 하나씩 바꿔 여러 변수가 동시에 변해 원인을 파악하기 어려워지는 일을 방지하세요.
글 읽기 →설치를 시작하기 전이라면 사용 가이드를 먼저 읽고 가져오기, 서버 선택, 트래픽 처리 방식 설정, 연결 확인 순으로 진행하세요. 설정을 가져왔지만 요청이 클라이언트에 들어오지 않는다면 앱의 프록시 설정을 중점적으로 확인하세요. 요청이 들어온 뒤에도 실패한다면 노드 설정, DNS, 로그를 살펴보세요. 고급 설정 예시는 자신의 아웃바운드 및 규칙에 맞게 조정해야 하며, 서비스 제공자가 안내한 연결 정보로 그대로 사용할 수는 없습니다.
특정 개념을 빠르게 확인하려면 용어 안내에서 프로토콜, 전송 방식, 코어, 클라이언트 기능을 찾아보세요. 반복되는 사용 방법이 궁금하다면 도움말을 먼저 확인할 수 있습니다. 두 자료는 이해를 돕기 위한 것으로, 자세한 조작 방법은 사용 가이드와 고급 활용의 전체 절차를 따르세요. 현재 문제를 먼저 파악한 뒤 읽을 자료를 선택하면 설정 페이지를 오가며 불필요하게 시도하는 일을 줄일 수 있습니다.