레퍼런스 inbounds / routing / outbounds 설정 단계별 안내

v2rayN 다운로드와 V2Ray 설정 레퍼런스

4개 플랫폼 클라이언트 다운로드 경로를 모아 실제 설정 필드를 바탕으로 구독 가져오기, 프록시 모드, 라우팅 규칙을 안내합니다.

오픈 소스 Xray / V2Fly 코어 JSON 설정 레퍼런스

V2Ray 클라이언트 다운로드

운영체제와 프로세서 아키텍처를 확인한 뒤 클라이언트와 설치 파일 형식을 선택하세요.

Windows v2rayN · Desktop / WPF

데스크톱에서는 v2rayN을 우선 고려하세요. Desktop은 크로스 플랫폼 인터페이스를 제공하고, WPF는 익숙한 기존 데스크톱 방식을 유지합니다. 두 버전 모두 서버 목록, 구독 그룹, 라우팅 설정을 중심으로 구성되어 있으므로 인터페이스 사용감과 설치 요구 사항을 확인해 선택하면 됩니다.

처음 실행하면 기존 구독 주소나 공유 링크를 가져온 다음 사용할 서버를 선택하세요. 시스템 프록시를 설정하기 전에는 로컬 리스닝 포트를 확인하고, 종료할 때 프록시 설정을 원래대로 돌려놓아 중지된 로컬 서비스에 앱이 계속 연결하지 않도록 하세요.

다운로드 페이지로 이동
macOS v2rayN · Apple Silicon / Intel

v2rayN 데스크톱 인터페이스에서 설정을 관리하세요. ‘이 Mac에 관하여’에서 칩 정보를 확인할 수 있습니다. Apple Silicon은 arm64, Intel 프로세서는 x64에 해당합니다. 설치 파일 형식이 같아도 프로세서 아키텍처는 다를 수 있으므로, 먼저 칩을 확인한 뒤 다운로드하세요.

설정을 가져온 뒤 일반 시스템 프록시부터 테스트하세요. 시스템 프록시 설정을 따르지 않는 앱까지 연결해야 한다면 TUN 모드 요구 사항을 확인하세요. 시스템 권한, 네트워크 서비스, 클라이언트 코어는 서로 다른 점검 항목이므로 한꺼번에 변경하지 않는 것이 좋습니다.

다운로드 페이지로 이동
Android v2rayNG / v2flyNG

Xray 코어 기반 v2rayNG를 우선 사용하고, V2Fly 설정과의 호환성이 필요하면 v2flyNG를 고려하세요. 최신 스마트폰은 대체로 arm64를 선택하면 됩니다. 아키텍처를 모를 때는 기기 정보를 확인하거나 용량이 더 큰 범용 설치 파일을 선택하세요.

처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다. 같은 시점에 해당 인터페이스를 사용하는 다른 앱이 실행 중이면 연결에 영향을 줄 수 있습니다. 백그라운드에서 연결이 끊긴다면 서버 문제를 의심하기 전에 시스템 배터리 관리와 백그라운드 실행 권한부터 확인하세요.

다운로드 페이지로 이동
Linux v2rayN · deb / rpm

v2rayN 그래픽 인터페이스에서 서버와 구독을 관리하세요. Debian·Ubuntu 계열 배포판은 보통 deb를, RPM 패키지 관리 체계를 사용하는 배포판은 rpm을 선택합니다. x64와 arm64도 구분해야 하며, 설치 파일 형식이 아키텍처 선택을 대신하지는 않습니다.

데스크톱 환경마다 시스템 프록시 지원 범위가 다를 수 있습니다. 브라우저는 연결되지만 다른 프로그램은 연결되지 않는다면 해당 프로그램이 데스크톱 프록시 설정을 따르는지 확인하세요. TUN에는 권한, 라우팅, DNS도 관여하므로 설치가 완료됐다는 이유만으로 트래픽이 정상적으로 전달된다고 판단하면 안 됩니다.

다운로드 페이지로 이동

V2Ray 설정 구조

로컬 리스닝부터 원격 아웃바운드까지, 각 필드를 따라 트래픽 처리 과정을 살펴보세요.

inbounds: 앱 트래픽이 들어오는 입구

인바운드는 코어가 트래픽을 받는 방식을 정의합니다. 흔히 사용하는 로컬 설정은 SOCKS 리스너를 두고 주소를 루프백 인터페이스로 제한합니다. 앱의 프록시 주소와 포트를 여기에 맞춰야 트래픽이 다음 라우팅 단계로 넘어갑니다. 포트가 이미 사용 중이라면 원격 서버를 바꾸기보다 다른 클라이언트나 중복 실행된 프로세스가 있는지 먼저 확인하세요. 연결 버튼만 사용하는 경우와 달리 인바운드 필드를 확인하면 ‘앱이 프록시로 연결을 보내지 않는 문제’와 ‘프록시가 연결을 받았지만 아웃바운드에 실패한 문제’를 구분할 수 있습니다.

{
  "inbounds": [{
    "tag": "socks-in",
    "listen": "127.0.0.1",
    "port": 10808,
    "protocol": "socks",
    "settings": { "udp": true }
  }]
}

인바운드부터 읽어 보세요. 먼저 앱이 연결을 어디로 보내는지 확인하고, 다음으로 라우팅이 어떤 아웃바운드를 선택하는지 살펴본 뒤 원격 프로토콜과 DNS 처리 방식을 점검하면 됩니다. 클라이언트 화면의 구독, 속도 테스트, 시스템 프록시는 관리 및 시스템 연동 기능으로, 코어 설정의 동명 필드와 반드시 대응하지는 않습니다. 두 계층을 구분해야 화면 옵션, 실행 설정, 운영체제 설정 중 어디를 바꿔야 할지 판단할 수 있습니다.

Project V, V2Fly, Xray 코어 생태계

클라이언트는 설정 화면을 제공하고 코어는 프로토콜·라우팅·DNS 처리를 담당합니다. 두 구성 요소는 별도로 업데이트되며 호환성에도 각각 영향을 줍니다.

Project V: 모듈형 프록시 설정의 배경

Project V는 V2Ray 생태계를 이해하는 출발점입니다. 모든 기능을 하나의 서버 주소에 담는 대신 연결 수신, 규칙 매칭, 아웃바운드 연결, DNS 처리를 각각 나눠 설정합니다. 하나의 실행 인스턴스에서 여러 인바운드와 아웃바운드를 구성하고 태그로 서로 연결할 수도 있습니다. 일상적으로 사용할 때는 그래픽 클라이언트가 설정 대부분을 감춰 주지만, 문제를 해결할 때는 각 기능의 경계가 단계별 점검 순서가 됩니다.

‘V2Ray 클라이언트’는 보통 앱의 한 범주를 가리킬 뿐, 모든 앱이 같은 코어와 설정 형식을 사용한다는 뜻은 아닙니다. 같은 공유 링크라도 클라이언트가 먼저 프로토콜과 추가 매개변수를 파악한 뒤 실제 실행 설정으로 변환해야 합니다. 가져오기에 실패했다면 공유 형식이 지원되는지 확인하세요. 가져오기는 성공했지만 실행에 실패한다면 코어가 생성된 필드를 인식하는지 점검하세요. 프록시 모드를 계속 바꾸는 것보다 문제 발생 지점에 가까운 확인 방법입니다.

V2Fly와 Xray: 공통된 뿌리, 서로 다른 발전

V2Fly는 V2Ray의 커뮤니티 유지보수 흐름을 이어가고, Xray는 관련 코드 기반에서 자체 구현과 확장을 발전시켰습니다. 인바운드, 아웃바운드, 라우팅 태그 같은 기본 개념은 상당 부분 공유하지만 프로토콜 확장, 전송 옵션, DNS 동작, 필드 지원이 항상 같은 시점에 맞춰지는 것은 아닙니다. 한 코어에서 실행되는 설정이 다른 코어에 그대로 복사해도 똑같이 작동한다고 보장할 수 없습니다.

예를 들어 REALITY 또는 XTLS Vision 관련 매개변수를 쓴다면 현재 코어가 해당 기능을 지원하는지, 서버가 요구하는 설정 조합과 일치하는지 확인해야 합니다. 코어 선택은 제품 이름만 볼 것이 아니라 필요한 기능과 클라이언트 연동 상태를 기준으로 하세요. 문제를 해결하기 전에 사용 중인 클라이언트, 실제로 실행된 코어, 설정 메뉴를 기록해 두면 한 구현의 문서로 다른 구현의 오류를 설명하는 일을 피할 수 있습니다.

세 가지 클라이언트: 플랫폼과 코어 조합

v2rayN, v2rayNG, v2flyNG는 모두 소스 코드가 공개된 그래픽 클라이언트입니다. 데스크톱에서는 v2rayN으로 서버, 구독, 라우팅을 관리하고, Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려할 수 있습니다. v2flyNG는 V2Fly 코어가 필요한 경우에 적합합니다. 선택 기준은 먼저 운영체제, 다음으로 프로토콜 기능과 설정 호환성입니다. 세 앱을 같은 성능 기준으로 단순히 순위 매기는 문제는 아닙니다.

v2rayN의 인터페이스 설정은 실행에 사용할 구성 요소에도 영향을 줄 수 있습니다. 서버를 선택한 뒤 해당 프로토콜과 클라이언트가 실제로 호출하는 코어가 호환되는지 확인하세요. 모바일에서는 시스템 VPN 인터페이스, 앱별 트래픽 분기, 백그라운드 제한도 고려해야 합니다. 데스크톱의 로컬 SOCKS 포트를 휴대폰 설정에 그대로 옮겨도 모바일 운영체제의 트래픽 전달 과정을 대신할 수는 없습니다. 같은 서버 설정도 플랫폼별 네트워크 진입 방식에 맞게 사용해야 합니다.

클라이언트 선택 가이드에서 세 앱의 지원 플랫폼, 설정 방법, 사용 범위를 비교합니다. 이미 정상적으로 작동하는 설정이 있다면 인터페이스를 통일하려고 클라이언트, 코어, 라우팅 방식을 한꺼번에 바꿀 필요는 없습니다. 기존 설정을 보존하고 한 번에 한 항목씩 변경해야 결과가 달라진 원인을 파악할 수 있습니다.

오픈 소스 라이선스: 클라이언트와 코어를 따로 확인하세요

소스 코드 공개는 각 프로젝트의 라이선스와 사용 조건에 따라 코드를 제공한다는 뜻이지만, 클라이언트와 코어, 함께 포함된 구성 요소가 서로 다른 라이선스를 적용받을 수 있습니다. V2Fly 코어는 MIT 라이선스를, Xray 코어는 MPL-2.0을 사용합니다. 클라이언트는 배포 파일에 포함된 각 라이선스 안내도 확인해야 합니다. 개인 사용, 소스 수정, 재배포는 각각 다른 상황이므로 ‘오픈 소스’라는 이유만으로 모든 권리와 의무를 단정할 수 없습니다.

일반적인 설치와 사용에서는 소프트웨어 이름, 지원 플랫폼, 구성 요소 안내를 확인하세요. 재배포하거나 소스 코드를 수정하는 프로젝트라면 적용되는 라이선스를 항목별로 읽고, 유지해야 하는 고지도 보존해야 합니다. 오픈 소스 여부가 설정 점검을 대신하지는 않습니다. 트래픽이 어디로 전달되는지, 구독이 어떤 서버를 갱신하는지, 로컬 리스닝 포트에 어떤 주소가 접근할 수 있는지는 실제 설정으로 결정되므로 실행 환경에서 확인해야 합니다.

업데이트 관리: 프로그램·코어·구독·규칙을 따로 점검

클라이언트 업데이트는 인터페이스와 설정 생성 로직을, 코어 업데이트는 프로토콜 구현을 바꿉니다. 구독 업데이트는 서버 항목을 새로고침하고, 규칙 리소스 업데이트는 도메인 또는 주소 분류에 영향을 줍니다. 네 가지 작업은 해결하려는 문제가 서로 다릅니다. 새 프로토콜 필드를 인식하지 못하면 먼저 코어 지원 여부를 확인하세요. 구독 서버 주소가 바뀌었다면 해당 그룹을 업데이트하세요. 규칙 파일이 없다면 클라이언트만 재설치하지 말고 리소스 설정과 실행 로그를 확인하세요.

설정을 바꾸기 전에 기존 설정과 사용자 지정 규칙을 보존해 두세요. 업데이트 후에는 먼저 선택한 서버가 실행되는지 확인하고, 다음으로 시스템 프록시나 TUN이 예상대로 트래픽을 전달하는지 검증한 뒤 자주 쓰는 앱과 로컬 네트워크를 테스트하세요. 코어를 바꾸고 구독을 지운 다음 DNS까지 다시 작성하면 연결이 복구되더라도 어떤 변경이 효과가 있었는지 알기 어렵습니다. 관련 없는 스위치를 계속 바꾸기보다 순서를 정해 점검하는 편이 장기적인 관리에 유리합니다.

연결 확인: 속도 테스트·핸드셰이크·실제 요청 구분하기

서버 목록의 테스트 결과는 특정 조건에서만 확인한 결과입니다. 포트 연결에 성공해도 프로토콜 핸드셰이크가 성공한다는 뜻은 아니며, 핸드셰이크가 완료돼도 대상 사이트의 DNS와 라우팅이 올바르다는 보장은 없습니다. V2Ray 노드 속도 테스트를 할 때는 테스트 대상과 방식을 먼저 확인한 뒤 실제 요청 결과와 함께 판단하세요. 테스트 하나만으로 모든 앱에서 접속된다고 결론 내리지 마세요.

정해진 순서로 확인하세요. 먼저 클라이언트가 코어를 실행했는지 보고, 프록시를 명시적으로 설정한 앱에서 요청을 보낸 다음 시스템 프록시를 확인하고 마지막으로 TUN을 테스트합니다. 각 단계의 로그를 따로 보관하세요. 시간 초과가 발생하면 요청이 어느 단계에서 멈췄는지 확인하고, 핸드셰이크 오류가 나면 인증 정보, 보안, 전송 필드를 다시 점검하세요. 로그에 표시되는 로컬 포트, 아웃바운드 태그, 대상 도메인이 막연한 ‘연결 실패’ 메시지보다 문제를 찾는 데 더 유용합니다.

프록시 모드: 트래픽 적용 범위와 라우팅 정책은 다릅니다

시스템 프록시는 해당 설정을 따르는 앱이 연결을 로컬 프록시로 보낼지 결정합니다. 라우팅 정책은 코어에 들어온 트래픽을 어떤 아웃바운드로 보낼지 결정합니다. 인터페이스의 ‘전역’은 보통 특정 라우팅 선택을 뜻하며 모든 프로세스의 트래픽을 반드시 처리한다는 의미는 아닙니다. 시스템 프록시를 따르지 않는 앱은 전역 라우팅을 선택해도 코어에 연결을 보내지 않을 수 있습니다. 적용 범위를 넓혀야 한다면 분기 규칙만 반복해서 바꾸지 말고 TUN 사용을 검토하세요.

따라서 ‘브라우저는 되는데 다른 프로그램은 안 되는’ 문제는 먼저 트래픽이 프록시로 들어오는 경로를 확인하고, ‘일부 도메인이 잘못된 경로로 가는’ 문제는 규칙 순서와 DNS를 확인하세요. 데스크톱 사용법은 시스템 프록시와 전역 프록시 안내를, 모바일은 v2rayNG 사용 가이드를 참고해 시스템 권한과 적용 범위를 확인하세요. 자주 묻는 문제는 FAQ에서, 설정 필드의 기본값과 참조 관계는 설정 레퍼런스에서 단계별로 확인할 수 있습니다.

프로토콜·설정·사용 가이드

인증 정보, 클라이언트 사용법, 프로토콜 선택 등 궁금한 주제를 이어서 살펴보세요.