v2rayN 및 v2rayNG 설정 가이드

시작하기 전에 설치된 클라이언트와 사용할 수 있는 구독 주소를 준비해야 합니다. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 사용합니다. 아직 설치하지 않았다면 설치 패키지 페이지에서 플랫폼에 맞는 버전을 선택하세요. 구독 주소는 일반적으로 https://로 시작하는 URL이며, 단일 vmess:// 또는 vless:// 공유 링크와는 다른 입력값입니다. 구독 주소는 업데이트 가능한 서버 설정 묶음이고, 공유 링크는 보통 하나의 설정만 나타냅니다.

처음부터 TUN, Mux, 라우팅 규칙과 코어 옵션을 한꺼번에 수정하지 마세요. 첫 설정의 목표는 클라이언트가 구독을 읽고 하나의 서버 설정을 가장 기본적인 프록시 진입점으로 실행하는 것입니다. 한 번에 하나의 설정만 변경해야 문제가 구독 형식, 서버 설정, 프록시 모드 또는 로컬 소프트웨어 충돌 때문인지 쉽게 판단할 수 있습니다. 이 문서의 예시에서는 전체 JSON을 직접 작성하지 않으며 각 전송 필드도 자세히 다루지 않습니다. 이미 원시 JSON 설정을 받았거나 VMess, VLESS, Trojan, Shadowsocks, REALITY를 비교하려면 프로토콜 및 코어 기술 참고서에서 해당 설명을 확인하세요.

첫 단계에서는 구독 출처만 처리합니다. 구독 이름은 로컬 메모이므로 알아보기 쉬운 용도명으로 지정하면 됩니다. 구독 URL은 처음부터 끝까지 완전히 붙여 넣고 앞뒤에 공백이 들어가지 않았는지 확인하세요. 구독을 저장했다고 서버 목록을 가져온 것은 아니므로 저장 후 직접 업데이트해야 합니다. 업데이트가 성공하면 클라이언트 기본 목록에 하나 이상의 서버 설정이 나타나고 주소 메모, 프로토콜 유형 또는 그룹 이름을 확인할 수 있습니다.

v2rayN에서 구독 추가

v2rayN 기본 창을 열고 상단 메뉴에서 “구독 그룹”을 찾아 “구독 그룹 설정”으로 이동합니다. 그룹 추가를 선택한 뒤 별칭 또는 메모란에 알아보기 쉬운 이름을 입력하고 URL란에 전체 구독 주소를 붙여 넣은 다음 저장합니다. 기본 창으로 돌아가 다시 “구독 그룹” 메뉴를 열고 “모든 구독 업데이트” 또는 해당 그룹의 업데이트 명령을 실행하세요. 처음 업데이트할 때 사용할 수 있는 프록시가 없다면 “프록시 사용 안 함”과 같은 업데이트 방식을 우선 선택합니다. 클라이언트가 구독 주소를 직접 요청하고 해석한 설정을 서버 목록에 기록합니다.

업데이트가 끝나면 잠깐 나타났다가 사라지는 알림이 아니라 기본 목록을 확인하세요. 목록에는 서버 메모, 주소, 포트, 프로토콜 등의 열이 표시되어야 합니다. 목록이 여전히 비어 있다면 구독 그룹 설정으로 돌아가 URL이 잘리지 않았는지, 웹페이지 주소를 구독 주소로 붙여 넣은 것은 아닌지, 그룹이 활성화되어 있는지 확인하세요. 형식 오류는 요청을 반복한다고 자동으로 해결되지 않으므로 업데이트를 연속해서 클릭하지 마세요. 먼저 브라우저 주소창에 주소를 붙여 넣어 텍스트가 반환되는지 확인한 뒤 클라이언트에서 다시 업데이트할 수 있습니다.

v2rayNG에서 구독 추가

v2rayNG를 열고 오른쪽 상단 메뉴에서 “구독 설정”으로 이동한 다음 추가 버튼을 누릅니다. 구독 메모와 구독 주소를 입력하고 저장한 뒤 구성 목록으로 돌아갑니다. 이어서 메뉴에서 “구독 업데이트”를 선택하세요. 일부 버전에서는 이 메뉴가 새로고침 아이콘 또는 “구독 설정 업데이트”로 표시됩니다. 업데이트가 완료되면 구성 목록에 선택 가능한 항목이 나타납니다. 각 항목에는 일반적으로 서버 메모가 표시되고, 선택한 항목에는 뚜렷한 선택 표시가 붙습니다.

v2rayNG에서 구독 콘텐츠를 해석하지 못했다는 메시지가 표시되면 다음 단계로 바로 넘어가지 마세요. 구독이 base64 통합 콘텐츠, 단일 공유 링크 모음 또는 특정 클라이언트 형식으로 반환될 수 있으며 형식별 호환 범위는 완전히 같지 않습니다. 먼저 제공자가 v2rayNG를 명시적으로 지원하는지 확인한 뒤 주소에 로그인 상태가 필요한지, 만료되었는지, 복사 과정에서 줄바꿈이 섞였는지 점검하세요. 공유 링크가 하나뿐이라면 “클립보드에서 가져오기”를 사용할 수도 있지만, 자동 업데이트되는 구독 그룹은 생성되지 않습니다. base64, 원시 JSON 및 공유 링크의 구조적 차이는 V2Ray 구독 형식 자세히 보기에서 확인할 수 있습니다.

서버 목록이 표시되면 먼저 설정 하나를 선택하되 모든 고급 기능을 동시에 활성화하지는 마세요. 다음 단계에서는 트래픽이 클라이언트로 들어오는 진입점을 결정해야 합니다. 데스크톱에서는 보통 시스템 프록시를 먼저 사용하고, Android에서는 시스템 연결 권한으로 TUN 인터페이스를 구성합니다. 프록시 진입점과 프로토콜 유형은 서로 다른 개념입니다. VMess 또는 VLESS는 서버 연결 방식을 설명하고, 시스템 프록시 또는 TUN은 로컬 앱 트래픽이 클라이언트로 들어오는 방식을 설명합니다.

v2rayN 데스크톱 버전에서 자주 사용하는 진입점은 “시스템 프록시”와 “TUN 모드”입니다. 시스템 프록시는 운영체제의 HTTP 및 SOCKS 프록시 설정을 변경하므로 브라우저와 시스템 프록시를 따르는 프로그램에서 바로 사용할 수 있습니다. TUN 모드는 가상 네트워크 인터페이스를 만들어 시스템 프록시를 읽지 않는 프로그램의 트래픽도 더 많이 처리합니다. 처음에는 시스템 프록시를 활성화해 구독과 서버가 정상인지 확인한 뒤, 필요한 앱 범위에 따라 TUN으로 전환하세요. 이렇게 하면 연결 문제와 가상 네트워크 카드 및 권한 문제를 분리해 처리할 수 있습니다.

v2rayN: 먼저 시스템 프록시 자동 구성 사용

v2rayN 기본 창 하단 상태 표시줄 또는 시스템 트레이 메뉴에서 “시스템 프록시”를 찾고 “시스템 프록시 자동 구성”을 선택합니다. 활성화하면 상태 문구나 트레이 아이콘이 보통 변경됩니다. 이때 클라이언트가 로컬 수신 주소를 운영체제 프록시 설정에 기록하므로 일반적인 브라우저에서는 포트를 따로 입력할 필요가 없습니다. 시스템 프록시 설정 화면에서 주소와 포트를 수동으로 다시 바꾸지 마세요. 클라이언트를 종료하거나 모드를 전환한 뒤 수동 값이 남아 문제 확인을 방해할 수 있습니다.

시스템 프록시는 라우팅 규칙과 함께 어떤 요청을 프록시로 전송하고 어떤 요청을 직접 연결할지 결정합니다. 처음 테스트할 때는 클라이언트 기본 라우팅을 유지하고 대규모 규칙 집합을 가져오지 않아도 됩니다. 화면에 “전체”, “규칙” 또는 사용자 지정 라우팅 옵션이 있다면 먼저 일반 규칙 모드를 선택하세요. 특정 앱이 규칙에 의해 우회되는지 확인할 때만 일시적으로 전체 프록시를 사용해 비교합니다. 전체 프록시는 일치하는 트래픽을 현재 서버로 통합 전달한다는 뜻이지 모든 프로그램이 반드시 시스템 프록시를 읽는다는 뜻은 아닙니다. 시스템 프록시를 전혀 사용하지 않는 프로그램에는 TUN이 필요할 수 있습니다.

v2rayN TUN 모드를 사용하는 경우

대상 소프트웨어가 시스템 프록시를 따르지 않거나 더 많은 TCP 및 UDP 트래픽을 라우팅 엔진으로 보내야 한다면 시스템 프록시를 끄고 “TUN 모드”를 활성화할 수 있습니다. 처음 활성화할 때 관리자 권한이 필요하거나 관련 네트워크 구성 요소를 설치 또는 시작해야 할 수 있습니다. 활성화 후에는 기본 스택과 기본 MTU를 유지하고 엄격한 라우팅, DNS 가로채기, 사용자 지정 네트워크 카드 매개변수를 동시에 변경하지 마세요. 권한 부족 메시지가 표시되면 종료한 뒤 시스템에서 허용하는 권한 상승 방식으로 다시 실행하고 TUN 스위치만 별도로 켜세요.

일부 설정에서는 시스템 프록시와 TUN을 동시에 사용할 수 있지만, 초보 단계에서는 두 기능을 함께 테스트하지 않는 것이 좋습니다. 둘 다 켜져 있으면 페이지가 열리더라도 실제 트래픽이 어느 진입점으로 들어왔는지 판단하기 어렵습니다. 먼저 시스템 프록시로 이 문서의 네 단계를 완료하세요. 더 많은 앱을 처리해야 할 때 시스템 프록시를 끄고 TUN을 켠 뒤 연결 및 확인 절차를 반복합니다. TUN 스택, DNS 라우팅, 프로세스 분할의 전체 관계는 프로토콜 안내서의 라우팅 장에서 확인하세요.

v2rayNG: 연결 권한 및 라우팅 설정 확인

v2rayNG는 연결을 시작할 때 시스템 수준의 TUN 인터페이스를 구성하므로 데스크톱처럼 “시스템 프록시”를 별도로 켤 필요가 없습니다. 처음 시작 버튼을 누르면 시스템에 연결 요청이 표시되며, 확인해야 클라이언트가 지정된 범위의 앱 트래픽을 처리할 수 있습니다. 권한을 거부한 적이 있다면 시작 버튼을 다시 누르고 시스템 안내에 따라 확인하세요. 설정 페이지의 “라우팅 설정”은 대상별 출구 선택 방식을 결정합니다. 처음에는 기본값을 유지하고 앱별 분할, 우회 규칙, 사용자 지정 DNS를 동시에 활성화하지 마세요.

Mux 다중화는 연결에 필요한 기능이 아닙니다. 일부 환경에서 연결을 재사용하려고 시도하지만 적합성은 서버 기능, 프로토콜 조합 및 접속 유형에 따라 달라집니다. 처음에는 기본 상태를 유지하고 기본 연결이 안정된 후 하나씩 비교하세요. REALITY, XTLS Vision 등의 프로토콜 관련 필드도 구독 설정에서 제공해야 하며 “최적화”를 위해 직접 수정할 필요가 없습니다. 필드 조합이 맞지 않으면 서버 핸드셰이크가 바로 실패할 수 있습니다.

프록시 진입점 준비가 끝나면 현재 활성 서버를 명확히 지정해야 합니다. 구독 목록에 설정이 여러 개 있어도 클라이언트는 사용할 항목을 자동으로 알 수 없으므로 대상 항목을 먼저 선택한 뒤 연결을 시작해야 합니다. 이때 복잡한 노드 속도 측정 결과를 우선할 필요는 없습니다. 구독에서 메모가 명확하고 프로토콜 필드가 완전한 설정 하나를 골라 연결 테스트를 진행하세요.

v2rayN 활성 서버

v2rayN 기본 목록에서 서버 설정 하나를 클릭하거나 Enter 키를 누른 뒤, 마우스 오른쪽 메뉴에서 “활성 서버로 설정”을 선택합니다. 활성 항목은 보통 색상, 아이콘 또는 상태 열로 표시됩니다. 이어서 창 하단 상태 표시줄에서 현재 서버 이름이 방금 선택한 항목과 일치하는지 확인하세요. 시스템 프록시가 자동 구성 상태라면 활성 서버로 지정한 뒤 클라이언트가 보통 해당 설정을 자동으로 불러옵니다. 하단에 코어가 실행되지 않았다고 표시되면 메뉴에서 코어 재시작 또는 클라이언트 재시작을 실행하세요.

이어서 로그 영역을 엽니다. 정상적으로 시작되면 설정 로드, 로컬 수신 포트 생성, 코어 시작 완료 등의 정보가 표시됩니다. 로그의 로컬 포트는 클라이언트 내부와 시스템 프록시를 연결하는 용도이므로 구독 설정에 복사할 필요가 없습니다. 즉시 failed, invalid, timeout 또는 포트 사용 중 관련 내용이 나타나면 오류가 “설정 로드” 단계에서 발생했는지 “원격 연결” 단계에서 발생했는지 먼저 기록하세요. 설정 로드 실패는 보통 필드 형식 또는 코어 호환성 문제와 관련 있고, 포트 사용 중 오류는 다른 프록시 프로그램이 실행 중일 때 흔히 발생합니다.

v2rayNG 현재 설정

v2rayNG 구성 목록에서 대상 항목을 눌러 현재 선택 항목으로 만든 다음 하단의 원형 시작 버튼을 누릅니다. 처음 시작할 때는 시스템 팝업에서 연결 요청을 확인하세요. 연결이 설정되면 버튼 상태가 바뀌고 알림 영역에 보통 연결 실행 상태가 표시됩니다. 목록으로 돌아왔을 때도 선택 표시가 방금 고른 서버에 남아 있어야 합니다. 누른 직후 중지된다면 메뉴의 로그를 열어 설정 해석, DNS, 핸드셰이크 또는 연결 시간 초과 중 어느 단계인지 확인하세요.

구독에 서버가 여러 개 포함되어 있고 첫 번째 서버에 연결되지 않으면 다른 서버로 바꿔 반복 테스트할 수 있습니다. 단, 바꿀 때마다 활성 항목이 실제로 전환되었는지 확인하세요. 모든 항목의 포트, 전송 방식 또는 TLS 필드를 한꺼번에 수정하지 마세요. 이러한 필드는 서버 설정에 의해 결정됩니다. 여러 항목이 동일한 단계에서 계속 실패한다면 구독 콘텐츠, 클라이언트 코어 또는 로컬 네트워크 진입점 문제일 가능성이 큽니다. 특정 항목만 실패할 때는 해당 설정 자체를 우선 의심하세요.

연결을 시작한 뒤 몇 초 기다려 DNS와 로컬 수신 상태가 안정되면 확인 단계로 넘어갑니다. 상태 아이콘이 실행 중으로 바뀌었다는 것은 클라이언트 프로세스가 시작되었다는 뜻일 뿐, 요청이 대상 출구를 통해 전달되었다는 증거는 아닙니다. 실제 확인을 위해 페이지 접속, 시스템 프록시 상태, 클라이언트 로그를 함께 관찰하고 최소 두 가지 결과가 서로 일치하는지 확인하세요.

확인할 때는 먼저 일반 HTTPS 페이지 하나만 사용하고 여러 브라우저 확장 프로그램, 명령줄 도구, 특수 앱을 동시에 테스트하지 마세요. v2rayN에서 시스템 프록시를 사용할 때는 시스템 프록시를 따르는 브라우저를 우선 사용하고, v2rayNG에서는 일반 브라우저를 바로 사용할 수 있습니다. 페이지를 연 뒤 클라이언트 로그로 돌아가 새로운 연결 기록이 나타나는지 확인하세요. 페이지가 열리고 로그에도 대상 도메인 또는 출구 연결이 함께 표시되면 요청이 클라이언트로 들어온 것입니다.

v2rayN 시스템 프록시 상태 확인

v2rayN에서 시스템 프록시 메뉴를 다시 열고 “시스템 프록시 자동 구성”이 계속 선택되어 있는지 확인하세요. “시스템 프록시 지우기” 또는 “시스템 프록시 변경 안 함”이 선택되어서는 안 됩니다. 이어서 운영체제의 프록시 설정을 확인하면 주소는 로컬 수신 주소를 가리키고 포트는 v2rayN의 현재 로컬 포트와 일치해야 합니다. 이 단계에서는 확인만 하고 직접 덮어쓰지 마세요. 브라우저를 오랫동안 열어 둔 상태라면 브라우저 프로세스를 완전히 종료한 뒤 다시 시작해 시스템 프록시를 새로 읽게 하세요.

브라우저 페이지에 변화가 없고 v2rayN 로그에도 새 요청이 전혀 없다면 문제는 대개 클라이언트 이전 단계에서 발생합니다. 브라우저가 별도 프록시 확장 프로그램을 사용하거나 시스템 프록시를 읽지 않을 수 있고, 다른 네트워크 도구가 시스템 설정을 덮어썼을 수도 있습니다. 먼저 브라우저의 프록시 확장 프로그램을 잠시 끈 뒤 시스템 프록시를 지우고 자동으로 다시 구성하세요. 로그에 요청은 있지만 핸드셰이크 실패, 연결 시간 초과 또는 원격 종료가 나타난다면 트래픽은 클라이언트에 들어온 것이므로 활성 서버, 프로토콜 필드, 로컬 네트워크를 중점적으로 점검하세요.

TUN 및 v2rayNG 상태 확인

v2rayN TUN 또는 v2rayNG를 사용할 때는 먼저 시스템 상태 영역에 연결이 계속 실행 중으로 표시되는지 확인하세요. 일반 페이지를 연 뒤 클라이언트 로그를 살펴봅니다. 대상 요청이 라우팅으로 들어왔지만 페이지가 완전히 로드되지 않는다면 DNS와 라우팅 설정을 중점적으로 확인하세요. 로그에 요청이 없다면 시스템 연결 권한이 여전히 유효한지, 앱별 프록시가 활성화되어 현재 브라우저가 제외된 것은 아닌지 확인합니다. 처음 확인할 때는 앱별 필터를 끄고 일반 트래픽이 먼저 클라이언트를 통과하게 한 다음, 확인이 끝나면 분할 조건을 하나씩 추가하세요.

정상 작동을 확인한 뒤에는 종료 테스트도 한 번 진행해야 합니다. 클라이언트 연결을 중지하거나 시스템 프록시를 지운 다음 방금 연 페이지를 새로 고치고 클라이언트 로그에 새 기록이 더 이상 생성되지 않는지 확인하세요. 이를 통해 페이지가 실제로 현재 클라이언트 연결에 의존하는지, 브라우저 캐시나 별도 확장 프로그램 또는 다른 백그라운드 프로그램 때문인지 구분할 수 있습니다. 테스트가 끝나면 연결을 다시 시작해 상태가 복구되는지 확인하세요. v2rayN을 종료하기 전에 프록시를 더 사용하지 않는다면 먼저 “시스템 프록시 지우기”를 선택해 시스템에 만료된 로컬 수신 주소가 남지 않도록 하세요.

구독 업데이트와 연결은 별개

구독 업데이트 성공은 클라이언트가 설정 목록을 가져와 해석했다는 뜻일 뿐입니다. 연결이 실행 중으로 표시되는 것은 코어가 활성 설정을 불러왔다는 뜻이고, 페이지 요청이 로그에 들어와 정상적으로 완료되어야 전체 작동 경로가 성립합니다. 따라서 문제가 생기면 목록에 설정이 있는지, 활성 서버가 명확한지, 프록시 진입점이 켜져 있는지, 코어가 실행 중인지, 요청이 로그에 들어오는지, 출구 연결이 성공했는지 순서대로 판단하세요. 앞 단계의 상태를 건너뛰고 프로토콜만 반복해서 바꾸지 마세요.

일상적인 사용에서는 정기적으로 구독을 업데이트하고 활성 서버를 선택한 뒤 프록시 진입점 상태를 확인하면 됩니다. 사용자 지정 라우팅, 프로세스 분할, DNS, Mux, REALITY를 추가로 설정하거나 코어를 변경하려면 한 번에 하나의 옵션만 수정하고 변경할 때마다 이 절차의 확인 과정을 반복하는 것이 좋습니다. 프로토콜 선택과 코어 호환성에 대한 자세한 내용은 프로토콜 안내서에서 계속 확인하세요.