클라이언트 다운로드 / 설정 필드 안내
v2rayN 다운로드 및 설정 안내
VLESS 노드 가져오기부터 라우팅 설정까지, 4개 플랫폼의 클라이언트 다운로드와 config.json 필드 안내를 제공합니다.
CLIENT / PLATFORM
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 확인하세요. 운영체제와 CPU 아키텍처를 확인한 뒤 설치 파일을 선택하면 됩니다. 같은 구독을 여러 클라이언트에서 사용할 수 있지만, 메뉴 옵션과 로컬 포트, 라우팅 프리셋은 다를 수 있습니다. 다운로드 페이지에서 설치 방법과 패키지 유형을 확인할 수 있으며, 홈에는 개별 버전을 나열하지 않습니다.
v2rayN / Desktop · WPF
구독 그룹, 노드 선택, 시스템 프록시를 데스크톱에서 한곳에 관리할 때 적합합니다. 다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 선택할 수 있습니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, 클래식 버전은 익숙한 데스크톱 조작 방식을 유지합니다. 먼저 운영체제 호환성을 확인하고 원하는 인터페이스를 선택하세요. 같은 컴퓨터에 두 버전을 모두 설치할 필요는 없습니다.
처음 실행한 뒤 코어가 정상적으로 작동하는지, 로컬 수신 포트가 충돌하지 않는지 확인하고 노드를 가져오세요. 업데이트 전에는 구독 그룹과 사용자 지정 라우팅을 보관하세요. 설정을 옮겨야 한다면 실행 디렉터리를 임의로 덮어쓰지 말고 클라이언트에서 지원하는 내보내기 기능을 사용하세요.
다운로드 Windows 클라이언트 →v2rayN / Apple Silicon · Intel
데스크톱에서 구독 및 라우팅을 관리할 때도 v2rayN을 사용할 수 있습니다. 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택합니다. CPU 아키텍처에 따라 설치 파일이 달라지므로 컴퓨터 외관이나 구입 연도만으로 판단하면 안 됩니다.
설치 후 앱 실행 및 네트워크 권한과 관련된 시스템 안내를 확인하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. 터미널 도구나 자체 프록시 옵션이 있는 소프트웨어는 별도로 설정해야 할 수 있습니다. 연결 문제를 확인할 때는 먼저 대상 앱이 어떤 프록시 경로를 사용하는지 살펴보세요.
다운로드 macOS 클라이언트 →v2rayNG / v2flyNG
먼저 Xray 코어를 사용하는 v2rayNG를 확인하세요. V2Fly 설정과의 호환성이 필요하다면 v2flyNG를 고려할 수 있습니다. 최근 출시된 기기는 대부분 arm64를 사용하며, 아키텍처가 확실하지 않다면 범용 설치 파일 안내를 확인하세요. 두 클라이언트는 코어 기능이 다르므로 이름이 비슷하다고 모든 설정 필드를 함께 사용할 수 있는 것은 아닙니다.
처음 연결할 때는 보통 시스템 VPN 권한을 허용해야 합니다. 이미 다른 VPN에 연결되어 있다면 연결이 충돌하는지 먼저 확인하세요. 백그라운드 연결이 끊기는 원인은 배터리 최적화나 백그라운드 실행 제한일 수도 있습니다. 백그라운드 실행을 허용한 뒤에도 문제가 계속되면 로그에서 노드 또는 DNS 문제를 확인하세요.
다운로드 Android 클라이언트 →v2rayN / deb · rpm
배포판의 패키지 관리 방식에 맞춰 deb 또는 rpm을 선택한 다음 x64와 arm64 아키텍처를 확인하세요. Debian 계열과 RPM 패키지를 사용하는 배포판은 다운로드 경로가 다릅니다. 패키지 형식은 기능 수준을 뜻하지 않습니다. 데스크톱 환경, 시스템 종속성, 네트워크 권한도 설치와 실행에 영향을 줄 수 있습니다.
그래픽 클라이언트는 노드와 설정을 관리하고, 실제 트래픽 처리는 코어가 담당합니다. 시스템 프록시 설정의 적용 여부는 데스크톱 환경과 앱의 지원에 따라 달라집니다. 브라우저는 연결되지만 명령줄 도구가 연결되지 않는다면 도구 자체의 프록시 설정을 확인하세요. 바로 노드를 바꾸거나 설정 파일 전체를 다시 작성할 필요는 없습니다.
다운로드 Linux 클라이언트 →CONFIG / FIELD INDEX
그래픽 인터페이스에서 노드와 설정을 관리하면 코어가 설정을 읽고 연결을 처리합니다. 아래에서 실제 용도에 따라 두 영역의 역할을 나눠 설명합니다. 코드는 필드 위치를 확인하기 위한 일부 예시이며, 그대로 연결할 수 있는 완전한 노드 설정이 아닙니다. 구체적인 문법은 사용하는 코어에 맞춰 확인하세요.
VMess, VLESS, Trojan, Shadowsocks는 서로 다른 아웃바운드 프로토콜을 나타내며, 전송 방식과 보안 계층은 별도 필드로 설정합니다. 노드를 가져온 뒤에는 서버 주소와 포트, 전송 방식, TLS 설정을 함께 확인하세요. REALITY는 보안 방식이며 독립된 노드 프로토콜이 아닙니다. v2rayN과 v2rayNG에서 특정 조합을 사용할 수 있는지는 선택한 코어에 따라 달라집니다. 프로토콜 이름만으로 호환성을 판단하기보다 서버에서 제공한 전체 설정을 확인한 뒤 핸드셰이크 로그를 살펴보는 것이 좋습니다.
아웃바운드 필드 보기 →{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}공유 링크에는 보통 노드 하나의 정보가 담기고, 구독 주소를 사용하면 업데이트 가능한 노드 목록을 가져올 수 있습니다. 먼저 구독 그룹을 만든 다음 업데이트하고 노드를 선택하면 수동으로 가져올 때 생기는 중복을 줄일 수 있습니다. 구독 그룹은 클라이언트 관리 데이터이며 config.json의 공통 최상위 필드는 아닙니다. 실행 시 클라이언트는 선택한 노드를 코어가 인식할 수 있는 아웃바운드 객체로 변환합니다. 예시의 tag는 라우팅에서 참조하는 이름이지 구독 주소가 아닙니다. 직접 만든 노드를 유지하려면 구독 업데이트와 섞이지 않도록 별도 그룹에 보관하는 편이 좋습니다.
구독 가져오기 방법 보기 →{
"outbounds": [
{
"tag": "local-socks",
"protocol": "socks",
"settings": {
"servers": [
{
"address": "127.0.0.1",
"port": 1080
}
]
}
}
]
}라우팅은 요청 조건과 아웃바운드 태그를 연결합니다. 규칙은 도메인, IP 또는 인바운드 태그를 기준으로 매칭한 뒤 outboundTag로 대상 아웃바운드를 지정할 수 있습니다. 규칙 순서에 따라 결과가 달라지므로 구체적인 조건을 더 넓은 조건보다 앞에 두는 것이 일반적입니다. 예시에서는 example.com과 하위 도메인에 direct 아웃바운드를 사용하며, 이 태그가 outbounds에 정의되어 있어야 합니다. 모든 트래픽의 출구를 계속 바꾸기보다 범위를 좁힌 규칙을 명확히 설정하면 검증하기 쉽습니다. 한 번에 한 규칙씩 수정하고 접속 로그에서 실제 적용 여부를 확인하세요.
routing 규칙 보기 →{
"routing": {
"rules": [
{
"type": "field",
"domain": [
"domain:example.com"
],
"outboundTag": "direct"
}
]
}
}DNS는 도메인 이름을 어떻게 확인할지 정하고, policy는 일부 연결 동작을 제어합니다. 두 설정은 서로 다릅니다. 코어 DNS, 시스템 DNS, 브라우저 자체 DNS가 동시에 작동할 수 있으므로 한곳을 수정해도 모든 요청에 적용되는 것은 아닙니다. 예시의 localhost는 로컬 DNS를 사용한다는 뜻이며, 사용자 레벨 0의 핸드셰이크 시간 제한을 설정합니다. 실제 환경에서는 라우팅에서 대상 도메인 확인이 필요한지, DNS 요청이 어떤 경로를 거치는지도 확인해야 합니다. 도메인으로만 접속할 수 없다면 먼저 이름 확인 단계와 연결 단계를 구분한 뒤 설정을 조정하세요.
DNS 설정 보기 →{
"dns": {
"servers": ["localhost"]
},
"policy": {
"levels": {
"0": {
"handshake": 4
}
}
}
}v2rayN은 여러 코어를 관리할 수 있지만, 코어를 전환한다고 모든 설정 필드가 자동으로 변환되는 것은 아닙니다. V2Fly와 Xray는 공통된 생태계에서 출발했지만 각자 프로토콜과 매개변수를 발전시켜 왔습니다. REALITY 같은 설정은 지원 범위를 특히 주의해서 확인해야 합니다. v2rayNG와 v2flyNG의 주요 차이도 코어 계열에 있습니다. 설정 파일에는 코어를 전환하는 공통 core 필드가 없으며, 전환은 클라이언트에서 수행합니다. 전환 후에는 warning 로그로 시작 상태를 확인하고 노드 연결을 테스트한 뒤 사용자 지정 라우팅과 DNS 설정을 복원하세요.
클라이언트 3종 비교 →{
"log": {
"loglevel": "warning"
}
}START / THREE STEPS
먼저 세 가지 개념 구분하기
클라이언트는 로컬 관리 인터페이스, 노드는 원격 연결에 필요한 매개변수, 구독은 노드 목록을 가져오는 주소입니다. 클라이언트를 다운로드해 설치해도 사용할 수 있는 노드는 별도로 필요합니다. 소프트웨어에 공용 서버 계정이 포함되어 있지는 않습니다. 이 세 가지를 먼저 구분하면 문제가 설치, 가져오기, 연결 중 어느 단계에서 발생했는지 파악하기 쉽습니다.
공유 링크와 구독 주소에는 접속 정보가 포함될 수 있습니다. 전체 주소가 보이는 화면을 공개하지 말고, 테스트를 위해 잘 모르는 변환 서비스에 주소를 입력하지 마세요. 문제를 제보할 때는 오류 유형, 코어 이름, 관련 필드만 남기고 주소의 사용자 식별 정보는 숨기세요.
기존 클라이언트 설정이 있다면 현재 사용하는 노드, 프록시 모드, 사용자 지정 규칙을 먼저 기록하세요. 처음 설정을 옮길 때는 최소한의 연결부터 구성해 정상 작동을 확인한 다음 추가 설정을 하나씩 복원하세요. 과거 설정의 문제까지 새 환경으로 함께 옮기는 일을 방지할 수 있습니다.
클라이언트 선택 안내 보기 →v2rayN에서 구독 그룹 설정을 열고 본인이 보유한 구독 주소를 추가한 뒤 저장하고 구독을 업데이트하세요. 노드 하나만 가져오려면 클립보드 가져오기를 사용합니다. v2rayNG에서는 구독 그룹이나 공유 링크로 노드를 추가할 수 있습니다. 메뉴 이름은 인터페이스 업데이트에 따라 달라질 수 있습니다. 입력하는 내용으로 구분하세요. 원격 노드 목록은 구독 메뉴에서, 단일 프로토콜 링크는 노드 가져오기를 이용합니다.
업데이트 후 목록에 노드가 표시되는지, 이름과 주소, 프로토콜이 예상과 맞는지 확인하세요. 가져오기에 성공했다는 것은 클라이언트가 내용을 읽었다는 뜻일 뿐, 서버가 작동 중이라는 뜻은 아닙니다. 목록이 비어 있다면 구독 주소가 만료되었는지, 인증이 필요한지, 현재 네트워크에서 구독 내용을 가져올 수 있는지 먼저 살펴보세요.
노드를 선택한 다음 현재 작업에 맞춰 시스템 프록시와 라우팅 모드를 설정하세요. 시스템 프록시는 앱이 트래픽을 클라이언트로 전달할지를 결정하고, 라우팅은 전달된 트래픽을 어디로 보낼지 결정합니다. 두 기능은 서로 대체할 수 없습니다. 데스크톱에서는 시스템 프록시를 따르는 브라우저로 먼저 테스트하고, Android에서는 시스템 VPN 권한이 허용되었는지 확인하세요.
처음에는 클라이언트의 기본 라우팅 설정을 그대로 사용하는 것이 좋습니다. TUN은 가상 네트워크 인터페이스와 추가 권한이 필요하므로 매번 연결할 때 켜야 하는 기능은 아닙니다. 일반 프록시 경로가 안정적으로 작동하는지 확인한 다음 대상 앱의 프록시 지원 여부에 따라 TUN 사용을 결정하세요. 여러 네트워크 계층을 동시에 변경하지 않는 것이 좋습니다.
선택한 경로를 통해 접속해야 하는 페이지를 열고 클라이언트 로그를 함께 확인하세요. 지연 시간 측정은 참고 자료일 뿐 실제 앱 접속을 대신할 수 없습니다. 노드 테스트 결과가 있더라도 DNS, TLS, 대상 웹사이트 접속이 모두 정상이라는 뜻은 아닙니다. 먼저 페이지 하나만 테스트해 로그에 동시 요청이 너무 많이 쌓이지 않게 하세요.
시간 초과가 발생하면 로컬 인바운드, 시스템 프록시, 라우팅 규칙 적용 여부, 원격 아웃바운드 순서로 확인하세요. 연결이 거부되면 수신 포트와 대상 포트를 점검하고, 핸드셰이크 오류라면 시스템 시간, 서버 이름, 보안 계층 매개변수를 확인하세요. 여러 설정을 연달아 바꾸기보다 수정 전후의 결과를 기록하면 원인을 찾기 쉽습니다.
PROJECT V / CORE / CLIENT
인터페이스는 관리하고 코어는 연결을 처리합니다
V2Ray는 Project V 생태계의 네트워크 프록시 도구입니다. 설정을 이해할 때는 인바운드, 라우팅, 아웃바운드 세 부분으로 나눠 볼 수 있습니다. 인바운드는 앱의 요청을 받고, 라우팅은 조건을 확인하며, 아웃바운드는 연결을 처리합니다. DNS, policy, log는 각각 이름 확인, 연결 동작, 실행 기록을 보완합니다. 이 구조는 config.json을 읽는 기본 순서이기도 합니다.
V2Ray의 커뮤니티 개발 흐름을 이어받아 코어와 관련 설정 기능을 유지 관리합니다.
V2Ray 생태계에서 출발한 또 다른 코어 계열로, 자체 프로토콜과 보안 방식을 발전시켜 왔습니다.
설정 형식이 비슷하다고 문법까지 완전히 같은 것은 아닙니다. 특정 필드를 인식하지 못한다면 노드가 작동하지 않는다고 단정하기 전에 코어 종류와 지원 범위를 확인하세요. 특히 프로토콜 확장, 전송 옵션, 보안 계층의 조합은 해당 코어가 지원하는지 따져봐야 합니다.
v2rayN은 데스크톱용 클라이언트로 구독, 노드, 라우팅, 선택 가능한 코어를 한곳에서 관리합니다. v2rayNG는 Xray 코어를 사용하는 Android 클라이언트이며, v2flyNG는 V2Fly 계열의 Android 클라이언트입니다. 세 클라이언트는 모두 오픈 소스 프로젝트입니다. 클라이언트 이름은 프로토콜 이름이 아니며, 클라이언트 업데이트가 코어 기능의 완전한 일치를 뜻하지도 않습니다.
그래픽 인터페이스는 자주 사용하는 작업을 옵션으로 제공하지만, 실행 시에는 코어 설정을 생성해야 합니다. 따라서 화면의 옵션 하나가 여러 JSON 필드에 영향을 줄 수 있으며, 반대로 모든 하위 매개변수를 인터페이스에서 설정할 수 있는 것은 아닙니다. 설정을 직접 수정해야 한다면 먼저 클라이언트가 실행 파일을 저장하고 생성하며 덮어쓰는 방식을 확인하세요. 편집한 내용이 인터페이스에서 다시 생성된 설정으로 바뀌는 일을 방지할 수 있습니다.
오픈 소스는 해당 라이선스에 따라 소스 코드를 사용하고 연구하며 수정할 수 있다는 뜻이며, 모든 구성 요소가 같은 라이선스를 사용한다는 의미는 아닙니다. V2Fly와 Xray의 코어 코드는 주로 MPL-2.0을 사용합니다. 클라이언트와 종속성, 함께 제공되는 구성 요소는 각각의 라이선스를 확인해야 합니다. 수정하거나 재배포할 때는 해당 프로젝트의 저작자 표시, 소스 코드 제공 및 기타 조건을 따라야 합니다. ‘무료’라는 이유만으로 사용 범위를 판단해서는 안 됩니다.
커뮤니티에서는 인터페이스 개선, 설정 호환성, 코어 업데이트를 각각 진행하는 경우가 많습니다. 업데이트 안내를 읽을 때는 변경 사항이 어느 계층에 해당하는지 구분하세요. 인터페이스 변경은 조작 위치만 바꿀 수 있지만, 코어 변경은 프로토콜 매개변수, 연결 동작, 규칙 지원에 영향을 줄 수 있습니다. 이 사이트는 다운로드와 설정 안내를 제공하며, 각 소프트웨어 프로젝트의 라이선스 설명을 대신하거나 노드 서비스를 제공하지 않습니다.
업데이트 전에는 구독 그룹, 직접 만든 노드, 사용자 지정 규칙을 저장하세요. 업데이트 후에는 시작 로그를 확인하고 자주 사용하는 노드와 앱의 연결을 테스트합니다. 특정 유형의 연결만 문제가 있다면 전체 데이터를 초기화하지 말고 관련 라우팅 또는 DNS 설정을 임시로 되돌려 하나씩 비교하세요. 진단을 위해 실행 로그를 사용할 때는 상세 기록을 장시간 켜 두지 말고, 로그에 접속 대상 도메인 등 개인정보가 포함될 수 있다는 점에 유의하세요.
설정을 익힐 때도 같은 순서로 진행하면 좋습니다. 먼저 기본 연결을 확인하고, 다음으로 아웃바운드 태그와 규칙 매칭을 살펴본 뒤, 마지막으로 이름 확인과 정책을 조정하세요. 각 필드가 어느 단계에 영향을 주는지 알아야 변경 사항이 실제 문제를 해결했는지 판단할 수 있습니다. 필드 유형과 예시는 설정 파일 안내에서 확인하세요.
NOTES / LATEST
기본 연결이 완료되면 구체적인 문제에 맞는 안내를 확인하세요. 프로토콜 글에서는 설정 필드의 작동 방식을 설명하고, 노드 선택 글에서는 테스트 결과를 해석하는 방법을 다루며, 문제 해결 목록은 원인 범위를 좁히는 데 도움이 됩니다. 현재 정상 작동하는 설정은 유지하고 한 번에 한 가지 변경만 테스트하세요.
시스템 프록시 상태, 로컬 포트, DNS 확인, 라우팅 규칙, 노드 작동 여부, 시스템 시간 순으로 점검합니다. v2rayN 데스크톱과 v2rayNG Android에서 흔히 발생하는 상황을 다룹니다.
글 읽기 →속도 측정 지연 시간 읽는 법부터 트래픽 배수 계산, 지역과 회선의 관계, VMess·VLESS·Trojan 선택까지 노드를 고르는 기준을 순서대로 안내합니다.
글 읽기 →XTLS Vision이 중복 암호화를 줄이는 방식, REALITY가 TLS 핸드셰이크를 개선하는 원리, Xray 코어 설정에서 이에 대응하는 flow 및 security 필드를 쉽게 설명합니다.
글 읽기 →