오픈 소스 클라이언트 · 다운로드 및 설정

V2Ray 입문 가이드v2rayN 다운로드 및 설정

구독 가져오기부터 라우팅까지, 실제 설정 항목에 따라 데스크톱 및 Android 클라이언트를 설정하세요.

  • VMess
  • VLESS
  • Trojan
  • REALITY
  • Shadowsocks

v2rayN 핵심 설정

먼저 구독을 정리한 다음 트래픽 경로를 설정하세요. 한 번에 한 종류씩 변경하고, 언제든 되돌릴 수 있도록 설정을 보관하세요.

Subscription / Filter

출처별로 그룹을 나누고 이름으로 필터링

홍콩|일본
(?i)hongkong|japan
^(?!.*테스트).*$

구독 그룹은 출처를 구분하고, 서버 필터는 현재 목록의 범위를 좁힙니다. 알아보기 쉬운 메모를 그룹에 입력한 뒤 구독 주소를 추가하세요. 업데이트가 완료되면 “홍콩|일본”으로 이름에 두 키워드 중 하나가 포함된 서버를 찾을 수 있습니다. 영문 대소문자는 인라인 표시로 처리할 수 있지만, 실제 지원 여부는 사용 중인 클라이언트에서 확인하세요. 필터 결과가 비어 있으면 식을 지우고 확인하세요. 구독을 바로 삭제할 필요는 없습니다. 서버를 하나씩 직접 가져오는 것보다 그룹으로 관리하면 출처가 유지되어 이후 업데이트와 문제 해결이 편리합니다. 구독 주소에 접근 정보가 포함될 수 있으므로 스크린샷을 공유하거나 로그를 전달하기 전에 전체 주소를 가리세요.

Client / Platform

플랫폼에 맞는 클라이언트 선택

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 살펴보세요. 설치 패키지 형식과 CPU 아키텍처는 다운로드 페이지에서 각각 확인할 수 있습니다.

Windows

v2rayN · 데스크톱 추천

구독 그룹, 시스템 프록시, 세부 라우팅을 관리하려는 데스크톱 사용자에게 적합합니다. 다운로드 페이지에서 차세대 크로스 플랫폼 GUI 버전과 클래식 인터페이스를 유지하는 WPF 버전을 선택할 수 있습니다. 두 버전은 같은 클라이언트의 서로 다른 인터페이스이며, 프록시를 사용하려고 둘 다 설치할 필요는 없습니다.

먼저 시스템 설정에서 CPU 아키텍처를 확인한 뒤 해당하는 다운로드 항목을 선택하세요. 처음 실행하면 구독을 가져오고 서버를 선택한 다음, 일반 시스템 프록시가 작동하는지 확인하고 TUN 사용을 검토하세요. 프로그램은 실행되지만 브라우저가 연결되지 않는다면 시스템 프록시가 클라이언트의 실제 수신 주소와 포트를 가리키는지 확인하세요. 같은 구독을 반복해서 가져오는 것만으로는 해결되지 않습니다.

인터페이스 버전을 바꾸기 전에는 구독 그룹과 라우팅 설정을 백업하고 기존 설정을 기록하세요. 두 클라이언트가 동시에 시스템 프록시를 수정하지 않도록 주의해야 합니다. 문제 해결을 마치거나 종료할 때는 프록시 설정이 의도한 상태로 복원됐는지도 확인하세요. 설정이 남아 있으면 이미 중지된 로컬 포트에 앱이 계속 접속을 시도할 수 있습니다.

다운로드 페이지로 이동

macOS

v2rayN · CPU별 패키지

데스크톱에서 구독, 라우팅, 프록시 모드를 한곳에서 관리하려는 사용자에게 적합합니다. 먼저 “이 Mac에 관하여”에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel은 x64 다운로드 항목을 선택하면 됩니다. 기기 외관이나 구매 연도로 아키텍처를 추측하지 말고 실제 하드웨어에 맞는 패키지를 선택하세요.

처음 실행할 때 시스템 보안 경고가 표시되면 먼저 설치 파일의 출처를 확인하고, 시스템의 “개인정보 보호 및 보안” 안내에 따라 처리하세요. 네트워크 접근, 시스템 프록시, 가상 네트워크 인터페이스는 서로 다른 권한입니다. 일반 프록시가 연결된다고 TUN에 필요한 권한까지 허용된 것은 아닙니다. 현재 화면의 안내에 따라 항목별로 권한을 부여하는 편이 반복해서 재설치하는 것보다 효과적입니다.

다른 컴퓨터에서 설정을 옮길 때는 구독을 먼저 가져온 다음 로컬 포트, 규칙 파일, 경로 설정을 확인하세요. 이전 기기의 절대 경로는 새 기기에서 그대로 사용할 수 없을 수 있습니다. 첫 실행이 차단되는 문제는 플랫폼별 안내를 참고해 보안 경고와 네트워크 권한을 순서대로 확인하세요. 시스템 보안 설정 전체를 바로 변경할 필요는 없습니다.

다운로드 페이지로 이동

Android

v2rayNG 추천 · v2flyNG 대안

v2rayNG는 Xray 커널을, v2flyNG는 V2Fly 커널을 사용합니다. 두 클라이언트 모두 오픈 소스 GUI 앱입니다. 클라이언트 이름이 비슷하다고 같은 제품으로 보지 말고, 구독에 포함된 프로토콜과 설정 호환성, 필요한 앱 설정을 기준으로 선택하세요. 최근 출시된 일반적인 스마트폰은 대체로 arm64를 사용합니다. 아키텍처를 모른다면 먼저 기기 정보를 확인한 뒤 범용 패키지를 고려하세요.

처음 연결할 때 시스템에서 VPN 연결 권한을 요청합니다. Android의 VpnService 인터페이스를 사용하는 방식이므로 시스템에 내장된 VPN 설정을 따로 입력할 필요는 없습니다. 네트워크를 가로채는 앱은 한 번에 하나만 실행하세요. 백그라운드에서 일정 시간 후 연결이 끊긴다면 배터리 최적화, 백그라운드 활동 제한, 제조사별 자동 실행 관리 설정을 확인하세요.

일부 앱에만 프록시를 적용하려면 먼저 앱별 프록시 목록이 “포함” 방식인지 “제외” 방식인지 확인한 다음 대상 앱을 선택하고 연결을 다시 설정하세요. 앱이 트래픽 가로채기 대상인지와 해당 연결이 최종적으로 어떤 출구를 사용하는지는 별개의 문제입니다. 전자는 가로채기 범위로 결정되고, 후자는 라우팅 규칙에 따라 달라집니다. 자세한 절차는 Android 플랫폼 가이드를 참고하세요.

다운로드 페이지로 이동

Linux

v2rayN · 배포판에 맞는 패키지 선택

GUI에서 구독과 라우팅을 관리하려는 데스크톱 사용자에게 적합합니다. 다운로드 페이지에서 deb 및 rpm 패키지를 제공하며 x64와 arm64 아키텍처를 구분합니다. 먼저 배포판에서 사용하는 패키지 형식을 확인하고 컴퓨터의 아키텍처를 확인하세요. 패키지 형식과 커널의 프로토콜 지원은 별개의 문제이므로 패키지 확장자를 바꿔도 설정 호환성은 해결되지 않습니다.

설치 후 클라이언트 화면에서 구독을 가져오고 커널이 정상적으로 시작되는지 확인하세요. 시스템 프록시 적용 여부는 데스크톱 환경과 앱에 따라 다르며 일부 프로그램은 별도 설정이 필요합니다. TUN을 켜려면 가상 네트워크 인터페이스 권한, 기존 라우팅, 다른 네트워크 가로채기 도구를 확인하고 원래 네트워크 상태로 되돌릴 방법을 마련하세요.

브라우저는 연결되지만 다른 프로그램이 연결되지 않는다면 해당 프로그램이 데스크톱 프록시 설정을 읽는지 먼저 확인한 뒤 앱 프록시를 설정할지 TUN을 사용할지 결정하세요. 클라이언트가 시작되지 않으면 로그에 표시된 권한, 의존성, 설정 필드 관련 안내부터 확인하세요. GUI가 실행되지 않는 문제와 원격 서버에 연결할 수 없는 문제를 혼동하지 마세요. 배포판별 요구 사항은 다운로드 페이지의 안내와 실제 시스템 메시지를 기준으로 확인하세요.

다운로드 페이지로 이동

클라이언트 전체 보기 →어떤 클라이언트를 쓸지 모르겠다면 선택 가이드부터 확인하세요.

Project V, V2Fly, Xray

프로젝트와 커널, 클라이언트를 구분한 뒤 설정을 어디에서 바꿀지 판단하세요.

생태계 구조

Project V
프로젝트 및 도구 체계
V2Fly / Xray
커널 구현과 각 프로젝트의 발전
v2rayN / v2rayNG / v2flyNG
사용자용 GUI 클라이언트
클라이언트와 커널 비교 →

V2Ray 프로젝트에서 커널 계열까지

Project V는 프록시 통신을 중심으로 구성된 프로젝트 생태계이며 V2Ray는 그중 널리 알려진 도구입니다. 커뮤니티가 성장하면서 V2Fly 커뮤니티가 V2Ray의 유지 관리와 발전을 이어 왔고, Xray는 관련 코드 기반에서 독립된 포크로 출발해 자체 기능과 설정 지원을 발전시켰습니다. 이 관계를 이해하면 세 이름을 같은 소프트웨어의 별칭으로 오해하지 않을 수 있습니다. 공통된 기술적 배경은 있지만 현재 지원하는 설정 기능은 각각 확인해야 합니다. 한 포크에 추가된 기능을 다른 포크에서도 사용할 수 있다고 단정하지 마세요.

일상적인 대화에서 “V2Ray 구독”은 여러 프록시 서버 설정을 통칭하는 말로 자주 쓰이지만, 이 표현만으로 모든 클라이언트가 내용을 해석할 수 있는 것은 아닙니다. 구독에는 여러 프로토콜과 전송 방식, 보안 매개변수가 포함될 수 있으며 클라이언트는 이 정보를 대상 커널이 인식하는 설정으로 변환해야 합니다. 따라서 가져오기에 성공한 것은 첫 단계일 뿐입니다. 선택한 서버의 매개변수가 모두 갖춰졌는지, 커널이 정상적으로 시작됐는지, 실제 연결이 예상한 아웃바운드를 사용하는지 확인하세요.

클라이언트는 관리하고 커널은 실행합니다

v2rayN은 데스크톱 GUI에서 구독 그룹을 정리하고 서버를 선택하며 라우팅과 프록시 모드를 관리할 수 있습니다. 실제 네트워크 기능은 사용하는 커널과 관련 구성 요소에 따라 달라지므로 현재 배포 패키지와 화면에 표시되는 옵션을 기준으로 확인하세요. v2rayNG는 Android에서 Xray 커널을 사용하는 오픈 소스 클라이언트이며, v2flyNG는 V2Fly 커널을 사용하는 Android 대안입니다. 세 클라이언트 모두 GUI를 주된 조작 방식으로 사용하지만 메뉴 위치, 가져오기 형식, 고급 옵션은 서로 다를 수 있습니다. 가이드의 설정 이름을 실제 화면과 대조해 확인하세요.

REALITY 프로토콜 설정을 다룰 때는 프로토콜, 전송 계층, 보안 방식을 구분해야 합니다. REALITY는 아무 서버에서나 버튼 하나로 켤 수 있는 범용 가속 옵션이 아닙니다. 연결 양쪽에서 서로 호환되는 설정과 구현을 지원해야 합니다. 구독에서 제공한 주요 매개변수를 경험에 의존해 변경하지 마세요. 필요한 값이 없다면 먼저 설정 출처를 확인하세요. 클라이언트 아이콘을 바꾸거나 인터페이스 버전을 전환해도 원격 설정이 자동으로 채워지거나 서버의 프로토콜 지원이 달라지지는 않습니다.

오픈 소스 라이선스의 의미

오픈 소스란 해당 라이선스 조건에 따라 코드를 열람, 사용, 수정 또는 배포할 수 있다는 뜻이지, 관련 프로젝트가 모두 같은 라이선스를 쓴다는 뜻은 아닙니다. V2Fly의 V2Ray 코어는 MIT 라이선스로, Xray 코어는 MPL 2.0으로 배포됩니다. GUI 클라이언트와 커널, 포함된 구성 요소에는 각각 다른 조건이 적용될 수 있습니다. 일반적으로 설치해 사용할 때는 클라이언트의 프로젝트 정보를 통해 구성 요소를 확인하세요. 코드를 수정하거나 소프트웨어를 재배포하려면 커널 라이선스를 설치 패키지 전체의 라이선스로 간주하지 말고 각 라이선스를 확인해야 합니다.

코드 공개가 로컬 권한 관리를 대신해 주는 것은 아닙니다. 구독 주소에는 계정 이용 권한이 연결될 수 있고, 설정에는 서버 주소와 접근 정보가 포함될 수 있으며 로그에는 접속 대상이 기록될 수 있습니다. 스크린샷을 공유할 때는 오류 유형과 필요한 항목만 남기고 민감한 내용은 가리세요. “LAN 연결 허용”을 켜기 전에는 수신 주소, 인증 방식, 방화벽 범위를 확인하세요. 이 설정은 다른 기기가 로컬 프록시 포트에 접근할 수 있도록 하는 기능이지 현재 컴퓨터의 연결 안정성을 높이는 필수 설정은 아닙니다.

클라이언트와 함께 설정 및 규칙도 업데이트하세요

클라이언트 프로그램, 프록시 커널, 구독 내용, geoip 및 geosite 규칙 데이터는 각각 별개의 업데이트 대상입니다. 클라이언트를 업데이트하면 인터페이스와 설정 생성 방식이 바뀔 수 있고, 커널 업데이트는 설정 필드 지원에 영향을 줄 수 있습니다. 구독 업데이트는 서버 매개변수를 가져오며 규칙 데이터베이스 업데이트는 도메인과 주소 분류에 영향을 줍니다. 특정 사이트가 예상과 다르게 라우팅된다면 먼저 어떤 규칙이 적용됐는지와 규칙 순서를 확인하세요. 데이터 파일을 업데이트해야 할지 판단하고 모든 구성 요소를 한꺼번에 교체하지 마세요.

업데이트 전에 사용자 지정 라우팅과 DNS 설정을 백업하고 현재 프록시 모드를 기록하세요. 업데이트 후에는 기존 설정으로 기본 연결을 확인한 다음 새 기능을 하나씩 활성화하세요. 변경 후에만 문제가 생겼다면 포트와 DNS, 라우팅을 동시에 바꾸기보다 마지막으로 변경한 항목 하나를 되돌리는 편이 원인을 찾기 쉽습니다. 일부 GUI 클라이언트는 실행 설정을 다시 생성하므로 생성된 파일을 직접 수정하면 다음 시작 때 덮어쓰일 수 있습니다. 계속 유지할 설정은 클라이언트에서 지원하는 사용자 지정 메뉴에 입력하세요.

연결 문제를 확인 가능한 단계로 나누세요

구독 업데이트 실패와 서버 연결 실패는 서로 다른 문제입니다. 전자는 구독 주소가 완전하고 유효한지, 업데이트 요청이 어떤 네트워크 경로를 이용하는지 확인하세요. 후자는 현재 서버와 프로토콜 매개변수, 시스템 시간, 커널 로그를 점검해야 합니다. 서버 목록이 보여도 시스템 프록시가 활성화된 것은 아닙니다. 브라우저에서 접속할 수 있어도 모든 앱이 같은 프록시 설정을 사용하는 것은 아닙니다. “가져오기, 시작, 트래픽 가로채기, DNS 조회, 라우팅” 순서로 확인하면 근거 없이 반복해서 재설치하는 일을 줄일 수 있습니다.

일상적인 설정은 시스템 프록시부터 시작하고 기본 연결을 확인한 다음 라우팅을 추가하세요. 앱의 트래픽을 직접 가로채야 할 때 TUN을 활성화하면 됩니다. DNS와 FakeDNS 같은 고급 항목은 커널과 라우팅 정책을 함께 이해해야 하므로 스위치 하나만 그대로 따라 켜는 방식은 적절하지 않습니다. 사용법 가이드에서는 구독 가져오기, 모드 선택, 연결 확인을 다룹니다. 고급 설정 매뉴얼에서는 필터 규칙, 사용자 지정 아웃바운드, 복잡한 DNS 환경을 각각 설명합니다. 구체적인 오류가 발생했다면 먼저 자주 묻는 질문에서 해당 단계를 확인한 뒤 조정할 항목을 결정하세요.

Notes / Configuration

설정 가이드와 플랫폼별 글

권한과 백그라운드 실행 등 실제 문제를 살펴보며 일상적인 설정의 작동 방식도 설명합니다.

v2rayNG 앱별 프록시 및 배터리 최적화 제외 설정: Android VpnService 사용 안내

백그라운드 연결 끊김과 일부 앱의 프록시 미적용은 각각 나눠서 확인해야 합니다. 이 글에서는 VpnService의 트래픽 가로채기 범위부터 설명하고, 앱별 프록시 목록과 배터리 최적화 제외, 부팅 후 자동 실행을 확인하는 순서를 안내합니다. 이를 통해 앱이 트래픽 가로채기 대상이 아닌 경우와 라우팅에 따라 다른 출구를 사용하는 경우를 구분할 수 있습니다.

글 읽기 →

v2rayN macOS 설치 시 개발자를 확인할 수 없음: 권한 허용 및 네트워크 접근 설정

처음 실행할 때 시스템에서 차단되면 먼저 파일 출처를 확인한 뒤 “개인정보 보호 및 보안”에서 허용 안내를 처리하세요. 이 글은 실행 권한, 네트워크 접근, 프록시 관련 권한을 각각 순서대로 설명합니다. 서로 다른 제한을 혼동하거나 실제 권한 문제를 해결하지 못한 채 반복해서 설치하는 일을 방지할 수 있습니다.

글 읽기 →

글 전체 보기 →