오픈 소스 클라이언트 · 중국어 설정 가이드

V2Ray 중국어판 v2rayN 다운로드 및 설정

v2rayN 다운로드 가이드 보기

구독 가져오기부터 라우팅까지, 오픈 소스 클라이언트로 데스크톱과 Android 기기의 프록시를 설정하세요.

플랫폼
프로토콜
  • VMess
  • VLESS
  • Trojan

설정 항목 색인

구독·라우팅·코어 설정

먼저 설정을 가져온 다음 어떤 앱과 목적지에 프록시를 사용할지 정하세요. 아래 설정 카드는 메뉴 위치를 설명하기 위한 예시입니다. 메뉴 이름은 클라이언트 버전에 따라 달라질 수 있으므로 현재 설치된 클라이언트의 화면을 기준으로 확인하세요.

구독 그룹 설정

메모
기본 그룹
주소 (url)
https://example.com/sub?token=xxxx
구독 업데이트(프록시 사용 안 함)

화면 예시입니다. 주소를 저장한 뒤 업데이트해야 연결 설정을 가져올 수 있습니다.

설정 순서는 일관되게 유지하는 것이 좋습니다. 구독은 사용할 수 있는 원격 연결을 제공하고, 활성 구성은 현재 사용할 경로를 정하며, 라우팅은 요청을 어디로 보낼지 결정합니다. 시스템 프록시나 TUN은 어떤 트래픽을 클라이언트로 전달할지 정합니다. 이 네 가지를 분리해 확인하면 구독 업데이트 실패 때 라우팅을 계속 바꾸는 일을 피할 수 있고, 클라이언트가 실행 중인데도 특정 앱이 직접 연결되는 이유도 파악하기 쉽습니다.

플랫폼별 설치 및 설정 가이드 보기 →

클라이언트 선택

4개 플랫폼 다운로드

데스크톱에서는 v2rayN, Android에서는 우선 v2rayNG를 확인하세요. 운영체제와 프로세서 아키텍처를 먼저 확인한 뒤 설치 파일을 선택해야 합니다. 설정 파일이나 구독 주소는 클라이언트 설치 파일을 대신할 수 없습니다.

Windows

 v2rayN · 추천

구독과 라우팅을 관리할 수 있습니다. 시스템 요구 사항을 확인하고 크로스 플랫폼 데스크톱 버전이나 클래식 WPF 버전을 선택하세요.

웹 사용은 시스템 프록시부터 시작하고, 다른 앱에는 TUN을 검토하세요. 종료 전 프록시를 해제하고 실행에 실패하면 로그를 확인하세요.

다운로드 Windows 클라이언트

macOS

 v2rayN · 데스크톱 클라이언트

‘이 Mac에 관하여’에서 칩을 확인하고 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 설치 안내에 따라 초기 설정을 마치세요.

네트워크를 바꾸면 프록시를 다시 확인하세요. TUN 권한은 안내에 따르고, 연결 문제는 활성 구성·프록시·DNS 순으로 점검하세요.

다운로드 macOS 클라이언트

Android

 v2rayNG · 추천

구독에 맞게 Xray 기반 v2rayNG 또는 V2Fly 기반 v2flyNG를 선택하세요. 지원 기기는 arm64, 그 외에는 범용 설치 파일을 확인하세요.

구독을 업데이트하고 구성을 선택한 뒤 VPN 권한을 승인하세요. 다른 VPN 앱과의 충돌을 피하고 연결이 끊기면 배터리 제한을 확인하세요.

다운로드 Android 클라이언트

Linux

 v2rayN · 그래픽 설정

GUI에서 구독과 라우팅을 관리할 수 있습니다. 배포판의 패키지 형식과 CPU 아키텍처에 맞는 deb 또는 rpm 파일을 선택하세요.

코어 실행과 설정 디렉터리의 쓰기 권한을 확인하세요. 프록시 지원은 앱마다 다르므로 더 넓은 트래픽 처리는 TUN 권한 안내를 참고하세요.

다운로드 Linux 클라이언트
모든 클라이언트 보기 →

빠른 시작 미리보기

설치부터 연결 확인까지

‘클라이언트 → 설정 → 트래픽 진입 방식’ 순서로 진행하세요. 첫 연결에서는 기본 설정을 유지하고, 연결이 확인된 뒤 복잡한 트래픽 분기와 TUN을 추가하세요.

1단계 · 클라이언트 설치

플랫폼과 설치 파일 확인

다운로드 페이지에서 운영체제에 맞는 항목을 선택하고 아키텍처와 실행 환경 안내를 확인한 뒤 클라이언트를 설치하세요. 처음 실행한 후에는 메인 화면이 정상적으로 표시되고 설정을 저장할 수 있는지 확인합니다. 클라이언트는 연결 설정을 관리하는 도구일 뿐, 사용할 수 있는 원격 서비스를 자동으로 제공하지 않습니다. 다음 단계로 넘어가기 전에 유효한 구독이나 공유 링크를 준비하세요. 기존 설정이 있다면 먼저 백업한 뒤 새로 설치한 프로그램으로 옮기세요. 설치 경로가 다른 프로그램의 코어와 설정 파일을 섞어 쓰지 마세요.

2단계 · 구독 가져오기

추가하고 업데이트한 뒤 구성 선택

데스크톱에서는 구독 그룹 설정을 열고 알아보기 쉬운 메모와 전체 주소를 입력한 다음 저장하고 업데이트하세요. Android에서는 구독 그룹 메뉴에서 주소를 추가한 뒤 구성 목록을 업데이트합니다. 업데이트가 완료되면 활성 구성을 선택하고 예상한 그룹에 속하는지 확인하세요. 공유 링크와 구독 링크는 가져오기 메뉴가 다를 수 있으므로 형식 오류가 발생하면 먼저 링크 유형을 확인하세요. 주소의 매개변수는 빠짐없이 유지하되 스크린샷이나 공개 메시지에 노출하지 마세요.

3단계 · 연결 확인

진입 방식 활성화 및 접속 확인

데스크톱에서는 먼저 시스템 프록시를 사용하고, Android에서는 연결을 시작한 뒤 VPN 권한을 승인하세요. 확인할 앱을 열어 대상에 접속한 다음 클라이언트 로그에서 연결 상태나 오류를 살펴봅니다. 클라이언트가 실행 중이라는 표시만으로 실제 접속이 확인된 것은 아닙니다. 특정 앱만 작동하지 않으면 시스템 프록시를 사용하는 앱인지 확인하세요. 모든 대상에 접속할 수 없다면 활성 구성과 원격 서비스, DNS를 점검합니다. 기본 연결이 확인된 다음 TUN 사용을 검토하세요.

전체 가이드 보기 →

오픈 소스 생태계와 유지 관리

Project V, V2Fly, Xray

소프트웨어 이름만 외우기보다 클라이언트와 코어의 역할을 이해하는 편이 유용합니다. 인터페이스는 설정을 관리하고 코어는 연결을 처리합니다. 오픈 소스 라이선스는 코드 사용 및 배포 조건을 규정하며, 실제 호환성은 기능별로 확인해야 합니다.

Project V 구성

Project V는 프록시 통신을 중심으로 형성된 오픈 소스 기술 생태계이며, V2Ray는 그 주요 구성 요소 중 하나입니다. 프로토콜, 전송, 라우팅, 인바운드와 아웃바운드 처리를 조합 가능한 모듈로 나누어 같은 기술을 여러 그래픽 클라이언트에서 다룰 수 있습니다. 사용자가 보는 것은 구독 목록과 설정 화면이고, 실제 처리는 클라이언트가 생성하거나 관리하는 코어 설정이 담당합니다.

클라이언트 이름과 프로토콜 이름은 서로 다르며 구독 출처가 코어 프로젝트를 의미하는 것도 아닙니다. 문제를 문의할 때는 단순히 “V2Ray가 안 된다”고 하기보다 클라이언트와 코어, 연결 설정 유형, 운영체제를 함께 설명하면 원인을 찾기 쉽습니다. 이 사이트에서는 세 가지 그래픽 클라이언트의 다운로드와 가이드를 제공합니다. 프로토콜 용어는 용어 설명에서 확인할 수 있습니다.

V2Fly와 Xray의 관계

V2Fly 커뮤니티는 V2Ray 코어와 관련 문서를 계속 관리하고 있으며, Xray는 관련 코드 기반에서 출발해 자체 구현과 기능 방향을 발전시켰습니다. 두 프로젝트는 기술적 배경을 공유하지만 모든 기능과 매개변수가 완전히 같은 것은 아닙니다. 특히 VLESS, REALITY, 흐름 제어 옵션을 사용할 때는 프로토콜 이름만으로 호환성을 판단하지 말고 현재 코어가 설정의 전체 조합을 지원하는지 확인해야 합니다.

코어는 원격 서비스에서 요구하는 사항을 기준으로 선택하세요. 기존 설정이 안정적으로 작동한다면 전환하기 전에 해결하려는 문제가 무엇인지 분명히 하세요. 설정을 가져왔다는 것은 클라이언트가 내용을 인식했다는 뜻일 뿐, 실제 연결에는 양쪽의 매개변수가 일치해야 합니다. 자세한 차이는 Xray와 V2Fly 코어 선택 가이드를 참고하세요.

세 클라이언트의 오픈 소스 라이선스

v2rayN은 데스크톱에서 구독 관리와 시스템 프록시, 라우팅 설정을 제공합니다. v2rayNG는 Android용이며 Xray 코어를 사용하고, v2flyNG는 Android용이며 V2Fly 코어를 사용합니다. 세 클라이언트 모두 오픈 소스이며 무료로 사용할 수 있습니다. 플랫폼과 설정 요구 사항을 먼저 확인하고 사용 방식을 고려하세요. Android 앱을 데스크톱 설치 파일로 착각하거나 코어 이름을 앱 이름과 혼동하지 마세요.

이 클라이언트는 주로 설정 관리와 연결 작업을 담당하며 원격 서비스는 별개입니다. 클라이언트를 설치한 뒤에도 유효한 설정을 직접 준비해야 하며, 오픈 소스라고 해서 구독 기간이나 서버 규칙이 달라지는 것은 아닙니다. 클라이언트와 설정 출처, 원격 서비스를 분리해 관리하면 문제가 생겼을 때 조정해야 할 부분을 찾기 쉽습니다.

오픈 소스 라이선스의 의미

v2rayN, v2rayNG, v2flyNG 클라이언트 프로젝트는 GPL 계열 라이선스를 사용합니다. V2Fly의 V2Ray 코어와 Xray 코어는 MPL 2.0 라이선스를 적용합니다. 클라이언트와 코어에는 각각 해당 라이선스가 적용되며, 소프트웨어에 포함된 다른 구성 요소는 별도의 조건을 따를 수 있습니다. 생태계 전체를 하나의 라이선스로 단정하기보다 소프트웨어에 포함된 라이선스 파일을 확인하는 편이 정확합니다.

오픈 소스 라이선스는 해당 조건에 따라 코드를 확인·수정·재배포할 수 있도록 허용하지만, 저작자 표시나 소스 코드 제공 등 의무를 무시해도 된다는 뜻은 아닙니다. 일반 사용자는 설치와 설정에 집중하면 됩니다. 프로그램을 수정하거나 재배포할 계획이라면 해당 프로젝트의 라이선스 전문을 확인하세요. 라이선스는 코드 사용 조건을 정하는 것으로 연결 속도나 네트워크 가용성, 서비스 품질을 보장하지 않습니다.

클라이언트와 코어 업데이트

인터페이스 업데이트는 메뉴 위치와 설정 저장 방식에 영향을 줄 수 있고, 코어 업데이트는 프로토콜 호환성이나 네트워크 처리, 버그 수정과 관련될 수 있습니다. 두 종류의 변경을 구분해서 살펴보세요. 다운로드 페이지에서 사용할 수 있는 설치 파일을 확인할 수 있으며, 홈페이지에는 특정 릴리스 번호를 고정해 두지 않습니다. 업데이트 전에 구독 그룹과 라우팅 규칙, 필요한 설정을 내보내거나 백업하고 변경 사항을 읽은 뒤 기존 설정을 옮길지 결정하세요.

업데이트 후에는 이전에 작동했던 동일한 구성으로 테스트해 기본 연결을 먼저 확인하고 시스템 프록시, TUN, 사용자 지정 규칙을 차례로 살펴보세요. 업그레이드와 동시에 구독, 코어, DNS를 모두 바꾸면 어떤 변경이 원인인지 판단하기 어렵습니다. 문제가 생기면 기존 설정을 복구해 비교하고 오류가 발생한 맥락을 보존하세요. 모든 설정을 바로 지우고 처음부터 시작하지 마세요.

설정 문제 점검 순서

구독 업데이트에 실패하면 먼저 주소가 온전한지, 서비스가 유효한지, 현재 네트워크에서 구독 정보를 가져올 수 있는지 확인하세요. 그런 다음 프록시를 사용한 업데이트와 사용하지 않은 업데이트를 각각 시도합니다. 구독은 갱신됐지만 접속할 수 없다면 활성 구성과 코어 로그를 확인하세요. 일부 앱에서만 적용되지 않는다면 시스템 프록시 지원 여부와 트래픽 전달 방식을 중점적으로 살펴보세요. 모든 연결 설정을 먼저 바꿀 필요는 없습니다.

DNS는 도메인 이름을 해석하는 방식을 정하고 라우팅은 트래픽을 분배하는 방식을 정합니다. 서로 연동되지만 같은 설정은 아닙니다. TUN을 켰다고 모든 요청이 프록시를 통과하는 것은 아니므로 제외 항목과 직접 연결 규칙도 확인하세요. 문제 해결 문답에 따라 하나씩 점검하고, DNS 해석 경로와 관련된 내용은 DNS 설정 안내를 확인하세요. 한 번의 속도 측정만으로 전체 설정이 올바른지 판단하지 마세요.

설정 주제별 가이드

구독·DNS·네트워크 배포

기본 연결을 확인한 뒤 필요한 주제별 가이드를 읽어보세요. 해결하려는 문제를 먼저 분명히 하고 설정을 복잡하게 늘려가세요. 데스크톱 클라이언트와 Android VPN, LAN 투명 프록시는 각각 설정 범위가 다릅니다.

플랫폼 배포

보조 라우터에서 V2Ray 코어 실행하기: OpenWrt 투명 프록시와 LAN 트래픽 분기 개요

메인 라우터와 보조 라우터 배포 방식을 살펴보고, OpenWrt에서 Xray 또는 V2Fly 코어를 직접 실행해 투명 프록시를 구성하는 전체 과정과 게이트웨이 설정, 주요 주의사항을 설명합니다. 기기 게이트웨이와 DNS 해석 경로, 프록시 출구를 구분해 라우터 설정을 데스크톱 시스템 프록시 설정에 그대로 적용할 수 없는 이유를 이해할 수 있습니다.

배포 개요 읽기 →
문제 해결

V2Ray DNS 누출 확인 방법: 원격 DNS, FakeDNS, TUN 조합별 차단 설정

DNS 누출이 발생하는 원인과 점검 방법을 설명하고 원격 DNS, 직접 연결 DNS, FakeDNS를 차례로 설정합니다. TUN 모드와 라우팅 규칙을 함께 확인해 DNS 요청이 프록시를 우회하는 경로를 찾습니다. 테스트할 때는 해석 출처와 실제 트래픽 출구를 모두 살펴봐야 합니다. 브라우저 페이지가 열린다는 사실만으로 DNS 동작이 의도한 대로라고 판단할 수 없습니다.

DNS 설정 보기 →
입문 가이드

V2Ray 구독 링크 가져오기 메뉴: v2rayN·v2rayNG 경로와 Base64/URI 형식

v2rayN 데스크톱과 v2rayNG Android에서 구독을 추가하고 업데이트하는 메뉴 위치를 각각 안내하고, Base64 구독과 vmess://, vless:// 공유 링크의 형식 차이를 설명합니다. 붙여 넣은 뒤 설정이 나타나지 않거나 가져오기 메뉴를 잘못 선택했거나 웹 주소를 구독 링크로 착각했을 때 참고하세요. 구독 업데이트와 활성 구성 선택의 차이도 다룹니다.

구독 가져오기 안내 보기 →
모든 글 보기 →