V2Ray 구독 업데이트 실패·노드가 표시되지 않을 때 확인할 사항

다운로드 실패와 파싱 결과가 비어 있는 경우 구분하기

구독 주소를 저장했다는 것은 클라이언트가 주소를 기억했다는 뜻일 뿐, 노드를 가져왔다는 뜻은 아닙니다. 업데이트 과정에서는 도메인 조회, 구독 서버 연결, 응답 수신, 형식 인식, 그룹에 노드 추가가 차례로 이뤄집니다. 목록이 비어 있다면 이 단계 중 하나가 실패했거나 현재 다른 그룹을 선택했을 수 있습니다.

먼저 클라이언트 로그를 열고 업데이트 시각 전후에 처음 나타난 오류를 기록하세요. 마지막에 표시되는 “업데이트 실패”만 보면 안 됩니다. 마지막 메시지는 원인이 아니라 결과인 경우가 많습니다. 브라우저에서 서비스 제공업체 홈페이지가 열린다고 해서 구독 API까지 정상이라는 뜻은 아닙니다. 홈페이지와 구독 API는 도메인, 접근 권한, 네트워크 경로가 서로 다를 수 있습니다.

링크 만료 및 API 권한 확인

구독 링크에는 계정 토큰이 포함되는 경우가 많습니다. 구독을 재설정했거나 요금제가 만료된 경우, 권한이 변경되거나 서비스가 이전된 경우에는 기존 링크에 접속되더라도 안내 페이지만 반환될 수 있습니다. 서비스 제공업체의 구독 관리 페이지에서 현재 클라이언트에 맞는 링크를 다시 복사하세요. 브라우저 주소창에 표시된 관리 페이지 주소를 복사하면 안 됩니다.

1. 기존 그룹 유지하기

   먼저 현재 그룹 이름과 마지막 업데이트 시각을 기록하세요. 아직 사용할 수 있는 노드가 있다면 설정을 백업한 뒤 새 링크를 시험하세요. 유일하게 사용할 수 있는 그룹을 출처가 불분명한 내용으로 덮어쓰지 마세요.

2. 링크 출처 확인

   서비스 제공업체 페이지에서 계정 상태와 구독 권한을 확인한 뒤 페이지의 복사 버튼을 사용하세요. 앞뒤 공백, 줄바꿈, 복사 과정에서 포함된 따옴표가 없는지 확인하고 기존 쿼리 매개변수는 그대로 두세요.

3. 그룹 주소 확인

   v2rayN에서는 「구독 그룹」→「구독 그룹 설정」을 열고 대상 그룹을 편집해 「주소」를 확인하세요. v2rayNG에서는 사이드 메뉴에서 「구독 그룹 설정」을 열고 해당 항목의 구독 주소를 편집하면 됩니다. 화면 버전에 따라 메뉴 위치가 다를 수 있습니다.

4. 대상 그룹 업데이트

   저장한 뒤 해당 그룹만 업데이트하고 권한 오류인지 파싱 오류인지 기록하세요. 구독 토큰을 재설정해야 한다면 다른 기기에 저장된 기존 주소도 함께 바꾸세요. 오래된 링크가 만료된 문제를 기기 오류로 오해하지 않도록 주의하세요.

아래 숫자는 HTTP 응답 상태 코드이며 클라이언트 버전이나 실제 성공률이 아닙니다. 다음 단계에서 권한을 확인할지 응답 내용을 확인할지 판단하는 데 도움이 됩니다.

인코딩과 형식: 내용을 받아도 가져오지 못할 수 있습니다

“V2Ray 구독”은 아무 설정 파일이나 가져오는 범용 메뉴가 아닙니다. 일반적으로 한 줄씩 나열된 공유 링크이거나, 링크 목록 전체를 Base64로 인코딩한 형식입니다. VMess 공유 링크 자체에도 인코딩 구조가 있을 수 있습니다. 이를 이유로 구독 전체를 다시 인코딩하거나 끝 문자를 직접 삭제하지 마세요.

VLESS는 노드에 사용하는 프로토콜 중 하나이고, 구독은 여러 노드를 배포하는 방식입니다. 클라이언트에서 특정 노드를 실행할 수 있다고 해서 서비스가 반환하는 모든 설정 텍스트를 인식하는 것은 아닙니다. 전체 코어 JSON 설정, 구조화된 설정 문서, 공유 링크 목록은 각각 알맞은 가져오기 메뉴를 사용해야 합니다.

• HTML이 반환됨: 로그인 양식, 인증 문자, 웹페이지 제목이 보인다면 노드 목록이 아니라 웹페이지를 받은 것입니다. 서비스 제공업체 페이지로 돌아가 올바른 클라이언트용 구독 메뉴를 선택하세요.
• JSON이 반환됨: API 오류 메시지인지 전체 코어 설정인지 먼저 확인하세요. 중괄호가 있다는 이유만으로 구독이라고 판단하면 안 됩니다. 오류 메시지에 권한이나 만료 안내가 있다면 이를 먼저 해결하세요.
• 빈 본문이 반환됨: 서비스 제공업체가 실제로 노드를 할당했는지, 그룹 필터가 모든 항목을 제외하고 있지는 않은지 확인하세요. 빈 응답은 코어를 바꿔도 노드가 생기지 않습니다.
• 공유 링크가 반환됨: 클라이언트가 지원하는 프로토콜과 매개변수가 포함됐는지 확인하세요. 일부 노드만 인식된다면 프로토콜과 전송 설정을 하나씩 비교하세요. 무조건 네트워크 문제라고 단정하지 마세요.

응답을 확인해야 한다면 가능한 한 기기에서 직접 확인하고, 브라우저는 시스템 프록시를 사용하지만 클라이언트 업데이트는 직접 연결을 선택할 수 있다는 점에 유의하세요. 네트워크 경로가 다르면 두 결과를 그대로 비교할 수 없습니다. 구독 서버가 요청 헤더에 따라 다른 내용을 반환할 수도 있으므로 브라우저에 웹페이지가 보인다는 사실은 단서일 뿐입니다. 클라이언트 로그와 서비스 제공업체 안내를 함께 확인하세요.

업데이트 시 프록시와 직접 연결 중 무엇을 사용할지

“노드는 연결되지만 구독 업데이트는 실패하는” 상황에서 자주 갈리는 지점입니다. 일반 트래픽이 현재 프록시를 거친다고 해서 구독 다운로드도 같은 경로를 이용하는 것은 아닙니다. 반대로 이미 작동하지 않는 노드에 구독 업데이트를 의존한다면 구독 서버가 정상이어도 요청이 계속 시간 초과될 수 있습니다.

1. 테스트 조건 고정

   같은 네트워크와 같은 구독 주소를 사용하고 업데이트 방식만 바꾸세요. 먼저 현재 프록시 노드로 일반 HTTPS 웹사이트에 접속할 수 있는지 확인합니다. DNS, 노드, 라우팅 규칙을 한꺼번에 바꾸지 마세요.

2. 먼저 직접 연결로 업데이트

   v2rayN의 「구독 그룹」 메뉴에서 「모든 구독 업데이트(프록시 사용 안 함)」을 선택하세요. 괄호는 화면 버전에 따라 다른 모양으로 표시될 수 있습니다. 핵심은 프록시를 사용하지 않는다고 명시된 명령을 선택하고 해당 그룹의 결과를 확인하는 것입니다.

3. 그다음 프록시를 사용해 업데이트

   직접 연결이 시간 초과되고 사용할 수 있는 노드가 있다면 「모든 구독 업데이트(프록시 사용)」를 선택하세요. 현재 노드가 작동하지 않는다면 같은 명령을 반복하지 마세요. 먼저 연결 가능한 노드를 복구하거나 구독 API에 직접 연결되는 네트워크를 사용하세요.

4. 결과 비교 기록

   직접 연결과 프록시 사용 시 각각 어떤 오류가 발생했는지 기록하세요. v2rayNG에서는 메인 화면 메뉴에서 「구독 업데이트」를 실행할 수 있습니다. 다운로드 경로는 버전과 실행 상태에 따라 달라지므로 데스크톱 메뉴 동작을 그대로 적용하지 말고 로그와 현재 연결 상태를 함께 확인하세요.

로그에 로컬 프록시 포트 연결 실패가 표시된다면 클라이언트가 실제로 수신 대기 중인 주소와 포트를 확인하세요. 다른 사람의 포트 번호를 그대로 따라 하면 안 됩니다. 프록시를 통한 업데이트로 성공하더라도 이번 요청에 해당 경로가 연결됐다는 뜻일 뿐입니다. 구독이 항상 프록시를 사용해야 한다거나 모든 노드가 정상이라는 의미는 아닙니다.

실제 오류에 따라 다음 단계 찾기

플랫폼과 네트워크 라이브러리에 따라 오류 문구는 다를 수 있습니다. 아래는 자주 나타나는 오류 원문입니다. 구독 도메인, 로컬 프록시, 노드 서버 중 어디에 연결하려다 발생했는지도 함께 확인하세요. 키워드 하나만으로 원인을 단정하면 안 됩니다.

인증서 오류가 발생했다면 먼저 시스템 날짜, 시간, 시간대를 확인한 뒤 구독 도메인이 인증서와 일치하는지 점검하세요. 구독 업데이트를 위해 인증서 검증을 끄지 마세요. 노드 편집 화면의 보안 옵션이 구독 다운로드에 사용되는 HTTPS 연결까지 제어하는 것은 아닐 수 있습니다.

클라이언트 버전과 업데이트 결과 확인

오래된 클라이언트는 새 공유 링크 매개변수를 인식하지 못하거나 구독 서버의 최신 응답 형식을 처리하지 못할 수 있습니다. 하지만 구독 파싱은 보통 클라이언트가 수행하고, 노드 연결은 주로 코어가 담당합니다. 서로 다른 단계입니다. Xray 또는 V2Fly 코어만 바꿔서는 로그인 페이지가 다운로드되는 문제나 만료된 토큰을 해결하기 어렵습니다.

• 현재 상태 기록: 「도움말」 또는 「정보」 화면에서 클라이언트 버전을 확인하세요. 업그레이드 전후를 비교할 수 있도록 오류 시각, 운영체제, 업데이트 방식도 기록합니다.
• 백업 후 업그레이드: 다운로드 페이지에서 해당 플랫폼용 설치 파일을 선택하고 안내에 따라 업데이트하세요. 데스크톱에서는 먼저 프로그램을 종료합니다. 모바일 기기에서는 앱 데이터와 기존 설정이 유지되는지 확인하세요.
• 호환되는 가져오기 메뉴 사용: v2rayNG는 Xray 코어를, v2rayNG는 V2Fly 코어를 사용합니다. 서비스 제공업체의 호환 안내에 맞춰 구독을 선택하세요. 두 클라이언트가 모든 프로토콜 매개변수를 똑같이 지원한다고 가정하면 안 됩니다.
• 두 결과를 따로 확인: 먼저 그룹에 노드가 표시되는지 확인한 다음 노드 하나를 선택해 연결을 테스트하세요. 가져오기에 성공했다고 연결까지 되는 것은 아니며, 연결 시간 초과가 구독 파싱 실패를 뜻하는 것도 아닙니다.

업데이트 성공으로 표시되는데 목록이 비어 있다면 먼저 검색어를 지우고 대상 구독 그룹으로 돌아간 뒤 필터가 켜져 있는지 확인하세요. 특정 그룹만 문제가 있다면 임시 테스트 그룹에서 새 주소를 확인하세요. 중복 노드 때문에 판단이 어려워지지 않도록 확인을 마친 뒤 기존 그룹을 정리하세요.

문의 전 자가 점검 목록

효과적인 문의에는 “어느 단계에서 실패했는지, 어떤 비교 테스트를 했는지”가 드러나야 합니다. 전체 설정을 보내거나 시각과 그룹 정보가 없는 빈 목록 스크린샷만 보내지 마세요. 아래 목록은 직접 점검하거나 서비스 제공업체 및 클라이언트 지원 담당자에게 전달할 내용을 정리할 때 사용할 수 있습니다.

• 계정의 구독 권한이 유효하고, 현재 서비스 제공업체 페이지에서 링크를 가져왔으며, 이전 토큰과 관리 페이지 주소를 사용하지 않았는지 확인했습니다.
• 클라이언트 이름과 실제 버전, 운영체제, 오류 발생 시 선택한 업데이트 메뉴를 기록했습니다.
• 로그에 관련된 첫 오류가 남아 있으며 도메인, 토큰, 노드 인증 정보, 개인 정보는 숨겼습니다.
• 시간 초과, HTTP 접근 거부, 응답 파싱 실패를 구분했으며 세 가지 문제를 모두 “구독이 작동하지 않음”으로 뭉뚱그리지 않았습니다.
• 가능한 경우 직접 연결과 프록시 사용 결과를 비교했고 현재 프록시 자체가 작동하는지도 확인했습니다.
• 응답 유형과 그룹 필터를 확인했으며 업그레이드 전에 백업했습니다. 반복 설치로 유일하게 사용할 수 있는 설정을 잃지 않았습니다.

점검 순서는 주소와 권한, 다운로드 경로, 응답 형식, 클라이언트 호환성으로 정리할 수 있습니다. 앞 단계의 원인을 확인하기 전에는 뒤의 설정을 여러 개 동시에 바꾸지 마세요. 이렇게 하면 문제 범위를 좁히고 복구 후 어떤 조치가 해결에 도움이 됐는지도 확인할 수 있습니다.