시스템 프록시부터 트래픽 라우팅까지, 먼저 처리할 트래픽 범위를 정한 다음 클라이언트에서 해당 기능을 설정하세요. 아래 예시는 설정 구조를 설명하기 위한 것으로, 실제 사용 시에는 클라이언트 화면과 현재 커널에서 지원하는 항목을 기준으로 확인해야 합니다.
로컬 SOCKS 인바운드는 앱에서 보낸 프록시 요청을 받습니다. 시스템 프록시는 운영체제 설정을 따르는 앱이 이 로컬 포트를 사용하도록 연결합니다. 두 기능은 같은 설정이 아닙니다. 일반적인 웹 브라우징은 먼저 ‘시스템 프록시 자동 설정’을 켜고, 대상 주소에 따라 프록시 사용 여부를 나누려면 PAC 모드를 확인하세요. 터미널이나 프록시를 별도로 지정한 브라우저는 자체 설정을 사용할 수 있으므로 메뉴 막대 상태만으로 연결 여부를 판단할 수 없습니다. 페이지가 열리지 않으면 로컬 포트, 시스템 프록시 대상, 현재 서버 상태를 차례로 확인하세요. 노드를 반복해서 바꾸는 것보다 문제 원인을 찾기 쉽습니다.
{
"inbounds": [{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth" }
}]
}라우팅 규칙은 조건에 맞는 트래픽을 지정된 아웃바운드로 보내며, 서버 설정을 대체하지 않습니다. 일반적으로 명확한 직접 연결 도메인과 사설 주소를 먼저 처리하고, 나머지 요청은 기본 아웃바운드로 보냅니다. 규칙은 위에서부터 순서대로 적용되므로 범위가 넓은 규칙을 앞에 두면 더 구체적인 항목보다 먼저 적용될 수 있습니다. 편집 전에 커널이 필요한 지리 데이터를 불러왔는지, 규칙에서 참조하는 아웃바운드 태그가 실제로 있는지 확인하세요. 웹페이지와 앱의 동작이 다르면 두 요청이 같은 로컬 인바운드를 거치는지도 확인해야 합니다. 클라이언트를 통과하지 않는 트래픽에는 해당 규칙이 적용되지 않습니다.
{
"routing": {
"domainStrategy": "AsIs",
"rules": [{
"type": "field",
"domain": ["geosite:private"],
"outboundTag": "direct"
}]
}
}구독 그룹은 업데이트 소스를 저장하고, 그룹 안의 서버 목록은 업데이트 결과를 표시합니다. 주소를 추가한 뒤 업데이트를 실행하고 서버가 목록에 나타나는지 확인한 다음 사용할 서버를 선택하세요. 여러 소스를 관리한다면 그룹마다 알아보기 쉬운 이름을 붙이면 서버의 출처를 파악하기 편합니다. 구독을 업데이트하면 서버 이름과 순서가 달라질 수 있으므로 목록의 위치만으로 자주 쓰는 항목을 기억하지 마세요. 가져오기에 실패하면 주소가 완전한지, 응답 형식이 클라이언트에서 지원되는지, 네트워크가 연결되어 있는지 차례로 확인하세요. 구독 주소를 단일 서버 설정으로 가져오면 안 됩니다.
구독 그룹: 업무 환경
구독 업데이트 → 서버 목록 확인 → 사용할 서버 선택
구독 소스와 로컬 라우팅 규칙은 따로 관리TUN 모드는 가상 네트워크 인터페이스를 통해 조건에 맞는 시스템 트래픽을 처리하므로 시스템 프록시 설정을 따르지 않는 앱에 적합합니다. 일반 시스템 프록시와 적용 범위가 다르며 추가 시스템 권한이 필요할 수도 있습니다. 켜기 전에 일반 프록시 연결이 정상인지 확인하고, 해당 플랫폼의 TUN 설정과 라우팅 옵션을 살펴보세요. 활성화 후 LAN 기기에 접속할 수 없다면 서버 프로토콜부터 바꾸지 말고 사설 주소, DNS, 제외 규칙을 먼저 확인하세요. 사용을 마치면 클라이언트에서 TUN을 끄고 운영체제 네트워크 설정이 원래 상태로 돌아왔는지 확인하세요.
연결 확인 순서:
일반 시스템 프록시 → DNS 설정 → TUN 가상 인터페이스
LAN 접속 문제 → 사설 주소 라우팅 확인v2rayN은 구독, 서버 선택, 프록시 모드 등을 GUI로 관리하며 실제 프로토콜 처리는 선택한 커널이 담당합니다. Xray와 V2Fly는 서로 관련되어 있지만 독립적으로 관리되는 커널 계열입니다. 특정 프로토콜이나 전송 설정의 사용 가능 여부는 커널 지원과 클라이언트의 설정 항목에 따라 달라집니다. 커널을 바꾸기 전에 현재 연결 방식을 기록하고 대상 커널이 기존 서버 매개변수를 지원하는지 확인한 다음 관련 서비스를 재시작하고 연결을 테스트하세요. 시작 오류가 발생하면 시스템 프록시 아이콘만 보는 것보다 클라이언트 로그에 표시된 설정 항목이나 프로세스 오류를 확인하는 편이 정확합니다.
클라이언트: v2rayN
커널 선택: Xray / V2Fly
확인 순서: 프로토콜 지원 → 설정 항목 → 시작 로그라우팅 규칙, DNS, 구독을 하나씩 확인하려면 고급 설정 안내서 →를 참조하세요
데스크톱에서는 v2rayN을 사용하세요. Android에서는 필요한 커널에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 운영체제와 프로세서 아키텍처를 확인한 뒤 해당 플랫폼의 다운로드 정보를 살펴보세요.
v2rayN은 데스크톱 버전과 기존 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 UI를 사용하며, WPF 방식에 익숙하다면 클래식 버전도 확인해 보세요.
다운로드 페이지로 이동 →v2rayN은 Apple Silicon과 Intel 칩에 맞는 다운로드 항목을 제공합니다. 시스템 정보에서 칩 종류를 확인한 뒤 알맞은 설치 파일을 선택하세요.
다운로드 페이지로 이동 →먼저 Xray 커널을 사용하는 v2rayNG를 확인하세요. V2Fly 커널이 필요하다면 v2flyNG를 선택할 수 있습니다. 두 앱 모두 arm64와 범용 버전을 제공합니다.
다운로드 페이지로 이동 →v2rayN은 패키지 형식에 따라 deb와 rpm을 제공하며, 각 형식의 arm64 버전도 안내합니다. 배포판의 패키지 관리자와 프로세서 아키텍처를 먼저 확인하세요.
다운로드 페이지로 이동 →어떤 빌드를 선택해야 할지 모르겠나요? 다운로드 페이지에서 플랫폼별 설치 파일, 아키텍처, 시스템 요구 사항을 확인하세요. 전체 클라이언트 보기 →
먼저 일반 시스템 프록시 모드에서 서버 하나를 연결한 뒤 라우팅, DNS, TUN을 설정하세요. 한 번에 한 종류의 설정만 바꾸면 연결 결과를 쉽게 파악할 수 있습니다.
시스템 아키텍처에 맞는 클라이언트를 설치하세요. 구독 설정에서 서비스 제공자가 안내한 주소를 추가하고 구독을 수동으로 업데이트한 다음 서버 항목이 목록에 표시되는지 확인합니다. 단일 설정 링크를 받았다면 구독 그룹이 아닌 클라이언트의 링크 가져오기 기능을 사용하세요.
서버 하나를 선택해 활성 설정으로 지정하고 커널을 시작한 뒤 시스템 프록시를 켜세요. 먼저 일반 프록시 모드에서 기본 연결을 확인하세요. 목적지에 따라 트래픽을 나눠 처리하려면 라우팅 설정을 열어 규칙 순서와 아웃바운드 태그를 확인합니다.
시스템 프록시를 따르는 앱으로 대상 서비스에 접속한 뒤 클라이언트 로그를 확인하세요. 접속에 실패하면 구독 업데이트 여부, 서버 선택 여부, 로컬 포트의 정상 리스닝 여부, 앱의 시스템 프록시 사용 여부를 차례로 점검합니다.
서버가 목록에 있는데 연결되지 않나요? 목록에 표시된다는 것은 가져오기에 성공했다는 뜻일 뿐입니다. 서버를 선택하고 커널을 시작한 뒤 시스템 프록시 상태도 확인해야 합니다. 연결 단계 보기 →
브라우저는 되는데 터미널은 접속할 수 없나요? 터미널은 프록시 환경 변수를 별도로 설정해야 하는 경우가 많습니다. 클라이언트가 리스닝 중인 로컬 포트를 가리키는지 먼저 확인하세요. 모드 설명 보기 →
라우팅을 바꾼 뒤 일부 사이트가 열리지 않나요? 도메인 규칙의 적용 순서, DNS 조회 결과, 해당 아웃바운드를 확인하세요. 먼저 이전에 작동했던 설정으로 되돌린 뒤 항목별로 조정하세요. 라우팅 안내서 보기 →
클라이언트 화면은 설정을 관리하고 커널은 연결을 처리합니다. 역할을 구분하면 오류 로그를 이해하기 쉽고, 클라이언트 기능과 프로토콜 지원 범위를 혼동하지 않을 수 있습니다.
Project V는 V2Ray의 프로토콜과 설정 방식의 기반을 마련했습니다. 이를 바탕으로 커널 구현체, 그래픽 클라이언트, 규칙 데이터 등 다양한 프로젝트가 만들어졌습니다. 서로 기술적으로 연관되어 있지만, 특정 그래픽 인터페이스의 기능 목록을 생태계 전체의 기능과 동일시해서는 안 됩니다. 설정 안내를 읽을 때는 클라이언트 조작, 커널 매개변수, 서버 연결 정보 중 무엇을 설명하는지 먼저 구분하세요. 같은 용어가 서로 다른 계층에서 쓰일 수 있습니다. 계층을 구분한 뒤 설정을 변경하면 잘못된 위치를 수정해 문제 해결에 시간을 낭비하는 일을 줄일 수 있습니다.
V2Fly는 V2Ray 프로젝트의 커널을 이어서 관리하며, Xray는 관련 생태계의 또 다른 독립 커널 계열입니다. 둘 다 연결 처리를 담당하지만 지원하는 프로토콜, 전송 옵션, 설정 항목은 다를 수 있습니다. 서버 설정에 특정 기능이 필요하다면 클라이언트의 가져오기 방식과 현재 선택된 커널을 함께 확인해야 합니다. 설정을 해석하지 못한다는 오류가 발생하면 오류 항목을 기록하고 해당 커널의 설정 안내를 확인하세요. 클라이언트 이름만으로 호환 여부를 판단하지 마세요. 여러 커널을 선택할 수 있는 이유는 실제 설정 요구에 맞추기 위해서이지, 하나의 설정을 모든 구현체에 자동으로 적용하기 위해서가 아닙니다.
v2rayN은 Windows, macOS, Linux 데스크톱 환경을 대상으로 하며 서버 관리, 구독 업데이트, 시스템 프록시, 라우팅 기능을 제공합니다. Android용 v2rayNG는 Xray 커널을 사용하고, v2flyNG는 V2Fly 커널을 선택할 수 있는 대안입니다. 세 클라이언트는 모두 오픈 소스 프로젝트지만 화면 구성, 업데이트 주기, 지원 기능은 서로 다릅니다. 운영체제를 확인한 다음 필요한 커널과 설정 기능에 따라 선택하세요. 여러 기기에서 같은 구독을 사용하더라도 각 기기의 프록시 모드와 로컬 규칙은 따로 확인해야 합니다.
프로젝트는 공개 오픈 소스 라이선스를 따르며, 구체적인 조건은 각 프로젝트의 안내를 확인해야 합니다. 생태계에서는 GPL-3.0, MIT 등의 라이선스를 사용합니다. 클라이언트, 커널, 규칙 데이터는 서로 독립적으로 관리될 수 있으므로 한 구성 요소를 업데이트해도 다른 구성 요소의 동작이 반드시 바뀌는 것은 아닙니다. 설정을 크게 변경하기 전에 정상 작동하는 설정을 보관하고 사용 중인 클라이언트, 커널, 운영체제를 기록해 두세요. 문제가 생겼을 때 이런 정보가 단순히 ‘연결할 수 없음’이라고 설명하는 것보다 원인을 찾는 데 도움이 됩니다. 다운로드 페이지에서 플랫폼별 설치 파일을 확인하고, 설정 방법은 주제별 고급 안내서에서 살펴보세요.
구독 필터, DNS, FakeDNS, 사용자 지정 아웃바운드를 더 확인하려면 고급 안내서 →를 읽어 보세요
시작 오류, 포트 충돌, 첫 사용 과정의 문제를 재현 가능한 상황별로 정리했습니다. 각 글에서 구체적인 문제 해결 절차를 확인할 수 있습니다.
데스크톱 운영체제에서 실행에 필요한 구성 요소, 폴더 권한, 보안 차단을 확인하고 프로그램 미실행과 커널 시작 실패를 구분합니다.
문서 읽기 →포트를 사용 중인 프로세스를 찾고 로컬 리스닝 포트를 변경한 뒤 브라우저와 터미널의 프록시 주소도 함께 업데이트합니다.
문서 읽기 →클라이언트 선택, 구독 가져오기, 시스템 프록시 모드, 라우팅 규칙 변경 시 자주 발생하는 문제를 정리했습니다.
문서 읽기 →