BEFORE STARTING

시작 전: 클라이언트와 유효한 구독 준비

설정 과정에는 두 가지 조건이 필요합니다. 클라이언트가 올바르게 설치되어 있고 구독 주소가 아직 유효해야 합니다. 구독은 해당 서비스 제공업체가 관리하며, 클라이언트는 구독에 포함된 서버 설정을 읽어 코어에 전달해 실행할 뿐입니다.

데스크톱에서는 v2rayN을, Android 기기에서는 v2rayNG를 사용합니다. 아직 설치하지 않았다면 먼저 클라이언트 다운로드 페이지에서 운영체제와 프로세서 아키텍처에 맞는 버전을 선택하세요. 설치가 끝난 뒤 이 페이지로 돌아오면 됩니다. 코어 파일을 미리 수정하거나 JSON 설정을 직접 작성할 필요는 없습니다. 처음 실행할 때 시스템 네트워크 또는 VPN 권한 안내가 표시될 수 있으므로 내용을 확인한 뒤 현재 기기의 보안 정책에 따라 클라이언트가 로컬 프록시 서비스를 만들도록 허용하세요.

구독 주소는 보통 HTTPS로 시작하는 전체 링크입니다. 복사할 때 앞뒤 문자열이나 쿼리 매개변수가 빠지지 않았는지 확인하고, 링크를 검색창이나 공개 채팅, 관련 없는 앱에 붙여넣지 마세요. 구독은 개인 계정 및 서비스 권한과 연결되는 경우가 많으므로 비밀번호와 같은 민감 정보로 취급해야 합니다. 제공업체가 QR 코드를 제공한다면 v2rayNG의 구독 관리 또는 스캔 메뉴에서 읽을 수 있습니다. 이후 업데이트를 안정적으로 진행하려면 최종적으로 저장되는 항목이 임시 서버 하나가 아니라 구독 항목인지 확인하세요.

클라이언트에 기존 설정이 있어도 바로 삭제할 필요는 없습니다. 먼저 현재 사용하는 구독 그룹과 서버 이름을 기록한 뒤 새 구독 항목을 추가하면 필요한 항목을 실수로 삭제하는 일을 막을 수 있습니다. 아래 네 단계는 순서에 맞춰 구성했으므로 처음 진행할 때 중간 단계를 건너뛰지 않는 것이 좋습니다. 각 단계를 마칠 때마다 화면의 피드백을 확인한 뒤 다음 단계로 넘어가세요.

SUBSCRIPTION

구독을 가져와 서버 목록 불러오기

구독은 연결 스위치가 아니라 업데이트 가능한 설정 소스입니다. 주소를 저장한 뒤 직접 업데이트해야 서버 항목이 클라이언트 목록에 추가됩니다.

v2rayN 데스크톱 버전에 구독 추가

v2rayN을 실행한 뒤 주 창 상단에서 “구독 그룹” 또는 “구독” 메뉴를 찾습니다. 배포 버전에 따라 메뉴 이름이 조금 다를 수 있지만, 구독 그룹 설정과 업데이트 기능은 모두 포함되어 있습니다. 구독 그룹 설정으로 들어가 새 항목을 추가하고, 메모란에는 서비스 이름이나 용도처럼 알아보기 쉬운 이름을 입력하세요. 그런 다음 전체 구독 주소를 주소 입력란에 붙여넣습니다. 메모는 로컬에서 구분하기 위한 용도이며 구독 내용에는 영향을 주지 않습니다.

설정을 저장한 뒤 주 창으로 돌아가 구독 메뉴를 다시 열고 현재 구독 업데이트 또는 모든 구독 업데이트를 선택합니다. 클라이언트가 구독 내용을 요청해 서버 설정을 분석합니다. 업데이트가 끝나면 주 목록에 여러 서버 항목이 표시되어야 하며, 일반적으로 별칭, 주소, 포트, 전송 방식, 구독 그룹 등의 열이 나타납니다. 목록에 내용이 표시되어야 가져오기가 완료된 것입니다. 구독 설정에 주소 한 줄만 보인다고 해서 서버가 로컬 목록에 업데이트된 것은 아닙니다.

업데이트 후에도 목록이 비어 있다면 먼저 구독 설정으로 돌아가 주소 앞뒤에 공백이 없는지 확인하고, 방금 만든 그룹이 선택되어 있는지도 점검하세요. 이어서 하단 로그 영역을 확인합니다. 네트워크 요청 실패는 보통 시간 초과나 연결 오류로 표시되고, 형식을 분석하지 못한 경우에는 구독 내용 관련 안내가 나타납니다. 이때 업데이트를 연속으로 클릭하지 말고 주소를 계속 사용할 수 있는지 확인한 뒤 한 번 더 업데이트하세요.

v2rayNG Android 버전에 구독 추가

v2rayNG를 열고 사이드 메뉴의 “구독 그룹 설정”으로 들어갑니다. 오른쪽 위의 추가 버튼을 눌러 구독 이름을 입력하고 주소를 붙여넣은 다음 저장하세요. 서버 목록으로 돌아온 뒤 오른쪽 위 메뉴를 열고 “구독 업데이트”를 실행합니다. 업데이트 중에는 화면이 잠시 현재 목록에 머물 수 있으며, 완료되면 가져오기 결과가 표시되고 서버 목록에 해당 항목이 추가됩니다.

서비스 제공업체가 QR 코드를 제공한다면 클라이언트의 스캔 기능으로 읽을 수 있습니다. 다만 QR 코드가 구독인지 단일 서버인지 먼저 확인해야 합니다. 단일 서버를 가져오면 보통 고정 설정 하나만 생성되어 이후 구독 업데이트를 따라가지 않습니다. 구독 항목은 다시 업데이트해 서버 변경 사항을 받을 수 있습니다. 지속적으로 관리해야 하는 설정이라면 구독 그룹으로 저장하는 편이 적합합니다.

구독에는 여러 프로토콜과 전송 설정이 포함될 수 있습니다. 입문 단계에서는 주소, 포트, TLS, 전송 필드를 하나씩 수정할 필요가 없습니다. 이러한 값은 구독에서 통합 제공되기 때문입니다. 필드 하나를 직접 변경하면 서버 설정과 일치하지 않을 수 있습니다. 전체 JSON 구조를 이해해야 한다면 설정 전체 가이드의 outbounds 설명을 별도로 확인하세요. 현재 단계에서는 항목을 선택할 수 있는지만 확인하면 됩니다.

다음 단계: 프록시 모드 선택 →

PROXY MODE

프록시 모드와 트래픽 범위 선택

프록시 모드는 어떤 요청을 현재 서버에서 처리할지 결정합니다. 서버 사용 가능 여부와는 별개의 문제이므로, 처음 설정할 때는 범위가 명확하고 확인하기 쉬운 모드를 선택해야 합니다.

데스크톱에서는 시스템 프록시와 라우팅 모드 구분

v2rayN에서 “시스템 프록시”는 브라우저와 운영체제의 프록시 설정을 따르는 프로그램이 요청을 클라이언트로 보낼지 결정합니다. “라우팅 모드”는 요청이 클라이언트에 들어온 뒤 프록시 아웃바운드, 직접 연결 아웃바운드, 차단 아웃바운드 중 어디로 갈지 정합니다. 두 설정은 함께 사용해야 하지만 적용 계층은 다릅니다. 서버만 선택하고 시스템 프록시를 켜지 않으면 일반 브라우저는 기존 네트워크 경로로 접속할 수 있습니다. 시스템 프록시를 켜야 클라이언트가 해당 프로그램의 요청을 받습니다.

처음에는 트레이 메뉴나 주 창에서 시스템 프록시 자동 설정을 선택하고 클라이언트가 제공하는 규칙 모드를 사용해 보세요. 규칙 모드는 내장 규칙이나 구독에서 제공하는 라우팅 규칙에 따라 트래픽을 처리하므로 일상적인 사용과 문제 해결에 적합합니다. 전역 모드는 더 넓은 범위의 요청을 프록시 서버로 보내므로 특정 접속 문제가 라우팅 규칙 때문인지 잠시 확인할 때 유용하지만, 모든 상황의 고정 해법으로 사용하기에는 적합하지 않습니다. 직접 연결이 필요한 로컬 주소, LAN 기기, 특정 도메인은 라우팅 규칙으로 명확히 처리해야 합니다.

macOS와 Linux의 v2rayN 데스크톱 버전에서도 시스템 프록시 상태를 확인해야 합니다. 데스크톱 환경과 네트워크 관리 구성 요소가 다르므로 메뉴 문구나 권한 안내가 Windows와 완전히 같지 않을 수 있습니다. “시스템 프록시가 켜짐” 상태를 기준으로 확인하고, 사용하는 브라우저가 시스템 프록시 설정을 읽는지도 점검하세요. 별도의 프록시 설정을 가진 일부 앱은 시스템 설정을 자동으로 따르지 않으므로 앱 내부에서 시스템 프록시 사용을 따로 선택해야 합니다.

Android에서 앱별 프록시 범위 지정

v2rayNG는 시스템 VPN 서비스를 통해 트래픽을 처리합니다. 처음 사용할 때는 기본 라우팅 설정을 유지하는 편이 확인을 완료하기 쉽고, 복잡한 앱별 프록시는 바로 켜지 않아도 됩니다. 앱별 프록시를 활성화한다면 “선택한 앱만 프록시”와 “선택한 앱 우회” 중 무엇을 사용할지 명확히 정해야 합니다. 두 옵션의 의미는 서로 정반대입니다. 확인에 사용할 브라우저가 목록에서 선택되지 않았다면 연결 버튼이 실행 중으로 표시되어도 브라우저 트래픽이 클라이언트를 거치지 않을 수 있습니다.

현재 목적이 구독과 서버가 작동하는지만 확인하는 것이라면 앱별 제한을 잠시 해제해 확인 경로를 단순하게 유지하세요. 연결에 성공한 뒤 필요에 따라 앱 범위를 좁히면 됩니다. 이렇게 하면 “서버를 사용할 수 없음”과 “앱이 프록시 범위에 포함되지 않음”을 분리할 수 있어 처음 설정할 때 여러 변수를 동시에 변경하는 일을 피할 수 있습니다.

모드를 정한 뒤 설정 페이지를 여러 곳 바로 살펴볼 필요는 없습니다. 먼저 서버 목록으로 돌아가 구체적인 항목을 선택하고 연결을 설정하세요. 도메인, IP, 인바운드 태그, 아웃바운드 태그에 대한 세부 규칙이 필요하다면 기본 연결을 완료한 뒤 설정 전체 가이드의 routing 장을 확인하세요.

다음 단계: 연결 설정 →

CONNECT

서버 선택 후 연결 설정

연결에는 두 단계가 있습니다. 먼저 현재 활성 서버를 지정한 다음 클라이언트 코어와 시스템 프록시 또는 VPN 서비스를 실행 상태로 전환해야 합니다.

서버를 현재 활성 항목으로 지정

서버 목록에서 방금 구독 그룹으로 가져온 항목을 하나 선택합니다. v2rayN은 보통 더블클릭, 마우스 오른쪽 메뉴 또는 바로가기 동작으로 항목을 활성 서버로 지정할 수 있습니다. 성공하면 해당 행에 선택 표시, 색상 변화 또는 활성 상태 안내가 나타납니다. v2rayNG에서는 서버 이름을 직접 누르면 되며, 선택된 항목은 보통 왼쪽에 선택 표시가 나타납니다. 목록을 보기만 한 상태에 머물지 말고 클라이언트가 특정 활성 설정을 명확히 가리키는지 확인하세요.

처음 선택할 때 최저 지연 시간만을 기준으로 삼을 필요는 없습니다. 지연 시간 테스트는 측정 시점의 연결 상태만 보여 줄 뿐 실제 연결 확인을 대신하지 못합니다. 테스트 기능이 있다면 완전히 시간 초과되는 항목을 먼저 제외하고 결과를 반환하는 설정을 선택하세요. 테스트 결과가 비어 있다고 해서 반드시 사용할 수 없는 것은 아닙니다. 일부 네트워크 환경이나 서버 설정은 특정 탐색 방식에 응답하지 않을 수 있으므로 최종 판단은 연결 로그와 실제 접속 결과를 기준으로 해야 합니다.

데스크톱 연결 시작

v2rayN에서 서버를 선택한 뒤 코어가 실행되었는지 확인하고, 시스템 프록시 메뉴에서 앞 단계에서 정한 프록시 상태를 선택합니다. 주 창 하단이나 로그 영역에 시작 정보가 표시되는 경우가 많으며, 트레이 아이콘과 상태 표시줄에도 현재 시스템 프록시 상태가 반영됩니다. 이때 클라이언트 프로세스를 바로 종료하지 마세요. 창을 닫아 트레이로 최소화한 것이라면 연결은 계속되지만, 트레이 메뉴에서 프로그램을 종료하면 로컬 프록시 서비스도 함께 중지됩니다.

시작 직후 중지된다면 먼저 로그 끝부분을 확인하세요. 포트가 이미 사용 중이면 리스닝 실패가 표시되는 경우가 많고, 호환되지 않는 설정 필드가 있으면 분석 또는 시작 오류가 나타납니다. 코어 파일을 실행할 수 없으면 시작 단계에서 바로 중단됩니다. 입문 단계의 문제 해결에서는 먼저 같은 로컬 포트를 사용하는 다른 프록시 프로그램을 종료한 뒤 v2rayN을 다시 시작하세요. 구독으로 생성된 서버 필드를 직접 편집하지는 마세요.

Android 연결 시작

v2rayNG에서 서버를 선택한 뒤 메인 화면 오른쪽 아래의 연결 버튼을 누릅니다. 시스템이 처음 VPN 서비스를 설정할 때 권한 대화상자가 표시되며, 승인해야 클라이언트가 로컬 VPN 인터페이스를 만들 수 있습니다. 연결에 성공하면 버튼 상태가 바뀌고 시스템 상태 영역에도 VPN 연결 표시가 나타납니다. 누른 뒤 버튼이 곧바로 연결 해제 상태로 돌아간다면 클라이언트 로그를 열어 시작 또는 핸드셰이크 단계의 오류를 확인하세요.

일부 Android 기기는 백그라운드 앱 실행을 제한합니다. 처음 확인할 때는 v2rayNG를 포그라운드에 둔 상태로 웹페이지 접속과 로그 확인을 먼저 완료하세요. 그 후 백그라운드 정책을 점검하면 됩니다. 포그라운드에서는 정상적으로 연결되다가 백그라운드로 전환한 뒤 일정 시간이 지나 중단된다면 구독 가져오기보다는 시스템 배터리 정책이나 백그라운드 제한이 원인일 가능성이 큽니다.

연결 아이콘은 로컬 서비스가 시작되었다는 사실만 보여 줄 뿐, 대상 요청이 원격 서버에 성공적으로 도달했다는 것을 단독으로 증명하지는 않습니다. 따라서 마지막 확인 단계가 필요합니다. 문제가 생겼을 때 동일한 설정 경로를 따라 점검할 수 있도록 확인하는 동안 현재 서버와 모드를 유지하세요.

다음 단계: 작동 여부 확인 →

VERIFICATION

실제 접속과 로그로 작동 여부 확인

정확한 확인을 위해 클라이언트와 앱 양쪽을 함께 관찰해야 합니다. 브라우저가 실제 요청을 만들고 클라이언트 로그에는 해당 요청의 라우팅과 아웃바운드 결과가 기록됩니다.

반복 가능한 브라우저 테스트 1회 실행

클라이언트 연결을 유지한 채 새 브라우저 창을 열고 현재 설정을 확인할 대상 페이지에 접속합니다. 안정적으로 반복 접속할 수 있는 페이지를 선택하고, 판단을 방해할 수 있는 여러 다운로드 작업이나 스트리밍 페이지는 동시에 열지 마세요. 페이지가 정상적으로 로드되면 한 번 새로 고친 뒤 작업 시간을 기억하고 즉시 클라이언트 로그를 확인합니다.

v2rayN의 로그 영역에는 새 연결 기록이 나타나야 하며, 보통 대상 도메인, 대상 포트, 사용한 인바운드, 라우팅된 아웃바운드 태그를 확인할 수 있습니다. v2rayNG의 로그 페이지에도 브라우저가 요청을 보낸 뒤 해당 기록이 추가됩니다. 브라우저 작업 시간과 로그 시간이 일치한다면 요청이 클라이언트에 들어온 것입니다. 브라우저에서 접속했는데 로그가 전혀 바뀌지 않는다면 시스템 프록시, 앱별 프록시 범위 또는 브라우저 자체의 독립 프록시 설정을 우선 확인하세요.

현상에 따라 문제 구간 찾기

로그에 요청 기록이 나타난 뒤 연결 시간 초과, 핸드셰이크 실패 또는 원격 종료가 표시된다면 트래픽은 클라이언트에 들어온 것이므로 서버 설정, 네트워크 경로 또는 시스템 시간이 원인일 가능성이 큽니다. 먼저 구독을 한 번 업데이트한 다음 같은 구독 그룹의 다른 서버로 비교해 보세요. TLS 관련 설정은 시스템 시간에 민감하므로 기기의 날짜, 시간대, 시간 동기화 상태가 올바른지 확인해야 합니다.

규칙 모드에서 페이지가 로드되지 않지만 전역 모드로 전환하면 복구된다면 서버는 대체로 정상이고 라우팅 매칭에 차이가 있을 수 있습니다. 이때 규칙 모드로 돌아가 대상 도메인이 어느 아웃바운드에 할당되었는지 확인하세요. 전역 모드에 계속 머무르지는 마세요. 라우팅 배열은 순서대로 매칭되므로 더 광범위한 규칙이 앞에 있으면 요청을 먼저 가로챌 수 있습니다. 전체 필드 관계는 라우팅 규칙 참고서에서 확인할 수 있습니다.

도메인 접속은 실패하지만 알려진 IP로는 연결된다면 DNS 확인 경로가 원인일 수 있습니다. 한 번의 문제 해결 과정에서 여러 DNS 방식을 동시에 활성화하지 마세요. 먼저 클라이언트 기본 설정을 유지하고 오류 현상을 기록한 뒤 DNS 설정 장을 참고해 로컬 확인, 원격 확인, 라우팅 규칙 사이의 관계를 항목별로 점검하세요.

모든 서버가 시작되지 않고 설정을 읽는 즉시 로그에 오류가 표시된다면 이번 업데이트로 생성된 비정상 항목을 삭제한 뒤 구독을 다시 업데이트하세요. 서버 하나만 실패하고 다른 항목은 정상이라면 클라이언트를 재설치할 필요 없이 해당 서버 설정으로 범위를 좁히면 됩니다. 기본 점검 순서는 구독 업데이트 여부, 서버 선택 여부, 로컬 서비스 실행 여부, 요청의 로그 기록 여부, 원격 연결 성공 여부입니다.

확인이 끝나면 테스트 페이지를 닫고 클라이언트를 계속 실행해도 됩니다. 데스크톱에서 종료해야 한다면 먼저 적절한 시스템 프록시 상태로 되돌린 후 트레이 메뉴에서 클라이언트를 종료하세요. Android에서는 메인 화면의 연결 버튼으로 직접 연결을 해제할 수 있습니다. 이렇게 하면 앱은 중지되었는데 시스템에 이전 프록시 설정이 남아 이후 브라우저 접속에 문제가 생기는 일을 방지할 수 있습니다.

완료 점검 보기 →

FINAL CHECK

완료 점검 및 추가 읽을거리

기본 설정을 마친 뒤에는 안정적으로 재현할 수 있는 설정을 먼저 유지하고, 그 후 라우팅, DNS 또는 앱 범위를 조정하세요.

01

구독 업데이트 가능

구독 그룹이 존재하며 수동 업데이트 후 서버 목록이 정상적으로 새로 고쳐지고 지속적인 분석 오류가 발생하지 않습니다.

02

활성 서버가 명확함

목록에 분명한 선택 상태가 표시되고 항목을 전환했을 때 현재 실제로 사용하는 설정을 확인할 수 있습니다.

03

프록시 범위가 예상과 일치

데스크톱에서는 시스템 프록시와 라우팅 모드가 함께 작동하고, Android에서는 확인에 사용할 앱이 올바른 프록시 범위에 포함되어 있습니다.

04

실제 요청과 로그가 일치

브라우저로 접속하면 새 로그 기록이 생성되고 시간과 대상 주소를 통해 요청이 클라이언트에 들어왔는지 판단할 수 있습니다.

설정 전체 가이드 읽기 클라이언트 다운로드 페이지로 돌아가기

QUICK RECOVERY

연결 실패 시 간단한 되돌리기 순서

처음 설정할 때 발생하는 문제는 대개 복잡한 설정을 다시 작성해야 해서가 아니라 작업 흐름이 완전히 이어지지 않아서 생깁니다. 먼저 확인하기 쉬운 상태로 설정을 되돌리세요. 구독 그룹 하나를 남기고 그 안의 서버 하나를 선택한 뒤, 추가 앱별 제한을 끄고 기본 라우팅 모드를 사용해 연결을 다시 시작합니다. 그런 다음 브라우저 페이지 하나만 열어 확인하세요.

로그에 브라우저 요청이 나타나지 않으면 시스템 프록시 또는 VPN 범위를 확인하세요. 로그에는 요청이 나타나지만 원격 연결에 실패한다면 구독을 업데이트하고 같은 그룹의 다른 서버로 바꾸세요. 코어가 시작되지 않으면 포트 사용 여부와 시작 오류를 확인하세요. 도메인만 실패할 때는 DNS를 별도로 점검합니다. 한 번에 한 항목만 수정하고 다시 테스트해야 원인과 결과의 관계를 명확히 파악할 수 있습니다.

이 페이지에서는 기본 연결 절차만 다룹니다. JSON 최상위 구조, inbounds, outbounds, routing, dns, policy에 대한 체계적인 설명은 설정 전체 가이드에 모아 두었으며, 기본 연결이 완료된 후 읽기에 적합합니다. 먼저 사용 가능한 기준 상태를 만든 다음 필드 단위로 조정하는 편이 처음 실행 전에 여러 매개변수를 동시에 수정하는 것보다 문제를 찾기 쉽습니다.

v2rayN 설정 가이드: 구독 가져오기, 프록시 모드, 연결 및 확인