기기에 맞는 오픈 소스 클라이언트를 선택하고, 구독 가져오기부터 라우팅까지 실제 메뉴에 따라 설정하세요.
먼저 세 가지를 구분하세요. 클라이언트는 설정을 관리하고, 코어는 연결을 처리하며, 라우팅은 트래픽의 경로를 결정합니다.
설정 둘러보기
구독 업데이트가 성공했다는 것은 서버 설정을 가져왔다는 뜻일 뿐입니다. 앱에서 프록시를 사용하려면 활성 서버, 라우팅 프리셋, 트래픽 연결 방식도 올바르게 설정해야 합니다. 왼쪽 메뉴를 따라가며 기본 연결부터 확인한 다음 필요에 따라 TUN, DNS, 사용자 지정 규칙을 설정하세요. 버전에 따라 메뉴 위치가 조금 다를 수 있으니 실제 클라이언트 화면을 기준으로 진행하세요.
구독 그룹
구독 그룹을 사용하면 소스별로 서버를 나눠 관리할 수 있어 업무용과 테스트용 설정을 함께 보관하기 좋습니다. ‘구독 그룹 설정’에서 그룹 이름과 구독 주소를 추가한 뒤 해당 업데이트 메뉴를 실행하세요. 업데이트 후에는 현재 그룹 필터를 확인하세요. 목록이 비어 있다고 가져오기에 실패한 것은 아닐 수 있습니다. 직접 연결로 업데이트되지 않으면 사용 가능한 연결이 있는지 확인한 뒤 프록시를 통해 업데이트해 보세요. 구독 주소에는 계정 정보가 포함될 수 있으므로 화면 캡처나 공개 로그에 노출하지 마세요. 서버 항목을 삭제해도 구독이 취소되는 것은 아니며, 다음 업데이트 때 다시 나타날 수 있습니다.
가이드 보기 →라우팅 프리셋 예시
라우팅은 코어에 전달된 요청을 프록시로 보낼지, 직접 연결할지, 차단할지 결정합니다. 먼저 라우팅 설정에서 프리셋을 선택한 다음 필요한 도메인·주소·포트 규칙을 추가하세요. 규칙을 한꺼번에 많이 넣는 것보다 문제를 찾기 쉽습니다. ‘중국 본토 우회’는 해당 도메인 및 주소 데이터에 의존하며 앱별 라우팅을 뜻하지 않습니다. ‘전역’도 코어에 들어온 트래픽에만 적용됩니다. 사용자 지정 규칙은 일반적으로 순서대로 적용되므로 구체적인 예외를 포괄적인 규칙보다 앞에 두세요. 변경 후에는 같은 대상으로 다시 테스트하고 로그에서 실제로 선택된 아웃바운드를 확인하세요.
가이드 보기 →트래픽 연결 방식
TUN은 가상 네트워크 인터페이스를 통해 트래픽을 연결하므로 시스템 프록시 설정을 따르지 않는 앱에 유용합니다. 다만 처음 연결할 때 가장 먼저 설정할 기능은 아닙니다. 일반 프록시 연결이 되는지 확인한 뒤 실행 권한, 가상 인터페이스, 다른 네트워크 도구와의 충돌을 점검하고 마지막으로 ‘TUN 모드 사용’을 켜세요. TUN을 켜도 아웃바운드는 라우팅 규칙에 따라 결정되며 모든 연결이 반드시 프록시를 거치는 것은 아닙니다. 인터넷이 끊기면 먼저 TUN을 끄고 네트워크를 복구한 다음 라우팅, DNS, 인터페이스 상태를 차례로 확인하세요. 네트워크를 바꾼 뒤에도 다시 테스트하고, 한 번에 여러 설정을 변경하지 마세요.
가이드 보기 →서버 목록 · 마우스 오른쪽 버튼 메뉴
실제 연결 테스트는 서버를 통해 테스트 대상에 접속하므로 단순 네트워크 왕복 시간보다 실제 사용 환경에 가깝습니다. 서버를 선택하고 마우스 오른쪽 버튼 메뉴에서 실제 연결 지연 시간 테스트를 실행하세요. 먼저 연결이 완료되는지 확인한 뒤 같은 네트워크에서 여러 차례 측정한 결과를 비교하세요. 한 번의 시간 초과는 테스트 대상, 도메인 확인 또는 일시적인 네트워크 불안정 때문일 수 있으며 설정이 잘못됐다고 단정할 수 없습니다. 지연 시간은 다운로드 속도와도 다릅니다. 활성 서버를 선택한 후 브라우저에서 접속을 확인하고 시스템 프록시 상태가 현재 사용 방식과 일치하는지 점검하세요.
가이드 보기 →코어 선택
클라이언트 화면과 프록시 코어는 서로 다른 계층입니다. v2rayN은 여러 코어를 관리할 수 있지만, 선택 가능한 항목은 배포판과 서버 프로토콜에 따라 달라집니다. 코어 전환이 모든 문제를 해결하는 것은 아닙니다. 매개변수 설정이나 코어 설정에서 선택하기 전에 현재 서버의 프로토콜, 전송 방식, 보안 옵션을 확인하고 대상 코어가 이를 지원하는지 살펴보세요. 전환 후 설정을 다시 불러오고 시작 로그를 확인하세요. 알 수 없는 항목이나 지원되지 않는 전송 방식이 표시되면 설정 호환성을 점검해야 합니다. 모바일 클라이언트 두 종류는 각각 다른 방식으로 코어를 선택합니다.
가이드 보기 →시스템 프록시 메뉴
시스템 프록시는 시스템 설정을 따르는 앱이 요청을 로컬 프록시 포트로 보내도록 합니다. 라우팅 모드는 코어에 도착한 요청을 어떻게 처리할지 결정합니다. 활성 서버를 선택한 뒤 ‘시스템 프록시 자동 설정’을 적용하고 브라우저에서 연결을 확인하세요. 시스템 프록시를 무시하는 앱은 앱 내부에서 프록시를 지정하거나 TUN 사용을 고려해야 합니다. 종료 후 인터넷에 연결되지 않으면 시스템 프록시가 로컬 포트를 가리키는 상태로 남아 있는지 확인하고 ‘시스템 프록시 해제’를 실행하세요. 프록시 도구를 여러 개 동시에 실행하면 설정이 서로 덮어쓸 수 있으므로 문제를 확인할 때는 트래픽을 제어하는 도구를 하나만 사용하세요.
가이드 보기 →플랫폼별 다운로드
데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 먼저 확인하세요. v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 설치 패키지의 프로세서 아키텍처가 기기와 일치해야 합니다. 같은 클라이언트의 패키지 종류가 다르다고 구독 서비스까지 달라지는 것은 아닙니다. 아래 링크를 선택하면 다운로드 페이지의 해당 플랫폼으로 이동합니다. 패키지 종류, 시스템 요구 사항, 설치 안내를 확인하세요.
v2rayN · 데스크톱 버전 / 클래식 WPF 버전
데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 클래식한 데스크톱 구성을 유지합니다. 먼저 운영체제와 프로세서 요구 사항을 확인한 뒤 익숙한 인터페이스를 선택하세요. 두 버전을 모두 설치할 필요는 없습니다. 처음에는 ‘서버’, ‘구독 그룹’, 하단의 시스템 프록시 메뉴를 살펴보고 활성 서버를 확인한 뒤 연결하세요.
다른 폴더에서 옮겨 올 때는 클라이언트에서 먼저 설정을 백업하세요. 실행 중인 프로그램 폴더를 그대로 덮어쓰지 마세요. 처음 실행할 때 권한이나 실행 환경 관련 안내가 나오면 다운로드 페이지의 패키지 설명을 따르고 로그도 확인하세요. 시작 문제를 구독 오류로 오해하지 않도록 주의하세요.
다운로드 페이지로 이동v2rayN · Apple Silicon / Intel
먼저 시스템의 ‘이 Mac에 관하여’에서 칩을 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택합니다. 설치 후에는 일반 권한으로 구독 가져오기와 기본 연결을 확인하고, TUN이 필요할 때 안내에 따라 관련 권한을 설정하세요. 아키텍처가 맞지 않아 발생한 시작 오류는 서버 설정과 직접적인 관련이 없습니다.
시스템 프록시의 적용 범위는 앱이 시스템 설정을 따르는지에 따라 달라집니다. 브라우저는 접속되지만 다른 앱은 실패한다면 전체 라우팅을 초기화하지 말고 먼저 앱 내부의 네트워크 옵션을 확인하세요. 시스템 보안 경고가 표시되면 설치 출처와 경고 내용을 확인하고, 시스템 보호 기능 전체를 끄지 않는 것이 좋습니다.
다운로드 페이지로 이동v2rayNG 우선 · v2flyNG 대안
v2rayNG는 Xray 코어를 사용하고, v2flyNG는 V2Fly 코어를 선택할 수 있습니다. 대부분의 최신 스마트폰에는 arm64가 적합합니다. 아키텍처를 모르면 먼저 기기 정보를 확인한 뒤 범용 패키지를 고려하세요. 구독을 가져온 다음 구성을 선택하고 연결 버튼을 누른 뒤 시스템 안내에 따라 VPN 연결을 허용하세요.
안드로이드의 VPN 연결은 데스크톱의 시스템 프록시와 같은 설정이 아닙니다. 다른 VPN 앱, 백그라운드 제한, 앱별 프록시 설정이 연결에 영향을 줄 수 있습니다. 화면을 잠근 뒤 연결이 끊기면 백그라운드 실행 정책을 먼저 확인하세요. 일부 앱만 접속되지 않는다면 앱별 프록시 목록을 점검하고 구독을 반복해서 삭제하거나 다시 설치하지 마세요.
다운로드 페이지로 이동v2rayN · deb / rpm
배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택한 뒤 x64와 arm64를 구분하세요. 그래픽 설치를 마치면 클라이언트가 실행되는지, 코어가 정상적으로 로드되는지 확인한 다음 설정을 가져오세요. 데스크톱 환경마다 프록시 설정 위치가 다를 수 있으므로 클라이언트가 실행된다는 이유만으로 모든 앱이 연결됐다고 판단하지 마세요.
TUN이 필요하다면 권한, 가상 네트워크 인터페이스, 기존 네트워크 관리 도구와의 호환성을 따로 확인하세요. 회사 네트워크, 컨테이너, 가상 머신 환경에는 추가 라우팅이 있을 수 있으므로 변경 전에 현재 상태를 기록하세요. 시스템 프록시로 기본 연결을 확인한 뒤 적용 범위를 단계적으로 넓히면 이전 설정으로 되돌리기 쉽습니다.
다운로드 페이지로 이동클라이언트는 설정을 읽고 트래픽을 연결하는 역할을 하며, 연결에 필요한 매개변수는 별도로 준비해야 합니다. 이 사이트는 클라이언트 다운로드 링크와 사용 안내를 제공하며 구독 서비스는 제공하지 않습니다.
전체 클라이언트 보기 →오픈 소스 생태계
V2Ray는 Project V의 모듈형 프록시 도구 생태계에서 시작했습니다. 이 배경을 이해하려면 먼저 그래픽 클라이언트와 코어를 구분해야 합니다. 화면의 서버 목록, 구독 관리, 메뉴는 클라이언트에 속하고, 프로토콜 처리와 라우팅 규칙 적용, 아웃바운드 연결은 주로 코어가 담당합니다. 클라이언트는 화면에서 선택한 항목을 코어가 읽을 수 있는 설정으로 변환하고 관련 프로세스를 실행 및 관리합니다.
V2Fly는 V2Ray의 커뮤니티 유지 관리 흐름을 이어가며, Xray는 관련 기술을 바탕으로 발전한 별도의 코어 계열입니다. 두 코어는 설정 방식과 일부 프로토콜의 기반을 공유하지만 기능 발전 방향, 설정 항목, 전송 방식 지원은 완전히 같지 않습니다. 같은 프로토콜 이름을 사용하더라도 보안 계층, 전송 방식, 세부 옵션을 확인해야 합니다. 코어 이름만 바꾸면 설정을 그대로 교체할 수 있다고 단정하지 마세요.
따라서 클라이언트를 선택할 때는 두 가지를 먼저 확인하세요. 기기에 적합한 그래픽 인터페이스가 무엇인지, 현재 연결 매개변수에 어떤 코어 기능이 필요한지입니다. 데스크톱에서는 v2rayN의 코어 설정에서 지원 범위를 확인하고, 모바일에서는 v2rayNG 또는 v2flyNG에서 적합한 코어를 선택하세요. 코어 계열은 속도 순위가 아닙니다. 실제 사용 환경은 네트워크 상태, 서버 상태, DNS, 라우팅 설정에도 영향을 받습니다.
프로토콜 및 코어 용어 보기 →v2rayN, v2rayNG, v2flyNG는 모두 소스 코드를 공개하는 그래픽 클라이언트지만, 같은 프로그램의 스킨만 다른 것은 아닙니다. v2rayN은 데스크톱 기기에서 서버, 구독, 실행 설정을 관리합니다. v2rayNG는 Xray의 연결 기능을 안드로이드 네트워크 인터페이스에 연결하고, v2flyNG는 V2Fly 코어가 필요한 모바일 설정에 사용됩니다. 사용 방식은 참고할 수 있지만 메뉴와 설정 항목은 각각 확인해야 합니다.
오픈 소스 라이선스는 코드의 사용, 수정, 배포 조건을 정합니다. v2rayN과 v2rayNG의 클라이언트 코드는 GPL 계열 라이선스를 사용하며, v2flyNG의 클라이언트 코드도 GPL 계열 라이선스를 사용합니다. 호출되는 코어와 포함된 의존성은 각각의 라이선스에 따라 배포됩니다. V2Fly의 V2Ray 코어는 MIT 라이선스, Xray 코어는 MPL 계열 라이선스를 사용하므로 클라이언트 라이선스를 모든 구성 요소에 그대로 적용할 수는 없습니다.
오픈 소스라고 해서 설치 후 설정이나 유지 관리가 필요 없는 것은 아닙니다. 클라이언트는 실제로 제공된 연결 매개변수만 사용할 수 있으며 서버 설정을 대신하거나 모든 구독의 작동을 보장하지 않습니다. 문제가 생기면 가져오기, 시작, 트래픽 연결, 대상 접속 중 어느 단계에서 발생했는지 먼저 확인하세요. 클라이언트 이름만 보고 반복해서 전환하는 것보다 해당 설정을 점검하는 편이 효과적입니다. 사이트의 소개 페이지에서 콘텐츠 범위와 관리 원칙을 확인할 수 있습니다.
클라이언트 업데이트는 주로 인터페이스, 설정 관리, 프로그램 수정에 관련됩니다. 코어 업데이트는 프로토콜 구현과 연결 동작에 영향을 주고, GeoIP·GeoSite 같은 규칙 데이터 업데이트는 주소 또는 도메인 집합의 매칭에 영향을 줍니다. 세 종류의 업데이트 주기는 서로 다를 수 있습니다. 새 클라이언트를 다운로드해도 기존 규칙 데이터가 함께 업데이트되는 것은 아닙니다. 구독 업데이트는 서버 설정을 다시 가져올 뿐 로컬 수신 포트가 사용 중인 문제를 자동으로 해결하지 않습니다.
업데이트 전에 클라이언트의 백업 또는 내보내기 기능으로 설정을 저장하고 활성 서버, 라우팅 프리셋, 시스템 프록시 상태, 사용자 지정 규칙을 기록하세요. 업데이트 후에는 이전에 작동했던 연결 하나를 다시 테스트한 다음 라우팅과 DNS를 확인하세요. 시작에 실패하면 로그에서 가장 먼저 나타난 오류를 확인하세요. 포트 충돌, 권한 부족, 설정 항목 비호환은 각각 해결 방법이 다르므로 모두 네트워크 불안정 탓으로 돌리지 마세요. 규칙 데이터베이스는 GeoIP 및 GeoSite 업데이트 안내를 참고하세요.
‘연결됨’은 보통 로컬 프록시나 네트워크 인터페이스가 시작됐다는 뜻이지, 모든 대상에 접속할 수 있다는 의미는 아닙니다. 브라우저 접속에 실패하면 먼저 활성 서버와 실제 연결 테스트 결과를 확인하고 앱이 시스템 프록시를 사용하는지 점검하세요. 일부 도메인만 문제가 있다면 DNS, 규칙 순서, 해당 아웃바운드를 확인하세요. 데스크톱 클라이언트를 종료한 뒤에도 일반 웹사이트에 접속할 수 없다면 시스템에 로컬 포트를 가리키는 프록시 설정이 남아 있는지 살펴보세요.
모바일 기기에서 화면을 잠근 뒤 연결이 끊긴다면 백그라운드 실행 제한이 원인일 수 있습니다. 화면이 켜져 있어도 테스트가 완료되지 않으면 연결 매개변수와 다른 VPN 앱과의 충돌부터 확인하세요. 문제가 발생한 시각, 발생 전후의 변경 사항, 필요한 오류 문구를 기록하되 구독 주소와 계정 정보는 가리세요. 전체 문제 해결 절차는 FAQ에서 확인하세요. 라우팅, 아웃바운드, 전송 방식 같은 용어가 낯설다면 먼저 용어집을 읽은 뒤 빠른 시작 가이드에 따라 검증 가능한 기본 설정을 복원하세요.
가이드 새 소식
최근 가이드 세 편을 소개합니다. 구독을 가져왔지만 프록시가 작동하는지 확실하지 않다면 첫 연결 안내부터 확인하세요. 시작 오류와 백그라운드 연결 끊김은 각각 로컬 포트 문제와 모바일 실행 설정을 다룹니다. 문제가 발생한 위치에 맞는 글을 선택하고 안내된 순서대로 점검하면 모든 문제를 같은 연결 오류로 취급하는 일을 줄일 수 있습니다.
구독을 가져온 뒤 서버를 선택하고 실제 연결 테스트로 사용 가능 여부를 비교하는 방법, 브라우저와 시스템 프록시 상태로 트래픽이 프록시를 거치는지 확인하는 방법을 안내합니다.
글 읽기 →안드로이드에서 v2rayNG의 배터리 소모가 커지는 주요 원인을 살펴보고 배터리 최적화 예외, 백그라운드 실행 제한, 앱별 프록시 설정을 조정하는 방법을 설명합니다.
글 읽기 →시작 오류로 로컬 포트 충돌을 확인하고 시스템 명령으로 10808/10809 포트를 사용하는 프로세스를 찾은 뒤 v2rayN 매개변수 설정에서 사용 가능한 포트로 변경하는 방법을 안내합니다.
글 읽기 →