V2RAY · V2RAYN · V2RAYNG
구독 가져오기부터 라우팅 분기까지 단계별로 v2rayN / v2rayNG를 설정하고, 코어 로그를 확인해 연결 문제를 진단하세요.
CLIENT SELECTION
데스크톱에서는 v2rayN, Android에서는 v2rayNG부터 살펴보세요. 설치 패키지의 아키텍처는 기기의 프로세서에 맞아야 하며, 파일 형식은 운영체제와 배포판에 따라 달라집니다. 먼저 적합한 클라이언트를 선택한 뒤 기존 서버 설정을 가져오면 설치 문제와 연결 문제를 나눠서 확인할 수 있습니다.
데스크톱 버전은 새로운 세대의 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 기존 데스크톱 조작 방식을 유지합니다. 처음 사용하는 경우 데스크톱 버전에서 서버 목록, 구독 그룹, 로그 패널을 살펴볼 수 있습니다. 기존 사용 방식에 익숙하다면 WPF 버전을 선택해도 됩니다. 두 버전은 인터페이스 형태가 다를 뿐, 유료 플랜의 차이나 구독을 가져온 뒤 연결이 보장된다는 뜻은 아닙니다.
설치 전에 시스템 설정에서 프로세서 아키텍처를 확인하고 다운로드 페이지의 실행 요구 사항을 읽어보세요. 실행 후 구독 그룹을 추가하고 업데이트한 다음, 서버 설정 하나를 선택해 실제 연결 속도를 측정합니다. 시스템 프록시를 켜도 시스템 프록시 설정을 따르는 프로그램에만 적용됩니다. 브라우저가 연결된다고 해서 모든 앱이 같은 경로로 통신하는 것은 아닙니다.
다운로드 페이지로 이동‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon 계열이면 arm64, Intel 프로세서이면 x64를 선택합니다. 두 설치 파일은 아키텍처가 다르므로 둘 다 설치할 필요는 없습니다. 설치 중 시스템 권한 안내가 표시되면 먼저 요청 대상과 설치 출처를 확인한 다음 시스템 안내에 따라 진행하세요.
데스크톱 클라이언트는 설정을 저장하고 서버를 전환하며 코어 실행 매개변수를 생성합니다. 실제 연결은 코어가 처리합니다. 설정을 가져온 뒤에는 현재 활성 서버와 프록시 방식을 확인하세요. 클라이언트를 바꿀 때 데이터 디렉터리 전체를 바로 덮어쓰지 말고 기존 설정을 보존한 뒤 구독과 규칙을 하나씩 옮기면 경로나 권한 차이를 확인하기 쉽습니다.
다운로드 페이지로 이동v2rayNG는 Xray 코어를 사용하는 Android 클라이언트로 우선 고려할 만합니다. v2flyNG는 V2Fly 코어를 사용하며 필요한 코어에 따라 선택할 수 있는 대안입니다. 비교적 최신 스마트폰이라면 arm64 설치 파일부터 확인하고, 아키텍처를 모를 때는 범용 버전 안내를 참고하세요. 휴대전화의 출시 연도만으로 판단하지 말고 실제 아키텍처와 시스템 요구 사항을 확인해야 합니다.
처음 연결할 때 시스템에서 VPN 연결 권한을 요청합니다. 이 권한은 클라이언트가 선택한 트래픽을 처리하도록 허용하는 시스템 인터페이스입니다. 승인한 뒤에는 앱별 프록시 설정, 라우팅 모드, 백그라운드 실행 제한도 확인하세요. 백그라운드로 전환한 뒤 연결이 끊긴다면 구독 주소나 서버 매개변수를 탓하기 전에 배터리 최적화 설정과 프로세스 상태를 살펴보세요.
다운로드 페이지로 이동Debian, Ubuntu 및 관련 파생 배포판에서는 보통 deb 패키지를 선택하고, Fedora처럼 RPM 패키지 체계를 사용하는 배포판에서는 rpm을 선택합니다. x64와 arm64도 구분해야 합니다. 패키지 형식과 프로세서 아키텍처는 별개의 조건이므로 형식이 맞아도 아키텍처가 다르면 설치나 실행이 되지 않을 수 있습니다.
GUI 클라이언트를 실행한 뒤에는 일반 권한으로 구독을 관리하고 기본 연결을 테스트하세요. 추가 권한이 필요한 네트워크 트래픽 처리 방식은 그다음에 검토하면 됩니다. 데스크톱 환경마다 시스템 프록시 지원이 다르고, 일부 프로그램은 별도로 설정해야 합니다. 앱마다 연결 결과가 다르면 해당 앱의 데스크톱 프록시 사용 여부와 DNS 방식을 기록한 뒤 TUN을 켤지 결정하세요.
다운로드 페이지로 이동클라이언트 설치 패키지에는 바로 사용할 수 있는 서버 서비스가 포함되어 있지 않습니다. 연결 주소, 포트, 인증 매개변수, 구독 링크는 사용 권한이 있는 서비스나 직접 구축한 환경에서 제공받아야 합니다. 설치, 가져오기, 속도 측정, 연결 확인은 순서대로 각각 진행하세요.
전체 클라이언트 보기 →CONFIGURATION INDEX
설정 문제는 ‘설정은 어디서 가져왔는가, 트래픽은 어디로 들어오는가, 어떤 출구와 연결되는가, 도메인은 어떻게 조회되는가’ 순서로 나눠 살펴볼 수 있습니다. 아래 다섯 항목은 자주 쓰이는 설정 메뉴이며, 예시는 관련 필드만 보여 줍니다. 단독으로 실행할 수 있는 완전한 설정이 아니므로 실제 필드는 선택한 코어와 클라이언트가 생성한 설정에 맞춰야 합니다.
구독은 서버 설정을 한꺼번에 가져오는 기능이지, 연결이 이미 이루어졌다는 뜻은 아닙니다. v2rayN의 구독 그룹에 전체 주소를 저장한 뒤 업데이트하세요. Android에서도 먼저 그룹을 추가하고 설정을 업데이트해야 합니다. 목록에 항목이 나타나면 활성 서버를 선택해 연결을 테스트하세요. 아래 내용은 로컬 SOCKS 인바운드 설정 일부이며 구독 내용과는 다른 계층입니다. 루프백 주소를 수신 주소로 설정하면 이 기기에서만 연결을 받습니다. 업데이트에 실패하면 구독 요청 로그를 먼저 확인하고, 원격 주소 문제를 해결하려고 인바운드 포트를 바꾸지는 마세요.
{
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}라우팅 분기 규칙은 요청을 어떤 아웃바운드로 보낼지 결정할 뿐, 서버 자체의 문제를 해결하지는 않습니다. 먼저 프록시와 직접 연결 아웃바운드에 알아보기 쉬운 태그를 지정하고, 구체적인 규칙부터 작성한 뒤 기본 출구를 정하세요. 아래 예시에서는 사설 주소를 direct라는 이름의 아웃바운드로 보냅니다. 이 태그가 전체 설정에 있어야 하고 참조하는 규칙 데이터도 사용할 수 있어야 합니다. 잘못된 분기를 진단할 때는 앞쪽에 먼저 일치하는 규칙이 있는지 확인하고 도메인이 IP로 변환됐는지도 살펴보세요. 규칙 이름만 보고 결과를 판단하거나 여러 규칙을 한꺼번에 수정하지 마세요.
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}웹페이지가 열리지 않아도 서버를 사용할 수 없는 것은 아닙니다. 도메인 조회가 예상한 경로를 따르지 않을 수도 있습니다. 시스템 DNS, 앱 자체의 암호화 DNS, 코어 내장 DNS를 구분한 다음 라우팅 규칙이 DNS 조회에 적용되는지 확인하세요. 아래는 코어 DNS 서버의 간략한 설정 필드이며 모든 앱의 조회가 이 설정으로 처리된다는 뜻은 아닙니다. 변경 전후의 로그와 접속 결과를 비교하면서 한 번에 DNS 설정 한 곳만 조정하세요. 원격 DNS를 사용한다면 DNS 서버까지 연결할 수 있는지도 확인해 의존성 순환을 피해야 합니다.
{
"dns": {
"servers": [
"1.1.1.1",
"8.8.8.8"
]
}
}TUN은 가상 네트워크 인터페이스로 트래픽을 처리하므로 더 많은 앱의 트래픽을 포함해야 할 때 유용합니다. 다만 권한, 라우팅, DNS 설정이 함께 맞아야 합니다. 먼저 일반 프록시 연결이 정상인지 확인하고 클라이언트에서 TUN을 켠 뒤 가상 인터페이스와 시스템 라우팅의 변화를 살펴보세요. 아래는 로컬 연결 테스트용 SOCKS 인바운드 설정이지 TUN 스위치가 아닙니다. TUN 구현과 설정 형식은 클라이언트의 구성 요소에 따라 다르므로 이 JSON을 가상 네트워크 인터페이스 설정으로 사용할 수 없습니다. 연결이 끊기면 먼저 TUN을 끄고 로그를 보존한 뒤 원인을 찾아보세요.
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}
]
}코어 실행 실패와 연결 후 시간 초과는 발생 단계가 다르므로 따로 살펴봐야 합니다. 같은 실행 과정에서 가장 먼저 발생한 오류를 찾고 설정 문법, 포트 사용 여부, 필드 호환성을 확인한 뒤 원격 연결과 TLS 핸드셰이크를 점검하세요. 문제를 재현하는 동안 로그 수준을 임시로 높이면 진단에 도움이 됩니다. 확인이 끝나면 불필요한 로그를 줄이도록 평소 수준으로 되돌리세요. 아래 warning 설정은 경고와 오류를 확인하는 데 적합합니다. 로그를 공유하기 전에 구독 링크, 인증 매개변수, 실제 주소를 삭제하고 오류 유형과 앞뒤 내용만 남기세요.
{
"log": {
"loglevel": "warning"
}
}처음 설정할 때는 기본 라우팅을 유지하고, 매개변수가 완전한 서버 설정 하나로 연결을 확인한 뒤 분기와 DNS 설정을 차례로 추가하세요. 여러 옵션을 한꺼번에 켜면 점검 범위가 넓어집니다. 매번 변수 하나만 바꾸고 변경 전 값을 기록해 두면 나중에 복원하고 비교할 수 있습니다.
첫 연결을 단계별로 설정하기 →PROJECT V ECOSYSTEM
V2Ray는 이 프록시 도구 생태계를 이해하는 출발점이지만 클라이언트, 코어, 프로토콜은 서로 다른 개념입니다. 각 요소의 역할을 알면 소프트웨어 이름만 비교하는 것보다 적합한 도구를 고르기 쉽고, 설정을 그대로 옮길 때 생기는 오해도 줄일 수 있습니다.
설정 구조와 프록시 구성 요소
프로토콜 처리와 연결 실행
설정 관리 및 조작 인터페이스
BACKGROUND
Project V는 프록시 기능을 서로 협력하는 구성 요소로 나눕니다. V2Ray는 그중 널리 쓰이는 구현체입니다. 설정을 이해할 때 인바운드는 앱 트래픽의 진입점, 아웃바운드는 연결 대상에 도달하는 방식, 라우팅은 둘 사이에서 경로를 선택하는 규칙으로 볼 수 있습니다. DNS, 로그, 정책은 각각 도메인 조회, 상태 확인, 리소스 관리 기능을 제공합니다. 이런 구조 덕분에 하나의 설정으로 여러 진입점과 출구를 구성할 수 있으며, 서버 주소만 바꾸는 것으로 모든 연결 문제가 해결되지 않는 이유도 알 수 있습니다.
GUI 클라이언트는 이러한 구조를 목록, 그룹, 스위치, 입력 폼으로 보여 줘 일상적인 관리 작업을 쉽게 해줍니다. 원격 서버가 아니며 서버 측 설정을 대체하지도 않습니다. 링크를 가져오면 보통 매개변수 묶음이 로컬 설정으로 변환될 뿐입니다. 실행할 때 클라이언트가 현재 라우팅 모드, 수신 포트, 사용자 설정에 따라 실행 설정을 다시 생성할 수도 있습니다. 따라서 가이드를 읽을 때 ‘가져올 때 저장된 설정’과 ‘현재 코어가 실제로 읽는 설정’을 구분해야 합니다. 두 파일이나 화면의 내용이 완전히 같다고 생각하지 마세요.
CORE FAMILIES
V2Fly는 V2Ray를 이어받아 커뮤니티에서 관리하고 있으며, Xray는 관련 코드에서 분기해 발전한 프로젝트입니다. 두 코어는 일부 설정 개념을 공유하지만 프로토콜 기능, 필드 지원, 향후 개발 방향이 완전히 같지는 않습니다. JSON 구조가 비슷하다고 모든 필드를 서로 바꿔 쓸 수 있는 것은 아닙니다. 한 코어가 지원하는 전송 매개변수를 다른 코어가 같은 방식으로 해석한다고 볼 수도 없습니다. 호환성을 확인하려면 클라이언트에서 실제로 사용하는 코어를 확인한 다음 프로토콜, 전송 계층, 보안 계층의 조합을 점검하세요.
VMess, VLESS, Trojan, Shadowsocks는 프로토콜 이름이고 WebSocket, gRPC 등은 전송 방식을 가리킵니다. TLS는 별도의 연결 보안 설정에 해당합니다. 하나의 서버 설정에 여러 이름이 함께 나타나더라도 담당하는 역할은 서로 다릅니다. 문제를 진단할 때는 코어를 바꿔가며 시도하기보다 주소와 포트, 인증 매개변수, 전송 경로, 서버 이름 순서로 확인하세요. 특정 기능이 필요한 경우에만 코어 선택을 설정 설계에 반영하면 됩니다.
OPEN SOURCE CLIENTS
v2rayN, v2rayNG, v2flyNG는 모두 커뮤니티 프로젝트가 소스 코드를 관리하는 오픈 소스 GUI 클라이언트입니다. v2rayN은 데스크톱용으로 서버 관리, 구독 그룹, 라우팅 등 자주 쓰는 기능을 제공합니다. Android용 v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 기기와 시스템 요구 사항, 서버 측 매개변수의 호환성을 먼저 확인하고 인터페이스 사용 방식은 그다음에 고려하세요. 이름이 비슷해도 같은 설치 패키지가 아니며 데이터 디렉터리를 그대로 공유할 수 있다는 뜻도 아닙니다.
오픈 소스 라이선스는 소프트웨어 코드의 사용, 수정, 재배포 조건을 설명하며 원격 서비스의 이용 가능 여부와는 관계가 없습니다. V2Ray와 Xray의 코어 코드는 MPL 2.0을 따르지만 각 클라이언트와 포함된 구성 요소의 라이선스 및 고지는 따로 확인해야 합니다. 클라이언트는 무료로 쓸 수 있어도 원격 서버, 네트워크 연결, 구독 서비스는 서로 다른 주체가 제공할 수 있습니다. 소프트웨어 도구와 서비스 제공처를 구분하면 문제를 어느 쪽에서 처리해야 할지 판단하기 쉽고, 서비스 요금을 클라이언트 라이선스 비용으로 오해하는 일도 막을 수 있습니다.
UPDATE & DIAGNOSIS
클라이언트 업데이트와 코어 업데이트가 항상 같은 작업은 아닙니다. 인터페이스 변경은 설정 메뉴의 위치에 영향을 줄 수 있고, 코어 변경은 필드 호환성과 프로토콜 동작을 바꿀 수 있습니다. 업데이트 전에 구독 그룹, 사용자 지정 라우팅, 필요한 개인 설정을 저장하고 변경 사항을 확인하세요. 업데이트 후에는 기존 설정이 실행되는지 먼저 확인하고 자주 사용하는 접속 환경을 테스트하세요. 기본 연결이 정상임을 확인한 다음 실험적인 라우팅이나 트래픽 처리 설정을 복원하면 업데이트로 인한 변화를 비교하기 쉽습니다.
업데이트 후 문제가 생겨도 모든 설정을 삭제하고 다시 설치하지 말고, 클라이언트 종류와 사용 중인 코어, 운영체제, 오류가 발생한 단계를 먼저 기록하세요. 코어 실행에 실패하면 처음 발생한 설정 오류를 확인하고, 일부 도메인만 접속되지 않으면 DNS와 규칙 적용을 살펴보세요. 브라우저는 되지만 다른 프로그램이 안 된다면 프록시 적용 범위를 점검해야 합니다. 로그에 실제 서버, 구독 주소, 인증 정보가 포함되어 있으면 먼저 숨긴 뒤 재현 절차를 정리하세요. 필드 설명과 최소 예시는 설정 참고 자료에서, 실제 작업 순서는 사용 가이드에서 확인할 수 있습니다.
TECHNICAL NOTES
사용 가이드는 전체 작업 흐름을 따라 구성하고 기술 노트는 한 가지 문제를 집중적으로 다룹니다. 설치를 마친 뒤 다음에 무엇을 확인할지 모르겠다면 첫 연결 가이드부터 읽어보세요. 버튼과 패널의 기능을 알고 싶다면 메인 화면 개요를, 트래픽 분기 규칙을 수정하려면 규칙 문법과 적용 순서를 확인하세요.
v2rayN 메인 창을 영역별로 살펴봅니다. 서버 목록의 마우스 오른쪽 버튼 메뉴, 구독 그룹 전환, 하단 로그 패널 확인 방법, 매개변수 설정에서 자주 사용하는 옵션을 안내합니다.
노트 읽기 →구독을 가져온 뒤 실제 연결 속도를 측정해 사용할 서버를 고르세요. 시스템 프록시를 켜고 브라우저 접속과 외부 IP 조회로 트래픽이 프록시를 통과하는지 확인하면 됩니다.
노트 읽기 →domain 접두사, full 및 regexp 매칭, ip와 geoip 작성법, geosite 분류 참조 방법과 규칙의 위에서 아래로 적용되는 순서, domainStrategy의 영향을 설명합니다.
노트 읽기 →문제 해결 문서를 읽을 때는 구독 업데이트, 코어 실행, 연결 수립, 앱 접속 중 어느 단계에서 문제가 발생했는지 먼저 확인하세요. 같은 시간 초과 메시지도 원인이 된 단계가 다를 수 있습니다. 발생 위치와 직전 로그를 함께 살펴보면 무작정 다시 시도하는 것보다 원인을 빠르게 좁힐 수 있습니다.
전체 글 보기 →