클라이언트 다운로드 / 설정 항목 안내
운영체제에 맞는 오픈소스 클라이언트를 선택하고, 구독 가져오기부터 config.json 설정 항목까지 설정과 해석 과정을 확인하세요.
운영체제를 선택한 다음 CPU 아키텍처와 설치 파일 형식을 확인하세요. 데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 우선 살펴보고 V2Fly 코어가 필요할 때 v2flyNG를 고려하면 됩니다.
v2rayN은 Desktop 버전과 기존 WPF 버전을 제공합니다. 전자는 크로스 플랫폼 인터페이스를 사용하고, 후자는 익숙한 데스크톱 UI를 유지합니다. 다운로드 전에 운영체제와 CPU 요구 사항을 확인하고 설치 파일을 선택하세요. 파일 크기만으로 호환 여부를 판단하지 마세요.
처음 설치한 뒤에는 기존 구독이나 연결 정보를 가져오고, 구성을 선택해 코어를 실행한 다음 시스템 프록시를 설정하세요. 시스템 프록시는 시스템 설정을 따르는 앱에 영향을 주며, 모든 프로그램의 연결을 자동으로 처리하지는 않습니다. 더 많은 앱의 트래픽을 처리하려면 TUN 안내를 확인하세요.
v2rayN은 Apple Silicon과 Intel 칩에 따라 다운로드 파일이 다릅니다. 시스템의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 알맞은 아키텍처를 선택하세요. 칩 유형과 설치 파일의 아키텍처가 일치해야 하며, 기기 외관이나 출시 연도로 대신 판단할 수 없습니다.
설치 후 클라이언트를 실행하고 설정을 가져온 다음 시스템 네트워크 프록시를 확인하세요. 일부 앱만 연결된다면 해당 앱이 시스템 프록시를 따르는지, 라우팅 규칙이 예상한 아웃바운드에 적용되는지, 도메인 조회가 올바른 경로를 사용하는지 각각 확인하세요. 불필요하게 재설치할 필요는 없습니다.
v2rayNG는 Xray 코어를 사용하고 v2flyNG는 V2Fly 코어를 사용하므로, 필요한 코어 동작에 따라 선택할 수 있습니다. 최근 출시된 대부분의 기기에서는 arm64를 선택합니다. CPU 아키텍처를 확인하기 어렵다면 범용 패키지의 지원 범위를 먼저 살펴보세요. 두 클라이언트의 설정 호환성은 항목별로 확인해야 합니다.
연결을 시작하면 시스템에서 VPN 연결 권한을 요청합니다. 이는 Android 클라이언트가 트래픽을 처리하기 위한 시스템 기능이며, 서버에 연결할 수 있다는 뜻은 아닙니다. 첫 연결에서는 클라이언트 로그를 확인하고 앱별 프록시 설정도 점검하세요. 같은 시스템 네트워크 기능을 사용하는 다른 프로그램과 충돌할 수 있습니다.
v2rayN은 여러 배포판에 맞는 패키지를 제공합니다. Debian·Ubuntu 계열은 보통 deb, Fedora 등은 rpm 패키지를 사용합니다. CPU 아키텍처도 x64와 arm64로 구분해야 합니다. 패키지 형식은 설치 방법을, CPU 아키텍처는 실행 파일의 호환성을 결정하므로 둘 다 확인하세요.
데스크톱 환경, 시스템 프록시, 자동 시작은 각각 별도로 설정해야 합니다. 먼저 그래픽 인터페이스에서 직접 연결한 뒤 로그인 시 자동 실행을 설정하세요. 프로그램은 실행되지만 앱이 연결되지 않는다면 데스크톱 프록시 설정과 앱 자체 프록시 옵션을 먼저 확인하고, 이후 권한과 의존성을 점검하세요.
클라이언트는 로컬 설정과 연결을 관리합니다. 실제로 연결하려면 사용할 수 있는 서버 정보가 필요합니다. 프로그램을 다운로드해 설치해도 구독이나 원격 계정이 자동으로 생성되지는 않습니다.
전체 클라이언트 보기 →클라이언트 화면에서 실제 설정까지 흐름을 따라가 봅니다. 아래는 데이터 흐름을 설명하기 위한 일부 예시입니다. 클라이언트 관리 항목과 코어 설정 항목을 구분하며, 예시 조각은 완전한 연결 설정이 아닙니다.
구독 가져오기는 연결 항목을 일괄 저장하는 기능입니다. 업데이트 주소는 클라이언트 관리 데이터이며, 공통 config.json의 최상위 항목이 아닙니다. v2rayN·v2rayNG·v2flyNG는 메뉴와 저장 방식이 다르지만, 가져온 뒤에는 프로토콜, 주소, 전송 매개변수를 확인해야 합니다. 아래 예시는 항목을 선택한 뒤 함께 사용할 수 있는 로컬 SOCKS 인바운드이며 구독 파일이 아닙니다. 수신 주소를 루프백으로 제한하면 로컬 앱이 해당 포트를 통해 코어에 연결할 수 있습니다. 구독을 업데이트해도 직접 관리하는 라우팅 규칙은 덮어쓰지 않아야 합니다.
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"udp": true
}
}
]
}라우팅은 대상별로 서로 다른 아웃바운드를 선택하며 원격 연결 매개변수를 다시 정의하지는 않습니다. 규칙은 순서대로 적용되므로 구체적인 규칙을 포괄적인 규칙보다 앞에 두세요. 예시에서는 사설 주소를 direct라는 이름의 아웃바운드로 보냅니다. 이 태그는 outbounds에도 있어야 합니다. v2rayN에서는 인터페이스에서 라우팅을 관리할 수 있으며, Android 클라이언트는 기본 규칙과 사용자 지정 메뉴가 다릅니다. 수정한 뒤 설정을 다시 불러오고 로그에서 대상 주소와 아웃바운드 태그를 확인하세요. 도메인이 아직 조회되지 않았다면 IP 규칙만으로는 예상대로 동작하지 않을 수 있습니다.
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
},
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}TUN은 가상 네트워크 인터페이스로 트래픽을 받아 시스템 프록시를 따르지 않는 앱을 처리할 때 주로 사용합니다. v2rayN의 구현 방식과 권한, 사용 구성 요소는 환경에 따라 다릅니다. Android 클라이언트는 시스템 VPN 인터페이스를 통해 트래픽을 처리하므로 데스크톱 설정을 그대로 적용할 수 없습니다. 모든 코어에서 공통으로 사용할 수 있는 최상위 tun 스위치는 V2Ray 설정에 없습니다. 아래 예시는 트래픽 처리 후 사용할 수 있는 직접 연결 및 차단 아웃바운드일 뿐, 가상 네트워크 어댑터를 만들지는 않습니다. 사용 전에 다른 네트워크 트래픽 처리 프로그램과 충돌하는지 확인하고 시스템 네트워크 설정을 복구할 방법도 마련하세요.
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
]
}DNS를 설정할 때는 조회를 요청하는 주체, 조회가 이루어지는 연결 경로, 조회 결과가 라우팅에 반영되는 방식을 함께 고려해야 합니다. 코어의 dns 항목이 모든 앱의 시스템 DNS 설정을 자동으로 대체하지는 않습니다. 예시의 localhost는 로컬 DNS 경로를 호출하며 서버 목록의 구조를 보여 주기 위한 것입니다. 모든 네트워크 환경에 그대로 적용할 수는 없습니다. v2rayN과 Android 클라이언트에는 원격 조회, 가상 주소, 트래픽 처리 옵션이 별도로 있을 수 있으므로 수정 후 실제 생성된 설정을 확인하세요. 도메인 접속은 실패하지만 IP로는 연결된다면 DNS 문제와 라우팅 문제를 구분해 살펴보세요.
{
"dns": {
"servers": [
"localhost"
]
}
}멀티 코어 전환은 클라이언트 기능이며 config.json에서 공통으로 사용하는 전환 항목은 없습니다. v2rayN에서는 지원 여부에 따라 코어를 선택할 수 있고, v2rayNG와 v2flyNG는 각각 Xray와 V2Fly를 대상으로 합니다. 설정 구조가 비슷해도 프로토콜, 전송 방식, 확장 항목이 모두 호환되는 것은 아닙니다. 전환 전에 서버 요구 사항을 확인하세요. 아래 policy 예시는 사용자별 정책 작성법을 보여 주며, 해당 사용자가 지정된 level을 사용하는 경우에만 적용됩니다. 전환할 때는 먼저 현재 작동하는 설정을 보존하고 항목별로 테스트하세요. 코어와 라우팅을 한꺼번에 바꾸지 않는 것이 좋습니다.
{
"policy": {
"levels": {
"0": {
"handshake": 4,
"connIdle": 300
}
}
}
}프로젝트 생태계, 연결 코어, 그래픽 클라이언트를 구분하세요. 프로토콜은 양쪽 끝에서 협상하고, 클라이언트는 설정을 코어에 전달해 실행합니다. 이름이 비슷하다고 설정을 그대로 바꿔 쓸 수 있는 것은 아닙니다.
프로토콜 이름은 설정 요구 사항을 파악하는 기준이며, 어떤 코어와 전송 방식의 조합이든 바로 사용할 수 있다는 뜻은 아닙니다.
Project V는 V2Ray의 기술적 배경을 이해하는 출발점입니다. 프록시 코어는 인바운드, 아웃바운드, 라우팅으로 연결을 구성하고, 그래픽 클라이언트는 구독 목록과 시스템 프록시, 설정 화면을 제공합니다. V2Fly는 V2Ray 관련 개발을 이어 왔으며, Xray는 별도의 코어 분기로 발전했습니다. 두 프로젝트는 비슷한 개념을 일부 공유하지만 이후 기능과 설정은 서로 다르게 발전했습니다. 자료를 읽을 때는 제목에 V2Ray가 있는지만 볼 것이 아니라 어떤 코어에 관한 내용인지도 확인하세요.
VMess, VLESS, Trojan은 연결 프로토콜이고 TCP와 WebSocket 등은 전송 방식이며 TLS는 전송 보안 설정과 관련됩니다. 각 계층을 함께 살펴봐야 하며 프로토콜 이름 하나만으로 전체 설정을 대신할 수 없습니다. 코어를 선택할 때는 먼저 서버가 요구하는 프로토콜, 전송 방식, 보안 매개변수, 확장 항목을 확인한 다음 클라이언트가 해당 설정을 생성할 수 있는지 살펴보세요. 호환되지 않는 경우 모든 문제를 클라이언트 설치 실패로 돌리지 말고 어떤 항목이 맞지 않는지 확인해야 합니다.
v2rayN·v2rayNG·v2flyNG는 모두 오픈소스 그래픽 클라이언트이며, 각 클라이언트 프로젝트는 GPL-3.0 라이선스를 사용합니다. 코어, 규칙 데이터, 포함된 구성 요소에는 각각 다른 라이선스가 적용될 수 있으므로 클라이언트의 라이선스만으로 모든 의존성의 조건을 판단할 수는 없습니다. 오픈소스는 구현과 설정을 살펴볼 수 있게 하지만 서버 출처, 구독 사용 권한, 시스템 권한을 확인하는 일을 대신하지 않습니다. 구독 주소에는 접근 정보가 포함될 수 있으므로 스크린샷이나 로그를 공유하기 전에 민감한 내용을 삭제하세요.
클라이언트, 코어, 구독, 규칙 데이터 업데이트는 각각 다른 작업입니다. 클라이언트 업데이트는 UI와 설정 생성 방식에 영향을 주고, 코어 업데이트는 지원 항목과 연결 동작에 영향을 줍니다. 구독 업데이트는 연결 항목을 바꾸고 규칙 업데이트는 적용 대상을 변경합니다. 환경을 변경하기 전 현재 작동하는 설정과 사용자 지정 규칙을 저장한 다음 한 번에 한 요소만 바꾸세요. 변경 후 설정을 다시 불러오고 도메인 조회, 직접 연결 대상, 프록시 연결 대상을 각각 테스트하면 변경 원인을 파악하기 쉽습니다.
설치 후 클라이언트가 실행되는지 확인하고, 구독 항목의 매개변수가 모두 있는지 점검하세요. 다음으로 로컬 프록시가 활성화되어 있는지 확인하고 마지막으로 라우팅과 DNS를 살펴보세요. 로그 오류는 발생한 계층에 따라 원인이 다릅니다. 수신 대기 실패는 포트 충돌을, 핸드셰이크 실패는 원격 프로토콜과 보안 매개변수를, 도메인 조회 실패는 DNS 경로를 확인해야 합니다. 모든 설정을 한꺼번에 바꾸기보다 단계별로 확인하는 편이 정상 작동 상태를 유지하며 문제를 찾기 쉽습니다.
용어를 확인하려면 용어 설명을, 화면을 따라 설정하려면 시작 가이드를 읽어 보세요. 설정 계층과 JSON 구조를 확인하려면 설정 항목 참고를 참조하세요. 예시의 포트, 태그, 정책은 구조를 설명하기 위한 것이므로 실제 사용 전 로컬 설정과 서버 매개변수에 맞춰야 합니다.
해결하려는 문제에 맞춰 읽어 보세요. 먼저 설정 구조를 파악한 뒤 DNS 조회 경로와 플랫폼 설치를 살펴보세요. 각 글의 예시는 사용하는 클라이언트와 코어에 맞는지 확인해야 합니다.
Debian·Ubuntu·Fedora 계열 배포판의 데스크톱 설치 방법을 소개하고 패키지 형식, 아키텍처 선택, 자동 시작, 자주 발생하는 의존성 문제를 설명합니다. 프로그램 설치, 데스크톱 실행, 네트워크 프록시를 나눠 확인하세요.
노트 읽기 →최상위 구조를 바탕으로 인바운드 수신 대기, 아웃바운드 연결, 라우팅 태그의 관계를 설명합니다. JSON 예시를 보며 클라이언트가 생성하는 설정을 이해하고 로컬 수신 매개변수와 서버 연결 매개변수를 구분할 수 있습니다.
노트 읽기 →dns 항목의 servers, domains, expectIPs 설정을 설명하고 로컬·원격 조회와 라우팅의 관계를 살펴봅니다. 먼저 조회 경로를 확인한 뒤 결과가 예상대로인지 판단하세요.
노트 읽기 →기술 노트는 문제별로 설명하며, 전체 설정 구조와 항목별 사용 범위는 설정 참고 문서에서 확인할 수 있습니다.
전체 글 보기 →