구독 업데이트 실패 해결: v2rayN 자동 업데이트 설정과 주요 원인

구독 주소의 4단계 구조와 흔한 작성 오류

구독 업데이트 실패에서 가장 큰 비중을 차지하는 유형은 주소 자체가 잘못된 경우입니다. v2rayN은 구독 주소를 받으면 두 가지만 합니다. 주소로 HTTPS 요청을 한 번 보내고, 돌아온 내용을 노드 목록으로 파싱합니다. 주소에서 한 글자만 틀려도 나머지 설정은 적용될 기회조차 없습니다.

https://sub.example.com/api/v1/client/subscribe?token=8f3c1a7d&flag=v2rayn
// 구조: 프로토콜 + 도메인 + 경로 + 쿼리 파라미터(token)

// 아래 두 줄은 단일 노드 공유 링크이며 구독 주소가 아닙니다
vmess://eyJ2IjoiMiIsInBzIjoi...
vless://[email protected]:443?security=tls

• 프로토콜과 도메인: 대부분의 패널은 https를 제공하지만 일부 자체 구축 패널은 여전히 http이며, 둘을 섞어 쓸 수 없습니다.
• 경로: /api/v1/client/subscribe 형태이며 대소문자를 구분합니다. 끝에 슬래시가 하나 더 붙어도 404가 반환될 수 있습니다.
• 쿼리 파라미터: token은 서버에서 생성되며, 복사할 때 마지막 문자를 빠뜨리거나 불필요한 공백이 섞이기 쉽습니다.
• 반환 내용: 정상이라면 base64 텍스트나 원본 JSON이어야 하며, 웹 페이지가 나오면 안 됩니다.

가장 간단한 자체 점검 방법: 구독 주소를 브라우저 주소창에 붙여 넣고 Enter를 누릅니다. base64 문자열이나 JSON이 보이면 주소가 유효하고, 로그인 페이지나 404 페이지, 빈 페이지가 보이면 먼저 서비스 제공자에게 새 주소를 요청한 뒤 클라이언트 설정을 조정하세요.

구독 자동 업데이트: 간격을 6시간으로 설정하기

주소가 유효한 것을 확인했다면 다음은 업데이트 주기입니다. v2rayN의 구독 업데이트에는 두 가지 경로가 있습니다. 직접 실행하는 '구독' 메뉴와 정해진 간격에 따라 자동으로 실행되는 업데이트입니다. 간격은 파라미터 설정에 저장되며 단위는 버전에 따라 달라지므로 화면에 표시된 단위에 맞춰 입력해야 합니다.

1. 파라미터 설정 열기

   메인 화면 상단 메뉴에서 '설정' → '파라미터 설정'을 눌러 설정 창을 엽니다.

2. 구독 탭으로 이동

   설정 창 왼쪽에서 '구독'을 선택하면 오른쪽에 구독 관련 입력 항목이 나타납니다.

3. 업데이트 간격 입력

   '구독 업데이트 간격'을 6시간으로 변경합니다. 입력란이 분 단위라면 360을 입력합니다.

4. 설정 저장

   '확인'을 눌러 저장하면 설정이 로컬 설정 파일에 기록되고, v2rayN을 다시 시작해도 유지됩니다.

5. 수동으로 한 번 확인

   메인 화면으로 돌아가 '구독' → '구독 업데이트(프록시 사용 안 함)'를 누르고 하단 로그 영역에서 이번 업데이트 시간을 확인합니다.

오류 원문과 대처 방법 대조

오류 원문은 메인 화면 하단 로그 영역에 표시되며, 팝업에는 요약 한 줄만 나옵니다. 점검할 때는 로그의 전체 문장을 기준으로 삼으세요. 아래 네 가지는 구독 업데이트 상황에서 가장 자주 나타나는 원문입니다.

점검 전에 로그 영역을 먼저 비우고 '구독 업데이트'를 다시 눌러 보세요. 그러면 로그에는 요청 시간, 반환 상태, 파싱 결과를 포함해 이번 작업의 전체 기록만 남습니다.

구독 업데이트 한 번은 어떤 단계를 거칠까

이 흐름을 위의 오류들과 대조하면 실패 지점을 거의 특정할 수 있습니다. 요청 단계에서 실패하면 404, 시간 초과, 이름 확인 오류가 나오고, 다운로드 단계에서는 빈 내용이나 웹 페이지가 반환됩니다. 디코딩 단계에서는 노드 수가 예상보다 적고, 기록 단계에서는 업데이트가 성공으로 표시되지만 목록에 노드가 보이지 않습니다.

1. 요청 단계: 주소, DNS, 프록시 상태 중 하나가 맞지 않으면 로그 원문이 원인을 바로 가리킵니다.
2. 다운로드 단계: 연결은 되었지만 내용이 구독이 아닌 경우로, 주소 만료나 로그인 요구, 서버 오류 페이지 반환에서 흔합니다.
3. 디코딩 단계: 내용이 잘리거나 설명 문구가 섞이면 base64로 풀리는 노드 수가 눈에 띄게 줄어듭니다.
4. 기록 단계: 그룹에 키워드 필터를 설정해 둔 경우 걸러진 노드는 목록에 나타나지 않는데 업데이트 로그는 성공으로 표시됩니다.

시스템 시간, DNS, 프록시 상태는 어떻게 확인할까

주소와 간격에 문제가 없는데도 업데이트가 실패한다면 남은 것은 세 가지 로컬 요인입니다. v2rayN 설정 안에 있는 항목은 아니지만, 각각이 구독 업데이트를 막을 수 있습니다.

프록시 상태는 가장 헷갈리기 쉬운 항목입니다. v2rayN의 시스템 프록시는 127.0.0.1:10809를 가리키는데, 코어가 실행되지 않았거나 현재 노드가 연결되지 않으면 프록시를 거치는 구독 요청은 시간 초과가 될 때까지 계속 대기합니다. 판단 방법은 간단합니다. 같은 주소로 '구독 업데이트'는 실패하고 '구독 업데이트(프록시 사용 안 함)'는 성공한다면 문제는 구독이 아니라 프록시 경로에 있습니다.

시스템 시간도 마찬가지로 구체적입니다. 시간 오차가 몇 분 이상으로 커지면 HTTPS 인증서 검증이 먼저 실패하고, 오류 문구는 네트워크 장애처럼 보이지만 실제로는 시스템의 자동 시간 동기화만 켜면 해결됩니다.

업데이트 간격 값과 두 가지 오해

처음에 말한 6시간으로 돌아가 봅시다. 간격은 짧을수록 좋은 것도 아니고, 한 번 설정하면 영원히 손댈 필요가 없는 것도 아닙니다.

• 5분으로 설정: 하루에 거의 300번을 요청하게 되어 서버 측 요청 제한에 걸리면 오히려 업데이트 실패가 늘고, 로그에 시간 초과나 429 같은 응답이 나타납니다.
• 7일로 설정: 노드가 교체된 뒤에도 로컬 목록이 오래된 상태로 남아, 구독은 업데이트되는데 연결은 계속 실패하는 증상이 나타납니다.
• 6시간으로 설정: 하루 네 번 요청으로 최신성과 요청량을 함께 챙길 수 있습니다. 새 노드를 바로 받아야 할 때는 '구독 업데이트'를 한 번 직접 누르면 됩니다.

순서를 다시 정리하면 다음과 같습니다. 먼저 브라우저로 구독 주소를 검증하고, 다음으로 자동 업데이트 간격을 6시간으로 설정한 뒤, 마지막으로 로그 원문에 따라 시스템 시간, DNS, 프록시 상태를 처리합니다. 이 세 단계를 거치면 구독 업데이트 실패의 대부분은 구체적인 한 지점으로 좁혀집니다.