Windows
v2rayN은 Desktop과 클래식 WPF 두 가지 인터페이스를 제공합니다. 처음 설치한다면 Desktop부터 사용해 보세요. WPF에 익숙하거나 WPF 가이드의 메뉴를 따라 설정하려면 클래식 버전을 선택하면 됩니다.
버전을 바꾸기 전에 기존 설정을 백업하고 다운로드 페이지에서 실행 환경 요구사항을 확인하세요. 새 인터페이스를 처음 열면 구독 그룹과 로컬 수신 포트가 예상대로 설정되어 있는지 먼저 살펴보세요.
다운로드01 플랫폼별 다운로드
먼저 운영체제를 확인한 다음 프로세서 아키텍처와 패키지 형식을 선택하세요. 데스크톱에서는 v2rayN을 사용하고, Android 기기에서는 구독 요구사항에 따라 Xray 또는 V2Fly 코어를 사용하는 클라이언트를 고를 수 있습니다.
v2rayN은 Desktop과 클래식 WPF 두 가지 인터페이스를 제공합니다. 처음 설치한다면 Desktop부터 사용해 보세요. WPF에 익숙하거나 WPF 가이드의 메뉴를 따라 설정하려면 클래식 버전을 선택하면 됩니다.
버전을 바꾸기 전에 기존 설정을 백업하고 다운로드 페이지에서 실행 환경 요구사항을 확인하세요. 새 인터페이스를 처음 열면 구독 그룹과 로컬 수신 포트가 예상대로 설정되어 있는지 먼저 살펴보세요.
다운로드v2rayN 설치 파일은 칩 종류에 따라 두 가지로 나뉩니다. ‘이 Mac에 관하여’에서 Apple 칩을 확인했다면 arm64, Intel 프로세서라면 x64를 선택하세요. 기기 외관이나 구매 연도만으로 판단하지 마세요.
다른 데스크톱 운영체제에서 옮겨오는 경우 구독은 다시 가져올 수 있지만, 시스템 프록시와 시작 프로그램 설정은 현재 기기에 맞게 확인해야 합니다. 처음 연결할 때는 브라우저 하나만으로 먼저 테스트해 보세요.
다운로드Xray를 사용하는 v2rayNG를 우선 고려하세요. 구독이나 기존 설정이 V2Fly를 명시적으로 요구할 때는 v2flyNG를 살펴보면 됩니다. 두 클라이언트의 인터페이스가 비슷해도 지원하는 코어 설정 필드까지 같은 것은 아닙니다.
대부분의 최신 스마트폰에서는 arm64 패키지를 선택할 수 있습니다. 기기가 어떤 아키텍처를 지원하는지 모르겠다면 기기 정보를 확인하거나 범용 패키지를 선택하세요. 가져오기를 마친 뒤에는 노드를 선택하고 연결을 시작해야 합니다.
다운로드v2rayN은 deb와 rpm 패키지를 제공합니다. Debian과 Ubuntu에서는 보통 deb를, Fedora 등에서는 해당 rpm 패키지를 선택하세요. 그런 다음 현재 시스템 아키텍처에 맞춰 x64 또는 arm64를 고르면 됩니다.
데스크톱 환경과 앱마다 프록시 설정을 읽는 방식이 다를 수 있습니다. 클라이언트가 실행된다는 것은 프로그램이 켜졌다는 뜻일 뿐입니다. 대상 앱의 요청이 로컬 프록시를 통과하는지 별도로 확인하세요.
다운로드02 설정 방법
라우팅 규칙 하나부터 살펴보세요. 먼저 어떤 요청을 일치시킬지 정하고, 일치한 요청을 어떤 아웃바운드로 보낼지 확인합니다. 클라이언트는 이 선택을 양식으로 제공하지만, 실제 동작은 코어가 설정에 따라 처리합니다.
설정을 재사용하려면 인바운드, 아웃바운드, 라우팅을 나눠 확인하는 것이 좋습니다. 인바운드 하나와 아웃바운드 하나로 연결을 먼저 검증한 뒤 분기와 DNS 설정을 차례로 추가하세요. 설정 전체를 그대로 복사하는 것보다 문제 지점을 찾기 쉽습니다.
{
"type": "field",
"domain": ["domain:example.org"],
"outboundTag": "direct"
}
이 설정은 규칙 하나일 뿐 전체 설정이 아닙니다. direct 태그를 가진 아웃바운드가 필요합니다. 태그는 이름일 뿐이며 실제 연결 방식은 아웃바운드 프로토콜에 따라 결정됩니다.
03 설정별 가이드
먼저 노드 하나를 연결한 다음 분기 규칙과 다른 설정을 추가하세요. 연결 상태가 달라지면 한 번에 하나씩 되돌려 노드, 라우팅, DNS 중 무엇이 원인인지 확인하는 편이 쉽습니다.
구독 주소는 업데이트 가능한 노드 목록을 가져오는 데 사용하고, 단일 공유 링크는 노드 하나만 추가합니다. v2rayN에서 먼저 구독 그룹을 만든 뒤 구독 주소를 붙여 넣고 저장한 다음 그룹을 업데이트하세요. 목록이 표시되면 노드를 하나 선택해 연결을 테스트합니다. 노드 링크를 클립보드에서 하나씩 가져오는 것과 달리 구독은 같은 그룹의 노드를 한 번에 새로 고칠 수 있습니다. v2rayNG에서는 보통 구독 설정 메뉴에서 가져옵니다. 업데이트 후에도 목록이 비어 있다면 먼저 입력한 주소가 구독 주소인지 확인하고 해당 주소에 접속할 수 있는지도 살펴보세요.
구독 그룹 설정라우팅은 요청을 직접 연결, 프록시 또는 차단 아웃바운드로 보냅니다. 구체적인 도메인 규칙을 하나 추가하고 이미 알고 있는 도메인으로 일치 결과를 확인한 뒤 더 포괄적인 규칙을 넣어 보세요. 코어는 보통 목록 순서대로 규칙을 처리하므로 조건이 넓은 규칙을 앞에 두면 뒤의 예외 규칙이 적용되지 않을 수 있습니다. JSON 전체를 직접 수정하는 것보다 v2rayN의 라우팅 목록에서 규칙 순서와 아웃바운드를 확인하기 쉽습니다. 모바일 클라이언트로 바꿀 때는 규칙에서 사용할 수 있는 필드와 기본 아웃바운드를 다시 확인하세요.
라우팅 설정클라이언트는 설정을 편집하고 실행하며, 프로토콜 핸드셰이크와 트래픽 전달은 코어가 담당합니다. 전환하기 전에 노드의 프로토콜, 전송 방식, 보안 옵션을 확인한 뒤 v2rayN 설정에서 호환되는 코어를 선택하고 같은 노드의 시작 로그를 살펴보세요. 인식하지 못하는 필드가 표시되면 구독을 바꾸기보다 현재 코어가 해당 옵션을 구현하는지 먼저 확인하세요. Android에서는 v2rayNG가 Xray, v2flyNG가 V2Fly를 대상으로 하므로 설정 호환성을 우선해 선택해야 합니다.
Core 유형 설정같은 네트워크의 다른 기기에서 데스크톱 프록시를 잠시 사용하려면 v2rayN에서 LAN 연결을 활성화한 뒤 다른 기기에 호스트의 LAN 주소와 프록시 포트를 입력하면 됩니다. 각 기기에 구독을 따로 가져오는 대신 호스트에서 노드를 한 번에 선택할 수 있지만, 프록시 설정을 따르는 앱에서만 사용할 수 있습니다. 활성화하면 수신 범위가 넓어지므로 신뢰할 수 있는 네트워크에서만 사용하고 방화벽으로 접속 출처를 제한하세요. 공유가 끝나면 즉시 끄는 것이 좋습니다.
LAN에서 들어오는 연결 허용IP 주소로는 접속되는데 도메인 이름이 열리지 않는다면 앱이 직접 도메인을 확인하는지, 요청이 코어에 전달되어 코어가 확인하는지 먼저 살펴보세요. 필요에 따라 직접 연결과 프록시 요청에 사용할 DNS 서버를 각각 지정하고 하나씩 검증합니다. 시스템 DNS를 바꾸는 것과 달리 클라이언트의 DNS 설정은 해당 DNS 처리 경로를 거치는 요청에만 적용됩니다. 브라우저 자체 DNS 설정에는 영향을 주지 않을 수도 있습니다. 분기 기준이 대상 주소라면 변경 후 도메인 규칙과 주소 규칙의 순서도 다시 확인하세요.
DNS 설정클라이언트에 연결 상태가 표시되어도 모든 앱이 프록시에 연결된 것은 아닙니다. 시스템 프록시는 시스템 설정을 따르는 앱에서만 적용되며, 앱 자체 프록시 옵션이 있을 수도 있습니다. 먼저 시스템 설정을 읽는 것으로 확인된 앱에서 재현한 뒤 대상 앱의 설정과 비교하세요. 포트, 노드, DNS를 한꺼번에 바꾸지 마세요.
연결 확인 및 테스트 방법 보기인터페이스의 항목 이름과 코어 설정 필드가 항상 일대일로 대응하는 것은 아닙니다. 예를 들어 ‘로컬 수신 포트’는 전역 포트가 아니라 특정 인바운드 객체에 설정될 수 있습니다. 현재 편집 중인 항목이 인바운드, 아웃바운드, 라우팅 중 무엇인지 확인하고 참고 예시와 비교하세요. 규칙을 복사할 때는 해당 규칙이 참조하는 아웃바운드 태그도 그대로 유지해야 합니다.
V2Ray 설정 필드 보기04 오픈 소스 생태계
프로젝트 생태계, 실행 코어, 그래픽 클라이언트는 서로 다른 계층입니다. 여러 기기에서 사용할 설정을 살펴볼 때는 먼저 어떤 코어가 각 필드를 해석하는지 확인한 다음 어느 인터페이스에서 가져올지 결정하세요.
V2Ray는 Project V 생태계의 프록시 코어입니다. 인바운드는 앱에서 전달된 요청을 받고, 아웃바운드는 요청을 보낼 곳을 정하며, 라우팅은 사용할 수 있는 아웃바운드 중 하나를 선택합니다. 이 세 가지 설정은 서로 분리되어 있어 로컬 수신 설정을 유지하면서 노드를 바꾸거나, 노드는 그대로 두고 직접 연결 규칙을 추가할 수 있습니다. 예전 가이드는 JSON 설정 파일부터 설명하는 경우가 많지만, 최신 그래픽 인터페이스에서는 같은 개념이 여러 메뉴에 나뉘어 있습니다. 인터페이스가 바뀌었다면 스크린샷의 위치보다 각 필드의 역할을 기준으로 찾아보는 편이 정확합니다.
V2Fly는 V2Ray를 이어받아 커뮤니티에서 관리되고 있으며, Xray는 V2Ray의 코드 기반에서 출발해 독립적으로 구현되었습니다. 두 코어는 인바운드, 아웃바운드, 라우팅 개념을 상당수 공유하므로 한쪽의 예시를 이해하면 다른 쪽을 파악하는 데 도움이 됩니다. 하지만 사용할 수 있는 필드와 기본 동작, 프로토콜 확장 기능은 다를 수 있습니다. 예를 들어 REALITY 노드를 사용한다면 VLESS 링크를 인터페이스가 인식한다는 이유만으로 연결된다고 판단하지 말고, 선택한 코어가 해당 핸드셰이크와 보안 설정을 지원하는지 확인해야 합니다. 가져오기에 성공했다는 것은 클라이언트가 일부 정보를 읽었다는 뜻일 뿐입니다. 실제 실행 여부는 코어가 생성된 설정을 해석하고 핸드셰이크를 완료할 수 있는지에 달려 있습니다.
v2rayN은 노드와 구독을 관리하고 시스템 프록시를 설정하며, 설정에 따라 지원되는 코어를 호출하는 데스크톱 오픈 소스 클라이언트입니다. v2rayNG는 Android 기기용 오픈 소스 클라이언트로 주로 Xray를 사용합니다. v2flyNG도 오픈 소스이며 V2Fly 코어를 대상으로 합니다. 클라이언트와 코어는 별개의 프로젝트이므로 각각의 라이선스와 릴리스 정보를 확인하세요. 오픈 소스라면 필드 처리 방식과 기본 동작, 변경 내역을 살펴볼 수 있지만, 특정 구독을 신뢰할 수 있다는 뜻은 아니며 도구 간 설정을 그대로 바꿔 쓸 수 있다는 의미도 아닙니다. 기기와 노드의 요구사항을 먼저 확인하고 LAN 연결 같은 구체적인 기능이 필요한지도 고려하세요.
클라이언트 업그레이드는 인터페이스나 설정 생성 방식을 바꿀 수 있고, 코어 업데이트는 프로토콜 처리와 로그, 사용 가능한 필드에 영향을 줄 수 있습니다. 구독 새로 고침은 서버에서 제공한 노드 목록을 다시 읽는 작업입니다. 세 작업은 서로 독립적으로 진행될 수 있습니다. 설정에 문제가 생겼다면 마지막으로 무엇이 바뀌었는지 떠올려 보세요. 특정 구독 그룹에 새로 추가된 항목만 작동하지 않는다면 노드 매개변수를 비교하고, 코어를 바꾼 뒤 여러 노드가 모두 시작되지 않는다면 시작 로그에 설정 오류가 있는지 확인하세요. 업그레이드 전에는 복구할 수 있도록 로컬 설정을 보관하고, 업그레이드 후에는 기존에 연결되던 노드로 테스트한 다음 사용자 지정 라우팅과 DNS를 점검하세요.
같은 노드를 여러 기기에서 사용할 때 보통 재사용할 수 있는 항목은 서버 주소, 프로토콜, 관련 전송 매개변수입니다. 수신 주소, 시스템 프록시 설정, LAN 권한, 라우팅 규칙은 현재 기기의 환경에 따라 달라집니다. 구독을 새로 고쳐도 이러한 로컬 설정이 동기화되는 것은 아닙니다. 설정을 옮길 때는 작동이 확인된 노드만 먼저 가져와 앱 연결을 확인한 다음 라우팅과 DNS를 하나씩 옮기세요. 새 기기와 기존 기기의 결과가 다르면 선택된 아웃바운드, 앱의 연결 방식, 처음 나타난 관련 로그를 기록하세요. 여러 설정을 반복해서 바꾸는 것보다 차이를 찾기 쉽습니다. 구독 주소에 접속 정보가 포함될 수 있으므로 주소 원문을 공개하지 않도록 백업과 로그 공유에 주의하세요.
05 최신 글
처음 설치한다면 데스크톱 설정 절차부터 확인하세요. 이미 연결할 수 있다면 관련 가이드에서 DNS 처리 경로와 공유 범위를 살펴보고 설정 변경이 실제로 어떤 요청에 영향을 주는지 확인하세요.
v2rayN을 Windows에서 압축 해제하고 처음 실행한 뒤 구독을 가져와 시스템 프록시를 설정하는 과정을 순서대로 안내합니다. WPF와 Desktop 버전의 차이를 비교하고 런타임 누락, 포트 충돌 같은 문제도 정리했습니다.
처음 설치하거나 인터페이스가 바뀐 뒤 기존 설정을 찾기 어려운 사용자에게 적합합니다. 프로그램 실행, 구독 업데이트, 앱의 실제 프록시 연결을 각각 나눠 확인합니다.
설치 및 설정 가이드 읽기DNS 조회를 예로 들어 FakeDNS가 가상 주소를 반환하고 코어가 도메인 이름을 복원하는 과정을 설명합니다. TUN과 투명 프록시에서의 역할, 프록시를 우회하는 앱이나 캐시 충돌 등 활성화에 적합하지 않은 상황도 살펴봅니다.
LAN 연결을 켰을 때 수신 주소가 어떻게 바뀌는지, 포트와 시스템 방화벽을 설정하는 방법, 다른 기기에서 프록시 주소를 직접 입력하는 절차를 안내하고 공유 전 확인해야 할 보안 사항도 다룹니다.