오픈 소스 클라이언트다운로드 · 한국어 설정 안내
데스크톱 및 Android 클라이언트를 정리하고 구독 가져오기와 라우팅 설정 경로를 안내합니다.
Project V 생태계 · 클라이언트와 코어의 계층
다운로드
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 확인하세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 해당 플랫폼의 설치 파일 목록으로 이동하세요.
Desktop은 크로스 플랫폼 인터페이스를 사용하고, WPF는 기존 데스크톱 방식의 조작 환경을 유지합니다. 두 버전 모두 구독 관리와 프록시 설정을 중심으로 하므로 화면이 다르다는 이유로 다시 구매하거나 구독을 변경할 필요는 없습니다.
먼저 시스템의 “설정 → 시스템 → 시스템 정보”에서 시스템 종류를 확인하세요. 처음 실행할 때 런타임 안내가 표시되면 설치 파일 안내에 따라 종속 항목을 설치하세요. 인터페이스 버전을 변경하기 전에 기존 설정 폴더를 보존해 사용 중인 파일을 덮어쓰지 않도록 하세요.
다운로드 페이지 Windows 클라이언트 →칩에 따라 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 시스템 메뉴의 “이 Mac에 관하여”에서 칩 이름 또는 Intel 프로세서가 표시되는지 확인하세요. 기기 외관이나 구매 연도만으로 아키텍처를 판단하지 마세요.
클라이언트를 응용 프로그램 폴더에 넣은 뒤 실행하면 이후 업데이트와 권한 관리가 편리합니다. 시스템 프록시 사용과 TUN 사용은 서로 다른 작업입니다. 처음 설정할 때는 일반 프록시 연결을 먼저 확인한 뒤 앱에 필요한 네트워크 권한을 설정하세요.
다운로드 페이지 macOS 클라이언트 →v2rayNG는 Xray 코어를 사용하므로 Android에서 우선 살펴볼 클라이언트입니다. v2flyNG는 V2Fly 코어를 사용하며 해당 설정을 이미 보유한 사용자에게 적합합니다. 비교적 최신 휴대전화에서는 arm64 패키지를 먼저 확인하고, 아키텍처를 모르면 범용 버전 안내를 살펴보세요.
연결하려면 시스템 VPN 권한을 확인해야 합니다. 다른 네트워크 도구가 이미 연결을 사용 중이라면 먼저 기존 연결을 중지하세요. 백그라운드에서 연결이 끊기는 현상은 배터리 관리와 관련이 있을 수 있습니다. 가져오기에 성공했다고 해서 클라이언트의 지속 실행 권한까지 확보된 것은 아닙니다.
다운로드 페이지 Android 클라이언트 →배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 다음 x64와 arm64 아키텍처를 확인하세요. 데스크톱 환경의 시스템 프록시는 일반적으로 해당 설정을 따르는 프로그램에만 영향을 줍니다. 터미널 도구는 프록시를 별도로 설정해야 할 수 있습니다.
처음 사용할 때는 구독을 업데이트하고 구성을 선택한 뒤 앱 요청을 테스트하세요. TUN이 필요하다면 관련 권한과 로컬 네트워크 관리 방식을 확인하세요. 라우팅, DNS, 방화벽을 동시에 변경하면 어떤 단계가 변화를 일으켰는지 파악하기 어렵습니다.
다운로드 페이지 Linux 클라이언트 →클라이언트는 설정을 읽고 로컬 연결 지점을 관리합니다. 서버 주소, 포트, 인증 정보는 사용자가 준비해야 합니다. 이 사이트는 다운로드 색인과 기술 안내를 제공하며 구독 계정이나 노드 서비스를 제공하지 않습니다.
모든 클라이언트 보기 →설정 경로
설정 출처, 트래픽 진입점, 코어의 아웃바운드를 나누어 확인하세요. 설정 항목을 선택하면 관련 작업과 설정 예시를 볼 수 있습니다.
구독은 여러 설정을 한곳에서 업데이트할 때 유용합니다. v2rayN의 “구독 그룹 → 구독 그룹 설정”에서 그룹을 추가하고 주소를 입력해 저장한 다음 구독을 업데이트하세요. 개별 공유 링크는 클립보드에서 가져오며 구독 주소 입력란에 넣지 않습니다. 개별 입력과 비교하면 그룹을 사용해 출처를 구분하고 여러 설정을 관리하기 쉽습니다. 업데이트하면 그룹의 내용이 바뀌므로 수동으로 수정하기 전에 보관할 설정을 내보내세요. 예시 주소는 형식을 확인하기 위한 것으로 실제 연결에는 사용할 수 없습니다.
https://example.com/sub?token=xxxx라우팅 규칙은 코어가 트래픽을 받은 뒤 적용되며, 일반적으로 규칙을 순서대로 확인해 처음 일치하는 규칙을 사용합니다. 모든 요청을 하나의 아웃바운드로 보내는 대신 사용자 지정 규칙으로 로컬 네트워크, 특정 도메인, 나머지 트래픽을 따로 처리할 수 있습니다. 아래 예시는 중국 도메인 모음과 사설 주소를 direct로 보냅니다. 실제 설정에는 동일한 이름의 아웃바운드와 필요한 규칙 데이터베이스가 있어야 합니다. 수정 전에 기존 규칙을 백업하고 한 번에 한 종류의 조건만 바꾼 뒤 대상 앱에서 확인하세요. 진입점 문제를 라우팅 문제로 오해하지 않도록 주의하세요.
{
"routing": {
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}시스템 프록시는 운영체제 설정을 통해 앱이 로컬 프록시를 사용하도록 안내하며, 해당 설정을 따르는 프로그램에만 적용됩니다. “시스템 프록시 자동 설정”은 설정을 기록하고, “시스템 프록시 해제”는 설정을 제거하며, “시스템 프록시 유지”는 현재 상태를 보존합니다. TUN은 가상 네트워크 인터페이스로 트래픽을 받기 때문에 일반 시스템 프록시와 적용 범위가 다르며 권한, 라우팅, DNS에도 영향을 줍니다. 먼저 시스템 프록시를 확인하고 필요한 경우 TUN을 사용하세요. 어느 쪽도 올바른 서버 설정을 대신하지 않습니다.
앱에서 프록시를 사용하지 않을 때 확인하기 →v2rayN 인터페이스는 설정을 관리하고 코어는 프로토콜 처리와 전달을 담당합니다. 사용할 수 있는 코어와 전환 방법은 설치된 패키지에 따라 다릅니다. 선택이 필요하면 설정에서 해당 프로토콜의 코어 유형을 확인하세요. Xray-core와 v2fly-core는 각각 독립적으로 발전하므로 프로토콜 이름이 비슷하다는 이유만으로 모든 필드가 호환된다고 볼 수 없습니다. 인터페이스만 변경하는 것과 달리 코어를 전환하면 설정 해석 기능에 영향을 줍니다. 전환한 뒤 시작 로그에서 코어가 실행되었는지 확인하고 전송 방식, 보안 매개변수, 서버 설정이 일치하는지 살펴보세요.
코어 및 프로토콜 용어 보기 →기기 간 이전 시에는 기존 구독 주소를 우선 사용하세요. 개별 설정만 있다면 서버 목록에서 항목을 선택하고 마우스 오른쪽 메뉴에서 공유 링크를 내보낸 뒤 대상 클라이언트에서 클립보드로 가져올 수 있습니다. 인터페이스에 따라 메뉴 이름은 조금 다를 수 있으므로 내보내기와 가져오기 기능을 확인하세요. 폴더 전체를 복사하는 것보다 공유 링크로 연결 매개변수를 전달하는 편이 간편하지만, 일반적으로 전체 라우팅, DNS, 시스템 권한은 포함되지 않습니다. 이전 후 로컬 포트와 프록시 모드를 다시 확인하고 인증 정보가 포함된 링크는 통제된 기기 사이에서만 전달하세요.
전체 플랫폼 설치 및 이전 안내 보기 →가져온 뒤 선택할 수 있는 설정이 있는지 확인하고, 코어 실행 여부와 앱 진입점을 차례로 확인한 다음 라우팅과 DNS를 조정하세요. 브라우저에서 특정 페이지가 열린다는 사실만으로 이번 요청이 성공한 것은 확인할 수 있지만 모든 프로그램이 같은 프록시 설정을 따른다고 볼 수는 없습니다. 더 자세히 확인하려면 같은 앱과 같은 대상을 사용해 반복 테스트하고 방금 변경한 설정을 기록하세요. 한 번에 조건 하나만 바꾸면 되돌릴 때 기준이 명확해집니다.
오픈 소스 생태계와 유지 관리 범위
클라이언트, 코어, 구독 서비스는 서로 다른 계층에 있습니다. 각자의 역할을 구분하면 소프트웨어 이름 하나만 기억하는 것보다 선택과 문제 해결이 쉬워집니다.
Project V는 프록시 통신 도구를 중심으로 형성된 기술 생태계이며 V2Ray는 널리 사용되는 구현체입니다. V2Fly는 V2Ray의 커뮤니티 유지 관리와 개발을 이어가고, Xray는 관련 코드 기반에서 출발해 독립적으로 발전하고 있습니다. 일부 개념을 공유하지만 새 기능, 설정 필드, 배포 주기는 완전히 같지 않습니다. 설정 문서를 읽을 때는 어떤 코어를 대상으로 하는지 함께 확인해야 하며, 한 구현체의 설정을 다른 구현체에 그대로 적용해서는 안 됩니다.
프로토콜 이름, 전송 방식, 보안 계층도 각각 구분해야 합니다. VMess, VLESS, Trojan, Shadowsocks는 서로 다른 프로토콜 방식을 설명하고, WebSocket 등의 전송 설정은 데이터 전달 방식을 나타내며 TLS 등의 보안 설정은 또 다른 계층에 속합니다. 클라이언트를 선택하기 전에 기존 서버에 어떤 기능이 필요한지 확인하세요. 이미 호환되는 도구를 더 많은 설정 항목을 위해 바꿀 필요는 없습니다. 각 필드는 서버에서 제공한 매개변수와 현재 코어의 지원 범위를 기준으로 확인하세요.
v2rayN은 데스크톱 시스템용으로 구독 그룹, 서버 설정, 라우팅, 로컬 프록시 진입점을 관리합니다. v2rayNG는 Android용이며 Xray 코어를 사용합니다. v2flyNG 역시 Android용으로 V2Fly 코어를 사용합니다. 세 클라이언트는 모두 오픈 소스 프로젝트입니다. 인터페이스가 조작을 돕지만 실제 프로토콜 기능은 포함된 코어와 설정에 따라 달라집니다. 데스크톱과 휴대전화에서 호환되는 동일한 구독을 사용할 수 있지만 로컬 네트워크 설정은 그대로 옮기면 안 됩니다.
Android의 시스템 VPN 권한, 데스크톱의 시스템 프록시, TUN 권한은 서로 다른 방식입니다. 연결 매개변수를 옮길 수는 있지만 모든 앱이 연결되었다고 단정할 수는 없습니다. 클라이언트의 용도를 비교하려면 운영체제, 코어 구성, 설정 관리 방식을 확인하세요. 특정 프로토콜의 사용 가능 여부를 판단하려면 전송 및 보안 매개변수도 확인해야 합니다. 인터페이스의 복잡성이나 설정 개수를 속도의 기준으로 삼지 마세요.
오픈 소스는 해당 라이선스 조건에 따라 코드를 공개하고, 약정된 범위에서 읽고 사용하거나 수정할 수 있다는 의미입니다. V2Fly의 V2Ray 코어는 주로 MIT 라이선스, Xray 코어는 주로 MPL-2.0 라이선스를 사용합니다. 클라이언트, 코어, 포함된 구성 요소의 라이선스는 각각 프로젝트에 포함된 안내를 확인해야 하며, 한 프로젝트의 라이선스로 설치 파일 전체의 라이선스를 판단할 수는 없습니다. 재배포하거나 수정하려면 해당 고지를 보존하고 구체적인 의무를 확인하세요.
코드가 공개되어 있다고 해서 모든 구독을 신뢰할 수 있는 것은 아니며 설정 출처를 확인할 책임도 사라지지 않습니다. 구독 주소에는 접근 자격 증명이 포함될 수 있고 공유 링크에는 서버 주소와 인증 매개변수가 들어갈 수 있습니다. 문제를 확인할 때 오류 유형, 코어 이름, 관련 설정은 보관하되 계정을 식별할 수 있는 정보는 삭제하세요. 클라이언트 사용 시 거주 지역의 법률과 이용 중인 네트워크의 관리 규정도 준수해야 합니다. 이 문서는 소프트웨어 설치와 기술 설정만 다룹니다.
클라이언트 업데이트는 인터페이스와 설정 생성 방식에 영향을 주고, 코어 업데이트는 프로토콜 해석 및 전달에 영향을 주며, GeoIP와 GeoSite 데이터 업데이트는 규칙 모음에 영향을 줍니다. 세 업데이트가 해결하는 문제는 서로 다릅니다. 도메인 라우팅 결과가 달라지면 규칙 참조와 데이터베이스를 확인하세요. 설정을 해석할 수 없다면 로그와 코어 호환성을 먼저 살펴보세요. 모든 문제를 클라이언트가 오래된 탓으로 돌리지 말고, 모든 구성 요소를 동시에 업데이트한 뒤 원인을 추측하지도 마세요.
업데이트 전에 구독 그룹과 직접 관리하는 규칙을 저장하고 이전 설정을 복구할 수 있는지 확인한 뒤 다운로드 페이지에서 패키지 유형과 아키텍처에 맞는 항목을 선택하세요. 이 사이트는 설치 및 설정 경로를 정리하며 클라이언트 공식 개발팀이 아니고 서버 연결을 보장하지 않습니다. 안내에 나오는 인터페이스 문구는 기능을 찾기 위한 것으로, 클라이언트 업데이트에 따라 배치가 바뀔 수 있습니다. 차이가 있다면 현재 화면과 로그 출력을 기준으로 확인하세요.
설정 및 문제 해결 기록
증상을 먼저 파악한 다음 해당 단계로 이동하세요. 아래 문서는 앱 진입점, 클라이언트 실행, 규칙 일치 문제를 각각 다루므로 서로 다른 문제를 혼동하지 않도록 도와줍니다.
브라우저에서 프록시를 사용하지 않는 문제는 확장 프로그램이나 프록시 설정 덮어쓰기와 관련이 많고, 터미널에서는 환경 변수를 직접 설정해야 하는 경우가 있습니다. 두 경로로 나누어 점검 순서를 안내합니다.
문서 읽기 →클라이언트가 시작 직후 종료되는 주요 원인을 정리합니다. .NET 데스크톱 런타임 누락, 설치 폴더 쓰기 권한 부족, 코어 파일 누락 또는 차단을 하나씩 확인하는 방법을 설명합니다.
문서 읽기 →v2rayN 사용자 지정 라우팅을 예로 들어 domain, ip, outboundTag 필드를 하나씩 살펴보고 직접 연결, 프록시, 차단 규칙의 순서와 자주 쓰는 구문을 소개합니다.
문서 읽기 →자주 묻는 질문
설치, 가져오기, 연결은 이어지는 세 단계입니다. 현재 진행 중인 단계에 맞춰 문서를 확인하면 모든 구성 요소를 처음부터 다시 설치할 필요가 없습니다.
도움말 센터로 이동 →클라이언트에는 개인 서버 계정이 포함되어 있지 않습니다. 유효한 구독 또는 개별 공유 링크를 준비해 가져오고 설정을 선택해야 연결할 수 있습니다. 구독 업데이트에 실패하면 주소 형식, 출처의 상태, 네트워크 연결을 먼저 확인하세요. 자격 증명이 포함된 주소를 온라인 변환 서비스에 함부로 전달하지 마세요. 자세한 절차는 사용 안내를 확인하세요.
아닙니다. 시스템 프록시는 시스템 설정을 따르는 앱이 요청을 로컬 진입점으로 보낼지 결정합니다. “전역”은 일반적으로 클라이언트의 라우팅 프리셋으로, 코어에 들어온 트래픽이 어느 아웃바운드를 사용할지 정합니다. 앱이 진입점에 연결되지 않았다면 라우팅 모드를 바꿔도 해결되지 않습니다. 관련 개념은 용어집을 확인하세요.
변환은 주로 설정 표현 방식을 바꾸는 기능입니다. 코어에 원래 없던 프로토콜 기능을 추가할 수 없으며 일부 전용 필드가 사라질 수도 있습니다. 출처에서 제공하는 호환 구독을 우선 사용하세요. 변환이 꼭 필요하다면 도구의 출처, 필드 보존 여부, 자격 증명 처리 방식을 확인하고 결과를 항목별로 점검하세요. 자세한 내용은 도움말 센터를 참조하세요.
먼저 활성 설정과 코어 지원 여부를 비교한 뒤 기기 시간, 네트워크 환경, 앱의 프록시 진입점을 확인하세요. 정상 작동하는 기기의 설정 폴더 전체를 다른 플랫폼에 그대로 덮어쓰지 마세요. 공유 링크로 연결 매개변수를 전달할 수 있지만 로컬 권한, DNS, 라우팅은 각각 확인해야 합니다. 플랫폼별 절차는 전체 설치 안내를 참조하세요.