구독 다시 업데이트
업데이트 성공 알림이 표시되고 노드 목록이 비어 있지 않은지 확인하세요. 모든 노드가 갑자기 작동하지 않는다면 먼저 구독 만료나 주소 변경을 확인합니다.
10 MINUTE SETUP
“구독 가져오기 → 프록시 모드 선택 → 연결 → 확인” 순서로 진행하세요. 처음에는 필요한 설정만 구성하고, 복잡한 라우팅·DNS·TUN은 기본 연결이 안정된 뒤에 설정합니다.
SCOPE
이 페이지에서는 가장 일반적인 첫 설정만 다룹니다. 사용할 수 있는 구독 링크가 이미 있고, 이를 클라이언트에 넣은 뒤 네트워크 트래픽이 선택한 노드를 거치는지 확인하는 과정입니다. 완료되면 클라이언트가 구독을 정상적으로 업데이트하고 노드 목록을 표시하며 로컬 프록시를 시작해 브라우저가 해당 프록시를 통해 인터넷에 접속할 수 있어야 합니다.
구독 링크는 노드 이름도 아니고 단일 VMess 또는 VLESS 설정 한 줄도 아닙니다. 보통 서비스 제공자가 생성하며, 클라이언트가 이 주소에 접속하면 여러 노드와 그룹 정보를 가져옵니다. 링크가 매우 길고 접속 정보가 포함될 수도 있으므로 신뢰할 수 있는 클라이언트에만 붙여 넣고 공개 페이지·채팅방·스크린샷에 공유하지 마세요.
아직 클라이언트를 설치하지 않았다면 먼저 클라이언트 페이지에서 현재 시스템에 맞는 버전을 선택하세요. 설치했지만 시작 오류나 시스템 구성 요소 누락이 발생했거나 TUN·DNS·복잡한 라우팅을 설정해야 한다면 전체 플랫폼 설치 및 설정 가이드를 확인하세요. 여기서는 처음부터 선택지가 너무 많아지지 않도록 이러한 고급 항목은 다루지 않습니다.
결과에 가장 쉽게 영향을 주는 세 가지 요소부터 확인하세요. 준비에는 1분도 걸리지 않지만 이후 설정을 반복해서 수정하는 일을 줄일 수 있습니다.
구독 링크를 복사할 때는 프로토콜 시작 부분부터 마지막 문자까지 모두 복사해야 합니다. 링크는 보통 https://로 시작하며 뒤에 긴 경로나 매개변수가 붙을 수 있습니다. 물음표 뒤의 내용을 임의로 삭제하거나 웹페이지에 표시된 줄임표까지 함께 복사하지 마세요. 가장 안전한 방법은 제공 페이지의 복사 버튼을 사용한 뒤, 링크를 자동으로 바꿀 수 있는 문서 프로그램을 거치지 않고 클라이언트의 구독 주소 입력란에 바로 붙여 넣는 것입니다.
제공자가 QR 코드를 안내했다면 v2rayNG의 QR 코드 스캔 메뉴를 사용할 수 있습니다. 데스크톱에서는 구독 주소를 직접 붙여 넣는 편이 더 편리합니다. QR 코드는 설정을 전달하는 방식일 뿐 카메라를 반드시 열어야 한다는 뜻은 아닙니다. 어떤 방식으로 가져오든 최종적으로 메인 화면에 노드 목록이 표시되는지가 판단 기준입니다.
시스템 날짜·시간대 또는 시간 오차가 너무 크면 TLS 연결이 시작 단계에서 실패할 수 있습니다. 시스템의 날짜 및 시간 설정을 열어 자동 설정을 활성화하고 시간대가 올바른지 확인하세요. 완료 후 클라이언트의 전송 매개변수를 조정하지 말고 먼저 구독을 다시 업데이트하세요. 오류 원인이 시스템 시계였다면 시간을 맞춘 뒤 대개 바로 복구됩니다.
한 기기에서 여러 프록시 클라이언트를 동시에 실행하면 로컬 포트를 두고 충돌하거나 시스템 프록시 설정을 서로 덮어쓸 수 있습니다. 처음 설정할 때는 다른 유사 프로그램을 종료하고 현재 클라이언트만 남겨 두세요. 브라우저에 별도의 프록시 확장 프로그램이 설치되어 있다면 잠시 “시스템 설정 따르기”로 바꾸거나 확장 프로그램을 끄는 것이 좋습니다. 그래야 확인 단계의 결과가 다른 백그라운드 프로그램이 아닌 현재 설정에 대응합니다.
이 단계의 완료 기준은 “링크를 붙여 넣었다”가 아니라 클라이언트 메인 화면에 실제로 선택 가능한 노드가 표시되는 것입니다.
v2rayN을 연 뒤 상단 메뉴나 구독 관련 메뉴에서 “구독 그룹” 또는 “구독 설정”을 찾으세요. 버전에 따라 메뉴 이름은 조금 다를 수 있지만, 새로 추가·편집·구독 업데이트 기능은 같은 메뉴에 있습니다. 설정 창에서 추가를 선택하고 이 구독 그룹을 쉽게 구분할 수 있는 메모를 입력하세요. 용도나 제공자 이름을 기준으로 정하면 좋습니다. 메모는 현재 기기에만 표시되며 연결에는 영향을 주지 않습니다.
전체 링크를 주소 입력란에 붙여 넣고 해당 그룹이 활성화되어 있는지 확인한 다음 저장하고 설정 창을 닫으세요. 저장만으로는 노드가 자동으로 생성되지 않으므로, 다음 단계에서 구독 메뉴로 돌아가 “모든 구독 업데이트”를 실행하거나 방금 만든 그룹만 업데이트해야 합니다. 업데이트 중에는 하단 상태 영역이나 로그 창을 확인하세요. 성공하면 보통 구독 업데이트 완료 메시지가 표시되고, 이어서 메인 목록에 여러 노드 설정이 나타납니다.
메인 목록이 여전히 비어 있어도 연결 버튼을 반복해서 누르지 마세요. 구독 설정을 다시 열어 주소 양끝에 공백이 들어갔는지, 그룹이 비활성화되었는지, 링크가 완전한지 확인하세요. 주소 끝에 커서를 놓고 줄바꿈 문자가 없는지 확인하는 것도 좋습니다. 브라우저에서 구독 링크가 열린다고 해서 반환된 내용이 클라이언트와 호환된다는 뜻은 아닙니다. 업데이트 과정에서 형식 오류가 명확히 표시되면 링크 제공 페이지에서 V2Ray 클라이언트에 맞는 구독 주소를 다시 발급받으세요.
v2rayNG를 열고 사이드 메뉴를 펼친 다음 구독 그룹 설정으로 들어가세요. 추가 버튼을 누르고 메모와 구독 주소를 입력한 뒤 저장할 때 활성화 스위치가 켜져 있는지 확인하세요. 메인 화면으로 돌아온 후 메뉴를 다시 열어 구독 업데이트를 실행합니다. 일부 버전은 화면 하단에 짧은 알림을 표시하며, 업데이트가 완료되면 노드가 메인 목록에 추가됩니다.
단일 설정 QR 코드를 받았다면 오른쪽 상단 메뉴의 QR 코드 스캔 가져오기를 사용하세요. 구독 QR 코드라면 구독 그룹의 QR 코드 스캔 메뉴에서 구독으로 저장해야 합니다. 단일 설정은 노드 하나만 추가하지만, 구독 그룹은 이후 여러 노드를 한 번에 새로 고칠 수 있다는 차이가 있습니다. 장기간 사용할 예정이라면 구독 그룹으로 저장하는 편이 이후 관리가 편합니다.
시스템에서 카메라 권한을 요청하더라도 클립보드 링크를 사용 중이라면 바로 돌아가 수동 입력을 선택하면 됩니다. 다른 연결 기능에는 영향을 주지 않습니다. 붙여 넣은 뒤에는 반드시 한 번 업데이트하세요. “구독 주소를 저장한 상태”와 “노드 내용을 다운로드한 상태”는 서로 다른 작업입니다. 목록이 표시되면 사용할 노드를 눌러 현재 선택 항목으로 지정하세요.
노드 이름은 보통 구독 제공자가 정하며, 이름에 포함된 지역·배율·회선 표시는 식별 정보일 뿐입니다. 이름이 앞에 있다고 클라이언트가 더 적합한 노드로 자동 판단하지는 않습니다. 처음 테스트할 때는 설정 하나를 임의로 선택하고 비교에 시간을 쓰지 않아도 됩니다. 목록의 모든 노드에 연결할 수 없다면 구독 상태·네트워크 환경·설정 호환성을 확인하고, 일부 노드만 실패한다면 개별 노드의 상태 문제일 가능성이 더 큽니다.
구독 업데이트가 완료되면 메인 화면에 머물면서 두 가지를 확인하세요. 목록에 설정이 하나 이상 있고 그중 하나가 선택되어 있어야 합니다. 이 두 가지를 확인한 후 프록시 모드 설정으로 넘어가세요. 구독 형식의 차이와 클립보드 가져오기·그룹 관리에 대한 자세한 설명은 구독 링크 가져오기 자세히 알아보기에서 확인할 수 있습니다.
프록시 모드는 어떤 요청을 프록시로 보낼지 결정하며 노드 자체를 바꾸지는 않습니다. 처음 설정할 때는 일반 접속과 프록시 트래픽을 함께 처리하기 쉬운 규칙 모드를 우선 사용하세요.
규칙 모드는 도메인·IP 또는 미리 설정된 규칙에 따라 트래픽의 경로를 결정합니다. 일반적인 로컬 서비스와 LAN 주소는 직접 연결로 유지하고, 프록시가 필요한 요청은 현재 노드로 보냅니다. v2rayN에서는 보통 시스템 프록시나 라우팅 메뉴에서 설정하고, v2rayNG에서는 설정 또는 라우팅 설정에서 기본 규칙을 선택할 수 있습니다. 버전에 따라 “LAN 우회”, “규칙”, “라우팅에 따라 처리” 등으로 표시되지만 핵심 의미는 같습니다.
처음부터 많은 사용자 지정 규칙을 가져오거나 도메인 정책을 동시에 조정하지 마세요. 먼저 클라이언트에 포함된 기본 규칙을 사용하고 연결이 성공한 뒤 실제 필요에 따라 세부 설정을 추가하세요. 규칙이 많을수록 문제를 확인할 때 매칭 순서까지 고려해야 합니다. 어떤 웹사이트는 직접 연결되고 다른 웹사이트는 프록시를 사용하는 상황이 반드시 오류는 아니며, 규칙 모드가 의도한 동작일 수 있습니다.
전역 모드는 프록시 적용 범위에 해당하는 더 많은 요청을 현재 노드로 보냅니다. 비교 테스트에 유용합니다. 규칙 모드에서 특정 웹페이지가 열리지 않다가 전역 모드로 바꾸자 바로 열리면 노드와 기본 연결은 정상이고 문제는 구독 가져오기나 코어 시작이 아닌 라우팅 규칙에 있을 가능성이 큽니다.
전역 모드라고 해서 기기의 모든 프로그램이 반드시 프록시를 사용하는 것은 아닙니다. 데스크톱에서 시스템 프록시만 켠 경우 일반적으로 시스템 프록시 설정을 따르는 앱만 이를 사용하며, 일부 프로그램은 자체 네트워크 스택이나 별도 프록시 옵션을 사용할 수 있습니다. Android에서는 시스템 연결을 만든 뒤 적용 범위가 클라이언트 설정과 시스템 메커니즘에 따라 결정됩니다. 더 많은 데스크톱 앱 트래픽을 처리해야 할 때 TUN 모드를 검토하고, 기본 테스트 단계에서는 변수를 동시에 늘리지 마세요.
직접 연결 모드는 요청이 프록시를 우회하도록 합니다. 일반 네트워크 접속을 잠시 복구하거나 프록시 사용 전후를 비교할 때 쓰며, 노드 사용 가능 여부를 판단하는 용도는 아닙니다. 클라이언트가 실행 중으로 표시되어도 모드가 직접 연결이면 브라우저의 외부 IP는 예상대로 바뀌지 않습니다. 연결하기 전에 현재 모드가 직접 연결이 아닌 규칙 또는 전역인지 다시 확인하세요.
모드를 선택한 뒤 바로 클라이언트를 종료하지 마세요. 다음 단계에서 특정 노드를 선택하고 연결을 시작해야 합니다. 모드와 노드는 별개의 조건입니다. 모드만 올바르고 노드를 선택하지 않았거나, 노드를 선택했지만 시스템 프록시를 켜지 않았다면 완전한 연결 경로가 구성되지 않습니다.
먼저 현재 노드를 확인한 다음 클라이언트를 시작하세요. “실행 중”이라는 표시만으로는 로컬 서비스가 시작됐다는 뜻일 뿐이며, 시스템 트래픽이 실제로 클라이언트로 전달되는지도 확인해야 합니다.
노드 목록으로 돌아가 사용할 노드를 클릭하세요. 일부 버전에서는 두 번 클릭하거나 마우스 오른쪽 버튼 메뉴에서 “활성 서버로 설정”을 선택해야 합니다. 선택 상태는 보통 행 강조, 상태 아이콘 또는 트레이 알림으로 표시됩니다. 이어서 시스템 프록시 메뉴를 열고 시스템 프록시 자동 설정 또는 규칙 모드에 해당하는 활성화 항목을 선택하세요.
완료한 뒤 바탕화면 알림 영역의 v2rayN 아이콘을 확인하세요. 아이콘 상태가 바뀌면 클라이언트의 실행 상태가 전환됐다는 뜻이지만, 실제로 유용한 정보는 로그에 있습니다. 로그 창을 열면 정상 시작 시 설정 로드, 로컬 리스닝 시작, 코어 시작 완료 등의 메시지가 표시되어야 합니다. 로그의 로컬 주소는 보통 127.0.0.1과 포트로 구성되며, 이는 클라이언트가 로컬에서 앱 트래픽을 기다리고 있다는 뜻이지 원격 노드 주소가 아닙니다.
로그에 포트가 사용 중이라고 표시되면 먼저 다른 프록시 프로그램을 종료한 뒤 v2rayN을 완전히 닫고 다시 시작하세요. 여러 설정의 포트를 임의로 전부 다른 숫자로 바꾸지 마세요. 시스템 프록시·HTTP 인바운드·SOCKS 인바운드 사이에는 서로 대응하는 관계가 있습니다. 기본 연결 단계에서는 포트를 다시 구성하기보다 충돌하는 프로그램을 정리하는 편이 안전합니다.
메인 목록에서 노드를 선택한 뒤 화면 오른쪽 아래의 연결 버튼을 누르세요. 처음 시작할 때 시스템에 연결 권한 창이 표시되며, 확인해야 클라이언트가 시스템 연결을 만들 수 있습니다. 시스템 안내에 따라 권한을 승인한 뒤 v2rayNG로 돌아오면 버튼과 상단 상태가 연결됨으로 바뀌고 시스템 상태 영역에도 연결 표시가 나타납니다.
누른 직후 연결이 중지되면 로그에서 처음으로 명확하게 표시된 오류를 확인하세요. 주요 원인은 구독 설정 만료, 서버에 연결할 수 없는 네트워크, 잘못된 시스템 시간, 현재 네트워크에서 특정 전송 방식이 제한된 경우입니다. “연결 실패”라는 네 글자만 보고 설정을 바꾸지 말고 주소 해석 실패인지, TCP 연결 설정 실패인지, TLS 핸드셰이크 실패인지, 인증 거부인지 확인하세요. 단계가 다르면 해결 방법도 완전히 다릅니다.
클라이언트가 막 시작된 직후에는 설정을 불러오고 라우팅을 초기화하며 필요한 연결을 구성해야 합니다. 시작 버튼을 누른 후 몇 초 기다렸다가 브라우저에서 새 페이지를 여세요. 이미 열려 있던 페이지는 기존 연결을 재사용할 수 있어 기존 탭만 새로 고치면 변화가 보이지 않을 때가 있습니다. 새 탭을 열거나 브라우저를 완전히 닫았다가 다시 여는 편이 확실합니다.
데스크톱에서는 브라우저가 시스템 프록시를 따르는지도 확인해야 합니다. 주요 브라우저는 보통 기본적으로 시스템 설정을 읽지만, 브라우저에 별도 프록시·명령줄 시작 옵션·확장 프로그램 규칙이 설정되어 있으면 v2rayN을 우회할 수 있습니다. Android에서는 v2rayNG가 계속 연결된 상태인지, 배터리 절약 기능에 의해 바로 중지되지 않았는지 확인하세요. 기본 연결이 성공하기 전에는 여러 앱별 프록시 규칙을 동시에 켜지 마세요.
클라이언트 버튼 색상만 확인하지 마세요. 먼저 로컬 실행 상태를 확인한 다음 웹페이지 접속과 외부 IP 변화를 점검해야 합니다.
클라이언트 로그를 열어 먼저 코어가 정상적으로 시작됐고 같은 오류가 계속 반복되지 않는지 확인하세요. 연결 재시도가 가끔 한 번 나타나는 것은 전체 실패를 의미하지 않을 수 있습니다. 네트워크 요청은 원래 다시 연결될 수 있기 때문입니다. 웹페이지를 열 때마다 같은 시간 초과·거부·해석 오류가 반복될 때만 연결 경로에 문제가 남아 있다고 판단하세요.
로그를 한 줄씩 모두 이해할 필요는 없습니다. 최신 시간이 기록된 오류와 반복 횟수가 많은 오류부터 찾고, 도메인 해석·연결 시간 초과·인증서·인증·라우팅 관련 키워드가 있는지 확인하세요. 오류를 유형별로 분류한 뒤 처리하는 편이 모든 설정을 한꺼번에 바꾸는 것보다 효과적입니다. 일반적인 오류의 의미와 확인 항목은 FAQ 문제 해결 분류에서 확인할 수 있습니다.
브라우저에서 새 탭을 열고 평소 직접 연결되는 웹사이트와 프록시를 통해 접속해야 하는 웹사이트를 각각 열어 보세요. 규칙 모드에서 두 종류의 사이트가 모두 열리면 기본 분할 라우팅과 프록시 연결이 작동하는 것입니다. 직접 연결 사이트는 정상인데 프록시 사이트만 시간 초과가 발생하면 노드와 구독 상태를 우선 확인하세요. 전역 모드는 정상이고 규칙 모드만 이상하다면 라우팅 규칙을 집중적으로 점검합니다.
브라우저에서 어떤 사이트도 열리지 않으면 먼저 시스템 프록시를 끄고 일반 네트워크 자체가 정상인지 확인한 다음 클라이언트를 다시 활성화하세요. 프록시를 꺼도 접속되지 않는다면 문제는 보통 V2Ray 설정이 아니라 로컬 네트워크에 있으므로 먼저 네트워크를 복구해야 합니다. 프록시를 끄면 복구되지만 다시 켜자 모두 실패한다면 로컬 리스닝, 포트 충돌, 시스템 프록시 주소가 서로 일치하는지 확인하세요.
연결하기 전에 브라우저에서 “현재 IP”를 검색해 표시된 외부 IP를 기록하세요. 연결 후 새 탭에서 다시 조회합니다. 외부 IP가 바뀌고 지역이 선택한 노드와 대략 일치하면 브라우저 트래픽이 프록시를 통과한 것입니다. 규칙 모드에서는 조회 서비스가 직접 연결로 분류될 수 있으므로 IP가 그대로라면 전역 모드로 잠시 전환해 비교한 다음 다시 규칙 모드로 돌아오세요.
외부 IP 변화는 현재 브라우저 요청이 프록시를 통과했다는 것만 보여 주며, 기기의 모든 앱이 같은 경로를 사용한다는 뜻은 아닙니다. 특정 프로그램만 계속 연결되지 않는다면 해당 프로그램이 시스템 프록시를 지원하는지, 자체 HTTP·SOCKS 주소가 설정되어 있는지 확인하세요. 시스템 프록시를 따르지 않는 데스크톱 앱까지 처리해야 한다면 전체 문서의 TUN 설정을 확인하세요.
연결이 정상인지 확인한 뒤에는 DNS·포트·라우팅을 계속 수정하지 마세요. 현재 사용 중인 구독 그룹·노드·프록시 모드·시스템 프록시 상태를 기억해 두세요. 이후 규칙을 추가하거나 실행 방식을 바꿨을 때 문제가 생기면 이 검증된 기본 상태로 돌아와 비교할 수 있습니다.
구독 내용은 제공자에 따라 업데이트됩니다. 노드 구성이 전체적으로 바뀌었을 때는 “구독 업데이트”를 사용하면 되며 그룹을 삭제하고 다시 가져올 필요가 없습니다. 업데이트 후 현재 노드가 사라지면 새 목록에서 다른 설정을 선택하세요. 구독 주소 자체가 변경되었거나 만료된 경우에만 그룹의 링크를 편집하면 됩니다.
QUICK FIXES
먼저 문제가 어느 계층에서 발생했는지 판단한 뒤 전체 문서로 이동할지 결정하세요. 아래 여섯 항목을 순서대로 확인하며 한 번에 하나의 변수만 변경합니다.
업데이트 성공 알림이 표시되고 노드 목록이 비어 있지 않은지 확인하세요. 모든 노드가 갑자기 작동하지 않는다면 먼저 구독 만료나 주소 변경을 확인합니다.
같은 구독에서 다른 설정 하나를 선택하세요. 특정 노드 하나만 실패한 경우에는 클라이언트 전체 설정을 수정할 필요가 없습니다.
현재 모드가 직접 연결이 아닌지 확인하세요. 규칙 모드의 결과가 불분명하면 전역 모드로 잠시 전환해 비교 테스트를 진행합니다.
다른 프록시 프로그램을 종료하고 현재 클라이언트를 다시 시작한 뒤 로그에 로컬 리스닝 실패가 계속 표시되는지 확인하세요.
자동 날짜 및 시간 설정을 활성화하고 시간대가 정확한지 확인한 다음 다시 연결해 TLS 관련 오류가 사라졌는지 확인하세요.
기본 단계를 모두 올바르게 진행했는데도 실패한다면 플랫폼별 설치·시스템 프록시·DNS·TUN·로그 진단 문서를 확인하세요.