시작 전 확인
설정을 시작하기 전에 클라이언트가 정상적으로 열리는지 확인하고 서비스 제공업체가 제공한 구독 링크를 준비합니다. 구독 링크는 보통 https://로 시작하는 전체 주소이며, 단일 서버의 메모나 클라이언트 설치 파일이 아닙니다. 복사할 때는 주소의 모든 문자를 포함하고, 메신저나 문서의 마침표와 공백은 함께 복사하지 마세요.
아직 클라이언트를 설치하지 않았다면 데스크톱에서는 Windows 다운로드, macOS 다운로드 또는 Linux 다운로드에서 v2rayN을 선택할 수 있습니다. Android 기기는 Android 다운로드에서 v2rayNG를 선택합니다. 처음 실행한 뒤에는 코어, 포트 또는 DNS를 반복해서 변경하지 마세요. 기본 설정을 유지해야 문제가 구독, 노드 또는 시스템 프록시 중 어디에서 발생했는지 판단하기 쉽습니다.
혼동하기 쉬운 개념이 두 가지 있습니다. 구독은 업데이트 가능한 서버 설정 목록을 클라이언트에 제공하고, 연결은 그 목록에서 노드를 선택해 로컬 프록시를 시작하는 작업입니다. 구독 추가에 성공했다고 네트워크 연결이 완료된 것은 아닙니다. 서버 목록이 표시된 뒤에도 모드 선택과 연결을 진행해야 합니다. 반대로 구독 목록이 비어 있으면 연결을 눌러도 정상적인 결과를 얻을 수 없습니다.
준비할 항목
설치된 클라이언트, 전체 구독 링크, 기본 웹페이지를 정상적으로 열 수 있는 현재 네트워크
잠시 변경하지 않을 항목
로컬 수신 포트, DNS 유형, 코어 경로 및 사용자 지정 라우팅 규칙은 기본 흐름을 완료할 때까지 기본값으로 유지합니다.
설정 출처
V2Ray 구독 링크 가져오기
v2rayN 데스크톱 버전에서 “구독 그룹” 또는 구독 설정 메뉴를 열고 새 구독 그룹을 만듭니다. 그룹 메모에는 “자주 사용하는 구독”처럼 알아보기 쉬운 이름을 입력하고, 주소 입력란에 전체 구독 링크를 붙여 넣습니다. 주소 앞뒤에 공백이 없는지 확인한 후 저장하고 “모든 구독 업데이트” 또는 현재 그룹 업데이트 명령을 실행합니다. 버전에 따라 메뉴 문구는 조금 다를 수 있지만, 그룹 추가·주소 입력·저장·업데이트를 완료해야 합니다.
업데이트가 시작되면 클라이언트 하단의 상태 영역이나 로그를 먼저 확인합니다. 정상적으로 완료되면 기본 서버 목록에 여러 설정 항목이 표시되며, 보통 유형, 주소, 메모 또는 그룹 정보가 포함됩니다. 구독에 프로토콜, 포트, 전송 및 보안 설정이 이미 포함되어 있으므로 서버 매개변수를 하나씩 수정할 필요가 없습니다. 필드를 직접 변경하면 오히려 구독 원본과 설정이 달라질 수 있습니다.
v2rayNG에서 사이드 메뉴의 구독 그룹 화면을 열고 추가 버튼을 눌러 메모와 구독 주소를 입력한 뒤 저장합니다. 구독 목록으로 돌아가 방금 만든 그룹을 선택하고 업데이트를 실행합니다. 그런 다음 메인 화면으로 돌아오면 서버 설정이 선택 목록에 표시되어야 합니다. 목록이 계속 비어 있다면 먼저 구독 그룹에서 해당 그룹이 활성화되어 있는지 확인하고, 주소만 저장한 것이 아니라 실제로 업데이트를 실행했는지 점검합니다.
구독 업데이트 중 주소 만료, 현재 네트워크에서 구독 원본에 접근할 수 없음, 호환되지 않는 응답 형식 또는 요청 시간 초과가 발생할 수 있습니다. 이때 동일한 그룹을 여러 개 연속으로 추가하거나 구독 링크를 단일 노드 공유 링크로 가져오지 마세요. 먼저 그룹 편집 화면에서 주소를 확인하고, 복사 과정이 의심되면 주소를 삭제한 뒤 다시 붙여 넣습니다. 그래도 실패하면 로그의 요청 오류와 발생 시간을 기록한 다음 구독 실패 진단에서 네트워크, 형식 및 프록시 경로를 차례로 점검합니다.
완료 기준
서버 목록에 설정 항목이 표시되고 구독 그룹이 인식되며 업데이트 중 오류가 계속 발생하지 않습니다.
트래픽 처리
프록시 모드 및 라우팅 규칙 선택
구독 가져오기가 끝났다고 각 노드를 바로 수정할 필요는 없습니다. 먼저 클라이언트가 대상별 연결을 어떻게 처리할지 정해야 합니다. 여기서 “시스템 프록시”와 “라우팅 모드”를 구분해야 합니다. 시스템 프록시는 데스크톱 앱의 요청을 v2rayN의 로컬 프록시 포트로 전달할지 결정하고, 라우팅 모드는 요청이 클라이언트에 들어온 뒤 직접 연결·프록시·차단 중 어떤 방식으로 처리할지 결정합니다. 서로 다른 계층이므로 하나만 켜면 기대한 결과가 나오지 않을 수 있습니다.
v2rayN을 처음 설정할 때는 라우팅 설정이나 트레이 메뉴에서 규칙 기반 분할 모드를 선택할 수 있습니다. 사전 설정된 도메인 및 주소 규칙에 따라 직접 연결 또는 프록시를 결정하는 방식입니다. 일반적인 웹페이지 접속을 확인하면서 어떤 규칙이 적용되었는지도 살펴볼 수 있습니다. 전역 모드는 클라이언트가 가로채는 대부분의 요청을 선택한 노드로 보내므로 특정 앱이 라우팅 규칙의 영향을 받는지 짧게 확인할 때 유용합니다. 다만 시스템 백그라운드 트래픽을 잘 모르는 상태에서 장기간 유일한 설정으로 사용하는 것은 권장하지 않습니다. 직접 연결 모드는 프록시 경로를 잠시 중단하고 비교 테스트할 때 사용합니다.
모드를 선택한 후 클라이언트의 현재 라우팅 설정이 로드되었는지 확인합니다. v2rayN은 버전에 따라 라우팅 메뉴가 설정 화면, 메인 메뉴 또는 트레이 메뉴에 있을 수 있으며, 현재 모드는 보통 체크 표시나 텍스트 상태로 나타납니다. 처음 연결하기 전에는 구독에 포함되었거나 클라이언트에 미리 설정된 규칙을 유지하고 사용자 지정 도메인을 많이 추가하지 마세요. 규칙이 복잡할수록 접속 이상이 발생했을 때 어떤 규칙이 원인인지 판단하기 어렵습니다.
v2rayNG 메인 화면에는 일반적으로 라우팅 옵션이나 사전 정의 규칙 메뉴가 있습니다. 데스크톱과 같은 방향의 규칙 모드를 선택한 뒤 메인 화면으로 돌아와 선택 사항이 저장되었는지 확인합니다. Android에서는 연결 서비스가 시작된 후에야 실제로 트래픽을 인계하므로, 이 단계에서 모드만 설정했다고 연결이 실행되는 것은 아닙니다. 이후 특정 앱이 브라우저와 다르게 동작하면 해당 앱의 네트워크 사용 허용 여부, 별도 DNS 사용 여부 또는 시스템 네트워크 서비스 우회 여부를 먼저 확인한 뒤 추가로 점검합니다.
| 모드 | 주요 용도 | 첫 설정 권장 사항 |
|---|---|---|
| 규칙 기반 분할 | 도메인, 주소 또는 규칙 집합에 따라 직접 연결과 프록시를 결정 | 이 가이드의 첫 연결에 사용 |
| 전역 모드 | 클라이언트가 인계한 대부분의 요청에 활성 노드 사용 | 비교 테스트 때만 잠시 전환 |
| 직접 연결 모드 | 현재 네트워크를 사용해 요청을 직접 전송 | 프록시를 일시 중지하거나 연결 차이를 비교할 때 사용 |
앱, 도메인, 포트 또는 네트워크 유형별로 더 세밀한 규칙이 필요하다면 이 가이드에서는 규칙 우선순위와 매칭 문법을 다루지 않습니다. 문제 진단에서 접속 이상을 확인하는 순서를 살펴본 뒤 실제 증상에 맞게 조정하세요. 처음에는 명확한 규칙 모드를 하나 선택하고 규칙을 단순하게 유지한 다음 노드를 연결하면 됩니다.
완료 기준
클라이언트에 현재 라우팅 모드가 표시되고 서로 충돌하는 임시 규칙이 동시에 활성화되어 있지 않습니다.
서비스 시작
노드 선택 및 연결 설정
서버 목록으로 돌아가 방금 업데이트한 구독 그룹에서 설정 하나를 활성 노드로 선택합니다. v2rayN에서는 보통 목록 항목을 두 번 클릭하거나, 마우스 오른쪽 버튼으로 활성 서버로 지정하거나, 화면의 선택 명령을 사용합니다. 선택하면 상태 표시줄에 현재 활성 설정의 메모가 표시되어야 합니다. 항목이 여러 개라도 첫 테스트에서는 하나만 선택하세요. 연결 중 자주 전환하면 로그에 여러 번의 시작 결과가 섞여 어느 작업이 실패했는지 판단하기 어렵습니다.
활성 노드를 정한 뒤 v2rayN에서 시스템 프록시를 켭니다. 이 기능은 보통 트레이 메뉴나 메인 화면의 시스템 프록시 메뉴에 있으며, 활성화하면 상태 문구나 아이콘이 바뀝니다. 클라이언트는 로컬 프록시 인바운드를 시작하고 시스템 프록시를 해당 로컬 수신 주소로 지정합니다. 확인하기 전에는 v2rayN을 종료하지 말고 실행 상태로 유지하세요. 메인 창을 닫은 뒤에도 프로그램이 트레이로 최소화된 것인지 완전히 종료된 것인지 확인해야 합니다.
일부 데스크톱 앱은 시스템 프록시를 자동으로 읽지 않거나 시작할 때 한 번만 읽습니다. 이전 설정의 영향을 피하려면 시스템 프록시를 켠 뒤 브라우저를 완전히 종료하고 다시 여는 것이 좋습니다. 브라우저는 정상인데 특정 앱만 연결되지 않는다면 클라이언트 코어와 노드는 실행 중일 가능성이 높으므로, 즉시 구독을 삭제하거나 클라이언트를 재설치하기보다 해당 앱 자체의 프록시 설정을 확인해야 합니다.
v2rayNG에서 먼저 서버 설정 하나를 선택해 현재 활성 항목으로 만든 다음 메인 화면의 연결 버튼을 누릅니다. 네트워크 서비스가 처음 시작되면 시스템 권한 확인 창이 표시됩니다. 안내를 읽고 이번 연결을 허용합니다. 연결이 설정되면 메인 화면의 버튼 상태, 상단 시스템 상태 영역 또는 클라이언트 상태 문구에 서비스 실행 여부가 표시됩니다. 시스템 바탕화면으로 돌아갈 때 v2rayNG를 강제 종료하거나 백그라운드 프로세스를 바로 정리하지 마세요. 프로세스가 끝나면 연결도 종료될 수 있습니다.
연결을 누른 직후 다시 미연결 상태가 되면 먼저 클라이언트의 최근 로그를 확인합니다. 서버 주소 해석 실패, 연결 시간 초과, 현재 코어에서 인식하지 못하는 설정 필드 또는 로컬 포트 사용 중 등의 메시지가 흔히 나타납니다. 연결 버튼의 색상 변화만으로 노드가 정상이라고 판단하지 마세요. 버튼은 로컬 서비스가 시작을 시도했다는 뜻일 뿐이며, 실제 원격 연결 결과는 로그와 다음 단계의 실제 접속 확인을 함께 살펴봐야 합니다.
노드 시간 초과가 전체 구독을 사용할 수 없다는 뜻은 아닙니다. 먼저 연결을 중지하고 같은 그룹의 다른 설정을 선택한 뒤 다시 시작해 보세요. 전환할 때마다 클라이언트가 코어를 다시 로드할 때까지 기다리고 새로운 로그 구간을 확인합니다. 여러 노드가 같은 단계에서 시간 초과되면 계속 하나씩 눌러 보기보다 현재 네트워크, 시스템 시간, DNS 및 구독 설정을 우선 점검하세요. 체계적인 절차는 노드 시간 초과 진단에서 확인할 수 있습니다.
완료 기준
활성 노드 이름이 명확하고 클라이언트가 실행 중이며 로그에 시작 실패나 포트 사용 중 오류가 연속으로 나타나지 않습니다.
결과 확인
프록시 작동 여부 확인
연결을 시작한 후 브라우저를 먼저 다시 열고 평소 안정적으로 열리는 일반 웹페이지에 접속합니다. 이는 시스템 프록시 설정으로 기본 네트워크가 끊기지 않았는지 확인하기 위한 작업입니다. 페이지가 로드되지 않으면 클라이언트 로그에 요청 기록이 있는지 바로 확인하세요. 기록이 있으면 브라우저 요청이 클라이언트에 들어온 것이므로 노드와 라우팅을 점검하고, 전혀 없으면 브라우저가 시스템 프록시를 사용하지 않거나 클라이언트 수신이 시작되지 않았거나 시스템 프록시 상태가 제대로 적용되지 않았을 가능성이 큽니다.
그다음 현재 라우팅 규칙상 프록시를 사용해야 하는 대상에 접속하고 클라이언트 로그나 연결 정보를 확인합니다. 로그에 해당 도메인, 아웃바운드 태그 또는 연결 설정 기록이 보이면 요청이 규칙 시스템으로 전달된 것입니다. 확인할 핵심은 페이지가 최종적으로 표시되는지만이 아니라 요청이 클라이언트에 들어왔는지, 어떤 규칙이 적용되었는지, 아웃바운드 연결이 성공했는지입니다. 웹페이지 캐시, 브라우저의 기존 연결 및 DNS 캐시 때문에 한 번의 결과만으로는 불명확할 수 있으므로 필요하면 페이지를 닫고 다시 여세요.
데스크톱에서는 시스템 프록시 상태가 현재 작업과 일치하는지도 확인해야 합니다. v2rayN은 정상 실행 중인데 모든 브라우저 요청이 로그에 없다면 시스템 프록시를 끈 뒤 다시 켜고 브라우저를 재시작해 보세요. 브라우저는 되지만 다른 앱이 안 되더라도 정상 작동 중인 노드를 변경하지 마세요. 먼저 대상 앱에 별도 프록시 옵션이 있는지 또는 직접 연결만 지원하는지 확인합니다. 시스템 프록시를 모든 프로그램이 자동으로 읽는 것은 아닙니다.
v2rayNG에서는 메인 화면의 연결 상태와 실시간 로그를 통해 트래픽이 서비스로 들어오는지 확인할 수 있습니다. 연결 후 모든 앱에 접속할 수 없다면 먼저 서비스를 중지하고, 중지 후 기본 네트워크가 복구되는지 확인한 다음 다시 연결해 테스트합니다. 서비스를 꺼도 기본 네트워크가 정상으로 돌아오지 않으면 원인을 클라이언트로만 보아서는 안 되며 현재 네트워크부터 복구해야 합니다. 끄면 정상이고 켜면 이상하다면 노드, 라우팅, DNS 순서로 점검합니다.
DNS 문제는 도메인은 열리지 않지만 직접 연결이나 일부 앱은 응답하는 형태로 나타나는 경우가 많습니다. 처음 설정할 때 여러 DNS 방식을 동시에 시도하면 시스템 DNS, 클라이언트 DNS 및 브라우저 보안 DNS가 여러 경로를 만들 수 있으므로 권장하지 않습니다. 먼저 기본값을 유지하고 구체적인 증상을 기록하세요. 로그에 도메인 해석 실패, 비정상 결과 또는 해석 시간 초과가 확인된 경우에만 DNS 문제 진단에서 관련 옵션을 수정합니다.
브라우저는 열리며 로그에 요청이 있음
기본 설정이 정상적으로 작동합니다. 이후에는 실제 사용 환경에 맞게 라우팅만 조정하면 되며 구독을 다시 가져올 필요는 없습니다.
브라우저가 열리지 않으며 로그에 오류가 있음
요청은 클라이언트에 들어온 상태이므로 활성 노드, 연결 시간 초과, 라우팅 아웃바운드 및 DNS를 중점적으로 확인합니다.
브라우저가 열리지 않으며 로그에 요청이 없음
시스템 프록시, 브라우저의 별도 프록시 설정, 로컬 수신 상태 및 클라이언트 프로세스를 중점적으로 확인합니다.
특정 앱 하나에서만 문제가 발생함
현재 정상 연결은 유지하고 해당 앱이 시스템 프록시를 읽는지 또는 자체 네트워크 설정을 사용하는지 확인합니다.
확인이 끝나면 중지 및 복구 테스트를 한 번 진행할 수 있습니다. 먼저 시스템 프록시를 끄거나 v2rayNG 연결을 해제해 네트워크가 직접 연결 상태로 돌아오는지 확인한 뒤 다시 연결을 활성화해 클라이언트가 정상적으로 복구되는지 확인합니다. 이 간단한 작업으로 우연히 남아 있던 기존 연결로 인한 오판을 배제하고 클라이언트 스위치와 실제 네트워크 경로의 관계를 이해할 수 있습니다.
완료 기준
대상 웹페이지가 예상대로 열리고 클라이언트 로그에서 요청 기록을 확인할 수 있으며, 중지 후 재연결했을 때 상태 변화가 명확하게 재현됩니다.
완료 후 확인할 네 가지 항목
기본 연결이 완료되었다면 고급 옵션을 계속 많이 수정할 필요가 없습니다. 아래 네 가지 결과로 전체 흐름이 정상적으로 끝났는지 먼저 확인하고 현재 작동하는 상태를 저장하세요. 나중에 문제가 생겨도 같은 순서로 어느 단계에서 문제가 발생했는지 빠르게 찾을 수 있습니다.
- 구독 업데이트 가능. 구독 그룹에 전체 주소가 저장되어 있으며 수동 업데이트 후 서버 목록에 항목이 표시됩니다. 업데이트에 실패하면 설정 출처나 업데이트 네트워크 경로에 문제가 있는 것입니다.
- 활성 노드 확인. 메인 화면이나 상태 영역에서 현재 선택한 서버 메모를 볼 수 있고, 노드를 전환하면 클라이언트가 설정을 다시 로드합니다. 활성 항목이 없으면 연결 버튼으로 유효한 아웃바운드를 만들 수 없습니다.
- 트래픽 인계 방식 확인. 데스크톱에서는 시스템 프록시가 켜져 있는지, Android에서는 연결 서비스가 실행 중인지 알고 있어야 합니다. 인계 방식을 확인해야 어떤 앱에는 트래픽이 있고 다른 앱에는 없는 이유를 설명할 수 있습니다.
- 로그와 작업의 대응 확인. 웹페이지를 열었을 때 로그에서 비슷한 시간의 요청이나 오류를 찾을 수 있어야 합니다. 작업 시간, 활성 노드 및 오류 유형을 기록하는 것이 클라이언트를 반복해서 재설치하는 것보다 이후 진단에 도움이 됩니다.
다음 단계
이 페이지에서는 첫 사용에 필요한 기본 작업만 완료합니다. 구독 업데이트 실패, 노드의 지속적인 시간 초과, 시스템 프록시 미작동, DNS 이상 또는 클라이언트 종료 문제가 발생하면 문제 진단 페이지에서 증상별로 확인하세요. 플랫폼용 설치 패키지를 바꿔야 한다면 다운로드 센터로 돌아가 해당 클라이언트를 선택합니다.