오픈 소스 클라이언트 선택부터 시작해 구독 가져오기와 라우팅 설정을 나누어 설명합니다.
구독을 가져왔다고 해서 브라우저가 바로 프록시를 사용하는 것은 아닙니다. 각 설정이 어느 단계에 관여하는지 먼저 파악한 뒤 조정하면 불필요한 반복 작업을 줄일 수 있습니다.
구독 그룹 설정
별칭: 일상용 구독
주소: https://example.com/sub?token=xxxx
업데이트 사용: 켜기구독은 업데이트할 수 있는 서버 설정 목록이며, 주소는 보통 서비스 제공자가 안내합니다. 전체 주소를 구독 그룹에 입력하고 저장한 다음 업데이트해야 클라이언트가 설정을 가져옵니다. 구독은 개별 서버 공유 링크와 다르며 웹사이트 로그인 주소도 아닙니다. 업데이트에 실패하면 먼저 링크가 온전한지, 만료되지는 않았는지 확인하고 구독을 가져올 때의 네트워크 경로를 살펴보세요. 기존 그룹을 반복해서 삭제하지 말고, 개인 토큰이 포함된 주소를 공개 스크린샷에 노출하지 마세요. 구독은 설정을 가져오는 역할만 하며, 시스템 프록시와 라우팅은 별도로 설정해야 합니다.
시스템 프록시
○ 시스템 프록시 해제
● 시스템 프록시 자동 설정
○ 시스템 프록시 변경 안 함시스템 프록시는 운영체제에 클라이언트의 로컬 프록시 주소를 등록하는 설정으로, 이 설정을 따르는 앱에 주로 영향을 줍니다. 처음 사용하는 경우 시스템 프록시 자동 설정을 선택하고 브라우저로 기본 연결을 확인해 보세요. 특정 프로그램에서 변화가 없더라도 서버 문제라고 단정할 수는 없습니다. 별도의 네트워크 설정을 사용하는 프로그램일 수 있습니다. TUN은 가상 네트워크 인터페이스로 트래픽을 전달하며 적용 범위와 권한 요구 사항이 다릅니다. 먼저 일반 시스템 프록시가 작동하는지 확인한 뒤 TUN이 필요한지 판단하세요. 네트워크를 동시에 가로채는 도구를 여러 개 켜면 요청 경로가 꼬일 수 있습니다.
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}라우팅은 요청이 클라이언트에 들어온 뒤 직접 연결할지 프록시를 거칠지 결정합니다. 위 규칙은 사설 주소를 direct라는 아웃바운드로 보내라는 뜻이며, 실제 설정에도 해당 아웃바운드가 있어야 합니다. 클라이언트의 라우팅 프리셋은 자주 쓰는 규칙을 메뉴로 묶어 두므로 기본 설정을 시작하기에 편리합니다. 분기 연결에 문제가 생기면 서버만 바꾸지 말고 규칙 순서, 도메인 일치 여부, 규칙 데이터 파일을 확인하세요. 시스템 프록시는 요청을 클라이언트로 보내고 라우팅은 요청을 어디로 보낼지 정하므로 서로 대체할 수 없습니다.
그래픽 인터페이스 → 설정 생성 → 프록시 코어
v2rayNG → Xray
v2flyNG → V2Fly
v2rayN → 설정에 맞는 지원 코어 선택클라이언트 인터페이스는 설정을 관리하고, 코어는 실제로 프로토콜과 네트워크 연결을 처리합니다. 이름이 비슷해도 기능이 완전히 같은 것은 아니므로 서버에서 요구하는 프로토콜, 전송 방식, 보안 매개변수를 기준으로 선택하세요. 예를 들어 REALITY 설정을 사용한다면 해당 코어와 클라이언트의 가져오기 기능이 지원하는지 확인해야 합니다. VLESS 메뉴가 있는지만으로는 충분하지 않습니다. 기존 설정이 안정적으로 작동한다면 이름만 보고 코어를 바꿀 필요는 없습니다. 지원되지 않는 필드가 있으면 먼저 프로토콜 설명과 클라이언트 업데이트 기록을 확인한 뒤 클라이언트를 바꾸거나 설정을 조정하세요.
문제 해결 순서
로컬 연결 → DNS → 원격 연결 → 핸드셰이크
기록할 항목: 작업 시간, 대상 도메인, 오류 원문
공유 전 주소 토큰과 인증 정보 숨기기로그는 클라이언트의 성능을 평가하는 것이 아니라 연결이 어느 단계에서 멈췄는지 찾는 데 유용합니다. 먼저 문제가 발생한 작업을 기록한 다음 같은 시간대의 오류를 확인하세요. 연결 거부, 시간 초과, 핸드셰이크 실패는 원인이 서로 다를 수 있으므로 같은 설정으로 해결할 수는 없습니다. 한 번에 한 항목만 변경하고 이전 설정을 보관한 뒤 테스트 결과를 비교하세요. 다른 사람에게 도움을 요청할 때는 클라이언트 이름, 운영체제 종류, 민감 정보를 가린 오류 원문을 제공하면 단순히 연결이 안 된다고 말하는 것보다 정확한 진단에 도움이 됩니다. 구독 정보와 인증 정보가 노출되는 것도 막을 수 있습니다.
전체 과정을 파이프라인으로 생각하면 이해하기 쉽습니다. 구독에서 설정을 가져오고, 클라이언트에서 서버를 선택한 다음 시스템 프록시나 가상 네트워크 인터페이스가 앱 요청을 받아 코어가 라우팅 규칙에 따라 연결합니다. 어느 한 단계라도 완료되지 않으면 최종 접속에 실패할 수 있습니다. 따라서 서버 목록이 표시된다는 사실만으로는 설정을 가져왔다는 것만 확인할 수 있으며, 전체 연결이 정상이라고 판단할 수는 없습니다.
처음 설정할 때는 기본 매개변수를 유지하고 가장 간단한 경로로 먼저 연결을 확인하세요. DNS, 라우팅, 전송 방식, 네트워크 모드를 한꺼번에 바꾸면 연결이 복구되어도 어떤 설정이 원인이었는지 알기 어렵습니다. 기본 연결이 안정된 뒤 실제 앱 사용에 필요한 규칙을 추가하세요. 낯선 항목은 용어집에서 뜻을 확인하고, 구체적인 오류는 도움말 센터에서 증상에 따라 해결 방법을 찾아보세요.
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 살펴보세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 이름이 비슷해도 설치 파일은 다른 플랫폼에서 사용할 수 없습니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 Windows 레이아웃을 유지합니다. 새로 설치한다면 먼저 데스크톱 버전을 살펴보세요. 기존 사용 방식에 익숙하다면 두 인터페이스의 메뉴 위치를 비교해 선택하면 됩니다. 구독을 가져오는 기본 방법은 같으므로 인터페이스를 바꾼다고 구독을 새로 신청할 필요는 없습니다.
설치 전에 시스템 아키텍처와 설치 안내를 확인하세요. 실행한 뒤 구독을 업데이트하고 서버와 시스템 프록시를 설정하면 됩니다. 클라이언트를 종료한 뒤에도 브라우저에 프록시 연결 오류가 표시된다면 서버 문제로 단정하지 말고 시스템 프록시 설정이 복구되었는지 먼저 확인하세요.
다운로드 페이지로 이동v2rayN macOS 설치 파일은 Apple Silicon과 Intel 칩용으로 나뉩니다. 시스템의 '이 Mac에 관하여'에서 칩 또는 프로세서 정보를 확인한 다음 해당 아키텍처에 맞는 파일을 선택하세요. 설치 파일을 다운로드했다고 해서 시스템에서 앱 실행을 허용한 것은 아닙니다. 처음 실행할 때 시스템 보안 안내를 처리해야 할 수도 있습니다.
시스템 프록시와 TUN은 필요한 권한이 서로 다릅니다. 먼저 일반 프록시 방식으로 구독과 서버가 작동하는지 확인한 뒤 필요에 따라 추가 네트워크 권한을 허용하세요. 실행이 차단되면 안내 내용을 읽고 시스템 설정의 허용 절차를 따르세요. 보안 기능 전체를 함부로 끄지 마세요.
다운로드 페이지로 이동v2rayNG는 Xray 코어를 사용하며 여기서 우선 추천하는 Android 클라이언트입니다. v2flyNG는 V2Fly 코어를 사용하는 또 다른 설정 경로입니다. 둘 다 arm64와 범용 설치 파일을 제공하므로 최근 출시된 일반적인 기기라면 먼저 arm64를 확인하고, 아키텍처를 모를 때는 다운로드 페이지의 선택 안내를 살펴보세요.
처음 연결할 때 표시되는 시스템 VPN 권한 안내는 로컬 네트워크 인터페이스를 만드는 절차입니다. 허용한 뒤에도 유효한 서버 설정을 선택해야 합니다. 화면을 잠근 뒤 연결이 자주 끊기면 백그라운드 활동 및 배터리 사용 제한을 확인하세요. 휴대전화의 절전 설정을 구독 오류로 오해하지 마세요.
다운로드 페이지로 이동v2rayN Linux 설치 파일은 deb, rpm 형식과 프로세서 아키텍처에 따라 나뉩니다. 먼저 배포판의 패키지 형식을 확인한 뒤 x64 또는 arm64를 선택하세요. 파일이 열린다는 이유만으로 설치를 진행하지 마세요. 패키지 형식, 아키텍처, 데스크톱 환경의 종속성을 모두 맞춰야 합니다.
데스크톱 환경에 따라 시스템 프록시를 읽는 방식이 다를 수 있으며 터미널 프로그램은 데스크톱 프록시 설정을 따르지 않을 수도 있습니다. 먼저 프록시 설정을 따르는 것이 분명한 앱을 골라 연결을 확인하고, 다른 프로그램도 차례로 점검하세요. TUN이 필요하다면 플랫폼 가이드에서 권한과 네트워크 트래픽 전달 방법을 확인하세요.
다운로드 페이지로 이동클라이언트 자체에는 사용할 수 있는 원격 서비스가 포함되어 있지 않습니다. 시작하기 전에 유효한 구독 주소나 공유 링크를 준비하고, 선택한 클라이언트와 코어에서 사용할 수 있는지 확인하세요.
v2rayN에서 구독 그룹 설정을 열고 알아보기 쉬운 별칭과 전체 구독 주소를 입력한 뒤 저장하고 구독을 업데이트하세요. v2rayNG에서는 구독 설정에 주소를 추가한 다음 메인 화면으로 돌아가 업데이트하면 됩니다. 붙여넣기 전후에 공백, 줄바꿈, 주소 잘림이 없는지 확인하세요. 특히 서비스 제공자의 관리 페이지 주소를 구독 주소로 입력하지 않도록 주의하세요.
업데이트가 끝나면 예상한 서버 설정이 표시되는지 확인하세요. 목록이 비어 있으면 업데이트 결과와 로그를 먼저 살펴보고, 기존 설정이 있다면 비교를 위해 보관하세요. 구독 토큰은 설정에 접근할 수 있는 인증 정보입니다. 스크린샷을 정리하거나 도움을 요청할 때 주소 전체를 숨기세요. 도메인만 가리고 쿼리 매개변수를 남겨 두지 마세요.
데스크톱에서는 사용할 서버를 선택한 다음 시스템 프록시 자동 설정을 적용하고 내장 라우팅 프리셋부터 사용해 보세요. Android에서는 설정을 선택하고 연결을 누른 뒤 시스템 안내에 따라 VPN 인터페이스 생성을 허용합니다. 메뉴 이름은 인터페이스 업데이트에 따라 바뀔 수 있지만, '설정 선택'과 '앱 요청을 클라이언트로 전달'은 언제나 별개의 단계입니다. 후자가 빠지면 브라우저가 계속 직접 연결할 수 있습니다.
처음부터 여러 네트워크 처리 방식을 동시에 적용하지 마세요. 시스템 프록시는 일반 브라우저의 연결을 먼저 확인하기 좋고, TUN은 시스템 프록시를 따르지 않는 앱까지 처리할 때 유용하지만 권한, DNS, 라우팅 문제를 해결하기가 더 복잡해집니다. 로컬 네트워크 기기에 접속할 수 없다면 무작정 프로토콜을 바꾸지 말고 로컬 네트워크 우회 설정부터 확인하세요.
먼저 결과를 분명하게 확인할 수 있는 자주 쓰는 웹사이트에 접속한 다음 대상 앱을 테스트하세요. 클라이언트에 내장된 연결 테스트는 해당 테스트 조건에서의 결과만 보여 주며 모든 사이트와 앱이 정상 작동한다고 보장하지 않습니다. 일부 웹사이트에는 자체 접속 제한이 있을 수 있으므로 특정 사이트 하나가 열리지 않는다고 구독 전체를 사용할 수 없다고 단정하지 마세요.
문제가 생기면 발생 시간, 앱, 오류 증상을 기록하고 로그에서 같은 시간대의 정보를 확인하세요. 클라이언트가 실행 중인지, 로컬 연결이 정상인지 먼저 확인한 뒤 DNS, 원격 연결, 핸드셰이크를 차례로 점검합니다. 변경할 때마다 같은 테스트를 반복해야 결과를 비교할 수 있습니다. 자세한 절차와 운영체제별 차이는 가이드에서 확인할 수 있습니다. 홈페이지에는 가장 간단한 작업 순서만 정리했습니다.
먼저 프로젝트, 코어, 그래픽 클라이언트를 구분한 뒤 프로토콜 지원을 비교하세요. 이름 사이에 역사적 연관성은 있지만 같은 소프트웨어의 스킨 세 가지는 아닙니다.
V2Ray는 Project V 생태계의 핵심 프로젝트로, 설정 가능한 네트워크 프록시를 바탕으로 프로토콜, 전송, 라우팅 기능을 제공합니다. 사용자가 일상적으로 다루는 그래픽 인터페이스는 보통 이러한 기능 위에 서버 관리, 구독 업데이트, 설정 메뉴를 제공합니다. 'V2Ray 클라이언트'를 검색하는 사용자가 실제로 필요한 것은 코어 설정 파일을 직접 편집하는 도구가 아니라 이런 그래픽 프로그램인 경우가 많습니다.
이 구분을 알아두면 실용적입니다. 인터페이스의 체크 항목 하나가 클라이언트 동작에 영향을 줄 수도 있고 코어 설정으로 변환될 수도 있습니다. 구독 관리, 창 레이아웃, 시스템 프록시 전환은 주로 클라이언트 영역이며, 프로토콜 핸드셰이크, 아웃바운드 연결, 규칙 매칭은 해당 코어가 처리합니다. 문제가 생기면 먼저 어느 영역에 속하는지 파악해야 관련 문서를 찾을 수 있습니다. 다른 클라이언트의 메뉴 이름을 그대로 검색하는 일도 줄일 수 있습니다.
V2Fly 커뮤니티는 V2Ray 관련 개발을 이어 가고 있으며, Xray는 관련 코드 기반에서 출발해 별도의 코어 계열로 발전했습니다. 일부 개념과 설정 방식은 공유하지만 기능 발전, 프로토콜 세부 사항, 필드 지원이 완전히 일치하지는 않습니다. 양쪽에서 VLESS를 지원한다고 해서 관련 설정을 모두 그대로 사용할 수 있는 것은 아닙니다. 파일 이름만으로 호환성을 판단해서도 안 됩니다.
코어를 선택할 때는 서버 요구 사항을 우선 확인하세요. 어떤 프로토콜과 전송 방식을 사용하는지, 특정 보안 기능이 필요한지, 클라이언트가 관련 필드를 모두 가져올 수 있는지 살펴봐야 합니다. REALITY 같은 기능은 지원 여부를 구체적으로 확인하세요. 구독에서 클라이언트에 맞는 가져오기 방법을 제공한다면 해당 설정 안내를 우선 따르세요. 매개변수가 낯설다면 이름만 보고 추측하지 말고 프로토콜 및 전송 용어를 확인하세요.
v2rayN은 데스크톱용으로 구독 관리, 서버 선택, 프록시 관련 설정을 제공합니다. v2rayNG는 Android용이며 Xray 코어를 사용하고, v2flyNG도 Android용으로 V2Fly 코어를 사용합니다. 각 클라이언트의 소스 코드는 해당 오픈 소스 라이선스에 따라 제공되며, 사용 및 재배포 조건은 프로젝트 라이선스를 확인하세요. 오픈 소스는 코드와 라이선스 조건을 뜻할 뿐 원격 서비스의 품질을 보증하지 않습니다.
클라이언트는 무료로 받을 수 있지만 구독에 연결된 원격 서비스는 별개의 항목입니다. 클라이언트를 설치한다고 서비스 제공자의 계정, 요금제, 이용 범위가 자동으로 제공되지는 않습니다. 구독 주소를 무관한 웹사이트에 넘겨 대신 분석하게 해서도 안 됩니다. 이 사이트는 클라이언트 다운로드와 설정 안내를 제공합니다. 가이드를 읽을 때 '도구가 어떻게 작동하는지'와 '서비스를 누가 제공하는지'를 구분하세요. 업데이트와 문제 발생 원인이 서로 다릅니다.
클라이언트 업데이트는 주로 인터페이스, 가져오기 기능, 플랫폼 호환성을 개선합니다. 코어 업데이트는 프로토콜 구현과 실행 동작에 영향을 줍니다. GeoIP 및 GeoSite 데이터 파일 업데이트는 일부 라우팅 규칙이 참조하는 데이터를 바꿉니다. 구독 업데이트는 서비스 제공자가 배포한 설정만 새로 가져오며 이 세 가지 업데이트를 대신하지 않습니다. 라우팅에 문제가 있을 때 구독만 반복해서 업데이트해도 오래된 규칙 데이터는 바뀌지 않을 수 있습니다.
설정을 조정하기 전에 복구할 수 있도록 기존 구성을 기록해 두세요. 업데이트한 다음에는 이전과 같은 앱과 웹사이트로 다시 확인합니다. 새 인터페이스에서 메뉴 위치가 달라졌다면 예전 스크린샷의 위치를 찾기보다 기능 이름을 기준으로 살펴보세요. 플랫폼별 차이가 많다면 전체 플랫폼 가이드를 확인하세요. 구체적인 오류가 발생하면 민감 정보를 가린 오류 원문을 먼저 저장한 뒤 로컬에서 원격 방향으로 차례로 점검하세요.
기본 연결을 마친 뒤 실제로 겪는 문제에 맞춰 더 알아보세요. 아래 세 글은 메뉴 찾기, 첫 실행 권한 처리, 라우팅 데이터 관리 방법을 각각 다루므로 모든 설정을 한꺼번에 바꿀 필요는 없습니다.
v2rayN 메인 창의 각 영역을 살펴보며 서버 목록, 구독 그룹, 하단 로그, 시스템 프록시 전환, 설정 메뉴의 역할을 설명합니다. 초보자도 읽고 나면 자주 쓰는 기능을 쉽게 찾을 수 있습니다.
macOS에서 v2rayN을 처음 열 때 실행이 차단되는 경우를 위해 개인정보 보호 및 보안에서 앱을 허용하고 네트워크와 시스템 프록시 권한을 부여하는 방법, TUN 모드에 필요한 추가 권한을 안내합니다.
GeoIP와 GeoSite 데이터 파일이 라우팅에서 어떤 역할을 하는지 설명하고, v2rayN과 v2rayNG에서 규칙 파일을 업데이트하는 방법과 geosite:cn 같은 표기의 의미를 안내합니다.
전체 글 보기 →