v2rayNG에서 구독 업데이트가 시간 초과되거나, 업데이트 후 노드가 표시되지 않거나, 자동 업데이트 주기를 조정하려는 경우에 적용할 수 있습니다. 먼저 요청 미완료, 서버의 요청 거부, 응답 내용 파싱 실패를 구분한 뒤 링크와 직접 연결·프록시 경로, 구독 형식을 각각 점검하세요. 자동 업데이트를 설정하기 전에 수동 업데이트가 성공해야 합니다. v2rayN의 그룹별 업데이트 주기와 v2rayNG의 버전별 지원 기능은 따로 확인해야 하며, 같은 설정을 그대로 적용할 수는 없습니다.
구독 업데이트는 어느 단계에서 실패할까?
구독 주소는 노드 설정을 가져오는 경로이지 노드 서버 주소가 아닙니다. 업데이트할 때 클라이언트는 먼저 구독 서버에 요청을 보내고, 응답을 로컬 설정으로 변환합니다. 노드에 연결하는 과정은 별개입니다. 따라서 기존 노드에 연결되면서 구독 업데이트는 실패할 수 있으며, 노드 지연 시간만으로 구독 서비스의 정상 여부를 판단할 수 없습니다.
업데이트를 시도한 시간, 전체 오류 메시지, 선택한 구독 그룹을 먼저 기록하세요. 점검 중에는 한 번에 그룹 하나만 업데이트하세요. ‘모든 구독 업데이트’를 연달아 누르면 서로 다른 주소의 오류가 섞이고 서버의 요청 횟수 제한에 걸릴 수 있습니다. 현재 사용할 수 있는 설정은 유지하고, 처음부터 그룹을 삭제하거나 앱 데이터를 지울 필요는 없습니다.
- 결과가 나오지 않고 오래 걸림: 노드 프로토콜을 바꾸기보다 네트워크 경로, DNS, 연결 시간 초과를 먼저 확인하세요.
- 즉시 접근 거부 알림이 표시됨: 구독 토큰과 계정 상태, 요청 제한, 구독 주소 변경 여부를 확인하세요.
- 요청은 완료됐지만 노드가 없음: 응답이 로그인 페이지나 오류 안내인지, 클라이언트가 지원하지 않는 형식인지 확인하세요.
- 업데이트는 성공했지만 연결에 실패함: 노드 설정과 서버 상태, 라우팅을 추가로 점검하세요. 이는 구독 업데이트와는 다른 단계의 문제입니다.
구독 링크와 계정 상태 확인
v2rayNG 메인 화면에서 사이드 메뉴를 열고 ‘구독 그룹 설정’으로 이동하세요. 해당 그룹을 선택해 편집 화면을 연 다음 구독 주소를 확인합니다. 그룹 이름은 앱에서 구분하기 위한 것일 뿐, 이름이 맞다고 링크도 유효한 것은 아닙니다. 주소를 복사할 때 앞부분의 프로토콜, 물음표 뒤의 매개변수, 끝부분 문자가 모두 포함됐는지 확인하세요. 웹페이지의 버튼 문구가 함께 복사되지 않도록 주의해야 합니다.
-
기존 그룹 유지
오류가 난 그룹과 현재 선택된 노드를 먼저 기록하세요. 아직 사용할 수 있는 노드는 삭제하지 마세요. 새 주소를 시험해야 한다면 ‘구독 그룹 설정’에서 그룹을 하나 더 만들어 기존 설정을 덮어쓰지 않도록 하세요.
-
주소 다시 복사
구독 제공업체 계정 페이지에서 현재 클라이언트에 맞는 구독 링크를 다시 복사하세요. 그룹 주소 입력란에 붙여 넣은 뒤 앞뒤 공백과 줄바꿈, 누락된 매개변수가 없는지 확인하고 저장합니다.
-
계정 상태 확인
요금제 유효 기간과 남은 트래픽을 확인하고, 구독 링크를 재설정했는지도 살펴보세요. 링크를 재설정하면 이전 토큰은 보통 더 이상 유효하지 않습니다. 이 경우 네트워크를 바꾸거나 만료된 링크를 계속 재시도해도 접근 권한을 복구할 수 없습니다.
-
그룹 하나만 업데이트
메인 화면으로 돌아가 해당 구독 그룹을 선택한 다음 오른쪽 위 메뉴에서 ‘현재 그룹 구독 업데이트’를 실행하세요. 버전에 따라 ‘구독 업데이트’라고 표시될 수 있으므로, 실행 전에 선택된 그룹을 확인해야 합니다.
직접 연결과 프록시 연결로 각각 업데이트 테스트
v2rayNG의 구독 요청이 앱을 실행해 연결하기만 하면 반드시 프록시를 거친다고 단정하면 안 됩니다. 일부 버전은 메인 화면 오른쪽 위 메뉴에서 일반 업데이트와 ‘프록시를 통해’ 업데이트 명령을 따로 제공합니다. 상태 표시줄의 연결 아이콘만 보고 요청 경로를 추측하지 말고, 해당 명령을 직접 선택해 비교 테스트하세요.
| 테스트 방법 | 조작 조건 | 결과 해석 |
|---|---|---|
| 일반 업데이트 | 대상 그룹을 선택한 뒤 ‘프록시를 통해’라는 문구가 없는 업데이트 명령 실행 | 성공하면 일반 요청 경로로 구독 서비스에 접근할 수 있다는 뜻입니다. 반드시 프록시를 사용하도록 바꿀 필요는 없습니다. |
| 프록시를 통해 업데이트 | 먼저 정상 작동이 확인된 노드에 연결한 뒤 ‘프록시를 통해’라는 문구가 있는 명령 실행 | 이 방식은 성공하고 일반 업데이트는 실패한다면 두 요청 경로의 접근성에 차이가 있다는 뜻입니다. |
| 네트워크 변경 | 같은 링크를 사용해 Wi-Fi와 모바일 데이터에서 각각 테스트 | 한 네트워크에서만 실패한다면 해당 네트워크의 DNS, 인증 페이지, 접근 제한을 먼저 확인하세요. |
| 자동 시간 설정 확인 | Android ‘설정’ → ‘시스템’ → ‘날짜 및 시간’에서 자동 설정 사용 | 시간이 맞지 않으면 HTTPS 인증서 검증에 실패할 수 있습니다. 시스템 메뉴 이름은 기기에 따라 다를 수 있습니다. |
사용 가능한 노드가 하나도 없다면 ‘프록시를 통해 업데이트’를 바로 실행해도 순환 문제가 생길 수 있습니다. 업데이트해야 사용 가능한 노드를 받을 수 있는데, 업데이트 요청도 이미 작동하지 않는 노드에 의존하기 때문입니다. 이때는 먼저 일반 업데이트를 시도하거나 네트워크를 바꾸고, 구독 제공업체에 접속 가능한 주소를 문의하세요. ‘프록시를 통해’ 업데이트가 모든 시간 초과 문제의 정답은 아닙니다.
브라우저에서 구독 주소가 열린다는 것은 브라우저가 사용하는 네트워크 경로로 접근할 수 있다는 뜻일 뿐입니다. 브라우저와 클라이언트는 DNS나 프록시 설정이 다를 수 있고, 브라우저에는 로그인 상태가 남아 있을 수도 있습니다. 클라이언트는 별도의 요청을 보냅니다. 페이지에 계정 로그인 화면이 표시된다면 구독 내용이 유효하다고 볼 수도 없습니다.
오류 문구로 네트워크·권한·형식 문제 구분
오류 문구는 클라이언트 버전과 운영체제, 요청 라이브러리에 따라 달라질 수 있습니다. 아래는 로그에서 볼 수 있는 주요 문구입니다. 전체 맥락과 함께 확인하고, ‘실패’라는 문구만 보고 클라이언트를 다시 설치하지 마세요. 인증서 오류가 발생해도 검증을 끄지 말고, 먼저 시간을 바로잡거나 구독 서비스 담당자에게 문의하세요.
오류: java.net.SocketTimeoutException
원인 및 해결: 제한 시간 안에 연결 또는 데이터 읽기가 완료되지 않았습니다. 일반 업데이트와 프록시 업데이트를 각각 테스트한 뒤 네트워크를 바꿔 보세요. 다른 네트워크에서도 실패한다면 구독 서비스가 일시적으로 중단됐는지 확인하세요.
오류: java.net.UnknownHostException
원인 및 해결: 구독 주소의 호스트 이름을 확인하지 못했습니다. 도메인 철자를 확인하고, Android 네트워크 설정의 ‘비공개 DNS’에 현재 네트워크에서 접근할 수 없는 서비스가 입력되어 있는지 살펴보세요. 잠시 ‘자동’으로 바꿔 비교 테스트할 수 있습니다.
오류: HTTP 403 Forbidden
원인 및 해결: 서버가 현재 요청을 거부했습니다. 토큰이나 접속 출처 제한, 접근 정책이 원인일 수 있습니다. 구독 주소를 다시 받아 계정 상태를 확인하세요. 프록시 업데이트에서만 거부된다면 일반 업데이트도 테스트하고, 바로 클라이언트 문제라고 단정하지 마세요.
오류: HTTP 429 Too Many Requests
원인 및 해결: 요청 횟수 제한에 걸렸습니다. 연속으로 새로고침하지 마세요. 응답에 Retry-After가 표시되면 안내된 시간만큼 기다린 뒤 그룹 하나만 테스트하고, 자동 업데이트 간격도 늘리세요.
오류: javax.net.ssl.SSLHandshakeException
원인 및 해결: HTTPS 핸드셰이크에 실패했습니다. 인증서 체인이나 시스템 시간, 네트워크 중간 장비가 원인일 수 있습니다. 먼저 시간을 맞추고 네트워크를 바꿔 다시 테스트하세요. 서버 인증서 설정에 문제가 있다면 서비스 담당자가 수정해야 합니다.
서버 응답은 정상이지만 노드가 표시되지 않는다면 응답 내용의 형식을 확인하세요. 구독은 인코딩된 노드 링크 모음일 수도 있고 특정 클라이언트 전용 설정일 수도 있습니다. 파일 확장자나 텍스트 길이, 다운로드 가능 여부만으로 호환된다고 판단할 수는 없습니다. HTML 로그인 페이지나 JSON 오류 메시지도 HTTP 200으로 응답할 수 있으므로, 상태 코드가 성공이어도 가져오기가 성공한 것은 아닙니다.
- 구독 제공업체 페이지에서 v2rayNG에 맞는다고 명시된 내보내기 메뉴를 선택하세요. 계정 홈 주소를 구독 주소로 사용하지 마세요.
- 클라이언트를 최신 버전으로 업데이트한 뒤 새 설정 필드가 호환되는지 확인하세요. v2rayNG는 Xray 코어를 사용하지만 구독 다운로드와 형식 파싱도 클라이언트 버전의 영향을 받습니다.
- v2flyNG는 V2Fly 코어를 사용합니다. 모든 프로토콜 필드를 v2rayNG와 동일하게 지원한다고 가정하거나 두 앱의 메뉴를 그대로 적용하면 안 됩니다.
- 일부 노드만 누락됐다면 해당 노드의 프로토콜 종류와 오류 요약을 기록한 뒤, 내보낸 내용이 완전한지 제공업체에 문의하세요. 알 수 없는 보안 매개변수를 임의로 삭제하지 마세요.
v2rayN·v2rayNG 자동 업데이트 주기 설정 방법
자동 업데이트를 설정하기 전에 수동 업데이트가 한 번 성공하는지 확인하세요. 구독 업데이트는 노드 목록을 새로고침할 뿐, 요금제 트래픽을 늘리거나 오프라인 서버를 자동으로 복구하지는 않습니다. 아래 시간은 설정 예시이며 속도 측정 결과나 모든 버전의 기본값이 아닙니다. 서비스 제공업체가 갱신 주기를 안내했다면 해당 안내를 따르세요.
v2rayN: 구독 그룹별 주기 설정
데스크톱에서 ‘구독 그룹’ → ‘구독 그룹 설정’으로 이동해 대상 그룹을 선택하고 편집한 뒤 ‘자동 업데이트 간격’ 항목을 찾으세요. 이 항목을 제공하는 버전에서는 보통 분 단위로 설정합니다. 예를 들어 360은 6시간마다, 1440은 24시간마다 업데이트한다는 뜻입니다. 현재 화면에 표시된 단위도 확인하세요. 일반적으로 0은 예약 업데이트를 사용하지 않는다는 뜻이지, 계속 새로고침한다는 뜻이 아닙니다.
- 그룹 주소가 올바른지 확인하고 저장한 뒤 수동 업데이트를 한 번 실행하세요.
- 그룹을 다시 편집해 화면에 표시된 단위에 맞춰 업데이트 주기를 입력하고 저장하세요. ‘분’ 입력란에 시간 단위 숫자를 입력하지 마세요.
- 프록시를 사용해야 접근할 수 있다면 ‘구독 그룹’ 메뉴에서 ‘현재 구독 업데이트(프록시를 통해)’를 실행해 확인하세요. 자동 작업의 요청 방식은 현재 버전의 설정과 로그를 함께 살펴봐야 합니다.
- 프로그램을 실행한 상태로 다음 업데이트 결과를 확인하세요. 프로그램을 종료했거나 컴퓨터가 꺼져 있거나 절전 모드인 동안에는 예약 작업이 실행된다고 기대하기 어렵습니다.
v2rayNG: 자동 업데이트 메뉴 지원 여부 확인
Android에서 먼저 ‘구독 그룹 설정’을 열고 대상 그룹의 편집 화면에 자동 업데이트나 업데이트 주기 옵션이 있는지 확인하세요. 이어서 사이드 메뉴의 ‘설정’에서 구독 관련 항목을 살펴봅니다. 버전에 따라 기능과 화면이 다릅니다. 많은 버전에는 수동 업데이트만 있고 사용자가 주기를 입력하는 기본 예약 메뉴가 없습니다. 화면에 주소와 이름만 있다면 v2rayN의 분 단위 설정을 그대로 적용할 수 없으며, 모든 버전에 공통으로 적용되는 숨겨진 스위치도 없습니다.
- 주기 설정 옵션이 있는 경우: 분 또는 시간 단위를 확인해 설정하고 저장한 뒤 실제 업데이트 기록을 확인하세요. 다른 안내의 숫자를 기본값으로 간주하지 마세요.
- 주기 설정 옵션이 없는 경우: 메인 화면 메뉴에서 수동 업데이트를 실행하세요. 예약 기능이 필요하다면 없는 메뉴를 계속 찾기보다 현재 버전의 기능 안내를 먼저 확인하세요.
- 백그라운드 업데이트를 지원하지만 실행되지 않는 경우: Android ‘설정’ → ‘앱’ → ‘v2rayNG’ → ‘배터리’에서 백그라운드 사용 제한을 확인하세요. 기기 제조업체에 따라 ‘앱 배터리 관리’나 ‘백그라운드 활동’으로 표시될 수 있습니다.
- 앱이 강제 종료된 경우: 앱을 다시 열고 수동 업데이트부터 실행하세요. 백그라운드 실행을 허용해도 예약 기능이 없는 버전에 자동 업데이트 기능이 생기는 것은 아니며, 모든 기기에서 정해진 시간에 정확히 실행된다고 보장할 수도 없습니다.
구독 업데이트 자주 묻는 질문
업데이트 성공이라고 표시되는데 노드 수가 그대로인 이유는?
구독 내용이 원래 바뀌지 않았을 수 있습니다. 먼저 현재 그룹과 필터 조건을 확인한 다음 노드 이름과 주소를 비교하세요. 같은 노드 목록을 다시 가져오면 노드 수가 그대로인 것은 정상입니다. 노드 수만으로 업데이트 실행 여부를 판단할 수 없습니다.
프록시 업데이트도 시간 초과되는데 포트를 바꿔야 하나요?
선택한 노드로 실제 인터넷에 접속할 수 있는지 먼저 확인한 다음 일반 업데이트도 테스트하세요. 프록시 업데이트의 시간 초과는 노드의 출구나 구독 서비스에서 발생할 수 있습니다. 로그에 로컬 수신 포트 충돌이 명확히 표시된 경우에만 포트 설정을 확인하고, 수신 포트 값을 무작정 바꾸지 마세요.
앱을 열 때마다 업데이트가 표시되는 이유는?
현재 버전이 백그라운드 예약 작업을 지원하는지 확인한 뒤 배터리 제한을 살펴보세요. 일부 작업은 앱이 다시 실행된 후에야 처리될 수 있습니다. 원인을 확인하려면 앱을 연 뒤 표시되는 알림만 보지 말고 마지막 성공 시각과 설정한 주기, 실제 실행 시각을 기록하세요.
구독 업데이트 후 선택했던 노드가 사라지면 어떻게 하나요?
서비스 제공업체가 노드를 삭제하거나 이름을 바꿨을 수 있습니다. 해당 그룹으로 이동해 사용할 수 있는 노드를 다시 선택하세요. 직접 수정한 설정을 보존해야 한다면 별도 백업을 먼저 만드세요. 구독을 다시 업데이트하면 그룹에서 구독으로 관리되는 설정이 덮어써질 수 있습니다.
재설치하면 구독 파싱 오류가 해결되나요?
먼저 내보내기 형식과 클라이언트 버전을 확인하세요. 같은 주소에서 계속 로그인 페이지나 오류 내용이 반환된다면 재설치해도 응답은 바뀌지 않습니다. 문제를 제보할 때는 버전 번호와 오류 발생 시각, 업데이트 방식, 개인정보를 가린 로그를 제공하세요. 복구할 수 있도록 기존 설정은 보존하세요.
점검을 마친 뒤 최소한 ‘그룹 하나를 수동으로 업데이트해 성공’하고 ‘업데이트된 노드를 선택해 연결 확인’까지 진행하세요. 첫 번째는 구독 요청 경로를, 두 번째는 노드의 작동 여부를 확인합니다. 예약 업데이트를 설정했다면 다음 작업이 실제로 실행됐는지도 확인하세요. 세 항목을 따로 점검해야 구독 서비스와 클라이언트 예약 작업, 노드 연결 문제를 혼동하지 않습니다.