v2rayN 및 v2rayNG 사용법

v2rayN 데스크톱에 구독 추가

v2rayN을 연 뒤 창 상단 메뉴를 확인합니다. ‘구독 그룹’ 또는 비슷한 이름의 구독 관리 메뉴로 들어가 ‘구독 그룹 설정’을 엽니다. 설정 창에서 추가를 선택하고 서비스 이름이나 용도처럼 식별하기 쉬운 메모를 입력한 다음 전체 구독 URL을 주소 입력란에 붙여 넣습니다. 메모는 로컬에서 구분하기 위한 것이며 구독 내용에는 영향을 주지 않습니다.

저장한 뒤 메인 창으로 돌아가 구독 메뉴를 다시 열고 ‘모든 구독 업데이트’를 실행하거나 방금 만든 그룹만 업데이트합니다. v2rayN은 구독 내용을 읽어 설정 목록에 표시합니다. 업데이트 중에는 버튼을 연속해서 누르지 말고 상태 표시줄이나 안내가 끝날 때까지 기다리세요. 목록에 기존 설정이 있다면 전체 행 수만 보지 말고 그룹 이름으로 새 내용이 추가되었는지 확인하세요.

메뉴에 ‘구독 업데이트’와 ‘프록시를 통해 구독 업데이트’가 함께 표시되면 처음에는 일반 업데이트를 선택하는 것이 좋습니다. 현재 네트워크에서 구독 URL에 직접 접근할 수 없지만 클라이언트에 이미 사용 가능한 연결이 있을 때만 기존 프록시를 통한 업데이트를 고려하세요. 새로 설치한 상태에는 활성 연결이 없으므로 프록시를 통한 업데이트가 최초 가져오기 문제를 해결하지 못하는 경우가 많습니다.

v2rayNG 안드로이드에 구독 추가

v2rayNG을 열고 사이드 메뉴에서 ‘구독 그룹 설정’으로 이동합니다. 추가 버튼을 누른 뒤 구독 이름과 구독 URL을 입력하고 현재 그룹을 저장합니다. 일부 버전은 저장 후 구독 목록으로 바로 돌아가고, 일부 버전은 편집 화면에 남아 있습니다. 새 그룹이 표시되기만 하면 메인 화면으로 돌아가 업데이트를 계속할 수 있습니다.

이후 오른쪽 상단 메뉴를 열고 ‘구독 업데이트’를 선택합니다. 업데이트가 완료되면 메인 목록에 구독에 포함된 설정 이름이 나타납니다. 목록이 비어 있다면 먼저 구독 그룹 설정으로 돌아가 방금 저장한 항목을 열고 주소의 시작과 끝, 중간에 줄바꿈이 없는지 확인하세요. 하나의 입력란에 구독 URL 두 개를 연속해서 붙여 넣지 마세요. 여러 출처를 추가해야 한다면 구독 그룹을 각각 만들어야 이후 업데이트와 문제 해결이 명확해집니다.

첫 단계 완료 여부 확인

구독 업데이트가 끝나면 최소 한 개의 선택 가능한 설정이 표시되어야 합니다. 이름, 지역 태그 및 정렬 방식은 구독 제공자가 정하며 클라이언트가 현재 네트워크에 가장 적합한 항목을 자동으로 판단하지는 않습니다. 업데이트에서 파싱 실패, 빈 응답 또는 주소에 접근할 수 없다는 메시지가 표시되면 아직 프록시 모드 설정으로 넘어가지 마세요. 이후 단계는 유효한 설정에 의존합니다.

이때는 링크가 처음부터 끝까지 제대로 복사되었는지, 구독이 아직 유효한지, 기기의 날짜와 시간이 정확한지 확인한 뒤 로컬 네트워크를 한 번 바꾸어 다시 업데이트해 보세요. 구독, 노드, 공유 링크 및 프로토콜의 차이는 구독 및 노드 용어에서 확인할 수 있습니다. 목록에 설정이 표시된 것을 확인한 뒤 프록시 모드를 선택하세요.

먼저 시스템 프록시와 라우팅 모드 구분하기

v2rayN에서 ‘시스템 프록시’와 ‘라우팅 모드’는 서로 다른 계층입니다. 시스템 프록시는 브라우저와 시스템 프록시 설정을 따르는 앱에 요청을 v2rayN의 로컬 리스닝 포트로 보내도록 알립니다. 라우팅 모드는 코어가 도메인, IP 또는 규칙 집합에 따라 요청을 프록시 아웃바운드, 직접 연결 아웃바운드로 보낼지 또는 차단할지 결정합니다. 라우팅만 바꾸고 앱이 로컬 프록시를 사용하도록 설정하지 않으면 브라우저는 여전히 기존 네트워크 경로로 접속할 수 있습니다.

처음 사용할 때는 v2rayN 트레이 메뉴나 메인 화면의 시스템 프록시 메뉴에서 ‘시스템 프록시 자동 구성’ 또는 현재 버전에서 같은 의미를 가진 활성화 옵션을 선택하는 것이 좋습니다. 그런 다음 라우팅 설정에서 클라이언트의 기본 규칙 모드를 사용하세요. 이렇게 하면 일반 브라우저가 클라이언트에 연결되는 동시에 기본 분할 라우팅을 유지할 수 있어 기본 확인이 수월합니다.

전역 모드는 더 많은 요청을 하나의 프록시 아웃바운드로 보내므로 규칙 때문에 접속 결과가 달라지는지 짧게 확인할 때 유용합니다. 하지만 모든 문제를 진단하는 첫 방법으로 사용하는 것은 권장하지 않습니다. 규칙 모드에서는 특정 주소에 접속할 수 없지만 전역 모드에서는 접속된다면 라우팅 매칭에 문제가 있을 가능성이 큽니다. 두 모드 모두 실패한다면 활성 설정, 구독 유효성 및 로컬 네트워크를 다시 확인하세요.

v2rayNG에서 모드 선택

v2rayNG은 기기 수준의 연결 채널을 만들며 메인 화면의 라우팅 설정에서 요청을 어떻게 분할할지 결정합니다. 처음 설정할 때는 기본 제공 규칙을 그대로 두고 사용자 지정 규칙 파일을 바로 가져오지 않아도 됩니다. 설정 페이지에 ‘앱별 프록시’가 있다면 우선 끄세요. 테스트할 앱이 선택되지 않아 클라이언트를 우회하는 일을 방지할 수 있습니다. 기본 연결 확인을 마친 뒤 실제 용도에 맞게 앱 범위를 설정하세요.

버전에 따라 기본 제공 모드의 이름이 조금 다를 수 있으므로 이름만 보지 말고 설명을 확인해야 합니다. 규칙 모드는 도메인과 IP 조건에 따라 아웃바운드를 선택하고, 전역 모드는 대부분의 요청을 활성 프록시 설정으로 보냅니다. 직접 연결 모드는 주로 프록시 경로를 일시 중지할 때 사용합니다. 여기서는 규칙 모드를 선택한 뒤 메인 화면으로 돌아가면 되며 반복해서 전환할 필요는 없습니다.

기본 리스닝 포트를 우선 유지

v2rayN은 보통 로컬 HTTP, SOCKS 또는 혼합 리스닝 포트를 설정합니다. 처음 연결할 때는 기본 포트를 바꿀 필요가 없으며 다른 종류의 클라이언트가 같은 포트를 사용하도록 두지도 마세요. 코어를 시작할 때 포트가 사용 중이라는 메시지가 명확히 표시되면 실행 중인 다른 프록시 클라이언트를 먼저 종료한 뒤 v2rayN을 다시 시작하세요. 꼭 동시에 실행해야 한다면 설정에서 로컬 리스닝 포트를 변경하고 프록시 주소를 수동으로 설정한 앱도 함께 수정해야 합니다.

라우팅의 domain, ip, geosite 및 규칙 우선순위는 고급 설정에 해당합니다. 지금은 규칙이 정해진 순서대로 매칭되고 먼저 일치한 규칙이 아웃바운드를 우선 결정한다는 점만 알아두면 됩니다. 자세한 항목과 JSON 예시는 라우팅 설정 항목에서 확인할 수 있으며, 처음 연결할 때 수정할 필요는 없습니다.

v2rayN에서 활성 서버로 지정

v2rayN 메인 목록으로 돌아가 방금 구독 그룹에서 가져온 설정 하나를 클릭해 선택합니다. Enter 키를 누르거나 마우스 오른쪽 메뉴에서 ‘활성 서버로 지정’을 선택할 수 있습니다. 활성 항목은 버전에 따라 색상, 굵은 글씨, 표시 아이콘 또는 상태 표시줄 문구로 나타납니다. 중요한 것은 목록에서 선택된 상태로만 남아 있는 것이 아니라 상태 영역에 현재 설정 이름이 표시되는지입니다.

활성 서버로 지정한 뒤 창 하단의 상태 표시줄이나 로그 영역을 확인합니다. 코어가 정상적으로 시작되면 시작 완료, 로컬 리스닝이 설정됨 또는 현재 설정이 로드됨과 같은 메시지가 표시되는 경우가 많습니다. 앞에서 시스템 프록시를 켰다면 시스템 설정을 따르는 브라우저 등의 앱이 v2rayN으로 요청을 보내기 시작합니다. 시스템 프록시가 꺼져 있으면 코어가 실행 중이어도 브라우저 접속 결과가 자동으로 바뀌지는 않습니다.

v2rayN은 메인 창을 닫아도 시스템 트레이에서 계속 실행될 수 있습니다. 일시 중지하려면 트레이 메뉴에서 시스템 프록시를 해제하거나 클라이언트를 종료하세요. 메인 창이 보이는지만으로 실행 상태를 판단하지 마세요. 창을 다시 열었을 때도 먼저 활성 설정과 시스템 프록시 상태를 확인한 뒤 재시작 여부를 결정하세요.

v2rayNG에서 연결 시작

v2rayNG 메인 목록에서 설정 하나를 눌러 현재 선택 항목으로 만듭니다. 그런 다음 메인 화면 하단의 연결 버튼을 누르세요. 처음 기기 연결을 만들 때 시스템에 연결 권한 창이 표시됩니다. 권한을 허용하면 버튼 상태가 바뀌고 시스템 상태 영역에도 연결 표시가 나타납니다. 권한은 클라이언트가 연결 채널을 만들도록 허용할 뿐 구독 설정 자체를 대신하지는 않습니다.

연결을 누른 직후 다시 연결 해제 상태로 돌아가면 먼저 로그를 열어 마지막 몇 줄의 오류를 확인하세요. 주요 원인은 설정 항목 파싱 실패, 서버 주소 확인 실패, 네트워크 연결 시간 초과 또는 시스템 시간 오차입니다. 연결 버튼을 빠르게 연속해서 누르지 마세요. 이전 코어가 아직 종료 중일 수 있으므로 몇 초 기다려 상태가 안정된 뒤 다시 시도하세요.

단일 설정의 연결 실패 처리 방법

설정 하나의 연결이 실패했다고 전체 구독을 바로 삭제하지 마세요. 먼저 같은 구독 그룹에서 다른 설정으로 바꾼 뒤 동일한 연결 절차를 실행합니다. 다른 설정으로 연결된다면 클라이언트 기본 설정은 대체로 정상이며 원래 설정의 사용 가능 여부나 네트워크 경로에 문제가 있을 가능성이 큽니다. 같은 그룹의 모든 설정이 실패한다면 구독을 다시 업데이트하고 로컬 네트워크에서 구독 URL에 정상적으로 접근할 수 있는지 확인하세요.

클라이언트 로그는 각 단계의 상태를 판단하는 주요 근거입니다. ‘파싱’, ‘연결 시간 초과’, ‘연결 거부’, ‘포트 사용 중’ 등이 포함된 로그는 각각 확인할 방향이 다릅니다. 처음에는 오류가 시작 전 발생했는지 연결 후 발생했는지만 기록하면 되며 전체 JSON을 바로 편집할 필요는 없습니다. 복잡한 로그와 인바운드·아웃바운드 항목의 관계는 인바운드 설정 및 아웃바운드 설정에서 확인할 수 있습니다.

먼저 클라이언트 상태 확인

v2rayN에서 상태 표시줄에 활성 설정이 계속 표시되고 코어가 중지되지 않았으며 시스템 프록시가 두 번째 단계에서 선택한 상태로 켜져 있는지 확인합니다. 이어서 로그 마지막 부분을 확인하세요. 정상 실행 중에는 요청 기록이나 연결 수립 정보가 나타날 수 있지만 같은 오류가 계속 반복되어서는 안 됩니다. 간헐적인 연결 실패 하나만으로 전체를 사용할 수 없다고 단정할 수는 없습니다. 페이지가 여러 리소스를 동시에 요청할 수 있기 때문입니다. 오류가 연속해서 발생하는지와 브라우저 접속 실패가 함께 나타나는지를 확인하세요.

v2rayNG에서는 연결 버튼이 실행 상태를 유지하고 시스템 연결 표시가 사라지지 않았는지 확인합니다. 로그를 열 때 먼저 테스트를 시작한 시간을 기억해 두고 브라우저로 한 번 접속한 다음 로그로 돌아와 해당 시점의 새 기록이 나타났는지 확인하세요. 이렇게 하면 시작 전에 남은 오래된 로그를 살펴보는 것보다 현재 요청이 클라이언트로 들어왔는지 판단하기 쉽습니다.

브라우저로 실제 접속 테스트

자주 사용하는 브라우저를 열고 새 시크릿 창을 만들거나 기존 페이지를 닫은 뒤 익숙한 웹사이트를 새로 엽니다. 새 창을 사용하면 캐시, 기존 연결 및 브라우저 확장이 결과에 미치는 영향을 줄일 수 있습니다. 페이지가 정상적으로 열리면 서로 다른 도메인의 두 번째 페이지도 열어 비교하세요. 한 웹사이트 자체의 장애를 잘못 판단하는 일을 피할 수 있습니다.

데스크톱에서 클라이언트는 실행 중으로 표시되지만 브라우저에 변화가 없다면 브라우저가 별도의 프록시 설정을 사용하는지 확인하세요. 일부 브라우저나 확장은 시스템 프록시를 덮어쓸 수 있으므로 충돌하는 설정을 일시적으로 끄거나 브라우저를 ‘시스템 프록시 사용’으로 되돌리세요. v2rayNG에서 일부 앱만 변화가 없다면 설정으로 돌아가 앱별 프록시가 켜져 있는지, 대상 앱이 선택 범위에 포함되어 있는지 확인하세요.

검증 실패 원인을 순서대로 찾기

확인에 실패하면 여러 매개변수를 동시에 바꾸지 말고 가장 짧은 경로부터 점검하세요. 첫째, 현재 활성 설정을 다시 확인합니다. 둘째, 구독을 업데이트하고 다른 설정으로 바꿉니다. 셋째, 시스템 프록시 또는 기기 연결이 계속 켜져 있는지 확인합니다. 넷째, 로컬 네트워크를 바꾼 뒤 다시 시도합니다. 변경할 때마다 동일한 브라우저 테스트를 반복해야 어떤 조치가 결과를 바꿨는지 알 수 있습니다.

브라우저에서 어떤 페이지도 전혀 열리지 않는다면 먼저 v2rayN의 시스템 프록시를 해제하거나 v2rayNG 연결을 중지해 로컬 네트워크 자체가 정상인지 확인하세요. 기본 네트워크가 복구되면 클라이언트를 다시 연결합니다. 직접 연결은 정상인데 연결 후 모든 접속이 실패한다면 활성 설정, 코어 로그 및 DNS 오류를 중점적으로 확인하세요. 특정 도메인만 문제가 있다면 라우팅 규칙이나 DNS 분할과 관련되었을 가능성이 큽니다.

DNS 문제는 도메인을 확인할 수 없지만 이미 알고 있는 일부 주소에는 직접 연결 경로가 설정되는 형태로 나타날 수 있습니다. 처음에는 DNS 설정 전체를 바로 교체하지 말고 클라이언트를 재시작하거나 다른 설정으로 바꾼 뒤 다시 테스트하세요. 문제가 계속되면 DNS 설정 항목에서 서버 목록, 도메인 매칭 및 조회 정책의 관계를 확인하세요.

완료 후 일상적인 사용 방법

일상적으로 시작할 때 구독을 다시 가져올 필요는 없습니다. 클라이언트를 연 뒤 구독을 업데이트하고 활성 설정을 확인한 다음 시스템 프록시 또는 기기 연결을 켜면 됩니다. 서비스 제공자가 설정을 변경하면 클라이언트는 구독 업데이트를 실행해야 새 내용을 가져옵니다. 코어만 다시 시작한다고 기존 구독 데이터가 자동으로 바뀌지는 않습니다. 단, 설정에서 시작 시 업데이트를 명시적으로 활성화한 경우는 예외입니다.

일시 중지할 때는 v2rayN에서 먼저 시스템 프록시를 해제한 뒤 클라이언트를 종료하고, v2rayNG에서는 현재 연결을 바로 중지하면 됩니다. 구독을 바꿀 때는 별도의 그룹을 추가하고 새 그룹이 정상적으로 업데이트되고 연결되는지 확인한 뒤 기존 그룹을 삭제할지 결정하는 것이 좋습니다. 이렇게 하면 명확한 복구 경로를 유지하고 문제가 어느 구독 출처에서 발생했는지도 쉽게 판단할 수 있습니다.

이제 기본 설정을 완료했습니다. 프로토콜의 의미와 클라이언트·코어의 관계는 V2Ray 용어집에서 확인할 수 있습니다. 인바운드, 아웃바운드, 라우팅, DNS 또는 정책 항목을 작성해야 할 때는 설정 파일 참고서로 이동하세요. 기본 연결이 안정적으로 작동한 뒤 고급 설정을 수정하면 문제 해결 경로가 짧아집니다.