v2rayN과 v2rayNG에서 ‘업데이트 실패’, ‘빈 응답’, ‘파싱 후 노드 0개’ 문제가 발생했을 때 유용합니다. 먼저 다운로드·파싱·표시 단계를 구분한 뒤 구독 주소, 네트워크 방식, 응답 내용과 그룹 필터를 차례로 확인하세요. 클라이언트를 반복해서 삭제하거나 코어 설정을 무작정 변경할 필요는 없습니다.
어느 단계에서 실패했는지 먼저 확인하기
‘구독 실패’는 하나의 단일 장애가 아닙니다. 클라이언트가 구독을 업데이트하려면 네트워크 연결, 응답 수신, 콘텐츠 인식, 노드 파싱, 그룹 저장, 필터 적용의 최소 6단계를 거쳐야 합니다. 실패한 단계에 따라 해결 방법은 완전히 달라집니다.
로그에 403, 시간 초과 또는 이름 확인 실패가 표시되면 대개 응답 수신 단계의 문제입니다. 이미 ‘업데이트 완료’가 표시됐지만 새 노드 수가 0개라면 구독 본문 형식, 중복 노드 처리와 그룹 필터 조건을 계속 확인해야 합니다.
| 나타나는 현상 | 우선 확인할 항목 | 먼저 하지 말아야 할 작업 |
|---|---|---|
| 즉시 401, 403 또는 404 표시 | 주소 유효 기간, 계정 상태, 전체 쿼리 매개변수 | Core 유형 변경 |
| 10~30초 후 시간 초과 | DNS, 업데이트 시 프록시 경유 여부, 시스템 시간 | 기존 노드 일괄 삭제 |
| 다운로드 성공 후 파싱 결과 0개 | 응답 본문, 인코딩 방식, 형식 호환성 | 노드 지연 시간 반복 테스트 |
| 로그에는 가져오기 성공으로 표시되지만 목록이 비어 있음 | 현재 구독 그룹, 필터 표현식, 숨김 상태 | 클라이언트 재설치 |
구독 주소 만료·잘림·복사 오류
구독 주소는 보통 단순한 경로 하나가 아닙니다. 끝부분에 인증 매개변수, 기기 식별자 또는 유효 기간 정보가 붙을 수 있습니다. 복사할 때 문자 하나가 빠지거나 물음표 뒤의 쿼리 매개변수가 누락되거나 줄바꿈이 섞이면 서버가 접근 거부 또는 리소스 없음 응답을 반환할 수 있습니다.
채팅 창, QR 코드 인식 결과 또는 접혀서 표시되는 페이지에서 복사할 때는 보이는 부분만 가져오기 쉽습니다. 주소 중간에 공백이 있거나 끝에 마침표, 닫는 괄호 또는 중국어 문장 부호가 붙어 있다면 해당 문자가 원래 주소에 포함되는지 다시 확인하세요.
그룹 설정 열기
v2rayN 7.x 메인 화면에서 ‘구독 그룹’ → ‘구독 그룹 설정’으로 이동한 뒤 문제가 발생한 그룹을 선택하세요. 같은 이름의 그룹을 바로 새로 만들지 마세요.
주소 다시 복사하기
구독 제공처에서 전체 복사 기능을 사용하고, 주소가 유효한 HTTP 또는 HTTPS 주소로 시작하는지 확인하세요. 줄바꿈, 중국어 공백과 불필요한 문장 부호도 없어야 합니다.
기존 주소 교체하기
입력란의 기존 내용을 삭제한 뒤 붙여넣어 주소 끝에 이전 문자가 남지 않도록 하세요. 저장하기 전에 물음표 뒤의 매개변수가 모두 포함됐는지 확인하세요.
그룹 하나만 업데이트하기
먼저 현재 그룹만 업데이트하고 로그를 확인하세요. 모든 구독을 동시에 업데이트하지 마세요. 단독으로 실행하면 구체적인 오류와 응답 시점을 더 쉽게 연결할 수 있습니다.
HTTP 401 또는 403은 보통 서버가 요청을 받았지만 현재 주소에 접근 권한이 없다는 뜻입니다. 404는 경로가 변경됐거나 주소가 완전하게 복사되지 않았을 때 자주 발생합니다. 410은 해당 주소가 명시적으로 중지됐음을 의미할 수 있습니다. 이런 상태 코드가 나오면 로컬 포트와 라우팅 규칙은 우선 확인할 항목이 아닙니다.
업데이트 요청이 사용 가능한 네트워크를 거치지 않음
구독 주소 자체는 정상이어도 클라이언트 업데이트가 연결할 수 없는 직결 경로를 사용하면 시간 초과가 발생할 수 있습니다. 브라우저에서 특정 페이지가 열린다고 해서 클라이언트의 구독 요청도 같은 프록시, DNS와 네트워크 인터페이스를 사용하는 것은 아닙니다.
v2rayN에는 일반적으로 프록시를 통해 업데이트하는 방식과 프록시 없이 업데이트하는 방식이 있습니다. 현재 네트워크에서 구독 서버에 직접 연결할 수 없다면 먼저 사용 가능한 노드를 실행한 다음 프록시를 통한 업데이트를 선택하세요. 기존 노드를 모두 사용할 수 없다면 해당 주소에 접근 가능한 네트워크 환경에서 새 설정을 받아야 합니다.
오류: The operation has timed out
원인 및 해결:제한 시간 안에 응답을 받지 못해 연결이 시간 초과되었습니다. 먼저 시스템 시간이 정확한지 확인하고, 이미 사용 가능성을 검증한 노드를 실행한 뒤 ‘모든 구독 업데이트’로 변경하여 요청이 현재 프록시를 거치는지 확인하세요.
오류: No such host is known
원인 및 해결:구독 도메인이 주소로 해석되지 않았습니다. 사용 가능한 DNS로 변경하고 네트워크 연결을 끊었다가 다시 연결한 다음 클라이언트 코어를 재시작하고 업데이트하세요.
오류: The remote server returned an error: (403) Forbidden
원인 및 해결:서버가 현재 요청을 거부했습니다. 유효한 구독 주소를 다시 받고 계정 상태, 주소 유효 기간과 쿼리 매개변수가 변경되지 않았는지 확인하세요.
오류: An existing connection was forcibly closed by the remote host
원인 및 해결:전송 중 원격 서버 또는 네트워크 장비가 연결을 종료했습니다. 업데이트 방식과 네트워크 인터페이스를 바꾸고 절전 모드 해제 직후 만료된 연결을 그대로 사용하지 마세요.
로컬 리스너가 실제로 실행 중인지도 확인해야 합니다. v2rayN의 일반적인 설정에서는 10808을 로컬 SOCKS 또는 혼합 리스닝 포트로 사용하며, 오래된 설정에서는 HTTP 리스너가 10809에 있을 수도 있습니다. 실제 포트는 ‘설정’ → ‘매개변수 설정’의 로컬 리스너 항목과 시작 로그를 기준으로 확인해야 하며, 오래된 튜토리얼만 보고 입력해서는 안 됩니다.
포트를 다른 프로그램이 사용 중이면 코어가 정상적으로 시작되지 않아 현재 프록시를 통한 구독 업데이트도 불가능합니다. 먼저 하단 로그에 ‘address already in use’와 같은 메시지가 있는지 확인한 뒤 해당 프로그램을 종료하거나 리스닝 포트를 변경하고 저장 후 코어를 재시작하세요.
결론: 브라우저에서 열리는 것과 클라이언트에서 업데이트되는 것은 다릅니다
판단 기준은 클라이언트 로그에 기록된 요청 결과여야 합니다. 브라우저 확장 프로그램, 시스템 프록시와 v2rayN 내부 업데이트 요청은 서로 다른 경로를 사용할 수 있습니다. 상태 코드와 응답 길이만이 구독 요청 완료 여부를 직접 보여 줍니다.
Base64 디코딩 실패와 응답 형식 비호환
일반적인 구독 본문은 VMess, VLESS, Trojan 또는 Shadowsocks URI로 구성된 텍스트일 수 있고, 전체 텍스트를 먼저 Base64로 인코딩한 형태일 수도 있습니다. 구독 형식이 모든 서비스와 클라이언트에서 완전히 동일한 것은 아니므로 긴 문자열이라고 해서 무조건 디코딩 가능한 콘텐츠로 간주해서는 안 됩니다.
서버가 실제로 로그인 페이지, 오류 설명 또는 JSON 안내를 반환하면 클라이언트가 구독 형식으로 파싱을 시도하다가 Base64 길이 오류, 잘못된 문자 또는 노드 수 0개가 발생할 수 있습니다. 이때는 문자열에 문자를 수동으로 덧붙이지 말고 먼저 응답 내용이 무엇인지 확인하세요.
정상 점검 기록 예시
HTTP 상태: 200
응답 유형: text/plain
응답 길이: 18.6 KB
콘텐츠 특징: 노드 URI 목록 또는 전체 Base64 텍스트
파싱 결과: 24개
필터 적용 후 표시: 18개오류: Invalid length for a Base-64 char array or string
원인 및 해결:본문이 잘렸거나 인코딩에 속하지 않는 문자가 섞였거나, 애초에 반환된 내용이 Base64가 아닙니다. 구독을 다시 받아 오고 누락된 끝부분을 수동으로 이어 붙이지 마세요.
오류: Invalid URI: The format of the URI could not be determined
원인 및 해결:디코딩된 일부 행이 완전한 노드 URI가 아닙니다. 응답에 설명 문구가 섞였는지 확인하고 현재 클라이언트 버전으로 업그레이드한 뒤 다시 파싱하세요.
오류: Sequence contains no matching element
원인 및 해결:응답에서 인식 가능한 노드를 찾지 못했습니다. 서버 출력 형식이 v2rayN 또는 v2rayNG에 적합한지 확인하고 그룹 설명만 반환되고 있지는 않은지도 점검하세요.
- HTTP 200은 요청이 성공했다는 뜻일 뿐, 본문이 유효한 구독이라는 의미는 아닙니다.
- 응답 길이가 수십 바이트에 불과하면 오류 안내, 빈 그룹 또는 주소 만료를 우선 의심하세요.
- 본문 첫 부분에 웹페이지 제목이나 로그인 안내가 나타나면 계속 Base64로 처리해서는 안 됩니다.
- 단일 VMess, VLESS, Trojan 또는 Shadowsocks 링크는 수동으로 가져올 수 있지만, 이후 자동 업데이트에 필요한 구독 주소를 대신할 수는 없습니다.
- 같은 구독이 이전 버전에서는 파싱되지만 최신 버전에서는 파싱되지 않는다면 로그를 보존하고 서버가 비표준 필드를 사용하는지 확인하세요.
그룹 필터로 모든 노드가 숨겨지는 경우
구독이 정상적으로 완료된 뒤에도 목록이 비어 있다고 해서 반드시 파싱 실패는 아닙니다. v2rayN의 구독 그룹에는 포함 또는 제외 필터 조건을 설정할 수 있습니다. 노드가 저장된 뒤에도 조건에 따라 다시 필터링되므로 표현식이 지나치게 엄격하면 모든 노드가 숨겨질 수 있습니다.
예를 들어 ‘홍콩’만 포함하도록 설정했지만 실제 노드 이름에는 ‘HK’를 사용하거나, 제외 조건에 ‘남은’을 입력했는데 모든 노드 이름에 트래픽 안내가 포함되어 있거나, 필터 표현식에 불완전한 정규식 문자가 섞인 경우 최종 표시 수가 0개가 될 수 있습니다.
| 업데이트 기록 | 의미 | 다음 단계 |
|---|---|---|
| 가져오기 30개, 파싱 30개, 표시 0개 | 다운로드와 파싱은 정상이며 필터가 가장 의심됨 | 포함 및 제외 조건을 일시적으로 모두 비우기 |
| 가져오기 성공, 파싱 0개 | 본문 형식을 인식하지 못함 | 응답 내용과 인코딩 확인 |
| 파싱 20개, 신규 0개, 업데이트 20개 | 노드가 이미 존재하여 기존 기록만 업데이트됨 | 현재 표시 그룹 확인 |
| 그룹 A에는 노드가 있지만 현재 목록은 비어 있음 | 화면에서 다른 그룹을 보고 있음 | 왼쪽 구독 그룹으로 전환 |
필터 조건 기록
‘구독 그룹’ → ‘구독 그룹 설정’을 열고 먼저 현재 포함 및 제외 내용을 복사해 두세요. 점검 후 쉽게 복원할 수 있습니다.
포함 조건 비우기
지역, 배율과 프로토콜 키워드를 일시적으로 제거하고 구독 이름과 주소만 남긴 뒤 저장하고 해당 그룹만 업데이트하세요.
제외 조건 비우기
만료, 잔여 트래픽 또는 테스트 노드를 숨기는 조건을 제거하고 필터를 적용하지 않았을 때 전체 목록이 표시되는지 확인하세요.
규칙을 하나씩 복원하기
조건은 매번 하나씩만 복원하고 업데이트하면서 노드 수 변화를 기록하세요. 24개에서 0개로 줄어드는 순간 마지막으로 복원한 조건을 집중적으로 확인하면 됩니다.
v2rayNG에서도 현재 그룹과 구독 필터 상태를 확인해야 합니다. 버전에 따라 메뉴 배열은 달라질 수 있지만 원칙은 같습니다. 먼저 전체 구독 결과를 표시한 다음 키워드 필터를 하나씩 복원하세요. v2flyNG는 v2fly 코어를 사용하므로 목록이 비어 있을 때도 가져오기·파싱·표시 단계를 먼저 구분해야 합니다.
결론: 파싱 수와 표시 수를 나누어 확인하세요
로그의 파싱 수가 0보다 큰데 기본 목록이 0개라면 먼저 그룹 선택과 필터 조건을 처리하세요. 파싱 수 자체가 0일 때만 응답 형식과 인코딩을 추가로 추적하면 됩니다.
정해진 순서로 구독 복구하기
안정적인 복구 과정에서는 변수를 최대한 줄여야 합니다. DNS, 포트, 코어, 구독 주소와 필터 규칙을 한꺼번에 바꾸면 장애가 일시적으로 사라져도 실제 원인을 확인할 수 없습니다.
먼저 실행 가능한 기존 노드 하나를 남겨 두고 프록시를 통한 업데이트를 검증하세요. 그다음 구독 주소만 교체하고, 파싱 수를 확인한 뒤 필터를 복원하세요. 전체 과정에서 같은 그룹의 로그와 노드 수를 계속 관찰해야 합니다.
코어 실행 상태 확인
하단 로그에서 로컬 리스너가 시작됐는지 확인하세요. ‘설정’ → ‘매개변수 설정’으로 이동하여 Core 유형과 리스닝 포트를 점검하고 포트 사용 중 오류가 없는지 확인합니다.
사용 가능한 노드 보존
기존 노드를 모두 삭제하지 마세요. 실제 연결 테스트를 통과한 노드 하나를 선택해 현재 프록시 경로로 연결을 설정할 수 있는지 먼저 확인하세요.
그룹 하나만 업데이트
다시 받은 전체 주소를 사용해 문제가 있는 그룹만 업데이트하세요. HTTP 상태, 응답 길이, 파싱 수와 업데이트 시간을 기록합니다.
두 경로 비교
직접 연결 업데이트는 시간 초과지만 프록시 업데이트는 성공한다면 프록시 업데이트 방식을 유지하세요. 두 방식 모두 403을 반환한다면 포트를 계속 바꾸지 말고 주소 권한 문제를 해결해야 합니다.
필터 규칙 복원
필터를 적용하지 않았을 때 노드가 표시되는지 확인한 뒤 포함 및 제외 조건을 하나씩 복원하세요. 매번 업데이트 후 파싱 수와 표시 수를 대조합니다.
실제 연결 테스트
노드 하나를 선택해 실제 연결 테스트를 실행하세요. 지연 시간 결과가 나온 뒤 시스템 프록시를 켜고 자주 사용하는 사이트에 접속해 보세요. 구독 업데이트 성공만으로 노드 사용 가능 여부를 판단하지 마세요.
| 최종 결과 | 확인 가능한 결론 |
|---|---|
| 주소를 바꾼 직후 복구됨 | 기존 주소가 만료되었거나 잘렸거나 권한이 무효화됨 |
| 프록시를 통해서만 업데이트 성공 | 직접 연결 경로, DNS 또는 네트워크 인터페이스에 제한이 있음 |
| 필터를 비운 후 복구됨 | 포함 또는 제외 조건이 지나치게 엄격함 |
| HTTP 200이지만 파싱 결과는 여전히 0개 | 응답 본문 형식이 호환되지 않거나 구독 내용이 아님 |
계속 실패할 때 수집해야 할 정보
위 단계를 완료한 뒤에도 업데이트되지 않는다면 어느 단계에서 문제가 발생했는지 판단할 수 있는 정보를 정리하세요. 접근 매개변수가 포함될 수 있으므로 전체 구독 주소는 공개하지 마세요. 프로토콜, 도메인 해석 여부, HTTP 상태와 본문 길이처럼 전체 인증 정보가 드러나지 않는 항목은 기록해도 됩니다.
클라이언트 버전도 중요합니다. v2rayN, v2rayNG 또는 v2flyNG의 정확한 버전 번호와 사용 중인 Xray 또는 v2fly 코어 버전을 기록하세요. 구독 파싱은 일반적으로 클라이언트가 수행하지만 버전 차이가 필드 인식, 리디렉션 처리와 그룹 동작에 영향을 줄 수 있습니다.
- 클라이언트 이름과 전체 버전 번호(예: v2rayN 7.x의 구체적인 마이너 버전)
- 운영체제 버전과 현재 네트워크 유형
- 업데이트 명령이 프록시를 통해 실행됐는지 여부
- 오류 발생 시간, HTTP 상태 코드와 전체 오류 문구
- 응답 길이, 파싱 수, 업데이트 수와 최종 표시 수
- ‘설정’ → ‘매개변수 설정’에 표시된 Core 유형과 로컬 리스닝 포트
- 구독 그룹의 포함 조건, 제외 조건과 현재 선택된 그룹
현상: 같은 주소가 여러 기기에서 동시에 작동하지 않음
원인 및 해결:주소 만료, 계정 상태 변경 또는 서버 응답 이상을 우선 의심하세요. 유효한 주소를 다시 받고 각 기기에서 포트를 따로 변경하지 마세요.
현상: 데스크톱에서는 성공하지만 안드로이드에서는 비어 있음
원인 및 해결:두 기기의 클라이언트 버전, 구독 그룹 필터와 응답 파싱 로그를 비교하세요. 안드로이드에서 전체 주소를 사용하는지 확인하고 필터 조건을 먼저 제거한 뒤 다시 업데이트하세요.
현상: 업데이트는 성공했지만 모든 노드를 사용할 수 없음
원인 및 해결:구독 가져오기와 노드 연결은 서로 다른 단계입니다. 노드의 실제 연결을 테스트한 다음 서버 주소 해석, 시스템 시간, 전송 매개변수와 라우팅 설정을 확인하세요.
구독 업데이트가 복구된 뒤에도 웹페이지가 프록시를 거치지 않는다면 시스템 프록시와 라우팅 설정을 계속 확인하세요. v2rayN에서는 시스템 프록시 상태와 현재 활성 서버를 점검하고, 안드로이드에서는 v2rayNG 또는 v2flyNG가 연결을 시작했는지 확인한 뒤 실시간 로그에 아웃바운드 오류가 있는지 살펴보세요.