클라이언트 선택과 구독 가져오기부터 연결 문제 해결까지, 인바운드·라우팅·아웃바운드로 V2Ray 설정을 이해해 보세요.
GUI 클라이언트는 설정을 관리하고, 코어는 연결을 처리합니다. 먼저 서버 정보가 모두 준비됐는지 확인한 다음, 어떤 앱을 프록시로 연결하고 어떤 요청을 직접 연결할지 정하세요. 아래에서 데스크톱, Android, 설정 구조별로 사용법을 살펴봅니다. 오른쪽 예시는 일부 필드만 보여 주며, 원격 서버에 바로 연결할 수 있는 완전한 설정이 아닙니다.
구독 그룹 설정에서 주소를 추가하고 저장한 뒤 업데이트를 실행하세요. 서버 목록에 프로토콜, 주소, 포트가 표시되는지도 확인합니다. 구독 링크와 단일 공유 링크는 가져오는 위치가 다르므로 링크 길이만으로 형식을 판단할 수 없습니다. 출처별로 그룹을 나누면 업데이트할 때 서버를 혼동하지 않습니다. 구독 주소에는 보통 접속 정보가 포함되므로 개인 기기에만 저장하세요. 문제를 확인할 때는 오류 메시지만 기록하고, 전체 주소를 공개된 곳에 올리지 마세요.
사용할 서버를 선택한 뒤 코어가 실행 중인지 확인하고 시스템 프록시를 설정하세요. 시스템 프록시는 운영체제 설정을 따르는 앱에 로컬 프록시 주소를 제공하지만, 모든 프로그램의 연결이 프록시를 통과하는 것은 아닙니다. 라우팅 모드는 코어에 들어온 요청을 어떤 아웃바운드로 보낼지 결정하므로 시스템 프록시와는 별개의 설정입니다. 처음에는 기본 라우팅을 유지하고 브라우저 연결부터 확인한 뒤 규칙을 하나씩 조정하세요. 더 많은 앱의 트래픽을 처리하려면 가상 네트워크 어댑터 모드의 권한 및 충돌 관련 안내를 먼저 확인하세요.
포트에 접속할 수 있다고 프로토콜 핸드셰이크까지 성공한 것은 아닙니다. TCPing은 주로 TCP 연결 수립 여부를 보여 주며, 실제 연결 속도 측정에는 프록시 핸드셰이크와 대상 서버 요청도 포함됩니다. 그래도 모든 웹사이트에서의 사용 경험을 보장하지는 않습니다. 서버를 선택한 뒤 클라이언트 로그, 브라우저 요청, 외부 IP를 함께 확인해 연결이 적용됐는지 판단하세요. 속도 측정은 성공했는데 앱이 작동하지 않는다면 앱이 시스템 프록시를 사용하는지 먼저 확인하고, 그다음 라우팅과 DNS를 점검하세요. 곧바로 서버를 계속 바꾸지는 마세요.
{ "inbounds": [ { "tag": "socks-in", "listen": "127.0.0.1", "port": 10808, "protocol": "socks", "settings": { "auth": "noauth", "udp": true } } ]}v2rayNG에서는 클립보드로 단일 공유 링크를 가져오거나, 구독 설정에 주소를 저장한 뒤 내용을 업데이트할 수 있습니다. 가져오기 전에 클립보드에 불필요한 설명이 섞이지 않았는지 확인하고, 가져온 후에는 서버 유형과 전송 매개변수를 살펴보세요. 서버 이름은 메모일 뿐 실제 프로토콜을 알려 주지 않습니다. 처음에는 정보가 완전한 서버 하나를 테스트해 연결을 확인한 다음 구독 그룹을 정리하는 편이 좋습니다. 그러면 형식 문제와 서버 자체의 문제를 구분하기 쉽습니다.
처음 연결을 시작하면 Android에서 VPN 연결 권한을 요청합니다. 허용해야 클라이언트가 시스템 인터페이스를 통해 앱 트래픽을 받을 수 있습니다. 기기에서 다른 VPN 앱을 함께 실행하면 충돌이 생길 수 있으니 현재 연결을 처리하는 앱부터 확인하세요. 앱별 프록시 설정은 어떤 앱의 트래픽을 클라이언트로 보낼지 정하고, 라우팅 규칙은 해당 요청을 어떤 경로로 내보낼지 결정합니다. 앱을 제외하면 같은 라우팅으로 해당 앱의 연결을 처리하지 않으므로 문제를 각각 나누어 확인해야 합니다.
화면을 끈 뒤 연결이 끊긴다면 먼저 시스템 배터리 정책, 백그라운드 활동 권한, 클라이언트 알림 상태를 확인하세요. 모바일 데이터나 Wi-Fi에서만 문제가 생기면 전환 전후의 로그를 기록해 도메인 조회, 원격 핸드셰이크, 네트워크 연결 시간 초과를 구분하세요. 여러 설정을 한꺼번에 바꾸면 어떤 변경이 효과가 있었는지 알기 어렵습니다. REALITY 또는 특수 전송을 사용하는 서버라면 현재 코어가 해당 매개변수를 지원하는지도 확인하세요. 클라이언트 화면이 비슷하다는 이유만으로 호환된다고 판단해서는 안 됩니다.
{ "routing": { "domainStrategy": "AsIs", "rules": [ { "type": "field", "ip": ["geoip:private"], "outboundTag": "direct" } ] }}인바운드는 코어가 기기에서 연결을 받는 방식을 정의합니다. 일반적으로 수신 주소와 포트, 프로토콜, 인증 방식이 포함됩니다. 기기 내 앱에서만 사용한다면 루프백 주소로 수신 범위를 제한할 수 있습니다. 로컬 네트워크에서 접근할 수 있도록 바꾸기 전에는 인증과 방화벽을 먼저 고려하세요. 앱에 입력하는 포트는 로컬 인바운드 포트이지 원격 서버 포트가 아닙니다. 주소가 이미 사용 중이라는 오류가 나면 다른 클라이언트나 이전 프로세스가 실행 중인지 확인한 다음 포트를 변경하고, 앱의 프록시 설정도 함께 업데이트하세요.
라우팅은 도메인, 대상 IP, 포트 또는 인바운드 태그를 기준으로 아웃바운드를 선택합니다. 규칙은 보통 위에서부터 순서대로 적용되므로, 조건이 넓은 규칙을 앞에 두면 뒤에 있는 구체적인 규칙이 적용되지 않을 수 있습니다. geosite와 geoip를 참조하려면 해당 규칙 데이터가 준비되어 있어야 합니다. 아웃바운드 태그를 사용할 때도 같은 이름의 아웃바운드가 있어야 합니다. 규칙을 추가하기 전에 기존 설정을 저장하고, 명확한 대상을 지정해 적용 결과를 테스트하세요. DNS, 스니핑, 라우팅을 한꺼번에 바꾸면 문제를 추적하기 어렵습니다.
아웃바운드는 원격 서버에 연결하거나 직접 연결, 차단 등의 작업을 수행합니다. VLESS, VMess, Trojan은 서로 다른 프록시 프로토콜이며 REALITY는 보안 전송과 관련된 방식입니다. 프로토콜 이름만 바꾼다고 설정이 변환되는 것은 아닙니다. 구독에는 보통 원격 주소와 인증 정보, 전송 및 보안 매개변수가 포함되지만, 형식에 따라 담기는 정보가 다릅니다. 설정을 직접 옮길 때는 항목별로 확인하세요. 특히 서버 이름, 전송 경로, 공개 키, 선택한 코어의 지원 여부를 주의해서 살펴봐야 합니다.
{ "outbounds": [ { "tag": "direct", "protocol": "freedom", "settings": {} }, { "tag": "block", "protocol": "blackhole", "settings": {} } ]}데스크톱에서는 v2rayN부터 시작하고, Android에서는 서버 기능에 맞춰 v2rayNG 또는 v2flyNG를 선택하세요. 클라이언트 이름, 코어 계열, 프로세서 아키텍처는 서로 다른 기준입니다. 운영체제를 먼저 선택한 뒤 칩 아키텍처와 프로토콜 지원 여부를 확인하세요. 다운로드 페이지에서 설치 파일과 지원 정보를 한눈에 확인해 비슷한 패키지를 혼동하지 않도록 하세요.
크로스 플랫폼 인터페이스를 사용하는 데스크톱 버전과 기존 데스크톱 방식의 조작을 따르는 WPF 버전이 있습니다. 먼저 인터페이스 선호도와 시스템 요구 사항에 맞춰 선택하세요. 인터페이스 차이를 서버 프로토콜 차이로 오해해서는 안 됩니다. 설치 전에 시스템 설정에서 기기 아키텍처를 확인하고, 처음 실행한 뒤 사용할 수 있는 설정 하나를 가져온 다음 시스템 프록시를 설정하세요.
설정을 옮길 때는 기존 구독 그룹과 사용자 지정 라우팅 규칙을 유지하세요. 앱이 시스템 프록시 설정을 따르지 않는다면 다른 연결 방식을 고려하기 전에 앱 자체 설정부터 확인하세요.
‘이 Mac에 관하여’에 표시된 칩에 맞춰 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 기기 아키텍처에 맞는 파일을 사용하면 호환성 계층으로 인해 생길 수 있는 변수를 줄일 수 있습니다. 처음 실행할 때 보안 경고가 표시되면 앱 출처와 시스템 요구 사항을 확인하고 다운로드 페이지의 안내에 따라 처리하세요. 앱을 실행하려고 시스템 보호 기능을 장기간 꺼 두지는 마세요.
시스템 프록시가 적용되는 범위는 각 앱이 해당 설정을 따르는지에 따라 다릅니다. 문제를 확인할 때는 로컬 수신 포트, 선택된 서버, 브라우저의 프록시 설정을 함께 확인하세요.
먼저 Xray 코어를 사용하는 v2rayNG를 살펴보세요. V2Fly 코어와의 호환성이 필요하다면 v2flyNG를 고려할 수 있습니다. 대부분의 최신 기기에서는 arm64 패키지를 사용하며, 아키텍처를 모르겠다면 범용 버전 안내를 확인하세요. 두 앱의 코어 기능은 다릅니다. REALITY나 특정 전송 매개변수를 사용할 때는 프로토콜 요구 사항부터 확인해야 하며, 화면의 옵션만 보고 설정을 그대로 옮겨서는 안 됩니다.
처음 연결할 때 시스템 VPN 권한이 필요합니다. 연결 후에는 알림을 표시된 상태로 유지하고 배터리 관리 설정도 확인해 앱의 백그라운드 실행이 제한된 경우와 원격 서버 연결이 끊긴 경우를 구분하세요.
먼저 배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택한 다음 x64와 arm64 아키텍처를 구분하세요. GUI 클라이언트를 설치한 뒤에도 데스크톱 환경의 프록시 설정을 확인해야 합니다. 브라우저, 터미널, 기타 앱은 각각 별도의 프록시 설정을 사용할 수 있습니다. 프로그램이 설치되어 실행된다고 해서 시스템의 모든 연결이 프록시를 통과하는 것은 아닙니다.
기존 네트워크 설정을 비교 기준으로 남겨 두세요. 로컬 포트 사용 중 오류나 권한 문제가 발생하면 로그를 먼저 확인한 뒤 클라이언트 옵션을 조정하세요. 여러 프록시 프로세스가 동시에 트래픽을 처리하지 않도록 주의하세요.
모든 클라이언트 보기 →설치 파일을 선택한 다음 구독을 가져오고 연결을 확인하세요.
일상적인 대화에서 ‘V2Ray’는 프로젝트나 코어를 가리키기도 하고 관련 클라이언트를 통칭하기도 합니다. 문제를 파악할 때는 이 세 가지를 구분해야 합니다. GUI는 설정을 입력하는 방식을, 코어는 각 항목의 실행 방식을, 서버 설정은 연결에 필요한 매개변수를 결정합니다. 이름이 비슷해도 기능이 완전히 같거나 설정을 서로 그대로 바꿔 쓸 수 있는 것은 아닙니다.
Project V는 V2Ray의 배경을 이해하는 데 필요한 프로젝트입니다. V2Ray는 모듈식 설정으로 프록시 연결을 구성하며, 요청을 받는 인바운드와 경로를 정하는 라우팅, 실제 연결을 시작하는 아웃바운드를 분리합니다. V2Fly는 V2Ray 개발을 이어 가는 커뮤니티 프로젝트입니다. 그 코어와 관련 규칙 데이터는 이 생태계의 중요한 구성 요소입니다. 특정 화면에서 버튼 위치를 외우는 것보다 설정 모델을 이해하는 편이 다른 클라이언트로 옮길 때 더 유용합니다.
가이드에서 SOCKS 인바운드, 도메인 규칙, 직접 연결 아웃바운드를 언급할 때는 코어의 역할 구분을 설명하는 것이지, 서로 다른 기기 세 대를 뜻하는 것이 아닙니다. 클라이언트 하나에서 여러 서버를 관리할 수 있지만 요청이 최종적으로 어떤 아웃바운드를 사용할지는 실제로 실행 중인 설정에 따라 달라집니다. GUI에서 생성되는 설정도 클라이언트 옵션에 따라 바뀔 수 있으므로 저장된 서버 이름만 보지 말고 현재 실행 상태와 로그를 기준으로 문제를 확인하세요.
Xray는 V2Ray 관련 코드를 바탕으로 발전해 독자적인 기능 개발 방향을 갖추게 됐습니다. XTLS Vision과 REALITY 같은 기능은 일반적으로 Xray의 지원 여부를 확인해야 합니다. V2Fly도 자체적으로 설정 및 전송 기능을 발전시키고 있습니다. 프로젝트 배경을 공유한다고 해서 모든 필드, 전송 조합, 기본 동작이 동일한 것은 아닙니다. 설정을 복사하기 전에 어떤 코어를 대상으로 작성됐는지 확인하고, 클라이언트가 실제로 어떤 코어를 실행하는지도 점검하세요.
프로토콜 이름이 같다는 이유만으로 호환된다고 판단할 수는 없습니다. 전송 방식, 보안 계층, 흐름 제어 매개변수, 인증 정보도 확인해야 합니다. ‘인식할 수 없는 필드’나 ‘핸드셰이크 실패’가 발생하면 설정 파싱 단계와 네트워크 연결 단계를 나눠 확인하세요. 전자는 코어의 지원 여부와 필드 표기를 먼저 살펴보고, 후자는 서버 주소와 시스템 시간, 보안 매개변수를 확인합니다. Xray와 V2Fly의 차이 알아보기에서 서버 설정의 요구 사항과 클라이언트 기능을 더 자세히 비교할 수 있습니다.
v2rayN은 서버 관리, 구독 업데이트, 프록시 및 라우팅 설정을 제공하는 데스크톱 GUI 클라이언트입니다. 실제 연결 기능은 선택한 코어에 따라서도 달라집니다. v2rayNG는 Android용 클라이언트로, 주로 Xray 코어 관련 기능을 사용합니다. v2flyNG는 V2Fly 코어를 사용하는 Android 대안입니다. 세 클라이언트 모두 오픈 소스 소프트웨어입니다. 선택할 때는 앱 이름보다 먼저 플랫폼, 코어, 사용 목적을 확인하세요.
오픈 소스 라이선스는 코드의 사용, 수정, 배포 조건을 정합니다. 클라이언트와 코어, 규칙 데이터는 각각 별도 프로젝트의 구성 요소이므로 구체적인 라이선스는 소프트웨어에 포함된 안내를 따로 확인해야 합니다. 오픈 소스 여부는 소프트웨어의 출처와 구현을 파악하는 데 도움이 되지만, 설정 검토를 대신하거나 구독 출처의 신뢰성을 보장하지는 않습니다. 이 사이트는 설치 및 사용 가이드를 제공하며 원격 서버 계정은 제공하지 않습니다. 클라이언트를 설치해도 사용할 수 있는 서버 연결 정보가 자동으로 생기는 것은 아닙니다.
클라이언트, 코어, 구독, 규칙 데이터 업데이트는 서로 다른 작업입니다. GUI를 업데이트해도 구독 내용이 바뀌지 않을 수 있고, 구독을 업데이트해도 코어의 기능이 달라지는 것은 아닙니다. 업그레이드 전에 현재 서버, 프록시 모드, 사용자 지정 라우팅을 기록하고 필요한 설정을 백업하세요. 업그레이드 후에는 기존에 작동하던 환경부터 다시 테스트한 다음 새 기능을 사용하세요. 서버 변경, DNS 조정, 라우팅 규칙 수정을 한꺼번에 하면 실패 원인을 찾기 어렵습니다.
문제를 기록할 때는 발생 시각, 클라이언트 이름, 코어 유형, 오류 요약, 재현 절차 정도만 적으면 됩니다. 로그를 공유하기 전에 구독 주소와 식별 정보, 기타 민감한 매개변수를 삭제하세요. 인증서 오류는 기기 시간과 서버 이름부터 확인하고, 연결 시간 초과는 주소에 접속할 수 있는지와 네트워크별 차이를 확인하세요. 특정 앱에서만 실패한다면 먼저 프록시 적용 범위를 살펴보세요. 클라이언트 비교는 클라이언트 선택에, 자주 묻는 질문은 빠른 문제 확인에, 문제 해결 가이드는 증상별 전체 점검 절차에 유용합니다.
첫 연결을 마친 뒤 코어 선택, 라우팅 순서, TLS 매개변수를 살펴보세요. 읽기 전에 문제가 어느 계층에서 발생하는지 확인하고, 글에 나온 점검 순서에 따라 범위를 좁혀 가세요. 설정 예시는 실제 서버 매개변수와 코어 기능에 맞춰 조정해야 합니다. 일부 예시만 기존 설정에 그대로 덮어쓰지 마세요.
인증서 무효, 핸드셰이크 실패 등의 메시지가 나타나면 기기 시간, SNI와 위장 도메인의 일치 여부, allowInsecure 설정, 지문 설정을 순서대로 확인해 흔한 TLS 오류 원인을 찾아보세요. 다음 점검 항목을 선택하기 전에 오류가 인증서 검증 단계에서 발생했는지 연결 수립 단계에서 발생했는지 먼저 확인하세요. 인증서 검증을 건너뛰는 방법을 일반적인 해결책으로 사용해서는 안 됩니다.
TLS 문제 해결 단계 보기 →domainStrategy부터 geosite·geoip 규칙 작성 순서까지 살펴보고, 중국 본토 직접 연결, 해외 프록시 연결, 광고 차단의 대표적인 라우팅 예시를 소개합니다. 앞에 있는 포괄적인 조건이 뒤의 규칙보다 먼저 적용되지 않는지, outboundTag가 실제 아웃바운드와 일치하는지 확인하세요. 분기 결과는 DNS와 대상 주소도 함께 검증해야 합니다.
라우팅 설정 가이드 보기 →두 코어 계열의 배경을 살펴보고 XTLS Vision, REALITY 등의 기능 지원 여부를 비교하며 v2rayNG와 v2flyNG 중 어떤 앱을 선택할지 안내합니다. 설정을 옮기기 전에 프로토콜, 전송 방식, 보안 계층, 필드를 하나씩 확인하세요. 서버 이름이 같다는 이유로 설정을 그대로 재사용할 수 있다고 판단해서는 안 됩니다. GUI에서 옵션을 입력할 수 있어도 코어가 해당 기능을 실행할 수 있다는 뜻은 아닙니다.
코어 차이 알아보기 →모든 글 보기 →첫 연결 및 구독 형식 가이드도 확인해 보세요.