이 가이드는 실제 작업 순서에 맞춰 구성했습니다. 먼저 구독을 클라이언트에 입력하고 프록시 모드를 정한 다음 서버를 선택해 연결합니다. 마지막으로 브라우저와 대상 애플리케이션에서 결과를 확인합니다. 각 단계에서 클릭할 위치, 성공 시 화면 변화, 오류 발생 시 우선 확인할 항목을 함께 설명합니다.
작업을 시작하기 전에 클라이언트를 설치하고 서비스 제공자가 발급한 구독 주소를 준비해야 합니다. 구독 주소는 보통 네트워크 프로토콜로 시작하는 링크이며, 클라이언트가 서버 항목과 연결 매개변수를 가져오는 데 사용됩니다. 특정 서버 하나를 뜻하는 것이 아니므로 내용을 직접 나눠 입력할 필요도 없습니다.
데스크톱 버전을 실행한 뒤 작업 표시줄 알림 영역에 v2rayN 아이콘이 나타나는지 먼저 확인하세요. 기본 창을 닫은 뒤에도 아이콘이 남아 있다면 클라이언트가 백그라운드로 최소화된 상태일 수 있습니다. Android에서 v2rayNG를 열면 서버 목록과 오른쪽 아래의 연결 버튼이 보여야 합니다. 처음 실행할 때 네트워크 연결 권한 요청이 나타나면 시스템 안내에 따라 허용해야 합니다. 그렇지 않으면 클라이언트가 로컬 프록시 터널을 만들 수 없습니다.
서비스 제공자의 관리 페이지에서 구독 주소 전체를 복사하세요. 화면에 보이는 일부 텍스트만 복사하면 안 됩니다. 주소 앞뒤의 공백, 메신저가 자동으로 넣은 줄바꿈, 만료된 링크는 업데이트 실패의 원인이 됩니다. 구독 주소에는 접근 자격 증명이 포함될 수 있으므로 공개 페이지나 스크린샷에 붙여 넣거나 관계없는 사람에게 전달하지 마세요.
처음 설정할 때의 목표는 구독과 서버가 정상적으로 작동하는지 확인하는 것입니다. 처음부터 복잡한 라우팅을 조정할 필요는 없습니다. 먼저 클라이언트의 기본 포트와 기본 규칙을 유지한 채 브라우저 접속을 한 번 확인하세요. 연결이 성립한 뒤 설정 참고의 라우팅 섹션을 읽고 분기 규칙을 단계적으로 추가하면 됩니다.
아래 단계에는 선후 관계가 있습니다. 구독 업데이트가 성공하지 않으면 서버 목록에 선택 가능한 항목이 나타나지 않습니다. 서버를 활성 상태로 지정하지 않은 채 프록시 모드만 켜도 전달할 아웃바운드 연결이 없습니다. 첫 단계부터 순서대로 진행하며 중간 상태 확인을 건너뛰지 않는 것이 좋습니다.
v2rayN 데스크톱 버전에서 메인 창을 열고 ‘구독 그룹’ 또는 이와 비슷한 메뉴를 찾으세요. 그룹 설정으로 들어간 뒤 새 항목을 추가합니다. 그룹 이름은 알아보기 쉬운 서비스 이름으로 지정할 수 있습니다. 주소 입력란에는 방금 복사한 구독 링크 전체를 붙여 넣으세요. 다른 옵션은 일단 기본값으로 두고 주소가 잘리지 않았는지 확인한 뒤 저장합니다. 저장은 로컬에 구독 기록을 만드는 과정일 뿐입니다. 클라이언트가 서버 설정을 주소에서 읽으려면 반드시 한 번 업데이트해야 합니다.
메인 화면으로 돌아와 구독 메뉴를 열고 현재 그룹 업데이트 또는 전체 구독 업데이트를 선택하세요. 업데이트 중에는 보통 상태 표시줄이나 로그 영역에 처리 결과가 나타납니다. 성공하면 메인 화면의 서버 목록에 여러 항목이 표시되고 프로토콜, 주소 별칭 또는 구독 제공자가 설정한 메모가 함께 나타납니다. 항목 수는 구독 내용에 따라 달라지므로 개수만으로 품질을 판단할 수는 없습니다. 이 단계에서는 목록이 비어 있지 않고 명확한 구문 분석 오류가 없는지만 확인하면 됩니다.
v2rayNG Android 버전에서는 사이드 메뉴에서 ‘구독 그룹 설정’으로 들어가 추가 버튼을 누르고 이름과 주소를 입력한 뒤 저장하세요. 서버 목록으로 돌아와 메뉴에서 ‘구독 업데이트’를 실행합니다. 업데이트가 끝나면 서버 항목이 목록에 나타납니다. 목록에 직접 추가한 설정이 이미 있다면 새 구독 항목과 함께 표시될 수 있습니다. 그룹 이름으로 구분하면 되며 기존 내용을 삭제할 필요는 없습니다.
화면에 주소 형식 오류가 표시되면 먼저 주소 앞뒤의 공백을 삭제하고 원본 페이지에서 다시 복사하세요. 연결할 수 없거나 요청 시간이 초과되었다는 메시지가 나오면 현재 네트워크에서 구독 출처에 접속할 수 있는지, 시스템 시간이 정확한지 확인합니다. 업데이트가 완료되었는데도 목록이 비어 있다면 구독에서 유효한 항목을 반환하지 않았거나 현재 그룹 필터가 새 항목을 숨기고 있을 수 있습니다. 업데이트 버튼을 빠르게 연속해서 누르지 마세요. 잘못된 주소가 해결되지 않을 뿐 아니라 여러 로그가 뒤섞일 수 있습니다.
구독 업데이트 실패에는 주소 만료, 업데이트 요청에 기존 프록시가 필요함, 클라이언트 포트 사용 중 등 여러 원인이 있습니다. 안내만으로 판단하기 어렵다면 구독 업데이트 실패 문제 해결 방법에 따라 하나씩 확인하세요. 서버 목록이 정상적으로 표시되면 다음 단계에서 프록시 모드를 선택할 수 있습니다.
서버 항목이 나타나면 어떤 애플리케이션의 트래픽을 클라이언트로 보낼지 결정해야 합니다. 여기서는 두 가지 개념을 구분해야 합니다. 서버는 트래픽이 어디로 향할지를 결정하고, 프록시 모드는 어떤 트래픽이 클라이언트로 들어올지를 결정합니다. 서버만 선택하고 적절한 프록시 진입점을 활성화하지 않으면 브라우저나 다른 애플리케이션이 기존 네트워크 경로를 계속 사용할 수 있습니다.
v2rayN 데스크톱 버전을 처음 사용할 때는 시스템 프록시 메뉴에서 ‘시스템 프록시 자동 설정’을 먼저 선택한 뒤 규칙 모드로 트래픽을 분기해 보세요. 시스템 네트워크 설정을 읽는 대부분의 브라우저와 데스크톱 애플리케이션은 이 설정을 따릅니다. 규칙 모드는 클라이언트 내부의 라우팅 규칙에 따라 연결 방식을 판단하므로 일상적인 사용에 적합합니다. 글로벌 모드는 더 많은 요청을 동일한 아웃바운드로 보내므로 특정 접속 문제가 규칙 매칭 때문인지 짧게 확인할 때 유용하지만, 필요하지 않은데 모든 트래픽 경로를 장기간 바꾸는 것은 권장하지 않습니다.
TUN 모드는 가상 네트워크 인터페이스를 통해 더 넓은 범위의 시스템 트래픽을 가로채며, 시스템 프록시 설정을 읽지 않는 프로그램에 적합합니다. 추가 시스템 권한이 필요할 수 있고 다른 가상 네트워크 도구와 충돌할 수도 있습니다. 처음부터 TUN을 켤 필요는 없습니다. 먼저 시스템 프록시로 구독과 서버가 정상인지 확인하면 문제 범위를 좁힐 수 있습니다. 브라우저는 정상인데 특정 독립 프로그램만 계속 변하지 않을 때 TUN 모드 전환을 고려하세요.
v2rayNG Android 버전에서는 연결을 누르면 시스템 수준의 VPN 터널이 만들어지고, 라우팅 설정에 따라 선택한 서버를 통과할 연결이 결정됩니다. 처음에는 클라이언트의 현재 기본 규칙을 유지하고 도메인 정책, 애플리케이션 필터, 사용자 지정 라우팅을 동시에 변경하지 마세요. 한 번에 하나의 옵션만 바꾸고 결과를 확인한 뒤 다음으로 진행해야 나중에 문제가 생겨도 원인을 쉽게 찾을 수 있습니다.
브라우저와 일반적인 데스크톱 애플리케이션을 먼저 확인할 때 적합합니다. 설정 단계가 적고 클라이언트를 종료했을 때 기존 시스템 설정을 복원하기도 쉽습니다.
시스템 프록시를 읽지 않는 애플리케이션까지 연결을 가로채야 할 때 적합합니다. 활성화하기 전에 기본 연결이 성공했는지 확인하고 시스템 권한 요청에 유의하세요.
목표가 구독 사용 가능 여부를 확인하는 것이라면 시스템 프록시와 규칙 모드로 충분합니다. 브라우저는 정상적으로 작동하지만 명령줄 도구, 게임 런처 또는 특정 독립 애플리케이션이 클라이언트를 거치지 않는다면 먼저 해당 애플리케이션에 별도 프록시 설정이 있는지 확인한 뒤 TUN 사용 여부를 결정하세요. 도메인 규칙, IP 규칙, 아웃바운드 태그의 관계를 이해하려면 설정 참고의 routing 섹션을 확인하세요. 이 가이드에서는 복잡한 규칙 작성은 다루지 않습니다.
모드 설정을 마친 뒤 여러 애플리케이션을 동시에 테스트하지 마세요. 먼저 브라우저 창 하나를 기준으로 삼아 확인한 다음 세 번째 단계에서 서버를 선택하고 연결을 시작합니다. 이렇게 하면 ‘모드가 트래픽을 가로채지 못함’과 ‘서버 자체에 연결할 수 없음’을 구분할 수 있습니다.
서버 목록으로 돌아가 구독 항목 하나를 먼저 선택하세요. v2rayN 데스크톱 버전에서는 대상 항목을 두 번 클릭하거나 마우스 오른쪽 버튼 메뉴에서 활성 서버로 지정할 수 있습니다. 선택된 항목은 보통 색상, 체크 표시 또는 상태 표시줄 문구로 구분됩니다. 이어서 클라이언트 코어가 실행 중인지 확인하고 시스템 프록시 상태가 두 번째 단계에서 선택한 설정과 일치하는지 확인하세요. 목록에서 한 줄을 클릭하는 것만으로는 활성 서버 전환이 완료되지 않을 수 있으므로 상태 영역에 표시된 현재 서버 이름을 기준으로 판단해야 합니다.
v2rayNG Android 버전에서는 서버 항목을 눌러 현재 설정으로 만든 뒤 메인 화면의 연결 버튼을 누르세요. 처음 시스템 터널을 만들 때 연결 권한 요청이 나타나며, 승인하면 연결 버튼과 상태 영역이 바뀝니다. 상단 상태 표시줄에도 시스템 네트워크 터널 표시가 나타나는 경우가 많습니다. 누른 직후 연결 안 됨 상태로 돌아간다면 서버를 계속 바꾸지 말고 클라이언트 로그에서 마지막 몇 줄을 확인하세요.
서버 목록이 많다면 클라이언트의 테스트 기능으로 기본 연결이 되지 않는 항목을 먼저 걸러낼 수 있습니다. 테스트 결과는 당시 네트워크 상태만 반영하므로 장기적인 성능을 의미하지 않으며 실제 접속 확인을 대신할 수도 없습니다. 기본 테스트를 통과한 항목을 하나 선택해 활성 서버로 지정한 뒤 연결 로그를 확인하세요. 정상적인 경우 코어가 시작된 후 로컬 인바운드 포트와 현재 설정 로드 등의 정보가 표시됩니다. timeout, rejected 또는 설정 구문 분석 오류가 나타나면 오류 키워드를 기록해 두세요.
연결 상태는 로컬 터널과 클라이언트 프로세스가 시작되었다는 뜻일 뿐, 원격 서버가 반드시 사용 가능하다는 의미는 아닙니다. 먼저 같은 구독의 다른 항목으로 비교해 보세요. 모든 항목에서 같은 지점에 오류가 발생한다면 기기 시간, 네트워크 연결, 클라이언트 권한, 구독이 방금 정상적으로 업데이트되었는지를 확인합니다. 특정 항목 하나만 실패한다면 해당 항목의 서비스 상태나 매개변수에 문제가 있을 가능성이 큽니다.
문제 해결 중에 포트, DNS, 라우팅, 코어 옵션을 동시에 변경하지 마세요. 여러 변수를 한꺼번에 바꾸면 성공이나 실패의 원인을 파악하기 어렵습니다. 로그에 명확한 영문 오류가 나타나면 V2Ray 실행 로그의 주요 오류 설명을 참고하세요. 더 자세한 오류 분류는 문제 해결의 오류 점검 섹션에서 확인할 수 있습니다.
연결이 설정된 뒤에는 클라이언트 버튼 색상만 확인하지 마세요. 로컬 상태, 브라우저 접속, 대상 애플리케이션의 세 단계로 확인해야 합니다. 첫 번째는 클라이언트입니다. 활성 서버 이름이 정확하고 코어가 계속 실행되며 로그에 연결 실패가 연속해서 나타나지 않는지 확인하세요. 두 번째로 새 브라우저 창을 열어 평소 테스트에 사용하는 대상 페이지에 접속합니다. 새 창을 사용하면 기존 연결, 캐시 또는 세션의 영향을 줄일 수 있습니다.
대상 페이지가 정상적으로 열리면 클라이언트로 돌아가 해당 연결 기록이 새로 추가되었는지 로그를 확인하세요. 새 인바운드, 라우팅 또는 아웃바운드 기록이 보인다면 브라우저 요청이 클라이언트로 들어온 것입니다. 규칙 모드에서는 일부 연결이 직결로 판정될 수 있으며 이는 정상적인 라우팅 결과입니다. 모든 로그가 같은 경로를 표시해야 하는 것이 아니라 프록시가 필요한 대상이 예상한 아웃바운드를 사용하는지가 중요합니다.
브라우저 확인을 통과한 뒤 실제로 사용하려는 애플리케이션을 여세요. 브라우저는 정상인데 대상 애플리케이션에 변화가 없다면 서버 경로 자체는 작동하고 애플리케이션이 시스템 프록시를 읽는지가 문제일 가능성이 큽니다. 먼저 애플리케이션의 네트워크 설정에서 ‘시스템 프록시 사용’ 또는 수동 프록시 옵션을 확인하세요. 데스크톱 명령줄 프로그램은 별도의 프록시 환경 설정이 필요한 경우가 많으므로 브라우저가 성공했다고 터미널도 자동으로 따라온다고 판단하면 안 됩니다. 브라우저와 터미널의 점검 경로를 구분해야 한다면 시스템 프록시가 적용되지 않을 때의 분리 점검 목록을 참고하세요.
| 확인된 결과 | 일반적인 의미 | 다음 단계 |
|---|---|---|
| 클라이언트 실행 중, 브라우저 접속 정상 | 구독, 서버, 시스템 프록시의 기본 경로가 정상적으로 연결됨 | 대상 애플리케이션을 다시 확인하고 필요에 따라 규칙 조정 |
| 클라이언트 실행 중, 브라우저에 변화 없음 | 시스템 프록시가 적용되지 않았거나 규칙이 매칭되지 않았거나 서버 연결에 실패함 | 먼저 로그를 확인한 뒤 프록시 상태와 활성 서버 점검 |
| 브라우저 정상, 독립 애플리케이션 실패 | 애플리케이션이 시스템 프록시를 읽지 않을 수 있음 | 애플리케이션 프록시 설정을 확인하고 필요하면 TUN 모드 검토 |
| 서버 전환 후 정상으로 회복 | 기존 항목을 현재 사용할 수 없거나 네트워크 경로에 문제가 있음 | 사용 가능한 항목을 유지하고 잠시 후 구독 업데이트 |
접속이 정상인지 확인한 뒤 연결을 직접 끊고 브라우저 동작이 기존 네트워크 경로로 돌아가는지 관찰한 다음 다시 연결해 보세요. 잠시 연결을 끊었다가 재연결하면 시스템 프록시 상태를 실제로 클라이언트가 제어하는지 확인할 수 있으며, 데스크톱 클라이언트 종료 후 시스템 프록시가 복원되지 않는 문제도 발견할 수 있습니다. 테스트가 끝나면 클라이언트 상태, 시스템 프록시 상태, 실제 사용 목적이 서로 맞도록 설정하세요.
규칙 모드를 장기간 사용할 계획이라면 다음으로 구독 업데이트, 서버 전환, 기본 라우팅만 익히면 됩니다. 하위 JSON을 바로 편집할 필요는 없습니다. 복잡한 DNS, 정책 객체, 사용자 지정 인바운드는 기본 흐름이 안정된 뒤 다루는 것이 좋으며 관련 구조는 V2Ray 설정 파일 참고에서 확인할 수 있습니다. 이제 최초 연결 과정이 완료되었습니다.
문제 해결의 핵심은 스위치를 계속 바꾸는 것이 아니라 장애가 구독, 서버, 클라이언트 프로세스, 프록시 적용 또는 특정 애플리케이션 중 어디에서 발생했는지 판단하는 것입니다. 아래 순서대로 확인하면 기본 연결이 성립하기 전에 고급 설정을 반복해서 바꾸는 일을 피할 수 있습니다.
서버 목록에 유효한 항목이 있어야 하며 업데이트 로그에 주소 분석 오류나 요청 실패가 표시되지 않아야 합니다.
상태 표시줄의 현재 서버가 선택한 목록 항목과 일치해야 합니다. 필요하면 다른 항목과 비교하세요.
시작 직후 종료되면 보통 오류가 남습니다. 먼저 마지막 몇 줄의 로그를 읽고 어떤 항목을 조정할지 결정하세요.
먼저 브라우저로 시스템 프록시를 확인한 뒤 독립 애플리케이션에 별도 프록시 설정이나 TUN 모드가 필요한지 판단하세요.
방금 변경한 DNS, 라우팅 또는 포트를 원래대로 되돌리고 기본 설정만 남긴 채 다시 테스트하세요.
최초 설정이 끝났다고 모든 고급 옵션을 한 번에 읽을 필요는 없습니다. 현재 문제에 맞는 페이지로 이동하면 관계없는 설정이 기존 연결에 미치는 영향을 줄일 수 있습니다.
주소 상태, 업데이트에 사용되는 네트워크 경로, 자동 업데이트 간격 설정 방식을 확인하세요.
구독 업데이트 문제 해결 보기inbounds, outbounds, routing의 관계를 이해한 뒤 도메인 및 IP 규칙을 조정하세요.
라우팅 설정 참고 보기브라우저, 명령줄, 독립 애플리케이션을 나누어 판단하고 트래픽 적용 문제를 서버 오류로 오해하지 마세요.
문제 해결로 이동