v2rayN 사용법

이 가이드는 클라이언트 설치가 완료되었고 출처가 명확하며 아직 유효한 구독 주소가 있다는 전제에서 설명합니다. 구독 주소는 해당 서비스 제공업체가 생성하는 것이며 클라이언트가 자동으로 만드는 값이 아닙니다. v2rayN 또는 v2rayNG는 주소의 설정을 읽은 뒤 해당 코어에 전달해 연결을 설정합니다. 공유 링크 하나만 있다면 클라이언트의 ‘클립보드에서 가져오기’ 기능을 사용할 수 있지만, 단일 링크를 업데이트 가능한 구독 그룹으로 착각하지 마세요.

설정하기 전에 시스템 프록시를 변경하거나 VPN 연결을 설정하는 다른 프로그램을 종료하세요. 여러 도구가 동시에 작동하면 브라우저가 이전 프록시를 읽거나 시스템 라우팅이 나중에 실행된 프로그램에 의해 덮어써질 수 있습니다. 이러한 프로그램을 잠시 종료하는 것은 이후 함께 사용할 수 없다는 뜻이 아니라, 첫 확인에서 변수를 하나로 줄이기 위한 조치입니다. 기기의 날짜, 시간 및 시간대도 정확한지 확인하세요. 연결에 사용되는 TLS 또는 REALITY 매개변수는 시스템 시간 오차의 영향을 받을 수 있습니다.

설정 전에 현재 네트워크 상태를 기록해 두세요. 시스템 프록시가 원래 켜져 있었는지, 브라우저가 별도 프록시를 사용하는지, DNS를 수동으로 지정했는지 확인합니다. 첫 시도에서 라우팅 규칙, DNS, TUN 및 코어 매개변수를 동시에 변경하지 마세요. 기본 연결 확인이 끝난 뒤 실제 필요에 따라 하나씩 조정하세요. 플랫폼별 설치 위치, 권한 및 아키텍처 선택이 궁금하다면 전체 플랫폼 가이드의 공통 준비 단원을 참고하세요.

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

먼저 구독 주소 전체를 복사하세요. 메신저가 자동으로 추가한 공백이나 줄바꿈이 포함되지 않도록 주의합니다. v2rayN 기본 창을 열고 상단 메뉴에서 ‘구독 그룹’ 또는 비슷한 이름의 구독 관리 항목을 찾아 구독 그룹 설정으로 이동합니다. 새 항목을 추가하고 알아보기 쉬운 메모를 입력한 다음 URL란에 주소를 붙여 넣으세요. 메모는 로컬에서 식별하기 위한 용도이며 연결 매개변수는 변경하지 않습니다.

저장한 뒤 기본 창으로 돌아와 구독 관련 메뉴를 다시 열고 ‘모든 구독 업데이트’ 또는 방금 만든 그룹의 업데이트를 실행하세요. 정상적으로 완료되면 기본 목록에 해당 그룹의 노드가 표시됩니다. 먼저 목록에 실제 변화가 있는지 확인하고 노드 이름과 유형 등 기본 필드가 표시되는지 확인합니다. ‘저장 성공’만으로 구독 내용이 다운로드되었다고 볼 수 없습니다. 반드시 업데이트를 완료해야 합니다.

v2rayNG Android 버전에 구독 추가

v2rayNG를 열고 구독 설정으로 이동한 다음 오른쪽 상단의 추가 메뉴에서 구독을 만드세요. 메모를 입력하고 주소를 붙여 넣은 뒤 저장하고 구독 목록으로 돌아가 업데이트를 실행합니다. 버전에 따라 메뉴 문구는 조금 다를 수 있지만 ‘주소 저장’과 ‘직접 업데이트’라는 두 작업은 동일합니다. 업데이트가 완료되면 구성 목록으로 돌아가 새로 가져온 항목이 표시되는지 확인하세요.

클립보드에 단일 vmess, vless 또는 다른 공유 링크가 있다면 오른쪽 상단 메뉴에서 ‘클립보드에서 가져오기’를 선택할 수 있습니다. 단일 링크를 가져오면 보통 로컬 설정 하나만 생성되며 구독처럼 일괄 업데이트되지는 않습니다. 여러 노드를 장기간 관리하려면 구독 관리를 우선 사용하고, 매개변수 하나를 임시로 테스트할 때만 클립보드 가져오기를 사용하세요.

업데이트 후 노드가 표시되지 않을 때 확인할 사항

먼저 구독 설정을 다시 열어 URL이 잘리지 않았고 메모 내용이 함께 붙여 넣어지지 않았는지 확인하세요. 그런 다음 다시 업데이트를 실행하고 알림이나 로그를 확인합니다. 요청 실패가 표시되면 구독 주소에 접근하는 단계에서 문제가 발생했을 가능성이 높고, 파싱 실패가 표시되면 현재 클라이언트가 응답 형식을 인식하지 못하는 것일 수 있습니다. 이때 동일한 그룹을 계속 새로 만들지 마세요. 나중에 중복 노드가 생겨 문제를 확인하기 어려워집니다.

‘구독 업데이트 성공’과 ‘노드 연결 가능’은 구분해야 합니다. 업데이트 성공은 클라이언트가 설정을 읽고 파싱했다는 뜻일 뿐, 원격 주소, 포트, 프로토콜 매개변수 및 네트워크 경로가 확인된 것은 아닙니다. 노드 목록이 표시되면 먼저 DNS나 라우팅을 변경하지 말고 다음 단계로 이동해 프록시 모드를 선택하세요. 구독 그룹 관리, 중복 노드 처리 및 업데이트 실패에 관한 자세한 내용은 설정 FAQ에서 확인할 수 있습니다.

데스크톱에서는 먼저 시스템 프록시 사용

v2rayN을 처음 사용하는 대부분의 데스크톱 사용자는 시스템 프록시부터 선택하는 것이 결과를 확인하기 쉽습니다. 시스템 프록시는 프록시 주소를 운영체제 설정에 기록하며, 브라우저와 시스템 설정을 따르는 다른 앱이 이를 읽습니다. v2rayN의 ‘시스템 프록시’ 메뉴를 열고 ‘시스템 프록시 자동 설정’ 또는 현재 버전에서 같은 기능을 하는 항목을 선택하세요. 메뉴에 ‘시스템 프록시 지우기’와 ‘시스템 프록시 변경 안 함’이 있을 수도 있습니다. 각각 현재 설정을 제거하거나 시스템 상태를 그대로 유지하는 기능입니다.

시스템 프록시가 모든 앱을 연결한다는 보장은 없습니다. 일부 프로그램은 자체 네트워크 스택을 사용하고, 일부 게임이나 명령줄 도구는 시스템 설정을 무시하며, 브라우저에 별도 프록시가 설정되어 있을 수도 있습니다. 특정 앱에서 트래픽이 보이지 않는다면 다른 웹페이지가 열린다는 이유만으로 해당 앱도 연결되었다고 판단하지 마세요. 먼저 브라우저 확인을 완료한 뒤 앱 범위에 따라 TUN이 필요한지 결정하세요.

더 넓은 연결 범위가 필요할 때 TUN 고려

TUN은 가상 네트워크 인터페이스를 통해 트래픽을 처리하므로 일반적으로 시스템 프록시보다 더 넓은 범위를 연결할 수 있지만, 권한·라우팅·DNS에 대한 사전 조건이 늘어납니다. 활성화하기 전에 v2rayN이 필요한 권한으로 실행되는지 확인하고 기존 시스템 프록시 상태를 기록해 두세요. 처음 TUN으로 전환할 때는 시스템 프록시를 먼저 지운 다음 TUN을 활성화하는 것이 좋습니다. 두 연결 경로가 동시에 존재하면 실제 트래픽이 어느 경로를 거치는지 판단하기 어렵습니다.

TUN을 켠 직후 로컬 네트워크 접속에 문제가 생겨도 DNS나 라우팅 규칙을 계속 추가로 변경하지 마세요. 먼저 TUN을 끄고 네트워크가 복구되는지 확인한 다음, 로그에서 가상 인터페이스 생성, 권한 또는 라우팅 기록 실패 메시지를 확인합니다. 가상 인터페이스 권한, 로컬 네트워크 접속 및 라우팅 범위에 관한 자세한 내용은 Windows 설치 및 설정 단원 또는 Linux 설치 및 설정 단원을 참고하세요.

Android에서 시스템 권한 확인

v2rayNG는 연결을 시작할 때 시스템 VPN 권한을 요청합니다. 처음 권한 창이 나타나면 승인해야 연결을 설정할 수 있습니다. 거부하면 노드 설정이 남아 있어도 앱 트래픽을 연결로 보낼 수 없습니다. 기기에 다른 VPN 연결이 있다면 먼저 기존 연결을 중지한 뒤 v2rayNG를 시작하세요. 시스템은 일반적으로 이러한 연결을 하나만 활성 상태로 허용합니다.

앱별 분할, 로컬 네트워크 우회 및 라우팅 규칙은 기본 연결이 성공한 뒤 설정해도 됩니다. 첫 시도에서는 단순한 규칙을 유지하세요. 특정 도메인이 직접 연결 규칙으로 허용되면 노드가 작동하지 않는 것으로 오해할 수 있습니다. 모드 선택 기준은 기능이 많은지가 아니라 현재 앱이 시스템 프록시를 따르는지, 더 많은 프로토콜을 연결해야 하는지, 기기에서 필요한 권한을 제공할 수 있는지입니다.

설정 하나 선택

v2rayN 기본 목록에서 사용할 노드를 클릭한 다음 오른쪽 클릭 메뉴 또는 더블 클릭으로 활성 서버로 지정하세요. 버전에 따라 색상, 굵은 글씨 또는 상태 표시줄 문구로 현재 선택을 나타낼 수 있습니다. 작업 후 기본 창 하단이나 트레이 메뉴에서 활성 서버 이름이 방금 선택한 항목과 같은지 확인합니다. 행을 강조 표시하기만 하고 활성 서버로 지정하지 않았다면 이후 연결에서 이전 설정이 사용될 수 있습니다.

v2rayNG에서는 구성 목록으로 돌아가 설정 하나를 선택하세요. 선택된 항목에는 보통 선택 표시가 나타납니다. 그런 다음 기본 화면의 시작 버튼을 누르고 시스템 상태 표시줄에 VPN 아이콘이 나타나는지 확인하면서 앱 상태가 중지에서 시작됨으로 바뀌는지 관찰합니다. 시작 버튼은 현재 선택된 설정만 사용하므로 누르기 전에 노드 이름을 다시 확인하세요.

연결 테스트와 실제 접속은 다릅니다

클라이언트에는 연결 테스트, 실제 연결 테스트 또는 다운로드 테스트가 있을 수 있습니다. 일반 지연 시간 테스트는 대상에 도달할 수 있는지만 확인하는 경우가 있어 프로토콜 핸드셰이크와 이후 접속을 완전히 보여 주지 못합니다. 실제 연결 테스트는 실제 연결 설정에 더 가깝지만 모든 앱이 올바른 프록시 경로를 사용한다는 뜻은 아닙니다. 테스트는 범위를 좁히기 위한 것이며, 다음 단계의 브라우저 및 로그 확인을 대신하지 않습니다.

처음에는 소수의 노드에 실제 연결 테스트를 실행한 뒤 정상 결과가 나온 노드를 선택하세요. 많은 노드를 동시에 반복 측정하거나 지연 시간 숫자만으로 설정 품질을 판단하지 마세요. 노드 사용 가능 여부는 프로토콜 매개변수, TLS 또는 REALITY 설정, 원격 상태 및 현재 네트워크 경로에도 좌우됩니다. 선택한 뒤에는 노드를 바꾸지 말고 실제 접속을 계속 확인하세요.

연결 실패 시 첫 번째 핵심 오류부터 확인

시작 직후 중지되거나 로그에 오류가 계속 표시되면 가장 먼저 나타난 핵심 메시지를 기록하세요. 도메인 확인 실패, 연결 시간 초과, 연결 거부, TLS 핸드셰이크 실패 및 매개변수 불일치는 서로 다른 단계의 문제를 의미합니다. 로그 마지막 부분에서 반복 오류 하나를 임의로 골라 원인을 판단하지 마세요. 이후 재시도 결과일 수 있습니다.

처리 순서는 단순하게 유지하세요. 먼저 현재 노드가 실제로 선택되었는지 확인하고, 구독을 한 번 업데이트한 다음 같은 구독 그룹의 다른 설정으로 다시 테스트합니다. 여러 설정이 같은 단계에서 실패한다면 로컬 시간, 네트워크 및 클라이언트 권한을 확인하세요. 한 번에 조건 하나만 변경하고 변경 후 다시 연결해야 어떤 조정이 영향을 주었는지 판단할 수 있습니다.

먼저 브라우저로 최소 확인

방금 선택한 노드와 프록시 모드를 그대로 유지한 채 테스트용 브라우저를 완전히 종료했다가 다시 열고, 평소 로딩 결과를 명확히 판단할 수 있는 페이지에 접속하세요. 브라우저를 재시작하면 기존 연결, 캐시 및 별도 프록시 설정의 영향을 줄일 수 있습니다. 페이지가 정상적으로 로드되면 클라이언트 로그를 열어 접속한 시간에 새 연결 기록이 나타나는지 확인합니다.

로그에는 대상 도메인 또는 주소, 라우팅 결과 및 연결 설정 과정이 표시되는 경우가 많습니다. 브라우저 접속 시간과 로그 시간이 일치하면 브라우저 트래픽이 클라이언트로 들어갔음을 비교적 확실하게 확인할 수 있습니다. 페이지는 열리는데 로그에 새 기록이 전혀 없다면 브라우저가 직접 연결하거나 자체 프록시를 사용했을 수 있고, 현재 라우팅 규칙이 해당 대상을 허용했을 수도 있습니다. 이때는 노드를 바로 바꾸기보다 브라우저 네트워크 설정과 클라이언트 라우팅을 먼저 확인하세요.

실제로 사용할 앱도 확인

브라우저 확인이 끝난 뒤 실제로 사용하려는 앱을 열고 로그를 다시 관찰하세요. 시스템 프록시 모드에서 브라우저에는 기록이 있지만 대상 앱에는 기록이 없다면 해당 앱이 시스템 프록시를 따르지 않을 가능성이 높습니다. 앱 자체에 프록시 설정이 있는지 확인하거나 권한 및 라우팅 조건을 확인한 뒤 TUN으로 전환할 수 있습니다. 전환하기 전에 기존 연결 방식을 먼저 끄고, 동시에 활성화되어 결과를 구분하기 어려워지는 상황을 피하세요.

Android에서는 먼저 페이지에 접속한 뒤 v2rayNG로 돌아와 실시간 로그 또는 연결 통계에 동작에 해당하는 변화가 나타나는지 확인하세요. 앱별 분할이 켜져 있다면 테스트 앱이 우회 대상으로 설정되지 않았는지도 확인합니다. 특정 앱 하나만 문제가 있고 다른 앱에서는 연결 기록이 생성된다면 구독을 즉시 다시 가져오기보다 해당 앱의 분할 설정, 백그라운드 제한 및 네트워크 설정을 먼저 확인하세요.

DNS 및 캐시 간섭 배제

연결은 이미 설정되었지만 도메인 확인이나 기존 캐시 때문에 페이지가 실패하는 경우가 있습니다. 먼저 다른 도메인으로 테스트한 다음 앱을 닫았다가 다시 열어 보세요. 원인을 확인하기 전에 시스템 DNS, 클라이언트 DNS 및 브라우저 보안 DNS를 동시에 변경하지 마세요. 문제가 일시적으로 사라져도 어느 계층이 영향을 주었는지 알기 어려워집니다. DNS 조회 경로와 규칙 매칭을 체계적으로 이해하려면 전체 플랫폼 가이드의 설정 FAQ를 참고하세요.

최종 판단에는 세 가지 조건이 모두 포함되어야 합니다. 클라이언트가 계속 실행 중이고, 대상 앱에 해당 로그가 생성되며, 페이지 또는 서비스에 실제로 접속되어야 합니다. 세 조건이 동시에 충족되어야 기본 설정이 완료된 것입니다. 노드 테스트만 성공했다면 연결 가능성이 있다는 뜻이고, 클라이언트만 실행 중이라면 프로세스가 시작되었다는 뜻입니다. 페이지는 열리지만 로그가 없다면 원래 직접 연결된 결과인지 확인해야 합니다.

검증에 성공한 노드와 프록시 모드를 우선 유지하고, 구독 그룹에는 알아보기 쉬운 이름을 지정하세요. 가져오는 과정에서 중복 그룹이 생겼다면 내용이 같은지 확인한 뒤 불필요한 항목을 삭제할 수 있습니다. 유일하게 사용할 수 있는 설정을 먼저 삭제한 뒤 복구하려 하지 말고, 서로 다른 출처의 구독을 구분하기 어려운 하나의 그룹에 섞지도 마세요.

사용을 마칠 때는 현재 모드에 맞게 종료해야 합니다. 시스템 프록시를 사용했다면 먼저 v2rayN에서 ‘시스템 프록시 지우기’를 선택한 뒤 클라이언트를 종료하세요. 시스템에 더 이상 사용할 수 없는 로컬 프록시 주소가 남는 것을 방지할 수 있습니다. TUN을 사용했다면 먼저 TUN을 끄고 네트워크가 복구된 뒤 종료하세요. v2rayNG Android 버전은 중지 버튼을 누른 뒤 시스템 VPN 아이콘이 사라질 때까지 기다립니다.

이후 로컬 네트워크 우회, 도메인별 분할, 사용자 지정 DNS, 시작 시 자동 실행 또는 규칙 데이터베이스 업데이트를 설정할 때는 한 번에 한 주제만 처리하고, 변경할 때마다 ‘실제 접속 및 로그 일치’ 방식으로 다시 확인하는 것이 좋습니다. 플랫폼별 설치 권한, TUN 조건, 플랫폼별 문제 및 설정 복구 방법은 전체 플랫폼 설치 및 설정 가이드에 정리되어 있습니다.

아직 클라이언트를 설치하지 않았다면 먼저 클라이언트 다운로드 페이지에서 기기 플랫폼에 맞는 설치 항목을 선택하세요. 데스크톱 기기는 v2rayN을 우선 확인하고, Android 기기는 코어와 사용 목적에 맞는 클라이언트를 선택할 수 있습니다. 설치가 끝나면 이 페이지로 돌아와 구독 가져오기부터 진행하세요.