클라이언트에서는 구독을 관리하고 코어를 실행하며, 설정 파일은 코어가 트래픽을 수신·해석·전달하는 방식을 정의합니다. 아래 예시는 필드를 이해하기 위한 것으로, 완성된 설정 파일로 바로 사용할 수 없습니다.
구독 항목과 로컬 인바운드
구독은 노드 목록을 일괄 업데이트하는 데 사용합니다. v2rayN을 예로 들면 먼저 구독 주소를 추가하고 해당 그룹을 업데이트한 다음, 갱신된 목록에서 노드를 선택합니다. 목록에 항목이 표시된다는 것은 클라이언트가 설정을 읽었다는 뜻일 뿐, 서버 연결이 확인됐다는 의미는 아닙니다. 구독 주소는 클라이언트에서 관리하는 데이터이며 코어의 JSON 필드가 아닙니다. 아래 SOCKS 인바운드는 코어를 실행한 뒤 로컬 앱에서 사용하는 프록시 진입점으로, 원격 구독 주소와는 별개입니다. 앱에 프록시를 직접 입력할 때는 현재 설정에 표시된 포트를 확인하세요.
라우팅 규칙은 코어로 들어온 연결을 어떤 아웃바운드로 보낼지 정합니다. 규칙은 목록 순서대로 확인하며 처음 일치하는 규칙이 적용되므로, 구체적인 규칙을 포괄적인 조건보다 앞에 두는 것이 일반적입니다. 예시에서는 대상 주소가 사설 네트워크 대역에 해당하면 direct 태그가 붙은 아웃바운드로 보냅니다. 이 태그는 아웃바운드 목록에 별도로 정의해야 합니다. 앱이 연결을 프록시 진입점으로 보내지 않는다면 라우팅 규칙을 바꿔도 트래픽에는 영향이 없습니다. 분기를 테스트할 때는 먼저 진입점을 고정하고, 규칙에 일치해야 하는 연결과 일치하지 않아야 하는 연결을 각각 확인하세요.
코어는 설정을 해석하고 실행합니다. 전환하기 전에 노드의 프로토콜·전송 방식·보안 매개변수가 대상 코어에서 모두 지원되는지 확인하세요. 프로토콜 이름만 확인해서는 안 됩니다. v2rayNG와 v2flyNG는 각각 Xray와 V2Fly를 사용하며, 같은 앱 안의 두 가지 전환 옵션이 아닙니다. 아래 freedom 아웃바운드는 두 코어에서 공통으로 사용할 수 있는 기본 문법을 보여 주며, 직접 연결만 처리하고 원격 노드 매개변수는 포함하지 않습니다. 사용자 지정 설정을 옮길 때는 로그에서 코어가 설정을 읽고 정상적으로 시작했는지 확인한 뒤 실제 접속을 테스트하세요.
DNS 설정은 도메인 이름을 주소로 변환하는 방식에 영향을 주며, 대상 주소에 의존하는 라우팅 규칙에도 영향을 줄 수 있습니다. 아래에서는 코어의 DNS 서버 목록에 localhost를 지정해 로컬 시스템의 이름 해석 기능을 사용합니다. 브라우저에 내장된 보안 DNS를 강제로 끄거나 모든 앱의 DNS 동작을 바꾸지는 않습니다. 같은 앱에서 알려진 주소에는 접속되지만 도메인이 열리지 않는다면 먼저 DNS 오류를 기록하고 실제 조회를 어느 계층에서 수행하는지 확인하세요. 원인을 파악하기 어려워지므로 DNS 서버, 노드, 라우팅을 한꺼번에 바꾸지 마세요.
{
"dns": {
"servers": ["localhost"]
}
}
앱 프록시 진입점과 가상 네트워크 어댑터
시스템 프록시는 시스템 설정을 참조하는 앱에 프록시 주소를 전달하므로, 보통 브라우저에서 먼저 연결을 확인하기에 적합합니다. 터미널 프로그램은 별도의 프록시 설정을 사용할 수 있으므로 웹페이지가 열린다고 해서 터미널 트래픽도 프록시를 거친다고 볼 수는 없습니다. TUN은 가상 네트워크 어댑터로 트래픽을 수신하며, 적용 범위는 라우팅·권한·플랫폼에 따라 달라집니다. 아래 HTTP 인바운드는 앞서 설명한 방식에서 사용할 수 있는 로컬 진입점만 보여 주며 가상 네트워크 어댑터를 만들지는 않습니다. 문제를 확인할 때는 접속 방식을 하나 선택한 다음 시스템 설정과 클라이언트 로그를 대조해 트래픽이 코어에 도달했는지 확인하세요.
v2rayN 다운로드 항목에는 x64 데스크톱 버전과 클래식 WPF 버전이 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 인터페이스를 유지합니다. 서로 다른 그래픽 프로그램일 뿐 노드 프로토콜이 다른 것은 아닙니다. 먼저 시스템의 「정보」 페이지를 열어 시스템 종류를 확인하고 해당 아키텍처의 프로그램을 실행할 수 있는지 살펴보세요.
기존 설치에서 옮기는 경우 기존 인스턴스를 종료한 다음 새 프로그램을 실행하세요. 한 기기에서 두 클라이언트가 같은 로컬 수신 포트를 사용하면 나중에 실행한 쪽에서 포트가 사용 중이라는 오류가 날 수 있습니다. 전환 후에는 시스템 프록시가 현재 프로그램의 실제 수신 주소와 포트를 가리키는지도 확인하세요. 실행에 실패했다면 먼저 인터페이스 프로그램이 실행되지 않은 것인지, 인터페이스는 열렸지만 코어가 시작되지 않은 것인지 구분한 뒤 해당 오류 메시지를 확인하세요.
시스템의 「이 Mac에 관하여」에서 칩 또는 프로세서 정보를 확인하세요. Apple 칩으로 표시되는 기기에는 Apple Silicon용 arm64 설치 파일을, Intel 프로세서로 표시되는 기기에는 x64 설치 파일을 선택하세요. 두 항목의 차이는 프로세서 아키텍처이므로 구독 프로토콜에 따라 고를 필요는 없으며, 기기의 외관만 보고 판단해서도 안 됩니다.
디스크 이미지가 열리면 앱을 「응용 프로그램」으로 옮긴 뒤 실행하세요. 이후에도 고정된 위치에서 편리하게 열 수 있습니다. 처음 테스트할 때는 시스템 프록시를 사용하는 브라우저 하나만 이용해 네트워크 옵션을 여러 개 동시에 바꾸지 않는 것이 좋습니다. Wi-Fi와 유선 네트워크의 프록시 설정은 서로 다른 네트워크 서비스에 적용될 수 있습니다. 네트워크를 바꾼 뒤 동작이 달라지면 구독을 다시 가져오기 전에 현재 사용 중인 네트워크 서비스의 설정부터 확인하세요.
최근 기기는 대부분 arm64 패키지를 선택할 수 있지만, 시스템에서 해당 아키텍처의 앱 실행을 지원해야 합니다. 확실하지 않다면 범용 패키지를 확인하세요. 범용 패키지에는 보통 여러 아키텍처용 네이티브 라이브러리가 포함되어 있지만, 클라이언트 자체의 시스템 요구사항은 여전히 충족해야 합니다. v2rayNG는 Xray 코어를 사용하며 V2Fly 동작을 비교하려면 v2flyNG를 선택하세요.
VPN 모드를 처음 사용할 때는 시스템에서 연결 권한을 확인하라는 메시지가 표시됩니다. 기기에서 다른 앱이 이미 VPN 연결을 설정했다면 서로 충돌하는지 먼저 확인하세요. 연결이 설정된 뒤 특정 앱만 다르게 동작한다면 클라이언트에서 앱별 필터링을 켰는지 확인하고, 해당 앱이 포함 목록이나 제외 목록에 있는지 살펴보세요. 이 단계에서는 설치 아키텍처가 보통 주요 점검 대상이 아닙니다. 아키텍처 문제는 주로 설치하거나 네이티브 라이브러리를 불러올 때 발생합니다.
먼저 배포판에 맞는 패키지 형식을 고르고, 이어서 기기에 맞는 아키텍처를 선택하세요. Debian 패키지 체계를 사용하는 배포판에는 보통 deb를, RPM 패키지 체계를 사용하는 배포판에는 보통 rpm을 선택합니다. 두 형식 모두 x64와 arm64 항목이 있으므로 패키지 형식과 아키텍처를 각각 확인해야 합니다. 패키지 형식이 맞다고 해서 아키텍처까지 맞는 것은 아닙니다.
패키지 관리자가 누락된 의존성이나 호환성 문제를 알리면 메시지를 기록하고 설치 단계에서 문제를 해결한 다음 v2rayN을 실행하세요. 실행 후 데스크톱 앱이 시스템 프록시를 사용하는지는 데스크톱 환경과 앱 자체에 따라 달라집니다. 브라우저는 되는데 터미널은 되지 않는다면 터미널 도구의 프록시 매개변수나 환경 설정을 따로 확인하세요. 터미널이 프록시를 사용하지 않는 것을 설치 실패로 오해하지 마세요.
처음에는 노드 하나, 라우팅 규칙 하나, 앱 하나만 테스트하세요. 기본 연결을 확인한 다음 다른 접속 방식을 사용하거나 DNS 설정을 조정하세요.
01 데이터 가져오기
구독 가져오기
구독 주소를 받으면 구독 그룹에 항목을 추가해 저장하고 해당 그룹을 직접 업데이트하세요. 주소 저장과 노드 가져오기는 별개의 단계입니다. 목록이 비어 있다면 방금 추가한 그룹을 선택했는지 확인한 뒤 업데이트 결과를 살펴보세요. 노드 공유 링크 하나만 있다면 단일 노드 가져오기 기능을 사용하세요.
가져온 뒤에는 프로토콜과 전송 매개변수가 명확한 항목 하나를 먼저 선택하세요. 업데이트 오류가 발생하면 주소가 잘렸거나 불필요한 공백이 붙었는지 확인하세요. 업데이트는 성공했지만 일부 노드만 보이지 않는다면 해당 노드의 형식이 클라이언트에서 지원되는지 확인하세요. 문제를 설명하기 위해 화면을 공유할 때는 구독 주소, 계정 정보, 노드 인증 정보를 가리세요.
02 아웃바운드 규칙
라우팅 모드 선택
어떤 연결은 직접 연결하고 어떤 요청은 프록시 노드로 보낼지 먼저 정하세요. 클라이언트의 사전 설정 규칙을 사용할 때는 실제로 선택된 규칙이 무엇인지 확인하고 직접 연결 대상과 프록시 대상의 조건을 살펴보세요. 사내 네트워크나 LAN 서비스를 직접 연결 테스트 대상으로 삼고, 프록시 테스트에는 안정적으로 접속되는 것으로 확인된 대상을 선택하세요.
시스템 프록시 스위치는 일부 앱이 트래픽을 로컬 진입점으로 보낼지 결정하고, 라우팅 모드는 코어가 받은 연결을 어디로 보낼지 정합니다. 두 설정은 서로 대체할 수 없습니다. 규칙을 바꾼 뒤 LAN 접속이 달라졌다면 기존 노드는 그대로 두고 원래 규칙으로만 되돌려 테스트하세요. 조건 일치 방식이 바뀐 것인지 앱이 아예 다른 진입점을 사용하게 된 것인지 구분하기 쉽습니다.
03 실제 요청
연결 및 확인
데스크톱에서는 노드를 선택하고 코어의 수신 준비가 완료됐는지 확인한 뒤 필요에 따라 시스템 프록시를 켜세요. 모바일에서는 노드를 선택한 뒤 VPN 연결을 설정하고 시스템 권한을 확인하세요. 실제 앱으로 직접 연결 대상과 프록시 대상을 각각 접속하고, 클라이언트 로그에 해당 요청이 표시되는지도 확인하세요. 목록에 표시된 지연 시간이나 연결 상태만으로는 이를 확인할 수 없습니다.
두 대상 모두 접속되지 않으면 먼저 로컬 진입점이나 VPN 상태를 확인하세요. 프록시 대상만 실패한다면 노드, 라우팅 규칙 일치 여부, 원격 핸드셰이크를 점검하세요. 브라우저 접속을 확인한 뒤 명령줄도 사용하려면 대상 도구에서 별도로 테스트하세요. 클라이언트를 종료하기 전에 시스템 프록시를 끄거나 지워야 다른 프로그램이 중지된 로컬 포트로 계속 연결하지 않습니다.
Project V는 초기 V2Ray 프로젝트를 이해하기 위한 출발점입니다. V2Ray는 트래픽을 받는 인바운드, 트래픽을 내보내는 아웃바운드, 매칭 규칙을 각각 정의합니다. 하나의 인바운드에서 받은 요청도 라우팅을 통해 서로 다른 아웃바운드로 보낼 수 있습니다. 이 구조에서는 트래픽을 받는 단계와 보낼 곳을 정하는 단계를 나눠 점검할 수 있으며, 다양한 그래픽 클라이언트가 공통 설정 개념을 활용할 수 있습니다.
v2rayN·v2rayNG·v2flyNG는 노드 관리, 설정, 실행 기능을 제공하는 오픈 소스 그래픽 클라이언트입니다. 데스크톱 클라이언트의 인터페이스 설정은 코어 설정 파일과 다르며, 모바일에서 VPN 권한을 승인하는 것도 운영체제의 동작입니다. 자료를 찾을 때는 문제가 인터페이스, 운영체제, 코어 중 어디에서 발생했는지 먼저 판단하세요. 예를 들어 프로그램 인터페이스가 정상적으로 열려도 코어가 수신 대기 중이라는 뜻은 아니며, 시스템에서 VPN 권한을 허용해도 원격 핸드셰이크 성공이 보장되지는 않습니다.
V2Fly와 Xray의 공통 문법과 차이점
V2Fly 커뮤니티는 V2Ray 코어를 이어서 유지 관리하고 있으며, Xray는 V2Ray 코드에서 분기되어 발전했습니다. 두 코어는 인바운드·아웃바운드와 여러 라우팅 필드의 개념이 비슷하지만 각각 독립적으로 구현됩니다. 같은 이름의 필드라도 현재 코어에서 지원하는 범위를 확인해야 합니다. 특히 새로운 전송 방식과 보안 옵션은 한쪽 설정의 매개변수를 다른 쪽에 그대로 적용할 수 없습니다.
클라이언트를 선택할 때는 노드에서 요구하는 매개변수를 먼저 확인하고, 클라이언트가 어떤 코어를 호출할 수 있는지 살펴보세요. 기존 환경에서 작동하던 설정이 새 환경에서 알 수 없는 필드나 지원되지 않는 옵션 오류를 낸다면 로그에서 필드 이름을 확인한 뒤 클라이언트가 잘못된 매개변수를 생성했는지, 대상 코어가 이를 인식하지 못하는지 판단하세요. 민감한 정보가 없는 간단한 설정으로 확인하면 반복해서 재설치하는 것보다 문제를 찾기 쉽습니다. 자주 쓰는 이름은 코어 용어에서 비교할 수 있습니다.
프로토콜·전송·보안 계층을 각각 확인하세요
VMess·VLESS·Trojan은 이 생태계에서 모두 사용되지만 인증 방식, 연결 매개변수, 보안 계층 요구사항은 서로 다릅니다. 프로토콜 항목과 전송 항목은 서로 다른 기준을 설명합니다. 클라이언트가 특정 프로토콜을 인식하더라도 해당 노드의 모든 전송 조합을 지원한다는 뜻은 아닙니다. 원격 주소와 포트가 정확해도 전송 매개변수나 서버 이름이 일치하지 않으면 연결에 실패할 수 있습니다.
예를 들어 VLESS 자체는 콘텐츠를 암호화하지 않습니다. 관련 설정을 확인할 때는 실제로 사용하는 보안 계층도 살펴봐야 하며, 프로토콜 이름만으로 연결 특성을 단정해서는 안 됩니다. 클라이언트와 코어의 소스 코드가 공개되어 있어도 프로그램으로 가져온 서드파티 노드를 해당 프로젝트에서 운영한다는 뜻은 아닙니다. 소프트웨어 출처, 연결 설정, 노드 운영자는 각각 따로 확인해야 합니다. 용어의 자세한 의미는 프로토콜 빠른 안내에서 확인하세요.
클라이언트·코어·구독은 각각 별도로 업데이트됩니다
클라이언트 업데이트는 인터페이스나 설정 생성 방식을 바꿀 수 있고, 코어 업데이트는 지원 필드에 영향을 줄 수 있으며, 구독 업데이트는 그룹의 노드 목록을 새로 고칩니다. 세 항목을 동시에 업데이트할 필요는 없습니다. 최근 변경으로 문제가 발생했다면 증상이 어느 단계부터 나타났는지 먼저 기록하세요. 소프트웨어 업데이트 후 실행되지 않는다면 코어 로그를 확인하고, 구독 업데이트 후 특정 노드만 작동하지 않는다면 먼저 해당 노드의 새 매개변수를 확인하세요.
규칙을 직접 관리한다면 현재 라우팅 설정, 주요 태그, 로컬 포트를 기록해 변경 전후를 비교할 수 있습니다. 먼저 작동이 확인된 노드 하나로 프록시 진입점과 원격 연결을 점검한 뒤 사용자 지정 라우팅과 DNS 설정을 하나씩 되돌리세요. 구독과 사용자 지정 설정을 옮겨야 한다면 인증 정보가 포함된 자료는 관리되는 안전한 위치에 보관하세요. 문제를 보고할 때는 일반적으로 오류 유형과 관련 필드 이름만 제공하면 됩니다.
오류가 발생한 위치에 따라 자료를 찾아보세요
구독 목록이 비어 있다면 가져오기 메뉴, 그룹, 업데이트 오류부터 확인하세요. 목록은 정상인데 모든 앱에서 접속할 수 없다면 코어가 실행 중인지, 포트가 수신 대기 중인지, 앱 요청이 로컬 진입점으로 전달되는지 확인하세요. 일부 대상만 실패한다면 라우팅 규칙 일치 여부, 도메인 이름 해석, 원격 연결을 살펴보세요. 이런 순서를 따르면 로컬 접속 문제를 노드 교체로 해결하려 하거나, 노드가 이미 작동하지 않는데 시스템 프록시만 계속 바꾸는 일을 피할 수 있습니다.
화면 조작 방법은 시작 가이드에서, 필드 값과 구조는 JSON 매뉴얼에서 확인하세요. 매뉴얼의 인바운드와 아웃바운드 예시는 해당 예제가 다루는 부분만 보여 줍니다. 기존 설정과 합칠 때는 이름이 같은 태그를 참조하는지와 기본 아웃바운드 순서를 먼저 확인한 뒤 실제 요청으로 테스트하세요.
05 사용 팁
설치·프록시 모드·노드 선택
현재 겪는 문제에 맞는 항목을 확인하세요. 클라이언트 실행 여부를 먼저 확인하고, 요청이 코어에 도달하는지 살펴본 다음 노드별 동작을 비교하세요.