준비할 것은 클라이언트, 유효한 구독 주소, 정확한 시스템 시간입니다. 기본 조건을 먼저 확인하면 이후 단계에서 반복해서 되돌아가는 일을 줄일 수 있습니다.
플랫폼별 인터페이스 안내
v2rayN 데스크톱 버전은 보통 상단 메뉴, 서버 목록 및 트레이 메뉴에서 조작합니다. v2rayNG Android 버전은 주로 사이드 메뉴, 오른쪽 상단 작업 버튼 및 하단 연결 버튼을 사용합니다. 메뉴 위치는 다르지만 설정 순서는 같습니다. 먼저 구독을 저장하고 구성을 업데이트한 다음 모드를 선택해 연결합니다.
시작하기 전에 해당 클라이언트가 설치되어 있는지 확인합니다. Windows, macOS 및 Linux 데스크톱 환경에서는 v2rayN을 사용하고 Android 기기에서는 v2rayNG를 사용합니다. 이 가이드에서는 전체 커널 구성을 직접 작성하거나 모든 프로토콜 필드를 미리 이해할 필요가 없습니다. 구독 서비스가 서버 주소, 포트, 전송 방식 및 인증 정보를 클라이언트가 읽을 수 있는 구성으로 정리해 주므로, 처음에는 구독 주소가 완전하고 아직 유효한지만 확인하면 됩니다.
두 번째로 기기 시간을 확인합니다. 연결 인증과 TLS 핸드셰이크에는 정확한 날짜, 시간 및 시간대가 필요합니다. 시스템 시간이 크게 어긋나면 서버 목록은 업데이트되지만 연결 시 계속 시간 초과가 발생하거나 핸드셰이크에 실패할 수 있습니다. 시스템에서 날짜와 시간대를 자동으로 설정한 다음 클라이언트를 완전히 종료하고 다시 여는 것이 좋습니다. 네트워크에서 구독 주소에도 접속할 수 있어야 합니다. 브라우저에서 구독 주소를 직접 열었을 때 만료, 접근 거부 또는 서버 오류가 표시된다면 클라이언트를 계속 수정하지 말고 구독 제공업체에 먼저 문의해야 합니다.
세 번째로 명확한 되돌리기 경로를 남겨 둡니다. 최초 설정에서는 사용자 지정 DNS, 복잡한 라우팅 규칙, TUN 매개변수 및 시스템 방화벽을 동시에 수정하지 마세요. 변수가 적을수록 문제를 찾기 쉽습니다. 먼저 기본 설정으로 연결을 한 번 확인한 뒤 기본 경로가 정상 작동하는지 확인하고, 용도에 맞게 라우팅과 DNS를 조정합니다. 프로토콜, 전송 계층, TLS, 구독 그룹 등의 용어는 개념 빠른 참조에서 확인할 수 있으며, 체계적인 장애 분석은 문제 해결 가이드에서 다룹니다.
01
SUBSCRIPTION
구독 가져오기 및 서버 목록 업데이트
이 단계의 완료 기준은 주소가 저장된 것이 아니라 클라이언트의 메인 목록에 선택 가능한 서버 구성이 표시되는 것입니다.
v2rayN 데스크톱 버전 사용법
v2rayN을 연 다음 먼저 “구독 그룹” 메뉴를 찾아 “구독 그룹 설정”으로 들어갑니다. 버전에 따라 메뉴 배치는 조금 다를 수 있지만 설정 창에는 그룹 추가, 별칭 입력 및 구독 주소 입력 영역이 있습니다. 그룹을 새로 만들고 용도에 따라 “일상 설정” 또는 “보조 설정”처럼 이름을 지정할 수 있습니다. 이름은 로컬에서 구분하기 위한 것이며 연결에는 사용되지 않습니다. 그런 다음 구독 주소를 주소 입력란에 빠짐없이 붙여 넣습니다. 메신저나 문서의 앞뒤 공백까지 함께 복사하지 않도록 주의하세요.
그룹을 저장했다고 해서 설정 창이 닫힌 뒤 서버가 바로 가져와지는 것은 아닙니다. 메인 화면으로 돌아가 “구독 그룹” 메뉴를 다시 열고 “모든 구독 업데이트”를 실행하거나 방금 만든 그룹을 업데이트합니다. 업데이트 중 클라이언트는 구독 내용을 요청하고 구성을 해석합니다. 정상적으로 완료되면 메인 목록에 여러 서버 항목이 표시되며, 보통 별칭, 주소, 포트 또는 프로토콜 유형 등을 확인할 수 있습니다. 이때 각 항목의 지연 시간을 서둘러 모두 테스트하지 말고 목록이 비어 있지 않은지만 확인한 뒤 다음 단계로 진행하세요.
저장 후 새 그룹이 전혀 보이지 않으면 구독 그룹 설정에 다시 들어가 방금 만든 기록이 실제로 존재하는지 확인합니다. 그룹은 있지만 업데이트 후에도 목록이 비어 있다면 클라이언트 하단 상태 정보나 로그 창을 중점적으로 확인합니다. 흔한 원인은 구독 주소가 불완전하게 복사되었거나 구독이 만료되었거나 현재 네트워크에서 구독 API에 접근할 수 없거나 서버가 클라이언트가 인식할 수 없는 형식으로 응답한 경우입니다. 업데이트 버튼을 빠르게 연속해서 누르지 말고, 한 번의 업데이트 결과를 먼저 읽은 뒤 안내에 맞게 처리하세요.
v2rayNG Android 버전 사용법
v2rayNG를 열고 사이드 메뉴의 “구독 그룹 설정”으로 들어갑니다. 추가 버튼을 누른 뒤 그룹 이름과 구독 주소를 입력하고 저장합니다. 메인 화면으로 돌아와 오른쪽 상단 메뉴에서 “구독 업데이트”를 실행합니다. 일부 화면에서는 먼저 구독 그룹을 선택해야 업데이트할 수 있으므로, 여러 그룹을 만들었다면 현재 작업이 방금 추가한 항목에 해당하는지 확인합니다. 업데이트가 끝나면 메인 화면에 서버 구성 목록이 표시되어야 하며 빈 화면만 남아 있어서는 안 됩니다.
Android 시스템은 앱의 백그라운드 네트워크 사용을 제한할 수 있습니다. 처음 업데이트할 때는 v2rayNG를 포그라운드에 둔 채 안내가 끝날 때까지 기다리는 것이 좋습니다. 시스템이 업데이트를 중단했다면 클라이언트를 다시 열고 한 번 더 업데이트합니다. 서버 목록이 정상적으로 표시되었다면 같은 주소를 반복해서 가져올 필요가 없습니다. 내용이 같은 그룹을 여러 개 만들면 이후 구성 선택과 문제 해결이 복잡해집니다.
완료로 판단하는 기준
이 단계를 완료하면 클라이언트 메인 목록에 선택 가능한 구성이 하나 이상 표시되고 업데이트 작업에서 해석 오류가 계속 나타나지 않아야 합니다. 서버 이름을 이해하기 쉬운지는 이후 작업에 영향을 주지 않습니다. 중요한 것은 구성이 클라이언트에 들어왔다는 점입니다. 다음 단계에서는 “어떤 트래픽을 클라이언트가 처리할지”를 정하므로 목록은 그대로 두고 각 구성의 하위 매개변수를 동시에 수정하지 마세요.
서버 구성은 어디에 연결할지를 결정하고, 프록시 모드는 어떤 트래픽을 클라이언트로 보낼지 결정합니다. 두 설정은 서로 독립적이므로 서버만 선택하고 시스템 프록시나 연결 모드를 무시해서는 안 됩니다.
먼저 라우팅 모드와 시스템 프록시를 구분하세요
v2rayN 데스크톱 버전에서 자주 사용하는 두 설정은 “라우팅 모드”와 “시스템 프록시”입니다. 라우팅 모드는 커널로 들어온 트래픽을 프록시로 보낼지, 직접 연결할지 또는 차단할지를 판단합니다. 시스템 프록시는 브라우저와 시스템 설정을 따르는 앱이 요청을 v2rayN으로 보내도록 합니다. 라우팅 모드만 바꾸고 시스템 프록시를 켜지 않으면 브라우저 트래픽이 클라이언트에 전혀 들어오지 않을 수 있습니다. 시스템 프록시만 켜고 활성 서버를 잘못 선택해도 로컬 프록시는 실행 중이지만 외부 연결은 계속 실패할 수 있습니다.
최초 설정에서는 클라이언트가 제공하는 규칙 기반 라우팅 모드를 사용하는 것이 좋습니다. 이 모드는 내장 규칙에 따라 트래픽 방향을 판단하므로 일반적인 웹 탐색이 작동하는지 먼저 확인하기에 적합합니다. 글로벌 프록시는 더 많은 요청을 현재 구성으로 통일해 일부 라우팅 규칙의 오판 여부를 확인하기 쉽지만, 기본 연결을 확인하기 전까지 장기간 사용하는 것은 권장하지 않습니다. 직접 연결 모드는 프록시 경로를 임시로 끌 때 사용합니다. 직접 연결을 잘못 선택하면 클라이언트 프로세스가 실행 중이어도 대상 요청이 선택한 서버를 거치지 않습니다.
v2rayN에서는 먼저 라우팅 설정이나 트레이 메뉴에서 규칙 기반 라우팅을 선택한 다음 시스템 프록시를 “시스템 프록시 자동 설정” 또는 현재 버전에서 같은 의미를 가진 활성화 항목으로 전환합니다. 전환에 성공하면 트레이 아이콘이나 상태 표시줄에 시스템 프록시가 켜졌다는 표시가 나타나는 경우가 많습니다. 아직 활성 서버를 정하지 않았으므로 연결이 완료된 것은 아니지만, 트래픽 진입점은 준비되었습니다. 다음 단계에서 구체적인 구성을 선택하면 됩니다.
v2rayNG 모드 선택
v2rayNG는 Android 시스템이 제공하는 연결 인터페이스를 통해 기기 트래픽을 처리하므로 앱 내부의 라우팅 설정과 연결 스위치가 핵심입니다. 처음에는 기본 라우팅 설정을 유지한 채 기본 작동을 확인하는 것이 좋습니다. 연결 버튼을 누르면 시스템에서 연결 권한을 요청할 수 있으며, 승인해야 클라이언트가 로컬 인터페이스를 만들 수 있습니다. 이 권한은 v2rayNG가 기기 트래픽을 처리하도록 허용한다는 뜻일 뿐 원격 서버 연결이 성공했다는 의미는 아닙니다. 최종 판단은 연결 상태와 실제 접속 결과를 함께 확인해야 합니다.
앱에 “LAN 우회”, “도메인 규칙” 또는 사전 정의된 라우팅 옵션이 있다면 처음부터 서로 겹치는 규칙을 여러 개 동시에 선택하지 마세요. 기본 규칙을 사용하면 변수를 줄일 수 있습니다. 연결 확인이 끝난 뒤 실제 필요에 따라 직접 연결 범위를 조정합니다. domain, ip, geosite, geoip 등 규칙 객체의 의미는 먼저 라우팅 및 분할 용어에서 확인하세요. 복잡한 규칙 충돌과 DNS 라우팅은 이 페이지의 빠른 절차에 포함되지 않으므로 문제 해결 가이드에서 다룹니다.
이 단계의 완료 상태
데스크톱은 규칙 기반 라우팅과 시스템 프록시가 활성화된 상태여야 하며, Android는 명확한 라우팅 모드를 유지한 채 다음 단계에서 연결 권한을 확인할 준비가 되어 있어야 합니다. 이때 다른 프록시 클라이언트를 동시에 켜지 마세요. 여러 프로그램이 같은 시스템 프록시 설정이나 로컬 포트를 두고 충돌할 수 있습니다. 이번 테스트에 사용하지 않는 유사 프로그램을 종료한 뒤 활성 서버를 선택하세요.
이 단계에서는 두 가지만 진행합니다. 구독 목록에서 활성 구성 하나를 정한 다음 클라이언트의 연결 기능을 시작합니다.
데스크톱에서 활성 서버 선택
v2rayN의 서버 목록으로 돌아가 사용할 구성을 클릭한 뒤 마우스 오른쪽 메뉴에서 “활성 서버로 설정”을 선택합니다. 현재 버전에서 제공하는 바로 가기 기능을 사용할 수도 있습니다. 활성 구성은 보통 색상, 아이콘, 글꼴 변화 또는 상태 표시줄 문구로 표시됩니다. 목록의 한 행이 마우스로 선택되어 있다는 이유만으로 작동한다고 판단하지 마세요. 마우스 선택은 화면상의 포커스일 뿐이며, 활성 서버가 실제로 커널이 읽는 대상입니다.
처음 선택할 때 모든 서버 테스트를 반복해서 실행할 필요는 없습니다. 테스트 결과는 현재 네트워크, 서버 응답 방식 및 테스트 대상의 영향을 받으므로 참고용으로만 사용해야 합니다. 먼저 구독 제공업체가 일반 용도로 표시한 구성 하나를 선택해 활성 서버로 지정하고 클라이언트 하단 상태를 확인하세요. 시스템 프록시가 계속 활성화되어 있는지도 확인합니다. 모드를 전환하면서 클라이언트가 구성을 다시 불러왔다면 상태가 안정될 때까지 기다린 뒤 브라우저를 여세요.
정상적으로 작동하면 v2rayN이 백그라운드에서 선택한 커널을 시작하고 로컬 프록시 포트를 수신 대기합니다. 로그에는 보통 구성 로드, 인바운드 수신 대기 및 실행 시작과 관련된 정보가 표시됩니다. 여기서 포트를 직접 수정할 필요는 없습니다. 포트가 이미 사용 중이거나 구성 해석에 실패했다는 메시지만 없으면 됩니다. 포트 충돌이 발생하면 먼저 다른 유사 클라이언트를 완전히 종료한 뒤 v2rayN을 다시 시작하세요. 용도를 모르는 상태에서 로컬 포트를 여러 개 연속으로 변경하지 마세요.
Android에서 연결 시작
v2rayNG 메인 목록에서 사용할 서버 구성을 눌러 현재 구성으로 지정합니다. 화면에는 보통 선택 표시로 활성 항목이 나타납니다. 그런 다음 하단 연결 버튼을 누릅니다. 처음 시작할 때 Android 시스템에 연결 요청이 표시될 수 있으며, 승인하면 상태 표시줄에 시스템 연결 아이콘이 나타나고 v2rayNG의 하단 버튼도 연결 상태로 바뀝니다. 권한을 거부하면 앱이 기기 트래픽을 처리할 수 없으므로 연결을 다시 누르고 승인해야 합니다.
연결 버튼이 시작 상태로 바뀌었다는 것은 로컬 연결 인터페이스가 만들어졌다는 뜻일 뿐 원격 서버를 사용할 수 있다는 증거는 아닙니다. v2rayNG를 몇 초간 포그라운드에 둔 채 구성 오류, 핸드셰이크 실패 또는 지속적인 시간 초과가 즉시 나타나는지 확인하세요. 뚜렷한 오류가 없다면 다음 단계에서 실제 접속으로 확인합니다. 테스트 중에는 여러 서버를 빠르게 반복 전환하지 말고, 전환할 때마다 클라이언트가 구성을 다시 로드하고 연결을 설정할 시간을 주세요.
연결 중 오류가 발생하면
로그에 구성 해석 실패가 명확히 표시된다면 구독의 구성 필드가 현재 클라이언트나 커널과 호환되지 않는 경우가 많습니다. 먼저 클라이언트 구독을 한 번 업데이트한 뒤 같은 구독의 다른 구성으로 테스트합니다. 모든 구성에서 같은 오류가 표시되면 오류가 발생한 단계와 키워드를 기록하고 문제 해결 가이드의 클라이언트 및 구성 항목을 확인하세요. 연결 시간 초과라면 먼저 네트워크를 바꾸거나 다른 구성으로 교차 확인하고 DNS와 라우팅은 바로 변경하지 마세요.
확인 단계로 넘어가기 전 점검
v2rayN은 활성 서버가 표시되고 시스템 프록시가 활성화되어 있어야 하며, 로그에 시작 실패가 계속 나타나지 않아야 합니다. v2rayNG는 구성을 선택하고 연결이 시작된 상태를 표시해야 합니다. 이 조건을 충족하면 클라이언트 측 준비가 완료됩니다. 이제 버튼 상태만 계속 확인하지 말고 새 브라우저 연결과 로그 변화를 통해 요청이 실제로 클라이언트를 통과하는지 확인하세요.
확인할 때는 실제 접속 결과와 클라이언트 로그를 함께 관찰해야 합니다. 연결 아이콘, 지연 시간 테스트 또는 로컬 포트만으로는 전체 경로가 정상인지 확인할 수 없습니다.
새 브라우저 세션으로 테스트
먼저 계속 열어 둔 테스트 페이지를 닫고 새 브라우저 탭에서 프록시 규칙을 거쳐야 하는 일반 사이트에 접속합니다. 페이지를 다시 열면 브라우저 캐시, 기존 연결 및 DNS 캐시가 판단에 미치는 영향을 줄일 수 있습니다. 페이지가 정상적으로 로드되면 사이트 내부의 다른 링크도 눌러 로컬 캐시만 읽은 것이 아닌지 확인합니다. 데스크톱에서는 일반 직접 연결 사이트도 테스트해 규칙 기반 라우팅에서 두 유형의 접속이 모두 작동하는지 확인해야 합니다.
브라우저에 이전 네트워크 상태가 계속 표시되면 브라우저를 완전히 종료한 뒤 다시 엽니다. 일부 브라우저는 이미 설정된 장시간 연결을 유지하므로 연결이 만들어진 후 시스템 프록시가 바뀌어도 기존 연결이 즉시 전환되지 않을 수 있습니다. 데스크톱 앱이 시스템 프록시를 따르는지는 앱 자체 구현에 따라 다르므로 최초 확인은 브라우저를 우선 사용하고, 프록시 작동 방식이 불확실한 소프트웨어 하나만으로 판단하지 마세요.
동시에 클라이언트 로그 확인
접속을 시작할 때 v2rayN 또는 v2rayNG의 로그 영역을 확인합니다. 페이지 요청에 따라 로그에 새 기록이 추가되면 트래픽이 이미 클라이언트에 들어온 것입니다. 이때도 페이지가 열리지 않는다면 문제 범위는 보통 원격 구성, 라우팅 일치, DNS 해석 또는 현재 네트워크 경로에 있습니다. 로그가 전혀 변하지 않으면 시스템 프록시가 작동하지 않거나 Android 연결이 시작되지 않았거나 테스트 앱이 현재 프록시 진입점을 사용하지 않는 경우일 가능성이 높습니다.
로그의 “연결 설정”과 “요청 유입”은 페이지 결과와 함께 해석해야 합니다. 요청 기록은 있지만 계속 시간 초과가 발생하면 먼저 구독의 다른 구성으로 바꿔 보세요. 구성 변경 직후 복구된다면 기존 활성 구성을 일시적으로 사용할 수 없는 것입니다. 모든 구성이 시간 초과되면 현재 기기의 네트워크를 바꿔 비교합니다. 특정 유형의 도메인만 실패하고 다른 접속은 정상이라면 클라이언트를 재설치하기보다 DNS나 라우팅 규칙을 점검해야 합니다.
데스크톱 시스템 프록시 상태 확인
v2rayN이 실행 중으로 표시되지만 브라우저 로그가 전혀 없으면 트레이 메뉴로 돌아가 시스템 프록시가 여전히 활성화되어 있는지 확인합니다. 일부 시스템 네트워크 전환, 클라이언트 비정상 종료 또는 다른 네트워크 도구 실행 후 시스템 프록시 설정이 덮어써질 수 있습니다. 시스템 프록시를 다시 활성화하고 브라우저를 완전히 닫았다가 다시 열어 테스트하세요. 활성화 후에도 곧바로 설정이 바뀐다면 다른 프로그램이 같은 시스템 설정을 관리하고 있는지 확인합니다.
Android 연결 상태 확인
v2rayNG에서 먼저 하단 버튼이 연결 상태인지 확인한 다음 시스템 상태 표시줄에 해당 연결 아이콘이 있는지 확인합니다. 백그라운드로 전환한 뒤 연결이 곧바로 중지된다면 Android 시스템의 v2rayNG 배터리 및 백그라운드 실행 제한을 확인하세요. 빠른 테스트에서는 먼저 앱을 포그라운드에 둔 채 웹페이지에 접속하고, 이후 백그라운드 유지 문제를 처리합니다. 모바일 네트워크에서만 또는 Wi-Fi에서만 실패한다면 두 네트워크를 한 번 전환해 현재 네트워크와 관련된 문제인지 비교합니다.
완료 후 개인 설정 조정
기본 연결이 정상임을 확인한 뒤 필요에 따라 구독 예약 업데이트를 켜거나 라우팅 규칙을 조정하고 특정 DNS를 설정할 수 있습니다. 한 번에 한 범주만 수정하고 수정 후에는 이 절의 접속 및 로그 확인을 반복하세요. 문제가 생겼을 때 어떤 변경이 원인인지 명확히 알 수 있으며 여러 매개변수가 동시에 바뀌는 상황을 피할 수 있습니다. 여러 구독, 복잡한 라우팅, TUN 모드 또는 DNS 정책을 장기간 관리해야 한다면 문제 해결 가이드를 계속 읽고, 최초 설정 단계에서 고급 옵션을 한꺼번에 모두 켜지는 마세요.
verification-path
1새 브라우저로 접속
기존 연결과 페이지 캐시 제외
2클라이언트 로그 확인
요청이 로컬 프록시에 들어오는지 확인
3구성 변경 비교
개별 구성 문제와 전체 문제 구분
4라우팅 결과 확인
프록시와 직접 연결이 모두 예상대로 작동하는지 확인
BASIC CHECK
최초 설정 기본 문제 해결 순서
모든 스위치를 무작정 바꾸지 마세요. 증상에 따라 범위를 좁히는 편이 보통 재설치나 반복적인 구독 가져오기보다 빠릅니다.
A
구독 업데이트 실패
구독 설정에 다시 들어가 주소가 완전한지, 공백이 추가되지 않았는지 확인하고 시스템 시간도 점검합니다. 그런 다음 현재 네트워크에서 구독 주소에 직접 접속해 보세요. 서버에서 만료 또는 거부 메시지를 반환한다면 먼저 구독 상태를 처리해야 합니다. 클라이언트 요청만 실패하는 경우에는 로그의 네트워크 및 인증서 안내를 확인합니다.
B
연결됨으로 표시되지만 웹페이지가 열리지 않음
먼저 웹페이지에 접속할 때 로그에 새 기록이 생기는지 확인합니다. 기록이 없으면 데스크톱 시스템 프록시 또는 Android 연결 상태를 점검하고, 기록은 있지만 시간 초과가 발생하면 활성 구성을 바꿉니다. 구성을 바꿔도 같다면 현재 네트워크를 전환해 비교한 뒤 마지막으로 DNS와 라우팅을 확인합니다.
C
일부 사이트만 이상함
이는 기본 경로가 작동하고 있으며 문제가 라우팅 일치, 도메인 해석 또는 사이트 자체 상태에 있을 가능성이 높다는 뜻입니다. 먼저 라우팅을 클라이언트 기본 규칙으로 되돌려 비교한 다음 로그에서 해당 도메인이 매칭된 아웃바운드 방향을 확인합니다. 사이트 하나의 문제만으로 전체 구독을 삭제하지 마세요.
D
서버를 바꿔도 변화가 없음
선택한 항목이 화면 포커스만 받은 것이 아니라 활성 구성으로 지정되었는지 확인합니다. 전환 후 커널이 다시 로드될 때까지 기다리고 브라우저 연결도 새로 엽니다. Android에서는 먼저 기존 연결을 중지하고 대상 구성을 선택한 뒤 다시 시작해야 합니다. 데스크톱에서는 상태 표시줄의 활성 서버 이름을 확인하세요.