먼저 구독 요청이 완료되지 않은 것인지, 콘텐츠를 다운로드했지만 파싱하지 못한 것인지 구분하세요. v2rayN으로 구독을 관리하다 업데이트 시간 초과나 빈 노드 목록을 겪는 사용자를 위해 URL, 응답, 인코딩, 형식, 업데이트 경로를 차례로 확인하는 방법을 정리했습니다. 마지막으로 그룹별 노드 수와 로그를 확인해 구독 문제를 노드 장애로 오인하지 않도록 합니다.
업데이트 실패와 파싱 결과가 비어 있는 경우 구분하기
구독 업데이트는 구독 URL 요청, 응답 내용 읽기, 내용을 노드로 변환하는 세 단계로 이루어집니다. 요청 시간 초과는 주로 첫 단계에서, 형식 오류는 뒤의 두 단계에서 발생합니다. 노드 지연 시간 테스트는 가져오기가 끝난 뒤 별도로 수행하는 작업이므로, ‘노드 시간 초과’만으로 구독 URL이 만료됐다고 판단할 수 없습니다.
v2rayN의 로그나 업데이트 결과 창을 열어 이번 업데이트 시간, 구독 그룹, 오류 원문을 기록하세요. 먼저 그룹 하나만 업데이트하고 모든 소스를 한꺼번에 새로 고치지 마세요. 화면의 그룹 필터와 검색창도 비우세요. 노드가 이미 가져와졌지만 현재 필터 조건에 가려져 있을 수 있습니다.
- 오래 기다린 뒤 시간 초과가 발생함: 구독 도메인 이름 확인, 네트워크 연결, 직접 연결 또는 프록시 업데이트 경로를 점검하세요.
- 401 또는 403 응답이 명확히 표시됨: 구독 권한, URL 유효 기간, 서버 접근 제한을 먼저 확인하세요.
- 다운로드는 완료됐지만 가져온 노드가 없음: 응답이 웹페이지나 빈 콘텐츠인지, 지원하지 않는 설정 형식인지 확인하세요.
- 노드는 표시되지만 연결되지 않음: 반복해서 가져오지 말고 노드 매개변수, 코어 호환성, 연결 로그를 확인하세요.
구독 URL 확인: 계정 페이지를 구독 URL로 착각하지 않기
구독 제공업체의 계정 페이지에서 현재 클라이언트에 맞는 구독 URL을 다시 복사하세요. 계정 로그인 페이지, 요금제 안내 페이지, 노드 공유 링크는 서로 다른 경로입니다. 원격 구독 URL은 보통 https://로 시작합니다. vmess://, vless:// 등의 접두사는 대개 개별 노드 공유 정보를 뜻하므로 노드 가져오기 기능을 사용해야 합니다.
-
다시 복사하기
제공업체 페이지에서 v2rayN용 구독 메뉴를 선택해 전체 URL을 복사하세요. 채팅 화면의 스크린샷에서 문자를 인식하거나 말줄임표가 표시된 미리보기에서 복사하지 마세요.
-
문자 확인
로컬 텍스트 편집기에서 URL의 앞뒤를 확인하고 실수로 포함된 따옴표, 공백, 줄바꿈을 제거하세요. 기존 경로, 물음표, 등호, 퍼센트 기호와 쿼리 매개변수는 그대로 유지하고, URL을 임의로 재배열하거나 디코딩하지 마세요.
-
그룹 수정
v2rayN 메인 화면에서 「구독 그룹」→「구독 그룹 설정」을 열고 대상 그룹의 구독 URL을 수정한 뒤 저장하세요. 메뉴 이름은 버전에 따라 조금 다를 수 있습니다. 개별 노드를 편집하는 화면이 아니라 구독 URL을 관리하는 창으로 이동해야 합니다.
-
그룹 하나만 업데이트
대상 그룹을 선택한 뒤 「구독 그룹」 메뉴에서 「현재 구독 업데이트(프록시 사용 안 함)」를 실행하세요. 먼저 이 경로의 결과를 기록하고, 실패한 경우 프록시를 통한 업데이트 결과와 비교하세요.
제공업체가 구독 토큰을 재설정했다면 계정 이용 기간이 남아 있어도 기존 URL이 즉시 무효가 될 수 있습니다. 새 URL을 복사한 뒤 기존 그룹의 주소를 교체하세요. 기존 주소 뒤에 새 주소를 덧붙이지 마세요. 컴퓨터 시간도 확인해야 합니다. 시간이 크게 어긋나면 HTTPS 인증서 검증에 실패해 콘텐츠 파싱 오류가 아니라 구독 다운로드 오류가 발생할 수 있습니다.
HTTP 응답 확인: 200이라고 해서 노드를 받은 것은 아닙니다
아래 세 숫자는 HTTP 상태 코드이며 클라이언트 버전이나 노드 수가 아닙니다. 업데이트를 계속 클릭하기보다 업데이트 로그의 상태 코드를 확인하면 문제 범위를 더 빠르게 좁힐 수 있습니다. 로그에 상태 코드가 없다고 해서 시간 초과를 서버 거부로 단정할 수도 없습니다.
브라우저에서 URL이 열린다고 해서 클라이언트도 같은 콘텐츠를 받는다는 뜻은 아닙니다. 브라우저에는 로그인 상태가 유지되거나 웹페이지 인증이 완료되어 있을 수 있고, 네트워크 경로가 다를 수도 있습니다. 클라이언트는 로그인 안내, 접근 제한 설명, 캡차 페이지를 받을 수 있습니다. 이런 페이지가 200을 반환하더라도 노드 구독으로 파싱할 수 없습니다.
Response status code does not indicate success: 403 (Forbidden).
원인: 구독 서버가 요청을 거부한 경우로, 토큰, 외부 IP 주소 또는 접근 정책이 원인일 수 있습니다. 해결: 유효한 구독 URL을 다시 복사하고 계정 상태를 확인한 다음, 제공업체에 클라이언트용 구독 경로와 접근 제한을 문의하세요.
The operation has timed out.
원인: 제한 시간 안에 요청이 완료되지 않은 것으로, URL 만료를 뜻하지는 않습니다. 해결: 직접 연결과 프록시를 통한 업데이트를 각각 테스트하고, 현재 네트워크에서 먼저 로그인이 필요한지 확인하세요.
The SSL connection could not be established, see inner exception.
원인: HTTPS 연결을 설정하지 못했습니다. 구체적인 원인은 이후에 표시되는 오류를 확인해야 합니다. 해결: 먼저 시스템 시간을 맞춘 다음 인증서 오류와 네트워크 차단 안내를 확인하세요. 인증서 검증을 바로 끄지 마세요.
정리: 응답 내용을 확인한 뒤 인코딩 문제를 해결하세요
응답이 로그인 페이지, 캡차 페이지 또는 만료 안내라면 구독 경로와 접근 조건을 바로잡아야 합니다. 이런 페이지를 반복해서 Base64 디코딩해도 가져올 수 있는 노드가 생성되지는 않습니다.
Base64와 공유 형식 확인: 올바른 경우에 한 번만 디코딩하기
기존 구독 형식은 여러 공유 링크를 줄 단위로 나열한 다음 전체 텍스트를 Base64로 인코딩하는 경우가 많습니다. 디코딩하지 않은 링크를 그대로 반환하는 구독도 있습니다. Base64는 텍스트 인코딩 방식일 뿐, 내용이 반드시 유효하거나 클라이언트가 해당 프로토콜을 지원한다는 뜻은 아닙니다. 먼저 응답 내용을 확인하고 필요한 경우에만 로컬에서 디코딩 결과를 살펴보세요.
| 로컬에서 확인한 내용 | 가능한 의미 | 처리 방법 |
|---|---|---|
| 여러 줄의 프로토콜 공유 링크 | 일반 텍스트 노드 목록 | 각 줄이 완전한지 확인하고 해당 형식을 지원하는 가져오기 기능을 사용하세요. |
| 연속된 인코딩 텍스트 | Base64 구독일 수 있음 | 로컬에서 한 번 디코딩한 뒤 결과가 완전한 공유 링크인지 확인하세요. |
| HTML 태그로 시작함 | 웹페이지 또는 오류 페이지 | 구독 URL, 로그인 상태, 서버 접근 제한을 다시 확인하세요. |
| JSON 또는 YAML 설정 | 다른 설정 출력 형식 | 제공업체에서 호환되는 구독 출력 형식을 선택하세요. 파일 확장자만 바꾸지 마세요. |
| 빈 내용 또는 만료 안내 | 노드가 없거나 계정 상태에 문제가 있음 | 사용량 한도, 유효 기간, 제공업체의 노드 할당 상태를 확인하세요. |
VMess 공유 링크는 보통 접두사 뒤에 인코딩된 설정 정보가 이어집니다. VLESS 공유 링크는 대개 URI 필드와 쿼리 매개변수를 사용합니다. 두 링크의 접두사를 서로 바꿔 쓸 수는 없습니다. 구독을 디코딩한 결과가 vmess://로 시작하는 완전한 링크라면, 해당 줄 전체를 외부 Base64 텍스트로 간주해 반복해서 디코딩하지 마세요.
- 구조 문자 유지: URI의
%인코딩을 임의로 바꾸거나 매개변수 사이의&를 문장 부호로 바꾸지 마세요. - 복사한 위치 확인: URL에
&같은 웹 엔터티 문자열이 실제로 들어 있다면 원래 페이지로 돌아가 복사 버튼을 사용하세요. 웹페이지 소스 코드를 복사하지 마세요. - 무작정 채워 넣지 않기: Base64에는 표준 형식과 URL 안전 형식이 있으며 패딩 문자를 처리하는 방식도 다를 수 있습니다. 디코딩 오류가 나면 먼저 텍스트가 잘리지 않았는지 확인하세요. 등호를 반복해서 추가하는 것만으로 해결하려 하지 마세요.
- 지원되는 필드 확인: 프로토콜 이름을 인식하더라도 현재 클라이언트와 코어가 모든 전송 매개변수를 지원하는 것은 아닙니다. 지원되지 않는 필드를 기록하고 제공업체에 호환되는 설정을 요청하세요.
v2rayN은 데스크톱 설정 관리 클라이언트이므로 가져오기 지원 여부와 실제 실행에 선택한 코어를 모두 확인해야 합니다. Android용 v2rayNG는 Xray 코어를, v2flyNG는 v2fly 코어를 사용하므로 세 클라이언트의 지원 범위가 완전히 같다고 가정하면 안 됩니다. 특정 유형의 노드만 누락된다면 구독 전체가 손상됐다고 판단하기보다 형식과 기능 지원 여부를 먼저 확인하세요.
업데이트 경로 바꾸기: 직접 연결과 프록시 연결을 각각 테스트하기
구독 다운로드에 프록시를 사용하는 설정은 브라우저의 시스템 프록시 사용 여부와 완전히 같지 않습니다. v2rayN에는 구독 업데이트 명령이 여러 가지 있으므로 실제로 선택한 명령을 기준으로 확인하세요. 시스템 프록시를 켜더라도 이전에 실패한 구독 업데이트 작업이 자동으로 프록시를 사용한다고 보장할 수 없습니다.
-
기존 노드 확인
이미 가져왔고 연결할 수 있는 노드를 하나 선택해 코어가 실행 중인지 확인하세요. 프록시를 통한 업데이트에는 사용 가능한 프록시가 필요하므로 노드 목록이 비어 있으면 연결을 새로 만들 수 없습니다.
-
프록시로 업데이트 실행
「구독 그룹」→「현재 구독 업데이트(프록시 사용)」를 여세요. 같은 구독 URL과 그룹을 유지하고 업데이트 경로만 바꾼 뒤, 여전히 시간 초과가 발생하는지와 구체적인 상태 코드를 기록하세요.
-
로컬 수신 포트 확인
로그에 로컬 연결 거부가 표시되면 「설정」→「매개변수 설정」에서 로컬 수신 포트와 코어 실행 상태를 확인하세요. 일부 설정은 10808을 사용하지만 실제 포트는 현재 설정을 기준으로 해야 합니다. 다른 기기의 값을 그대로 따라 하지 마세요.
-
두 결과 비교
직접 연결은 실패하고 프록시 연결은 성공한다면 접근 경로에 차이가 있다는 뜻입니다. 두 방법 모두 같은 인증 오류를 반환한다면 URL과 계정을 다시 확인하세요. 서버 인증 문제를 해결하려고 노드 프로토콜을 계속 바꾸지 마세요.
업데이트 후 확인: 그룹, 노드 수, 연결 결과 점검
‘업데이트 완료’가 표시되면 먼저 대상 그룹으로 전환하고 검색어를 지운 뒤 노드 수를 확인하세요. 새로 추가된 노드가 0개라고 해서 반드시 가져오기에 실패한 것은 아닙니다. 로그에 새로 추가된 노드 수만 기록하는 경우 기존 설정에 변화가 없으면 0으로 표시될 수 있습니다. 그룹에 있는 기존 노드와 업데이트 로그를 함께 확인하세요.
- 대상 그룹 확인: 수정하고 업데이트한 그룹이 같은지 확인하세요. 다른 그룹의 목록을 결과로 착각하지 않도록 주의하세요.
- 필터 설정 확인: 구독 그룹 설정의 필터 조건을 살펴보고, 이름 필터가 너무 좁다면 일시적으로 제거한 뒤 다시 시도하세요.
- 노드 하나 점검: 주소, 포트, 전송 방식, TLS 설정이 모두 입력됐는지 확인하세요. 민감한 사용자 정보는 로컬에서만 확인하세요.
- 연결 테스트는 따로 진행: 가져오기에 성공한 노드 하나를 선택해 연결한 뒤 코어 로그를 확인하세요. 지연 시간 수치만으로 웹페이지 접속 여부를 판단하지 마세요.
- 문제 해결 기록 보관: 업데이트 방식, 상태 코드, 응답 본문 유무, 그룹별 노드 수를 기록하세요. 제공업체에 문의할 때는 민감한 정보를 가린 내용만 전달하세요.
구독 관리 자주 묻는 질문
브라우저에서는 구독 URL이 열리는데 v2rayN 업데이트는 왜 실패하나요?
먼저 브라우저에 노드 정보가 표시되는지, 계정 페이지가 표시되는지 확인하세요. 그런 다음 프록시를 사용하지 않는 업데이트와 프록시를 사용하는 업데이트를 각각 실행하세요. 브라우저와 클라이언트는 로그인 상태, 인증 절차, 네트워크 경로가 다를 수 있습니다. 클라이언트에서만 요청이 거부된다면 제공업체에 지원되는 구독 경로와 요청 제한을 문의하세요.
같은 구독에서 일부 노드만 가져왔습니다. 다시 설치해야 하나요?
먼저 구독 그룹의 필터와 검색 조건을 확인한 다음, 제외된 노드의 프로토콜과 전송 매개변수, 로그를 살펴보세요. 클라이언트 다운로드 페이지에서 해당 플랫폼에 맞는 버전을 선택하고 설정을 백업한 뒤 클라이언트를 업데이트하세요. 먼저 설정을 모두 지우지 마세요. 재설치해도 호환되지 않는 원본 형식은 해결되지 않습니다.
목록이 이미 비었는데 프록시 업데이트로 복구할 수 있나요?
클라이언트에 사용할 수 있는 노드가 따로 있고 코어가 정상적으로 실행 중일 때만 이 방법을 사용할 수 있습니다. 모든 그룹이 비었다면 먼저 로컬 백업을 복원하거나 제공업체에서 받은 유효한 단일 노드를 사용하세요. 또는 구독 URL에 직접 연결할 수 있는 네트워크로 바꾼 다음 구독을 업데이트하세요.
구독 URL을 온라인 변환 도구에 붙여 넣어 테스트해도 되나요?
먼저 제공업체가 지원하는 호환 출력 형식과 로컬 확인 방법을 사용하세요. 구독 URL에는 보통 접근 권한이 포함되어 있으므로 외부 도구에 제출하면 해당 서비스 운영자가 URL을 확인할 수 있습니다. 실수로 공개했다면 제공업체 계정에서 구독 토큰을 재설정한 뒤 클라이언트의 기존 URL을 교체하세요.
위 항목을 확인하면 문제는 대개 URL 권한, 네트워크 요청, 응답 형식, 클라이언트 호환성 중 하나로 좁혀집니다. 이후에는 한 번에 한 항목만 바꾸고 같은 그룹에서 다시 테스트하세요. 그래야 어떤 변경이 효과가 있었는지 파악할 수 있으며, 반복해서 가져오는 과정에서 기존의 정상 설정을 잃지 않을 수 있습니다.