구독 요청 시간 초과, 오류 상태 코드, 업데이트 후 노드가 표시되지 않는 문제, 예약 업데이트 미실행에 적용할 수 있습니다. 기존 노드를 유지한 채 주소, 요청 경로, 응답 내용, 자동 업데이트 조건 순으로 확인하세요. 한 번에 하나씩 변경하고 같은 그룹을 수동 업데이트해 해결 여부를 판단합니다.
먼저 구분하기: 구독 다운로드 오류인가, 노드 연결 오류인가
구독 업데이트는 클라이언트가 HTTP 또는 HTTPS 주소에 설정 목록을 요청하는 과정입니다. 노드 연결은 코어가 목록에 있는 서버 정보로 연결을 설정하는 과정으로, 서로 다릅니다. 기존 노드가 작동해도 구독 주소가 유효하다는 뜻은 아니며, 구독 업데이트에 성공해도 새 노드가 모두 연결된다는 보장은 없습니다.
오류가 발생한 단계를 먼저 기록하세요. 403이 표시되면 요청이 어떤 HTTP 서비스에는 도달한 것입니다. connection refused라면 로컬 프록시 포트에서 거부된 것인지 원격 서비스에서 거부된 것인지부터 확인하세요. 모든 오류를 ‘노드가 끊겼다’고 단정하지 마세요.
- 현재 사용할 수 있는 그룹은 유지하고 노드 수, 현재 활성 서버, 오류 발생 시간을 기록하세요. 목록을 먼저 비우지 마세요.
- 문제가 발생한 그룹 하나만 업데이트해 로그가 섞이지 않도록 하세요. v2rayN 메인 창에서 이번 구독 작업의 출력을 확인하고, 프록시 경로는 코어 로그를 추가로 살펴보세요.
- 프록시를 사용하지 않았는지, 프록시를 경유했는지 요청 방식을 기록하세요. 이후 비교할 때는 같은 주소를 사용해야 합니다.
- 오류 키워드와 상태 코드를 기록하세요. 서비스 제공자에게 문의하기 전에는 전체 구독 URL, 액세스 토큰, 계정 정보를 가리세요.
구독 주소 확인: 만료된 링크, 로그인 페이지, 형식 불일치
v2rayN에서 「구독 그룹」→「구독 그룹 설정」을 열고 대상 그룹의 구독 주소를 확인하세요. v2rayNG에서는 사이드바의 「구독 그룹 설정」으로 이동해 해당 항목의 URL을 확인합니다. 버전에 따라 메뉴 이름은 조금 다를 수 있지만, 그룹 이름과 구독 주소를 저장하는 편집 화면을 찾으면 됩니다.
서비스 제공자 계정 페이지에서 클라이언트용 구독 주소를 다시 복사하세요. 앞뒤 공백, 줄바꿈, 한글 따옴표가 없고 채팅 앱에서 매개변수가 잘리지 않았는지 확인합니다. 구독 주소에는 액세스 정보가 포함되는 경우가 많습니다. 인증 정보를 재설정했다면 기존 주소는 비슷해 보여도 바로 만료될 수 있습니다.
| 확인된 내용 | 가능한 의미 | 다음 단계 |
|---|---|---|
| HTTP 401 / 403 | 인증 정보가 잘못되었거나 권한이 없거나 게이트웨이가 요청을 거부한 상태 | 계정 상태와 새 구독 주소를 확인하세요. 계속 실패하면 요청 출처에 제한이 있는지 문의하세요. |
| HTTP 404 / 410 | 경로가 없거나 기존 주소가 폐기된 상태 | 계정 페이지에서 주소를 다시 받아 사용하세요. URL 경로를 임의로 추측하지 마세요. |
| HTTP 429 | 요청 빈도가 제한된 상태 | 연속 재시도를 멈추고 서버 안내에 따라 기다린 뒤 업데이트 간격을 늘리세요. |
| HTTP 200이지만 파싱 실패 | 로그인 페이지나 인증 화면, 호환되지 않는 설정 형식이 반환되었을 수 있습니다. | 응답 형식을 확인하고 현재 클라이언트에 맞는 구독 형식을 선택하세요. |
| 업데이트 성공으로 표시되지만 새 노드가 0개 | 구독 내용이 비어 있거나 변경되지 않았거나 항목을 파싱하지 못했을 수 있습니다. | ‘추가된 노드’ 수만 보지 말고 업데이트 전후의 전체 노드 수와 로그를 비교하세요. |
직접 연결과 프록시 경유 업데이트: 같은 주소로 비교하기
v2rayN의 「구독 그룹」 메뉴에는 보통 「현재 구독 업데이트(프록시 미사용)」, 「현재 구독 업데이트(프록시 사용)」 같은 항목이 있으며, 전체 구독을 업데이트하는 메뉴가 따로 있을 수도 있습니다. 먼저 대상 그룹을 선택한 뒤 두 방식을 각각 한 번씩 테스트하세요. 시스템 프록시 설정과 구독 메뉴의 다운로드 방식은 별개이므로 작업 표시줄 아이콘만 보고 요청 경로를 판단하지 마세요.
- 직접 연결은 실패하고 프록시 경유는 성공: 우선 프록시 경유 업데이트를 사용하고, 로컬 네트워크에서 구독 도메인을 확인하고 접속할 수 있는지 점검하세요.
- 직접 연결은 성공하고 프록시 경유는 실패: 먼저 활성 노드나 로컬 프록시 리스너를 점검하세요. 구독 서비스가 프록시 출구 IP를 제한할 수도 있습니다.
- 두 방식 모두 같은 403을 반환: 우선 구독 권한과 서버 규칙을 확인하세요. 로컬 포트를 계속 바꿔도 대개 해결되지 않습니다.
- 두 방식 모두 시간 초과: 네트워크, 도메인 해석, 서버 상태를 확인한 뒤 서비스 제공자에게 문의할지 결정하세요.
v2rayNG에서는 먼저 사용 가능한 설정을 하나 실행한 다음 메인 화면 오른쪽 위 메뉴에서 「구독 업데이트」를 선택하세요. 현재 버전에 프록시 경유 업데이트 옵션이 있다면 설정 상태를 기록합니다. 별도 옵션이 없다면 데스크톱 메뉴와 동일하게 적용할 수 없습니다. Android의 VPN 연결 표시만으로 구독 요청이 원격 노드를 경유한다고 단정할 수도 없습니다.
결론: 우선 업데이트가 가능한 경로 하나를 복구하세요
직접 연결로 업데이트할 수 있다면 우선 직접 연결을 사용하세요. 프록시 경유로만 가능하다면 사용할 수 있는 노드를 최소 하나 유지하세요. 기존 그룹을 삭제한 뒤 테스트하면 구독 주소와 다운로드에 필요한 프록시 연결을 동시에 잃을 수 있습니다.
오류 키워드: 시간 초과, 인증서, 도메인 해석, 포트 충돌
시스템과 클라이언트에 따라 오류 문구가 다를 수 있습니다. 아래는 흔히 보이는 저수준 오류 메시지입니다. 원인을 찾을 때는 대상 주소와 앞뒤 로그도 함께 확인하세요. 키워드 하나만 보고 모든 네트워크 설정을 바꾸면 안 됩니다.
connection refused
원인 및 해결 방법: 대상 포트가 연결을 거부했습니다. 대상이 127.0.0.1이라면 로컬 코어가 실행 중인지, 프록시 포트가 일치하는지 먼저 확인하세요. 원격 주소라면 서버 포트와 서비스 상태를 점검하세요.
context deadline exceeded
원인 및 해결 방법: 제한 시간 안에 요청이 완료되지 않았습니다. 직접 연결과 프록시 경유 업데이트를 비교해 연결, TLS 핸드셰이크, 응답 읽기 중 어디서 멈추는지 확인하세요. 시간 초과만 늘려서는 만료된 링크를 복구할 수 없습니다.
no such host
원인 및 해결 방법: 도메인을 확인하지 못했습니다. 구독 도메인 철자를 확인하고 기기가 네트워크에 연결되어 있는지 점검하세요. 코어 로그에 표시된 노드 도메인 문제라면 활성 노드를 확인해야 하며, 구독 주소부터 바꿀 필요는 없습니다.
x509: certificate has expired or is not yet valid
원인 및 해결 방법: 인증서 유효 기간을 확인하지 못했습니다. 먼저 기기의 날짜, 시간, 시간대를 맞추세요. 시간이 정확하다면 서비스 제공자에게 인증서를 확인해 달라고 요청하세요. 인증서 검증을 끄는 방식으로 문제를 우회하지 마세요.
address already in use
원인 및 해결 방법: 로컬 수신 포트가 이미 사용 중입니다. 중복 실행된 클라이언트를 종료하거나 수신 포트를 변경하세요. 코어가 정상적으로 시작된 것을 확인한 뒤 프록시 경유 업데이트를 테스트합니다.
로컬 포트 확인 예시
「설정」→「매개변수 설정」에서 로컬 수신 포트를 10808로 지정했다고 가정하고 Windows 터미널에서 아래 명령을 실행하세요. 이 포트는 문제 해결을 위한 예시이므로 현재 클라이언트에 표시된 값으로 바꿔야 합니다. HTTP, SOCKS 또는 혼합 수신 방식도 현재 설정을 따르세요.
netstat -ano | findstr ":10808"로컬 주소와 상태가 LISTENING인 항목을 찾아 마지막 열의 PID를 기록한 뒤 작업 관리자의 「세부 정보」에서 프로세스를 확인하세요. 현재 코어가 포트를 수신 중인 것은 정상입니다. 다른 프로세스가 같은 주소와 포트를 사용하고 있을 때만 조치하면 됩니다. 포트 번호만 보고 프로세스를 종료하지 말고, 버전마다 자주 쓰는 포트를 고정된 기본값으로 간주하지 마세요.
자동 업데이트 설정: v2rayN과 v2rayNG를 각각 확인하기
먼저 수동 업데이트를 한 번 완료한 뒤 예약 업데이트를 설정하세요. 자동 업데이트는 일정에 따라 다운로드를 반복할 뿐 403, 잘못된 주소, 호환되지 않는 형식을 해결하지 않습니다. 설정할 때는 시간 단위를 꼭 확인하세요. 분과 시간은 60배 차이가 납니다.
| 클라이언트 | 확인할 위치 | 설정 및 확인 방법 |
|---|---|---|
| v2rayN | 「구독 그룹」→「구독 그룹 설정」→ 대상 그룹 편집 | 「자동 업데이트 간격(분)」 또는 비슷한 항목을 찾으세요. 예를 들어 6시간마다 업데이트하려면 분 단위 항목에 360을 입력합니다. |
| v2rayNG | 사이드바의 「구독 그룹 설정」에서 대상 그룹을 편집하고, 사이드바 「설정」에 구독 업데이트 옵션이 있는지도 확인하세요. | 현재 버전에 자동 업데이트 스위치와 간격 항목이 있는지 확인하세요. 단위가 시간이라면 6시간 간격은 6으로 입력해야 합니다. 데스크톱의 360을 그대로 입력하면 안 됩니다. |
| 예약 업데이트 옵션이 없는 버전 | 그룹 편집 화면과 설정 화면에서 관련 항목을 찾을 수 없는 경우 | 메인 화면의 「구독 업데이트」를 수동으로 사용하거나, 먼저 버전 안내를 확인한 뒤 업그레이드 여부를 결정하세요. |
일반적으로 v2rayN은 그룹별로 자동 업데이트 간격을 저장합니다. 한 그룹을 설정해도 다른 그룹까지 자동 업데이트가 활성화되는 것은 아닙니다. 항목 설명에서 0이 사용 안 함을 뜻한다면 0보다 큰 간격을 입력하고 저장하세요. 화면에 별도의 활성화 스위치가 있으면 그것도 켜야 합니다. 비활성화 값과 실행 시점은 현재 버전의 안내를 따르세요. 모든 버전이 저장 즉시 업데이트를 시작한다고 가정하지 마세요.
v2rayNG의 예약 업데이트 기능과 메뉴 위치는 버전마다 다릅니다. 「업데이트 허용」처럼 그룹을 업데이트 대상에 포함하는 옵션을 자동 업데이트 스위치로 착각하지 마세요. 화면에 예약 기능이 명시된 경우에만 스위치와 간격을 설정하세요. 해당 항목이 없다면 모든 버전에 공통으로 적용되는 숨겨진 설정 경로도 없습니다.
- 간격: 우선 6~12시간, 즉 360~720분으로 설정할 수 있습니다. 이는 설정 권장값이며 소프트웨어 기본값은 아닙니다. 서비스 제공자가 요청 빈도를 지정했다면 해당 안내를 우선 따르세요.
- 데스크톱 실행 조건: 클라이언트를 실행 상태로 유지하세요. 프로그램을 종료하거나 기기가 절전 모드인 동안에는 예정된 시간에 계속 다운로드할 수 없습니다. 기기를 다시 켠 뒤 최근 업데이트 기록을 확인하세요.
- Android 백그라운드 조건: 시스템 「설정」→「앱」→「v2rayNG」에서 배터리 및 백그라운드 데이터 제한을 확인하세요. 메뉴 이름은 기기마다 다를 수 있습니다. 제한을 해제해도 백그라운드 작업이 분 단위로 정확하게 실행되는 것은 아닙니다.
- 결과 확인: 다음 예정 주기가 지난 뒤 업데이트 시각, 로그, 노드 수를 확인하세요. 확인할 기록이 없다면 수동 업데이트로 네트워크 경로를 점검하세요. 노드 순서가 그대로라는 이유만으로 실패라고 판단하지 마세요.
자주 묻는 질문: 업데이트에 성공했는데 변화가 없을 때
업데이트 성공으로 표시되는데 왜 기존 노드만 보이나요?
서버에서 새 목록을 제공하지 않았을 수 있습니다. 선택한 그룹과 업데이트 로그를 먼저 확인하고 전체 노드 수를 비교하세요. ‘새 노드 0개’가 반드시 실패를 뜻하지는 않습니다. 새 항목이 숨겨지지 않도록 검색창, 그룹 필터, 정렬 설정도 확인하세요.
기존 노드가 모두 끊겼고 프록시로만 구독을 가져올 수 있으면 어떻게 하나요?
서비스 제공자에게 직접 연결할 수 있는 구독 주소나 임시로 사용할 설정을 요청하세요. 기존 그룹은 유지하고 삭제 후 재생성을 반복하지 마세요. 사용할 수 있는 아웃바운드가 하나도 없다면 ‘프록시 경유 업데이트’를 켜도 연결을 만들 수 없습니다.
구독 주소를 바꿨는데 자동 업데이트 오류가 계속되는 이유는 무엇인가요?
그룹 편집 화면을 다시 열어 새 주소가 저장되었는지 확인하고, 같은 이름의 기존 그룹이 남아 있는지도 살펴보세요. 새 그룹만 따로 수동 업데이트해 성공한 뒤 해당 그룹의 자동 업데이트 간격을 확인하세요.
업데이트 후 노드 지연 시간은 측정되는데 웹페이지가 열리지 않습니다. 구독 문제인가요?
지연 시간 테스트는 해당 테스트 경로의 일부 연결이 가능하다는 것만 보여줍니다. 먼저 활성 서버와 시스템 프록시 또는 VPN 상태를 확인한 뒤 라우팅과 DNS를 점검하세요. 구독 파싱에 성공했다면 연결 문제를 살펴봐야 합니다. 같은 목록을 계속 다시 다운로드하지 마세요.
문제 해결 후 보관할 기록
문제를 재현하는 데 필요한 최소한의 정보만 남겨 두세요. 같은 문제가 다시 발생하면 모든 설정을 새로 조정하는 것보다 기존 기록과 비교하는 편이 효과적입니다. 구독 주소는 액세스 정보이므로 기록에는 도메인만 남기고 토큰 전체를 저장하지 마세요.
- 클라이언트 이름과 버전, 시스템 버전, 오류 발생 및 복구 시각
- 성공한 업데이트 방식: 직접 연결 또는 프록시 경유. 프록시를 사용했다면 활성 설정 이름도 기록하세요.
- 마지막 오류 키워드, HTTP 상태 코드, 해결 조치, 업데이트 후 전체 노드 수
- 그룹별 자동 업데이트 스위치, 간격과 단위, 기기의 절전 또는 백그라운드 제한 상태
안정화된 뒤에는 필요한 업데이트 주기만 유지하세요. 여러 기기에서 같은 구독을 사용한다면 업데이트 시각을 분산하세요. 서비스 제공자가 구독 인증 정보를 재설정했다면 기기마다 주소를 변경해야 합니다. 클라이언트 설치와 기본 프록시 설정은 사이트의 입문 가이드를 참고할 수 있습니다.