// QUICK CLIENT SETUP

v2rayN 및 v2rayNG 구독 가져오기와 연결 방법

“구독 가져오기 → 프록시 모드 선택 → 연결 → 확인” 순서로 진행하세요. 인터페이스는 버전에 따라 조금 다를 수 있지만 메뉴 이름, 상태 판단법과 문제 해결 흐름은 대체로 같습니다.

예상 소요 시간: 약 10분 준비물: 유효한 구독 주소 지원 클라이언트: v2rayN, v2rayNG
01 IMPORT 구독 저장 및 구성 업데이트
02 ROUTING 시스템 프록시와 라우팅 모드 결정
03 CONNECT 구성을 선택하고 클라이언트 시작
04 VERIFY 접속 결과와 로그로 재확인

// BEFORE STARTING

00시작 전 확인: 클라이언트, 구독 주소와 시스템 시간

작업을 시작하기 전에 클라이언트가 설치되어 정상적으로 열리는지 확인하세요. 데스크톱에서는 v2rayN을, 안드로이드에서는 v2rayNG를 사용합니다. 아직 설치하지 않았다면 클라이언트 다운로드 페이지에서 플랫폼에 맞는 버전을 선택하세요. 처음 실행할 때 네트워크 액세스, 방화벽 또는 로컬 VPN 인터페이스 관련 안내가 표시될 수 있습니다. 현재 기기의 보안 정책에 따라 클라이언트가 로컬 네트워크 연결을 만들도록 허용해야 합니다. 그렇지 않으면 구성을 가져와도 앱 트래픽이 클라이언트로 전달되지 않을 수 있습니다.

이 튜토리얼에서는 “구독 주소”를 입력값으로 사용합니다. 구독 주소는 일반적으로 구독 서비스 제공자가 생성한 https://로 시작하는 전체 링크입니다. 일반 웹 주소와 달리 클라이언트가 이 주소를 읽으면 하나 이상의 사용 가능한 구성을 받아 구독 그룹에 추가합니다. 복사할 때는 처음부터 끝까지 모두 선택하고 앞뒤 공백을 남기지 마세요. 메신저가 자동으로 붙인 마침표도 함께 복사하지 않도록 주의하세요.

구독 주소는 민감한 인증 정보처럼 다뤄야 합니다. 구독 계정을 식별하는 매개변수가 포함될 수 있으므로 스크린샷, 공개 문서 또는 문의 내용에 게시하지 마세요. 다른 사람에게 클라이언트 화면을 보여줘야 한다면 구독 주소와 구성 이름에 포함된 개인정보를 먼저 가리세요. 이 튜토리얼에서는 주소를 로컬 클라이언트에 붙여넣기만 하면 되며, 주소를 이 사이트에 제출할 필요는 없습니다.

마지막으로 시스템 날짜, 시간과 시간대가 정확한지 확인하세요. 일부 프로토콜은 핸드셰이크 단계에서 시간 정보를 사용하므로 시스템 시간 오차가 크면 구성을 가져오는 데 성공해도 연결이 시작 직후 실패할 수 있습니다. 먼저 시스템의 자동 시간 설정을 켠 뒤 가져오기를 진행하는 것이 좋습니다. 클라이언트에 기존 구성이 있다면 바로 삭제할 필요는 없습니다. 알아보기 쉬운 이름의 새 구독 그룹을 만들면 테스트 실패 시 기존 구성으로 빠르게 돌아갈 수 있습니다.

첫 단계로 넘어가기 전에 확인할 상태

  • 클라이언트가 정상적으로 열리고 기본 화면에 시작 오류가 계속 표시되지 않습니다.
  • 전체 구독 주소를 확보했으며 주소가 아직 유효한지 확인했습니다.
  • 시스템 날짜, 시간과 시간대가 정확합니다.
  • “구독 그룹”과 “개별 구성”을 구분할 수 있습니다. 전자는 업데이트를 담당하고 후자는 실제 연결에 사용됩니다.

// STEP 01 · IMPORT

01구독 가져오기: 먼저 그룹을 만들고 구성 목록 업데이트

첫 단계의 목표는 바로 연결하는 것이 아니라 클라이언트에 구독 주소를 저장하고 구독 내용을 선택 가능한 구성으로 변환하는 것입니다. 완료되면 기본 화면에 구독 그룹이 나타나고 그룹 아래에 하나 이상의 구성이 표시되어야 합니다. 주소만 저장하고 업데이트하지 않으면 구성 목록이 비어 있는 경우가 많습니다. 따라서 “저장”과 “업데이트”는 이어서 진행해야 하며, 첫 단계만 수행해서는 안 됩니다.

v2rayN 데스크톱에서 진행

v2rayN을 연 뒤 상단 메뉴에서 “구독 그룹” 또는 비슷한 이름의 구독 관리 메뉴를 찾아 “구독 그룹 설정”으로 들어갑니다. 새 그룹을 만들고 메모 또는 별칭 입력란에 “일상 구독”처럼 알아보기 쉬운 이름을 입력하세요. 전체 구독 주소를 주소 입력란에 붙여넣습니다. 다른 고급 옵션은 일단 기본값으로 두고 설정을 저장한 다음 창을 닫습니다.

기본 화면으로 돌아와 구독 메뉴를 다시 연 뒤 “모든 구독 업데이트”를 실행하거나 방금 만든 그룹만 선택해 업데이트합니다. 업데이트 중에는 하단 상태 영역에 처리 정보가 표시됩니다. 성공하면 기본 목록에 여러 구성 행이 나타나며 일반적으로 구성 유형과 별칭 등의 항목을 확인할 수 있습니다. 이때 이름만 보고 사용 가능 여부를 판단하지 말고, 해당 구성이 방금 만든 구독 그룹에 속하는지 먼저 확인해 기존 목록의 항목을 잘못 선택하지 않도록 하세요.

v2rayN에서 읽기 실패가 표시되면 구독 그룹 설정으로 돌아가 주소의 시작과 끝, 프로토콜 접두사가 완전한지 확인하세요. 주소를 다시 복사해 기존 내용을 덮어쓴 뒤 저장하는 방법도 있습니다. 구독 주소를 “클립보드에서 개별 구성 가져오기” 메뉴에 붙여넣지 마세요. 이 메뉴는 vmess://, vless:// 또는 다른 개별 구성 링크를 처리할 때 사용하며, 구독 그룹의 지속적인 업데이트를 대신할 수 없습니다.

v2rayNG 안드로이드에서 진행

v2rayNG를 열고 왼쪽 상단 메뉴 또는 구독 그룹 관리 메뉴로 들어가 새 구독을 선택합니다. 그룹 이름을 입력하고 전체 구독 주소를 주소 입력란에 붙여넣은 뒤 저장하세요. 기본 화면으로 돌아와 오른쪽 상단 메뉴에서 “구독 업데이트”를 실행합니다. 일부 버전에서는 먼저 구독 그룹을 선택해야 업데이트할 수 있습니다. 기본 화면이 계속 비어 있다면 현재 표시된 그룹이 방금 만든 그룹인지 먼저 확인하세요.

업데이트가 완료되면 기본 화면에 구성이 목록으로 표시됩니다. 구성을 누르면 현재 구성으로 지정되며, 선택 상태는 색상, 체크 표시 또는 목록 강조로 나타납니다. 이 단계에서는 선택만 완료하고 연결 버튼을 서두르지 마세요. 다음 단계에서 프록시 모드와 라우팅 방식을 확인해야 하며, 그렇지 않으면 연결이 시작되어도 일부 앱의 트래픽이 클라이언트를 거치지 않을 수 있습니다.

구독 업데이트 실패 원인은 하나가 아닙니다. 주소가 완전히 복사되지 않았거나 구독 상태가 변경되었을 수 있고, 현재 네트워크에서 주소를 읽지 못하는 경우도 있습니다. 먼저 주소와 시스템 시간을 확인한 다음 클라이언트 로그의 첫 번째 오류를 살펴보세요. 업데이트 버튼을 계속 반복해서 누르지는 마세요. “구독이 비어 있음”, “지원되지 않는 형식”, 업데이트 후 구성 사라짐 등의 문제는 자주 묻는 질문에서 오류 증상에 따라 계속 확인할 수 있습니다.

// STEP 02 · ROUTING

02프록시 모드 선택: 트래픽 진입점과 라우팅 규칙 구분

구성을 가져온 뒤에는 어떤 트래픽을 클라이언트가 처리할지 결정해야 합니다. 여기서는 두 개념을 혼동하기 쉽습니다. 시스템 프록시 또는 로컬 VPN 인터페이스는 앱 트래픽을 클라이언트로 보내고, 라우팅 모드는 클라이언트에 들어온 요청을 직접 연결, 프록시 또는 차단 중 어떤 방식으로 처리할지 결정합니다. 전자가 켜져 있지 않으면 브라우저가 클라이언트를 완전히 우회할 수 있습니다. 후자를 잘못 선택하면 일부 사이트만 정상 작동하고 다른 사이트의 결과가 예상과 달라질 수 있습니다.

먼저 규칙 모드를 선택하고 필요할 때 조정

처음 설정할 때는 사용자 지정 규칙을 대량으로 수정하기보다 규칙 라우팅을 사용하는 것이 좋습니다. 규칙 모드는 도메인, IP와 규칙 집합에 따라 트래픽을 분류하며, 로컬 네트워크 주소는 보통 직접 연결하고 나머지 요청은 구성에 따라 처리합니다. v2rayN에서는 “규칙”, “LAN 및 중국 본토 우회” 또는 구독 제공 라우팅 방식이라는 이름이 자주 사용됩니다. v2rayNG에서는 라우팅 설정에서 미리 정의된 규칙을 선택할 수 있습니다. 버전에 따라 문구는 조금 다를 수 있으므로 메뉴 위치보다 모드 설명을 기준으로 판단하세요.

“전역” 모드는 일반적으로 클라이언트로 들어온 트래픽을 현재 구성으로 모두 처리한다는 뜻입니다. 규칙 매칭 문제를 잠시 확인할 때 유용하지만 기본 설정으로 사용하는 것은 권장하지 않습니다. “직접 연결” 모드는 클라이언트로 들어온 요청을 대상에 바로 연결하며 주로 비교 테스트에 사용합니다. 규칙 모드에서 특정 사이트가 열리지 않지만 전역 모드에서는 열린다면 라우팅 매칭 문제일 가능성이 큽니다. 두 모드 모두 실패한다면 구성, 연결 상태와 로컬 네트워크를 다시 확인하세요.

v2rayN: 시스템 프록시 켜기

v2rayN 기본 화면 또는 시스템 트레이 메뉴에서 “시스템 프록시”를 찾아 시스템 프록시 자동 설정 또는 비슷한 이름의 활성화 항목을 선택합니다. 활성화되면 트레이 상태, 메뉴 체크 표시 또는 기본 화면 상태 표시줄이 바뀌어야 합니다. 그런 다음 라우팅 설정으로 들어가 규칙 모드를 선택하세요. 이제 브라우저와 시스템 프록시 설정을 따르는 데스크톱 앱의 요청이 v2rayN으로 전달됩니다.

일부 앱은 별도의 프록시 설정을 사용하므로 시스템 프록시를 읽지 않을 수 있습니다. 브라우저에서는 확인에 성공했지만 특정 앱이 계속 기존 연결 방식을 사용한다면 해당 앱의 네트워크 설정을 확인하세요. 한 앱의 문제를 해결하려고 v2rayN의 로컬 수신 포트를 자주 변경하지 마세요. 포트가 바뀌면 저장된 시스템 프록시 설정에도 영향을 줍니다. 포트 충돌 확인과 변경 방법은 로컬 수신 포트 충돌 해결을 참고하세요.

v2rayNG: 라우팅 확인 후 시작

v2rayNG의 트래픽 진입점은 연결 버튼을 눌렀을 때 만들어집니다. 처음 연결을 시작하면 시스템에서 로컬 VPN 인터페이스 권한을 요청합니다. 승인해야 다른 앱의 트래픽을 클라이언트가 받을 수 있습니다. 설정의 라우팅 옵션으로 들어가 먼저 규칙 모드를 선택하세요. 앱별 분류, 사용자 지정 DNS와 사용자 지정 규칙은 고급 기능이므로 첫 연결에서는 기본값을 유지해야 문제 발생 지점을 쉽게 판단할 수 있습니다.

이전에 v2rayNG에서 일부 앱만 클라이언트로 허용하도록 설정했다면 테스트할 브라우저가 허용 목록에 포함되어 있는지 먼저 확인하세요. 그렇지 않으면 클라이언트에는 연결됨으로 표시되어도 브라우저는 해당 인터페이스를 사용하지 않을 수 있습니다. 처음 확인할 때는 단순하고 재현 가능한 방식이 좋습니다. 구성 하나를 선택하고 규칙 모드를 사용하며 평소 쓰는 브라우저를 연결에 포함해 기본 경로가 정상인지 확인한 뒤 세부 규칙을 추가하세요.

트래픽 진입점 v2rayN 시스템 프록시 / v2rayNG 로컬 VPN 인터페이스
라우팅 판단 규칙 모드가 도메인과 IP에 따라 처리 방식을 결정합니다
현재 구성 프록시 경로로 처리할 연결 매개변수를 담습니다

// STEP 03 · CONNECT

03연결 설정: 구성 선택 및 실행 상태 확인

연결하기 전에 구성 목록을 다시 확인해 강조 표시된 항목이 방금 업데이트한 구독 그룹에 속하는지 확인하세요. 클라이언트는 일반적으로 현재 선택된 구성 하나만 사용합니다. 목록에 항목이 많다고 자동으로 하나씩 시도하는 것은 아닙니다. 현재 항목의 이름이 불분명하다면 같은 그룹의 다른 구성으로 바꾼 뒤 선택 표시가 함께 이동하는지 확인해 클릭이 적용되었는지 점검하세요.

v2rayN 데스크톱 연결 과정

기본 목록에서 구성을 두 번 클릭하거나 마우스 오른쪽 버튼 메뉴를 통해 활성 구성으로 지정합니다. 시스템 프록시가 켜져 있는지 확인한 뒤 하단 상태 표시줄을 확인하세요. 활성 구성 이름, 로컬 수신 상태와 실행 안내가 현재 선택과 일치해야 합니다. 일부 버전은 구성 선택 후 코어를 자동으로 시작하고, 일부 버전은 메뉴에서 시작 또는 재시작을 실행해야 합니다. 작업 후 상태 영역이 새로 고쳐질 때까지 기다리세요. 짧은 시간에 여러 구성을 연속으로 바꾸면 로그에 여러 시작 정보가 섞여 실패 지점을 판단하기 어려워집니다.

정상적으로 시작되면 로그에 구성 로드 완료와 로컬 수신 연결 생성이 표시된 뒤 연결 대기 상태로 들어갑니다. 포트 사용 중, 구성 필드 오류 또는 코어 시작 실패가 나타나면 로그의 첫 번째 명확한 오류부터 처리하세요. 이후 반복되는 많은 메시지는 같은 문제로 인한 연쇄 결과일 때가 많습니다. 설정을 수정한 뒤 “서비스 재시작”을 한 번 실행하거나 구성을 다시 선택해 새 설정을 완전히 적용하세요.

v2rayNG 안드로이드 연결 과정

구성 행을 눌러 현재 구성으로 지정한 다음 기본 화면 하단의 연결 버튼을 누릅니다. 처음 연결할 때는 시스템에 표시되는 로컬 VPN 인터페이스 요청을 승인하세요. 연결되면 버튼 모양과 상단 상태가 바뀌고 시스템 상태 표시줄에도 해당 아이콘이 나타납니다. 버튼이 곧바로 연결 안 됨 상태로 돌아가면 버튼을 반복해서 누르지 말고 로그에서 시작 실패 원인을 확인하세요.

구성을 바꿀 때는 먼저 현재 연결을 중지한 다음 새 구성을 선택하고 다시 시작하세요. 이렇게 해야 라우팅, DNS와 연결 매개변수가 함께 다시 로드됩니다. 실행 중 여러 구성을 빠르게 바꾸면 이전 연결이 잠시 남아 브라우저 테스트 결과와 현재 강조된 항목이 일치하지 않을 수 있습니다. 전환을 마친 뒤에는 브라우저의 기존 페이지를 닫고 새 탭에서 확인하세요.

“시작됨”과 “사용 가능”의 차이

클라이언트에 시작됨으로 표시되는 것은 로컬 서비스 또는 인터페이스가 만들어졌다는 뜻일 뿐, 원격 연결이 반드시 성공했다는 의미는 아닙니다. 실제 사용 가능 여부는 다음 단계에서 웹 접속과 로그를 함께 확인해야 판단할 수 있습니다. 반대로 브라우저에서 일반 웹 페이지가 열린다고 해서 트래픽이 클라이언트를 거쳤다고 단정할 수도 없습니다. 해당 페이지가 라우팅 규칙에 따라 직접 연결되었을 수 있기 때문입니다. 녹색 상태 표시 하나나 웹 페이지 하나만 보고 판단하지 마세요.

구성 연결에 실패하면 먼저 같은 구독 그룹의 다른 구성을 시도하세요. 여러 구성이 같은 단계에서 모두 실패한다면 구독이 방금 정상적으로 업데이트되었는지, 시스템 시간이 정확한지와 로컬 네트워크에서 클라이언트 연결을 허용하는지를 확인하세요. 한 번에 조건 하나만 바꾸세요. 먼저 구성을 바꾸고, 다음으로 클라이언트를 재시작한 뒤, 마지막에 라우팅 또는 DNS를 수정합니다. 순서대로 진행해야 여러 변수가 동시에 바뀌는 일을 막을 수 있습니다.

// STEP 04 · VERIFY

04적용 여부 확인: 웹 결과, 로그와 라우팅 기록 함께 확인

확인 단계에서는 세 가지를 판단해야 합니다. 앱 트래픽이 클라이언트로 들어오는지, 현재 구성이 연결에 성공했는지, 라우팅 규칙이 예상대로 요청을 처리하는지입니다. 가장 간단한 방법은 클라이언트 창이나 로그 페이지를 보이는 상태로 두고 평소 사용하는 브라우저에서 테스트할 사이트를 여는 것입니다. 페이지가 로드되는 동안 로그에 새 연결 기록이 나타나는지 확인하세요. 웹 페이지가 응답하고 로그도 동시에 늘어난다면 브라우저 트래픽이 클라이언트로 들어온 것입니다.

그다음 일반적으로 직접 연결되어야 하는 자주 쓰는 사이트를 열고 라우팅 기록을 확인하세요. 규칙 모드에서는 요청마다 처리 결과가 다르게 표시될 수 있으며 이는 정상적인 분류 동작입니다. 모든 요청이 로그에 나타나지 않는다면 v2rayN의 시스템 프록시가 계속 켜져 있는지 또는 v2rayNG의 로컬 VPN 인터페이스가 연결을 유지하는지 먼저 확인하세요. 로그에 요청은 있지만 모두 실패한다면 현재 구성과 구독 상태를 중점적으로 점검하세요.

브라우저는 기존 연결과 캐시를 재사용할 수 있습니다. 구성이나 라우팅 모드를 바꾼 뒤에는 기존 테스트 탭을 닫고 새 탭을 여세요. 필요하면 브라우저를 완전히 종료한 뒤 다시 실행합니다. 이렇게 하면 이전 경로를 계속 사용하는 기존 연결의 영향을 줄일 수 있습니다. 단일 페이지에서 이미지 하나가 로드되지 않았다고 클라이언트 오류로 단정하지 말고, 서로 다른 사이트를 최소 두 곳 테스트하면서 로그에서 실패 요청의 공통 특성을 확인하세요.

확인에 실패했을 때 정해진 순서로 다시 점검

  1. 현재 구성을 확인합니다. 목록의 강조 항목이 방금 업데이트한 구독 그룹에 속하는지 확인하고 같은 그룹의 다른 구성도 시도하세요.
  2. 트래픽 진입점을 확인합니다. 데스크톱에서는 시스템 프록시 상태를, 안드로이드에서는 로컬 VPN 인터페이스 상태를 확인하세요. 로그에 새 요청이 전혀 없을 때는 이 단계부터 점검합니다.
  3. 시작 로그를 확인합니다. 첫 번째 명확한 오류부터 처리하고 포트 충돌, 구성 필드 오류와 시간 이상을 각각 해결하세요.
  4. 라우팅 모드를 임시로 비교합니다. 규칙 모드에서 특정 사이트만 실패하면 잠시 전역 모드로 바꿔 비교할 수 있습니다. 테스트가 끝나면 규칙 모드로 되돌리세요.
  5. 전체 경로를 재시작합니다. 클라이언트를 중지하고 브라우저를 닫은 뒤 클라이언트를 다시 시작해 상태가 안정될 때까지 기다립니다. 이후 브라우저를 열어 다시 테스트하세요.

웹 페이지는 열리지만 도메인 조회 결과가 예상과 다르다면 문제는 구독이나 구성 자체가 아니라 DNS 설정에 있을 수 있습니다. 이때 여러 DNS 매개변수를 동시에 바꾸지 말고 먼저 DNS 점검 및 클라이언트 설정 안내에서 시스템 조회, 클라이언트 조회와 라우팅 규칙의 관계를 확인하세요. 더 복잡한 프로토콜 차이, 코어 호환성과 리소스 사용량 비교는 프로토콜 및 코어 참고서에서 계속 살펴볼 수 있습니다.

확인을 마친 뒤 현재 사용 가능한 구성 이름, 구독 그룹과 라우팅 모드를 기록해 두세요. 나중에 연결 상태가 바뀌면 먼저 확인된 설정으로 되돌린 다음 구독 업데이트, 개별 구성 또는 로컬 환경 중 어디가 변경되었는지 판단할 수 있습니다. 모든 설정을 한꺼번에 초기화하기보다 정상 작동이 확인된 기준 상태를 남겨 두는 편이 문제를 찾기 쉽습니다.

// AFTER SETUP

완료 후 관리: 구독 업데이트, 구성 전환과 기준 설정 유지

일상적으로 사용할 때 구독을 새로 만들 필요는 없습니다. 구독 내용이 바뀌면 “구독 업데이트”를 실행한 뒤 업데이트된 목록에서 구성을 선택하세요. 구독 주소 자체가 바뀐 경우에만 기존 그룹을 편집하거나 새 그룹을 만들면 됩니다. 업데이트 후 현재 구성이 삭제되면 클라이언트에 이전 선택이 남아 있어도 계속 사용할 수 없으므로 목록에 남아 있는 구성을 다시 선택하세요.

구성을 전환할 때는 연결 중지, 새 구성 선택, 재연결, 새 탭에서 확인의 순서를 지키세요. 라우팅 모드를 바꿀 때도 자주 쓰는 사이트를 다시 테스트해 기존 연결로 인한 오판을 피해야 합니다. 문제를 확인하려고 전역 모드를 임시로 사용했다면 테스트 후 규칙 모드로 되돌리세요. 사용자 지정 규칙을 추가했다면 수정 목적과 대상 매칭을 기록해 두면 다음 구독 업데이트 후 다시 확인하기 쉽습니다.

문제가 생기면 클라이언트를 바로 재설치하기보다 증상을 먼저 설명하세요. 유용한 문제 해결 정보에는 사용한 클라이언트 종류, 문제가 구독 업데이트 단계에서 발생했는지 연결 단계에서 발생했는지, 로그의 첫 번째 오류, 시스템 프록시 또는 로컬 VPN 인터페이스 상태와 구성 변경 후 결과가 포함됩니다. 스크린샷에 구독 주소를 공개하지 마세요. 일반적인 오류는 자주 묻는 질문 페이지에서 “설치 및 구성”과 “문제 해결” 분류로 찾아볼 수 있습니다.

// NEXT REFERENCE

어느 부분을 더 알아볼까요?

다운로드 페이지에서는 클라이언트 버전을 선택할 수 있고, 자주 묻는 질문 페이지에서는 증상별 해결 순서를 안내합니다. 프로토콜 상세 페이지에서는 VLESS, VMess, Trojan, REALITY와 V2Fly 및 Xray 코어의 관계를 비교해 설명합니다.