클라이언트 사용법
GUI 클라이언트는 연결 정보를 관리하고 실행 상태를 표시하며, 트래픽 처리는 코어가 담당합니다. 가져오기 성공, 코어 실행, 앱의 프록시 사용은 서로 다른 확인 단계입니다. 먼저 연결 하나가 정상 작동하도록 설정한 뒤 규칙과 트래픽 처리 범위를 넓히면, 문제 발생 시 변경된 지점을 더 쉽게 찾을 수 있습니다.
{
"type": "field",
"domain": [
"geosite:category-ads-all"
],
"outboundTag": "block"
}block 아웃바운드가 정의되어 있고 해당 도메인 규칙 세트가 제공되어야 합니다.
위 화면은 조작 구성을 설명하기 위한 예시입니다. 실제 메뉴 이름은 플랫폼과 빌드에 따라 다르며 포트도 변경할 수 있습니다. 설정 항목을 확인할 때는 먼저 클라이언트에서 어떤 코어를 사용하는지 확인한 뒤 해당 설정 구조를 살펴보세요. GUI의 옵션 이름을 JSON 필드로 간주해 그대로 복사하면 안 됩니다.
설정 파일 참고 자료 보기 →설치 파일 선택
데스크톱에서는 v2rayN을, 안드로이드에서는 우선 v2rayNG를 확인하고 V2Fly 코어를 사용하려면 v2flyNG를 대안으로 고려하세요. 운영체제 이름이 같아도 설치 파일이 서로 호환되는 것은 아닙니다. 다운로드 전에 프로세서 아키텍처와 패키지 형식을 확인하세요. 설치 후 기존 서버 정보나 구독을 이용해 설정을 시작할 수 있습니다.
v2rayN · Desktop / WPF
차세대 크로스 플랫폼 인터페이스 버전과 클래식 WPF 버전을 제공합니다. 처음 설치한다면 다운로드 페이지에서 두 인터페이스의 차이를 확인한 뒤 실행 환경에 맞는 버전을 선택하세요. 기존 설정을 안정적으로 사용 중이라면 업데이트 전에 구독 그룹, 사용자 지정 규칙과 관련 설정을 백업하세요.
프로그램은 현재 사용자에게 쓰기 권한이 있는 폴더에 두고 압축 파일 안에서 직접 실행하지 마세요. 실행 중 런타임 관련 안내가 표시되면 안내에 따라 필요한 구성 요소를 먼저 설치하세요. 창이 열리지 않는 문제를 서버 장애로 오해하지 않도록 주의해야 합니다. 시스템 프록시가 적용된 뒤에도 브라우저가 별도의 프록시 확장 기능을 사용하는지, 로컬 수신 포트를 다른 프로그램이 점유하고 있는지 확인하세요.
다운로드 페이지로 이동v2rayN · Apple Silicon / Intel
‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel 프로세서는 x64에 해당합니다. 컴퓨터 외관이나 구입 연도로 추측하는 것보다 칩에 맞는 설치 파일을 선택하는 편이 정확합니다. 설치 후 응용 프로그램 폴더에서 실행하고, 시스템 안내에 따라 앱 열기 권한을 설정하세요.
메뉴 막대에서 시스템 프록시를 전환하고 실행 상태를 확인할 수 있습니다. TUN이 필요하다면 현재 빌드의 지원 여부와 권한 요구 사항을 확인하세요. 처음부터 여러 트래픽 처리 도구를 동시에 켜지 마세요. 기본 창을 닫은 뒤에도 연결이 유지된다면 메뉴 막대의 클라이언트가 계속 실행 중인지 확인하세요. 종료할 때는 네트워크 프록시 설정이 복구되었는지도 점검해야 합니다.
다운로드 페이지로 이동v2rayNG · v2flyNG
v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 최근 출시된 휴대전화는 대부분 arm64 버전을 선택할 수 있습니다. 기기 아키텍처를 모른다면 다운로드 페이지에서 범용 버전을 확인하세요. 이름이 비슷해도 코어 기능과 설정 지원은 각각 확인해야 하며 아이콘만 보고 판단할 수 없습니다.
처음 연결할 때는 시스템의 VpnService 권한을 허용해야 합니다. 권한을 허용한 다음 연결을 확인하고, 백그라운드에서 연결이 자주 끊기면 배터리 최적화와 제조사의 백그라운드 제한을 점검하세요. 앱별 프록시는 트래픽 처리 대상 앱을 지정하는 기능이므로 설정 전에 ‘선택한 앱’의 의미를 정확히 확인해 허용과 우회를 반대로 이해하지 않도록 주의하세요. 다른 네트워크 트래픽 처리 앱을 동시에 실행하면 권한이나 실제 트래픽 경로에 영향을 줄 수 있습니다.
다운로드 페이지로 이동v2rayN · deb / rpm
먼저 배포판에서 사용하는 패키지 체계를 확인한 뒤 x64와 arm64를 구분하세요. deb와 rpm은 서로 다른 설치 형식이므로 확장자만 바꿔서 서로 대신 사용할 수 없습니다. 다운로드 페이지에서 형식별 설치 파일을 제공하므로 그래픽 소프트웨어 관리자를 지원하는 데스크톱 환경에 적합합니다.
데스크톱 환경마다 시스템 프록시를 읽는 방식이 달라 브라우저에서 연결된다고 해서 모든 프로그램이 프록시를 사용하는 것은 아닙니다. 처음 실행하면 코어 시작 로그를 확인한 뒤 실제로 네트워크에 연결해야 하는 앱에서 동작을 검증하세요. TUN을 켜기 전에 권한과 네트워크 관리 방식을 확인하고, 충돌이 발생하면 다른 가상 인터페이스나 유사한 트래픽 처리 프로그램을 먼저 중지하세요. 재현 가능한 최소 설정을 유지하고 DNS, 라우팅, 서버를 한꺼번에 바꾸지 마세요.
다운로드 페이지로 이동설치 파일과 시스템 요구 사항은 다운로드 페이지에서 확인할 수 있습니다. 클라이언트를 바꾸기 전에 기존 구독 정보를 보관하세요. 클라이언트가 내보낸 실행 설정에는 자동 생성 필드가 포함될 수 있으므로 다른 코어로 그대로 옮기지 않는 것이 좋습니다.
모든 클라이언트 보기 →오픈 소스 생태계와 설정의 경계
V2Ray는 생태계와 기술 논의에서 널리 쓰이는 이름이며 실제 실행 기능은 클라이언트, 코어, 설정이 함께 결정합니다. 이 세 가지를 구분하면 설치 파일, 가이드, 프로토콜 매개변수가 현재 환경에 맞는지 판단하기 쉽고, ‘가져오기는 됐는데 연결되지 않는’ 상황도 줄일 수 있습니다.
Project V는 모듈형 네트워크 프록시 도구를 지향하며, V2Ray는 널리 사용되는 구현체입니다. 설정은 인바운드, 아웃바운드, 라우팅, DNS 등의 항목으로 동작을 구성합니다. 인바운드는 로컬 앱의 연결을 받고, 아웃바운드는 대상이나 프록시 서버에 연결하는 방법을 지정하며, 라우팅은 연결을 보낼 출구를 선택합니다. 이런 구조에서는 프로토콜과 트래픽 처리를 각각 설정할 수 있지만, 연결 하나를 구성하려면 여러 항목이 서로 맞아야 할 수 있습니다. 문제 해결 시 서버 주소만 확인해서는 부족하며 로컬 포트, 전송 매개변수, 라우팅 대상도 함께 살펴봐야 합니다.
V2Fly는 V2Ray의 커뮤니티 유지 관리와 구현 발전을 이어가고 있으며, Xray는 관련 코드 기반에서 출발해 독립적으로 발전한 코어 프로젝트입니다. 두 프로젝트는 기술적 배경을 공유하지만 이후 기능과 매개변수 지원이 완전히 같지는 않습니다. VMess, VLESS 등 프로토콜 이름을 확인한 뒤에도 전송 방식, 보안 설정, 코어별 구현 요구 사항을 살펴봐야 합니다. 설정 형식이 비슷해 보여도 모든 필드를 코어 간에 그대로 재사용할 수 있는 것은 아닙니다. sing-box 역시 자체 설정 체계를 사용하므로 Xray의 라우팅 구문을 그대로 붙여 넣지 말고 해당 문법을 확인하세요.
v2rayN은 데스크톱용으로 서버 관리, 구독 그룹, 시스템 프록시, 코어 설정 기능을 제공합니다. v2rayNG는 안드로이드 환경에서 Xray 코어와 시스템 네트워크 서비스 인터페이스를 이용해 연결을 처리합니다. v2flyNG는 V2Fly 코어가 필요한 안드로이드 환경을 위한 대안입니다. 세 클라이언트 모두 오픈 소스이며 소스 코드를 커뮤니티에서 검토하고 함께 개선할 수 있습니다. GUI는 설정을 직접 작성하는 수고를 줄여 주지만 유효한 서버 정보를 대신 제공하지 않으며 잘못된 인증 정보나 서버 측 전송 설정을 자동으로 수정하지도 않습니다.
오픈 소스 라이선스는 코드의 사용, 수정, 배포 조건을 설명하며 프록시 서비스의 이용 약관과는 다릅니다. 클라이언트, 코어, 패키지 의존성에 각기 다른 라이선스가 적용될 수 있으므로 재배포할 때는 해당 프로젝트의 라이선스 문서와 고지를 확인해야 합니다. 클라이언트를 무료로 사용할 수 있다고 해서 서버 연결 정보까지 클라이언트 프로젝트가 제공한다는 뜻은 아닙니다. 구독 서비스의 이용 가능 여부, 접근 정보, 사용 범위는 정보를 제공한 곳에 문의하세요. 설정을 공개적으로 공유하기 전에는 구독 주소, 사용자 ID, 비밀번호 등 개인 서비스에 접근할 수 있는 정보를 삭제해야 합니다.
인터페이스, 코어, 규칙 세트 업데이트는 각각 다른 문제를 해결합니다. 인터페이스 업데이트는 조작 방식과 설정 생성 방법을 바꿀 수 있고, 코어 업데이트는 프로토콜 구현과 매개변수 조건을 변경할 수 있으며, 규칙 세트 업데이트는 도메인이나 주소 분류에 영향을 줍니다. 업데이트 전에 작동하는 설정을 기록하고 변경 사항을 읽은 뒤 기존 테스트 절차로 검증하세요. 설정 파싱에 실패하면 로그에 표시된 필드와 파일 위치부터 확인하세요. 업그레이드, 프로토콜 전환, 라우팅 교체를 동시에 진행하지 마세요. 한 번에 하나만 바꿔야 문제의 원인을 파악할 수 있습니다.
먼저 코어가 실행되는지 확인하고 로컬 수신 포트를 점검한 다음 앱의 트래픽이 실제로 프록시를 통과하는지 확인하세요. 웹페이지가 열린다는 사실만으로 모든 앱과 요청이 같은 출구를 사용한다고 볼 수는 없습니다. 기본 연결을 확인한 뒤 로컬 네트워크 접근, 특정 도메인 규칙, DNS 동작을 차례로 테스트하세요. 지연 시간 테스트는 특정 탐색 경로의 결과일 뿐 실제 서비스 연결 전체가 성공한다는 뜻은 아닙니다. 계속 시간 초과가 발생하면 한 번의 테스트 결과만 보고 서버를 전부 삭제하기보다 시스템 시간, 포트, 방화벽, 인증, 전송 설정 순서로 점검하세요.
이미 연결에 성공했다면 outbounds의 아웃바운드 태그와 routing 규칙의 관계부터 살펴보세요. 로컬 연결을 점검해야 한다면 inbounds의 수신 주소, 프로토콜, 포트를 먼저 확인하고, 도메인 해석이 관련되면 dns와 라우팅의 해석 정책을 함께 확인하세요. policy 등의 정책 항목은 처음 실행할 때 꼭 수정할 필요가 없으므로 명확한 목적이 있을 때만 조정하세요. 예제는 필드 간 관계를 설명하기 위한 것이므로 병합 전에 현재 코어의 전체 설정 구조와 대조하고, 정상 작동하는 원본 설정을 따로 보관하세요.
가이드와 문제 해결 기록
실제 사용 단계에 맞춰 클라이언트 안내를 제공합니다. 백그라운드 연결 끊김, 로컬 네트워크 공유, 실행 오류가 발생하면 해당 증상을 먼저 찾고 문서의 점검 순서대로 진행하세요. 권한이나 방화벽을 변경할 때는 영향 범위를 파악하고 원래 설정으로 되돌리는 방법도 마련해 두세요.
안드로이드에서 연결이 끊기거나 프록시가 적용되지 않는 문제는 시스템 권한, 백그라운드 배터리 제한, 앱 선택 범위 때문일 수 있습니다. 연결 전 권한, 백그라운드 실행, 앱별 설정 순서로 확인해 클라이언트 설정 문제와 시스템 제한을 구분하세요.
가이드 읽기 →공유하기 전에 PC의 수신 주소와 실제 포트를 확인한 다음 방화벽과 다른 기기의 프록시를 설정하세요. 같은 네트워크에서 연결하는 방법과 접근 범위, 공유를 중단할 때 복구해야 할 설정을 안내합니다.
가이드 읽기 →창이 바로 닫히면 인터페이스 빌드와 실행 환경을 구분한 뒤 폴더 쓰기 권한과 설정 파일을 확인하세요. 원본 정보를 보존하고 항목을 하나씩 점검해 실행을 복구하면 모든 설정을 바로 초기화하는 일을 피할 수 있습니다.
가이드 읽기 →