구독 업데이트에 실패하거나 그룹이 새로고침되지 않을 때, 또는 업데이트 후 노드 수가 줄었을 때는 먼저 해당 그룹만 수동 업데이트해 다운로드 실패, 콘텐츠 파싱 실패, 업데이트 후 연결 실패를 구분하세요. v2rayN과 v2rayNG 사용자는 구독 주소와 업데이트 경로를 확인한 뒤 해당 그룹의 예약 새로고침을 설정할 수 있습니다.
다운로드·파싱·연결 중 어느 단계에서 실패했는지 확인
구독 주소는 클라이언트가 노드 목록을 가져올 때 사용하는 주소이며, 목록에 있는 개별 노드의 서버 주소와는 다릅니다. 새로고침에 성공했다는 것은 클라이언트가 구독 콘텐츠를 가져와 처리했다는 뜻일 뿐, 모든 노드에 연결된다는 의미는 아닙니다. 반대로 구독 주소에 접속할 수 없어도 기존에 저장된 노드가 즉시 만료되는 것은 아닙니다. 문제를 확인할 때는 기존 목록을 유지하고, 링크 테스트를 위해 그룹을 삭제하지 마세요.
- 주소 요청 실패: 서비스 제공업체 페이지에서 구독 주소 전체를 다시 복사하고 앞뒤 공백, 줄바꿈, 쿼리 매개변수를 확인하세요. 계정 로그인 페이지, 개별 노드 공유 링크, 변환 서비스의 안내 페이지를 구독 주소 대신 사용하지 마세요.
- 요청은 성공했지만 노드가 가져와지지 않음: HTTP 200은 서버가 콘텐츠를 반환했다는 뜻일 뿐입니다. 로그인 페이지, 점검 페이지, 인증 페이지도 200을 반환할 수 있습니다. 먼저 서비스 제공업체가 클라이언트에서 가져올 수 있는 구독 형식을 제공하는지 확인하고, 그룹 필터가 항목을 제외하고 있지 않은지도 살펴보세요.
- 노드 업데이트 후 연결되지 않음: 그룹에서 새로 받은 노드 하나를 선택해 단독으로 테스트하고 연결 로그를 확인하세요. 이 경우 노드 주소, 전송 매개변수, 코어 지원 여부를 점검해야 합니다. 구독 새로고침 주기를 짧게 해도 핸드셰이크 실패는 해결되지 않습니다.
구독 오류 로그: 시간 초과·파싱·인증서 오류
오류가 발생한 그룹만 새로고침하고 클릭한 시간을 기록한 다음, 같은 시각에 표시된 클라이언트 메시지를 확인하세요. 오류 문구는 운영체제와 버전에 따라 다를 수 있으므로 아래에는 흔히 볼 수 있는 메시지와 오류명을 정리했습니다. 구독 요청 오류와 코어 실행 로그에 기록된 노드 연결 오류를 먼저 구분하세요.
java.net.UnknownHostException
원인: 요청을 보낸 쪽에서 호스트 이름을 확인하지 못했습니다. 주소가 잘못되었거나 현재 네트워크에서 도메인 조회에 실패했을 수 있습니다. 해결 방법: 먼저 구독 도메인을 확인한 뒤, 신뢰할 수 있는 다른 네트워크에서 같은 그룹을 다시 시도하세요. 노드 설정과 DNS를 동시에 변경하지 마세요.
java.net.SocketTimeoutException: timeout
원인: 연결 또는 응답 읽기에 시간이 너무 오래 걸렸습니다. 이 메시지만으로 구독이 만료됐다고 단정할 수는 없습니다. 해결 방법: 같은 구독 주소를 유지한 채 현재 네트워크에서 직접 연결하는 방법과 정상 작동이 확인된 프록시 경로를 각각 한 번씩 테스트하고, 어느 쪽에서 다운로드가 완료되는지 기록하세요.
The SSL connection could not be established, see inner exception.
원인: TLS 연결 실패를 나타내는 포괄적인 메시지입니다. 인증서 날짜, 호스트 이름, 신뢰 체인 문제는 세부 오류를 확인해야 구분할 수 있습니다. 해결 방법: 먼저 시스템 날짜와 시간, 시간대를 동기화한 다음 다시 시도하세요. 계속 오류가 나면 민감한 정보를 가린 세부 오류를 서비스 제공업체에 전달해 확인을 요청하세요. 인증서 검증은 끄지 마세요.
같은 그룹에서 두 경로 모두 401을 반환하면 먼저 링크를 바꾸세요
서비스 제공업체 페이지에서 구독 주소를 새로 발급받아 기존 그룹의 주소를 바꾸고 한 번 수동으로 새로고침하세요. 429가 반환되면 응답의 Retry-After 값이나 서비스 제공업체의 안내에 따라 기다리세요. 업데이트를 연속해서 누르면 다음 테스트 결과를 판단하기 어려워집니다.
v2rayN: 현재 구독 업데이트 및 새로고침 주기 설정
v2rayN에서는 메인 화면의 「구독 그룹」 메뉴에서 그룹을 관리하거나 같은 메뉴에서 업데이트를 실행할 수 있습니다. 아래 설명은 일반적인 중국어 UI를 기준으로 하며, 버전에 따라 메뉴 문구가 조금 다를 수 있으니 실제 메뉴와 입력란의 단위를 확인하세요. 처음 문제를 점검할 때는 현재 그룹만 업데이트해야 결과와 로그를 쉽게 대조할 수 있습니다.
그룹 주소 확인
「구독 그룹」→「구독 그룹 설정」으로 이동해 대상 그룹을 열고 이름과 구독 주소를 확인하세요. 서비스 제공업체에서 링크를 재설정했다면 기존 그룹의 주소를 바꾸고 저장하세요. 새 링크와 이전 링크를 별도의 업데이트 대상 그룹으로 남기지 않는 것이 좋습니다.
직접 연결로 업데이트 테스트
메인 화면으로 돌아가 대상 그룹을 선택한 뒤 「구독 그룹」→「현재 구독 업데이트(프록시 사용 안 함)」을 실행하세요. 메시지와 대상 그룹의 목록을 확인합니다. 일부 항목이 빠졌다면 그룹 필터 설정을 살펴보고 서비스 제공업체가 전달한 콘텐츠도 확인하세요.
프록시 연결로 업데이트 비교
직접 연결 업데이트가 시간 초과되면 기존 노드가 정상적으로 연결되고 로컬 프록시가 실행 중인지 확인한 다음, 「구독 그룹」→「현재 구독 업데이트(프록시 사용)」으로 결과를 비교하세요. 두 방법 모두 실패하면 각각의 오류를 기록하세요. 프록시 업데이트가 인증 오류나 인증서 오류를 모두 해결해 주는 것은 아닙니다.
새로고침 주기 입력
수동 업데이트가 성공하면 해당 그룹의 편집 화면으로 돌아가 「자동 업데이트 간격」 입력란을 확인하세요. 단위는 분이며
1440을 입력하면 24시간입니다. 서비스 제공업체가 더 긴 간격을 요구하면 안내에 따르세요. 저장한 뒤 클라이언트를 계속 실행해 두고 다음 주기에 업데이트 기록을 확인하세요.
수동으로 「프록시 사용」을 선택해 성공했더라도 예약 작업이 같은 업데이트 경로를 사용한다는 뜻은 아닙니다. 수동 업데이트는 성공했지만 예약 업데이트가 실패했다면 예정된 시간대의 로그를 확인해 당시 프로그램이 실행 중이었는지, 기기가 절전 상태였는지, 예약 요청에 필요한 네트워크나 로컬 프록시를 사용할 수 있었는지 살펴보세요. 그룹 콘텐츠가 바뀌지 않은 것은 정상일 수도 있으므로 노드 수만으로 새로고침 여부를 판단하지 마세요.
v2rayNG: 그룹 새로고침 및 자동 업데이트 확인
v2rayNG 메인 화면에서 사이드바를 열고 「구독 그룹 설정」으로 이동해 대상 구독을 편집한 뒤 주소와 해당 그룹이 업데이트 대상인지 확인하세요. 저장하고 노드 목록으로 돌아가 대상 그룹을 선택한 다음 오른쪽 위 「⋮」 메뉴에서 「구독 업데이트」를 누릅니다. 버전에 따라 메뉴가 적용되는 범위가 다를 수 있습니다. 현재 그룹만 업데이트하는 항목이 있으면 우선 사용하세요. 전체 업데이트만 제공되는 경우에는 결과와 그룹 목록을 확인하고 다른 그룹의 결과를 대상 그룹의 결과로 혼동하지 마세요.
- 예약 새로고침 설정: 먼저 「구독 그룹 설정」의 편집 화면에서 현재 버전에 자동 업데이트 스위치나 간격 설정이 있는지 확인하세요. 설정이 전역 스위치라면 활성화한 뒤 대상 그룹도 업데이트에 포함되는지 확인해야 합니다. 간격 입력란이 있다면 표시된 단위에 맞춰 하루에 해당하는 값(예:
24시간 또는1440분)을 입력하세요. 화면에 예약 설정이 없다면 수동으로 새로고침하세요. 데스크톱 버전의 메뉴 경로를 그대로 적용하지 마세요. - 업데이트 경로 확인: 구독 새로고침은 클라이언트의 네트워크 요청으로 이루어집니다. 시스템에 연결이 켜져 있다고 표시되더라도 그 아이콘만으로 구독 도메인이 어떤 경로를 사용하는지 알 수는 없습니다. 앱별 트래픽 분기, 현재 네트워크, 클라이언트 구현 방식이 모두 결과에 영향을 줄 수 있습니다. 비교 테스트에서는 한 번에 조건 하나만 바꾸고 같은 구독 주소를 사용하세요.
- 백그라운드 실행 확인: 앱을 열어 수동 업데이트하면 성공하지만 예약 업데이트 기록이 없다면, Android 시스템이 앱의 백그라운드 실행을 제한하는지 또는 절전·대기 중 작업을 지연하는지 확인하세요. 먼저 현재 버전이 예약 업데이트를 지원하는지 확인한 뒤 시스템 제한을 점검해야 합니다. 배터리 설정만 바꿔서는 클라이언트에 예약 업데이트 기능이 추가되지 않습니다.
자동 새로고침 주기와 결과 확인
서비스 제공업체가 권장 주기를 안내하지 않았다면 우선 24시간 간격으로 한 주기를 확인해 보세요. 장기간 안정적인 그룹은 즉시 업데이트를 위해 간격을 계속 줄일 필요가 없습니다. 여러 기기에서 같은 구독을 사용한다면 요청이 한꺼번에 몰리지 않도록 업데이트 시간을 분산하세요. 서비스 제공업체가 지정한 새로고침 주기가 이 권장 사항보다 우선합니다.
- 기준 상태 기록: 수동으로 한 번 새로고침한 뒤 그룹 이름, 성공 시간, 노드 항목 수를 기록하세요. 쿼리 매개변수에 접근 정보가 포함될 수 있으므로 구독 주소 전체를 스크린샷이나 공개 로그에 남기지 마세요.
- 다음 작업 확인: 설정한 주기가 지난 뒤 클라이언트 알림이나 업데이트 로그를 확인하세요. 콘텐츠가 바뀌지 않았더라도 요청과 파싱이 성공했다고 로그에 기록되어 있다면 간격을 줄일 필요가 없습니다. 클라이언트를 실행한 뒤에야 업데이트되는 것처럼 보인다면 작업이 실행 시점이나 절전 해제 후에 처리되는지 확인하세요.
- 상황에 맞게 설정 되돌리기: 요청 제한이 발생하면 간격을 늘리거나 자동 업데이트를 일시적으로 끄세요. 서비스 제공업체가 인증 정보 재설정을 요구하면 기존 그룹의 주소를 바꾸세요. 한 그룹만 실패한다면 먼저 해당 그룹만 수정하면 되며 다른 구독까지 다시 만들 필요는 없습니다.