데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 살펴보세요. 운영체제와 CPU 아키텍처를 확인한 다음 해당 설치 페이지로 이동하세요.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 UI를 사용하고, WPF 버전은 익숙한 창 레이아웃을 유지합니다. 두 버전 모두 서버 관리, 구독 그룹, 라우팅 설정을 중심으로 구성되어 있으므로 UI가 최신인지 여부만으로 선택할 필요는 없습니다.
처음 설치한다면 먼저 시스템 요구 사항과 실행에 필요한 구성 요소를 확인하세요. 기존 설정을 옮길 때는 이전 클라이언트를 종료하고 설정 폴더를 백업해 두세요. 두 인스턴스가 동시에 시스템 프록시를 변경하는 일을 막을 수 있습니다. 브라우저에서는 프록시가 작동하지만 다른 프로그램은 직접 연결되는 경우에 TUN이 필요한지 확인하세요. 처음부터 모든 옵션을 한꺼번에 켜지는 마세요.
다운로드 페이지로 이동v2rayN을 선택하기 전에 시스템의 ‘이 Mac에 관하여’를 열어 칩 또는 프로세서 정보를 확인하세요. Apple Silicon과 Intel은 설치 파일이 다릅니다. 파일 확장자만 보지 말고 하드웨어 아키텍처에 맞는 패키지를 선택하세요.
설치 후 설정을 가져온 다음 시스템 프록시를 테스트하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 적용되며 모든 네트워크 트래픽을 가로채지는 않습니다. TUN을 사용하려면 클라이언트 안내에 따라 권한과 관련 구성 요소도 설정해야 합니다. 권한 부족 메시지가 표시되면 구독 주소를 계속 바꾸지 말고 먼저 권한 문제를 해결하세요.
다운로드 페이지로 이동v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 비교적 최신 기기라면 보통 arm64 버전을 선택합니다. 기기의 아키텍처를 모르겠다면 시스템 정보와 다운로드 페이지의 설명을 확인해 범용 버전을 선택하세요. 코어에 따라 지원하는 설정 항목이 다를 수 있으므로 가져오기에 성공해도 모든 매개변수가 작동하는 것은 아닙니다.
처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다. 화면을 잠근 뒤 연결이 자주 끊긴다면 배터리 최적화, 백그라운드 실행, 자동 시작 설정을 확인하세요. ‘앱별 프록시’에서는 프록시를 적용할 앱을 정합니다. 설정 후 프록시와 우회 중 어떤 쪽이 선택됐는지 확인하고, 다른 VPN 앱이 연결을 사용 중인지도 살펴보세요.
다운로드 페이지로 이동Linux용 v2rayN 다운로드는 deb·rpm 패키지와 CPU 아키텍처에 따라 나뉩니다. Debian·Ubuntu 계열은 보통 deb, Fedora 계열은 보통 rpm을 사용합니다. x64와 arm64도 확인해야 하며, 패키지 형식과 CPU 아키텍처는 별개의 조건입니다.
데스크톱 환경의 프록시 설정과 터미널 프로그램의 프록시 환경 변수는 서로 다른 경로입니다. GUI 클라이언트에서 시스템 프록시가 켜져 있어도 모든 명령줄 도구가 프록시를 사용하는 것은 아닙니다. 먼저 프록시를 명시적으로 지원하는 앱으로 연결을 확인한 뒤 다른 프로그램을 설정하세요. TUN을 사용할 때는 권한과 라우팅, 기존 네트워크 관리 도구의 영향도 확인해야 합니다.
다운로드 페이지로 이동트래픽을 가로채는 방식부터 연결 출구까지, 서로 연관된 5가지 설정을 순서대로 살펴봅니다. 아래는 정적인 UI 예시이며 메뉴 이름은 클라이언트 버전에 따라 달라질 수 있습니다.
v2rayN → 메인 창 하단 → 시스템 프록시
시스템 프록시는 시스템 설정을 따르는 앱의 연결을 클라이언트의 로컬 포트로 전달합니다. v2rayN 메인 창 하단에서 ‘시스템 프록시 자동 설정’을 선택한 뒤 브라우저로 연결을 확인하세요. 도메인별 직결 여부를 정하는 기능은 아니며, 실제 연결 출구는 라우팅 규칙이 결정합니다. TUN보다 변경하는 시스템 네트워크 설정이 적어 기본 연결을 먼저 테스트하기에 적합합니다. 종료하기 전에 ‘시스템 프록시 해제’를 선택할 수 있습니다. 다른 프록시 도구도 실행 중이라면 시스템 설정이 반복해서 덮어써지지 않도록 하나를 종료하세요.
v2rayN → 설정 → 라우팅 설정
라우팅은 클라이언트로 들어온 요청을 어떤 출구로 보낼지 결정합니다. ‘설정 → 라우팅 설정’에서 기존 규칙을 확인한 다음, 명확한 도메인 또는 IP 조건을 추가하세요. 규칙은 대개 순서대로 적용되므로 범위가 넓은 조건을 앞에 두면 뒤쪽의 구체적인 예외 규칙이 적용되지 않을 수 있습니다. Android의 앱별 프록시와 달리 도메인 라우팅은 앱이 아니라 대상 주소를 기준으로 합니다. 문제를 확인할 때는 먼저 트래픽이 클라이언트로 들어왔는지 확인하고, 조건과 규칙 순서, 출구 태그를 점검하세요. 시스템 프록시만 바꿔서는 라우팅 규칙 자체의 오류를 해결할 수 없습니다.
v2rayN → 구독 그룹 → 구독 그룹 설정
구독 그룹은 출처 주소와 업데이트 옵션을 각각 저장하는 기능입니다. ‘구독 그룹 → 구독 그룹 설정’에서 별칭과 주소를 입력하고 저장한 다음 업데이트하세요. 클립보드에서 단일 공유 링크를 가져오는 것과 달리, 구독은 출처 목록을 다시 가져올 수 있고 출처가 바뀌면 로컬 항목도 달라집니다. 출처별로 그룹을 나누고 기본 필터 조건은 우선 그대로 두는 것이 좋습니다. 업데이트에 실패하면 주소가 완전한지, 만료되지는 않았는지, 프록시를 통해 업데이트하도록 설정했는지 확인하세요. 접속 정보가 포함된 구독 주소를 공개 스크린샷이나 로그에 노출하지 마세요.
v2rayN → 메인 창 하단 → Tun 사용
TUN은 가상 네트워크 인터페이스로 트래픽을 가로채 시스템 프록시를 따르지 않는 앱에도 적용할 수 있습니다. 먼저 일반 프록시 연결이 작동하는지 확인한 뒤 클라이언트 안내에 따라 권한을 얻고 ‘Tun 사용’을 켜세요. TUN과 시스템 프록시는 트래픽을 가로채는 범위를 정하는 기능이지, 연결이 끊긴 서버를 복구하는 기능은 아닙니다. 켠 뒤에는 DNS와 LAN 접근도 확인해 다른 VPN이나 가상 네트워크 도구와 라우팅을 두고 충돌하지 않는지 살펴보세요. 시스템 프록시만 바꿀 때보다 점검 범위가 넓으므로 인터넷이 끊기면 먼저 TUN을 꺼서 기본 상태로 되돌린 다음 설정을 하나씩 확인하세요.
v2rayN → 설정 → DNS 설정
DNS는 도메인 이름을 IP 주소로 변환하지만, 시스템과 앱, 프록시 코어가 각각 조회에 관여할 수 있습니다. ‘설정 → DNS 설정’을 바꾸기 전에 문제가 이름 조회인지 연결인지 먼저 구분하세요. 라우팅의 domainStrategy는 라우팅 규칙을 적용할 때 도메인 조회가 필요한지를 제어하며, 시스템 DNS 전체를 바꾸는 설정은 아닙니다. 상위 DNS 서버만 바꾸기보다는 조회 경로와 라우팅 출구를 함께 맞추는 것이 중요합니다. TUN이나 FakeDNS를 사용할 때는 트래픽 가로채기와 도메인 매핑도 확인하세요. 용도를 모르는 설정 조각을 여러 개 그대로 합치지 마세요.
먼저 반복해서 확인할 수 있는 테스트 경로를 만들고, 이후 분할 라우팅 규칙을 추가하세요. 데스크톱은 v2rayN, Android는 v2rayNG를 기준으로 설명합니다.
사용 권한이 있는 구독 주소나 단일 서버 공유 링크를 준비하세요. v2rayN에서 ‘구독 그룹 → 구독 그룹 설정’을 열고 그룹을 추가해 별칭과 주소를 입력한 다음 저장하고 구독을 업데이트합니다. 단일 공유 링크를 받았다면 전체 내용을 복사한 뒤 ‘서버’ 메뉴의 클립보드 가져오기 기능을 사용하세요. 구독 주소 입력란에 넣으면 안 됩니다.
v2rayNG는 메인 화면의 추가 메뉴에서 클립보드 내용을 가져올 수 있으며, 구독은 구독 그룹에서 관리합니다. 완료 후 항목이 예상한 그룹에 표시되는지 확인하세요. 목록이 비어 있다면 DNS를 급히 바꾸기 전에 주소와 필터 조건부터 점검하세요. 클라이언트에는 사용할 수 있는 서버가 포함되어 있지 않습니다. 앱 설치와 연결 설정은 별개의 과정입니다.
v2rayN 서버 목록에서 사용할 설정을 선택하고 활성 서버로 지정했는지 확인한 다음 ‘시스템 프록시 자동 설정’을 선택하세요. 처음 테스트할 때는 ‘LAN 우회’ 같은 기본 라우팅 방식을 사용하고 다른 옵션은 기본값으로 두어 변수를 한꺼번에 늘리지 마세요.
v2rayNG에서 설정을 선택해 연결을 누른 뒤 시스템 VPN 권한을 허용하세요. 앱별 프록시를 켰다면 테스트할 앱이 프록시 적용 범위에 포함되어 있는지 확인해야 합니다. 데스크톱에서는 처음부터 TUN을 함께 켤 필요가 없습니다. 시스템 프록시를 따르지 않는 프로그램까지 연결해야 할 때 TUN을 별도로 테스트하세요. 한 번에 설정 하나만 바꾸면 실패했을 때 직전의 작동 상태로 정확히 되돌릴 수 있습니다.
프록시 설정의 영향을 받는 브라우저로 대상 사이트에 접속한 다음 클라이언트 로그에 해당 연결이 기록되는지 확인하세요. Tcping은 TCP 핸드셰이크 상태를 보여주고, 실제 연결 지연 시간은 프록시 경로를 거치며, 다운로드 속도 테스트는 처리량을 확인합니다. 각각 확인하는 항목이 다르므로 테스트 하나만으로 모든 앱의 연결 여부를 판단할 수 없습니다.
테스트에 실패하면 ‘활성 설정 → 트래픽 처리 방식 → 라우팅 → DNS’ 순서로 확인하세요. 브라우저는 정상인데 특정 프로그램만 실패한다면 해당 프로그램이 시스템 프록시를 사용하는지 먼저 살펴보세요. 화면을 잠근 뒤 연결이 끊긴다면 백그라운드 제한을 확인하세요. 연결이 안정되면 설정을 백업하고 필요한 항목을 기록해 두세요. 이후 변경 사항을 비교할 기준으로 활용할 수 있습니다.
클라이언트는 조작 화면을 제공하고 코어는 연결과 라우팅을 처리합니다. 각자의 역할을 이해하면 설정 메뉴 위치를 외우는 것보다 문제 해결에 도움이 됩니다.
GUI → CORE → OUTBOUND
먼저 플랫폼을 선택하고 코어 호환성을 확인하세요. 프로토콜, 전송 방식, 보안 매개변수는 서로 맞춰 설정해야 합니다.
클라이언트 3종 비교 보기 →Project V는 네트워크 프록시 도구를 중심으로 한 프로젝트 생태계이며 V2Ray는 널리 쓰이는 핵심 소프트웨어입니다. V2Fly 커뮤니티가 관련 개발을 이어가고 있고, Xray는 공통 기술 기반에서 자체 구현과 기능을 발전시켰습니다. 설정 개념이 비슷하더라도 모든 항목과 프로토콜 기능, 기본 동작이 완전히 같다고 볼 수는 없습니다. 가이드를 참고할 때는 앱 이름만 보지 말고 현재 클라이언트가 실제로 사용하는 코어를 확인하세요.
‘프로토콜’, ‘전송 방식’, ‘보안 설정’은 서로 다른 계층입니다. 프로토콜은 연결 양쪽이 프록시 요청을 주고받는 방식을, 전송 방식은 데이터가 전달되는 통로를 설명합니다. TLS 등의 설정은 연결 보안과 관련됩니다. 가져온 설정으로 연결되지 않는다면 서버 측 요구 사항을 항목별로 확인하세요. 프로토콜 이름만 바꾸거나 기능 스위치를 하나 더 켜는 것으로 빠진 서버 매개변수를 보완할 수는 없습니다.
v2rayN은 데스크톱용 클라이언트로 서버 목록, 구독 그룹, 라우팅 관리, 시스템 프록시 설정을 GUI에서 제공합니다. 다양한 하위 설정을 메뉴로 조작할 수 있지만 실제 기능은 선택한 코어와 운영체제, 관련 구성 요소에 따라 달라집니다. 크로스 플랫폼 데스크톱 버전과 클래식 WPF 버전은 우선 UI 기술과 지원 플랫폼이 다릅니다. UI 이름만으로 프로토콜 호환 여부를 단정하지 마세요.
v2rayNG는 Xray 코어를 사용하는 Android 클라이언트이며, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. Android는 VpnService 권한으로 트래픽을 가로채고, 데스크톱은 시스템 프록시나 가상 인터페이스 등 다른 방식을 사용합니다. 따라서 같은 공유 링크를 여러 기기에서 가져올 수 있어도 권한, 백그라운드 실행 유지, 앱별 트래픽 설정까지 그대로 적용되는 것은 아닙니다. 플랫폼을 바꾼 뒤에는 연결 확인 절차를 다시 진행하세요.
v2rayN·v2rayNG·v2flyNG 클라이언트 프로젝트는 GPL-3.0 오픈 소스 라이선스를 사용합니다. 라이선스 조건에 따라 코드를 열람하고 사용·수정·배포할 수 있습니다. 수정한 버전을 배포할 때는 관련 소스 코드 공개와 라이선스 의무도 따라야 합니다. 클라이언트에서 사용하는 코어와 기타 구성 요소는 각자 다른 라이선스를 적용받을 수 있으므로 클라이언트 라이선스를 전체 의존성에 일괄 적용할 수는 없습니다.
오픈 소스 여부와 원격 서비스 품질은 별개로 살펴봐야 합니다. 클라이언트는 설정과 연결 기능을 제공하고, 구독 정보는 해당 출처에서 관리하며, 서버의 가용성은 원격 설정과 계정 상태, 네트워크 환경에 따라 달라집니다. 이 페이지에서는 클라이언트 선택과 사용법을 안내하며 구독 계정은 제공하지 않습니다. 연결 문제를 확인할 때는 소프트웨어, 설정 출처, 원격 서비스를 나누어 점검해야 원인을 명확히 파악할 수 있습니다.
클라이언트와 코어, 규칙 데이터는 서로 다른 주기로 업데이트될 수 있습니다. UI 업데이트로 메뉴 위치가 바뀌거나 코어 업데이트로 지원 설정 항목이 달라질 수 있으며, 규칙 데이터 변경은 도메인 분류와 라우팅 결과에 영향을 줄 수 있습니다. 업데이트 전에 현재 트래픽 처리 방식과 라우팅 선택, 사용자 지정 DNS를 기록하고 클라이언트 설정을 백업하세요. 구독 주소는 안전하게 보관하고 백업 파일을 공개적으로 공유하지 마세요.
업데이트 후에는 기존 기본 연결이 작동하는지 먼저 확인하고 구독 그룹과 사용자 지정 규칙이 유지됐는지 살펴보세요. 문제가 새로 발생하면 오류 내용과 재현 절차를 기록하고 코어, 라우팅, DNS를 연달아 바꾸지 마세요. 다운로드 페이지에서는 플랫폼과 아키텍처별 설치 방법을 확인할 수 있습니다. 심화 가이드에서는 설정 간 관계를 설명하므로 UI가 바뀌어도 해당 개념을 찾아볼 수 있습니다.
용어가 낯설다면 먼저 용어집에서 시스템 프록시, TUN, DNS, 라우팅을 구분하고, 자주 묻는 질문에서 증상에 맞는 해결 방법을 찾아보세요. 여러 구독을 관리하거나 사용자 지정 출구를 추가해야 할 때는 심화 가이드를 확인하세요. 처음 연결하는 단계에서 복잡한 설정을 한꺼번에 적용하지 않는 것이 좋습니다.
구독 업데이트와 공유 링크, Android 설정을 중심으로 설정 화면만으로 알기 어려운 점검 방법을 안내합니다.
구독 문제를 순서대로 점검하세요. 주소 만료, 인코딩 형식 미지원, 프록시를 통한 업데이트 설정, 시스템 시간 오차, 필터 규칙으로 항목이 삭제되는 경우를 살펴보고 각 설정 위치를 안내합니다.
구독 문제 해결 노트 보기 →단일 서버 공유 링크와 구독 주소의 구조 차이를 설명하고, v2rayN·v2rayNG에서 클립보드로 링크를 가져오고 구독 그룹을 추가하는 방법과 주의 사항을 안내합니다.
링크 가져오기 안내 보기 →v2rayNG 첫 연결 시 표시되는 VpnService 권한 요청, 제조사별 백그라운드 배터리 제한을 예외 목록에 추가하는 방법, 앱별 프록시의 우회·프록시 모드를 설명합니다.
Android 설정 노트 보기 →