구독 업데이트가 실패하면 먼저 요청이 전송되지 않은 경우, 서버가 요청을 거부한 경우, 응답을 가져왔지만 가져오기에 실패한 경우로 나눠 살펴보세요. 이 글에서는 macOS에서 v2rayN을 사용하는 방법을 기준으로 링크, 업데이트 경로, 인증서, 콘텐츠 형식 순서로 점검하고, 분 단위 자동 업데이트 간격도 제안합니다. 기존 노드를 먼저 보존하고 구독 그룹 하나만 따로 테스트하세요. 처음부터 클라이언트를 다시 설치할 필요는 없습니다.
1. 구독 업데이트와 노드 연결은 다릅니다
구독 업데이트는 클라이언트가 구독 주소로 요청을 보내 노드 정보를 내려받아 로컬 그룹에 가져오는 과정입니다. 노드 연결은 코어가 현재 설정에 따라 원격 서버에 접속하는 과정입니다. 두 작업은 서로 관련이 있지만 동일하지 않습니다. 기존 노드는 정상적으로 연결되더라도 구독 주소에서 오류가 반환될 수 있고, 구독 다운로드가 성공해도 모든 노드를 사용할 수 있는 것은 아닙니다.
먼저 v2rayN의 로그 창을 열고 문제가 발생한 그룹만 업데이트하세요. 작업 시간, 오류 원문, 프록시를 통한 업데이트 여부, 업데이트 전후 노드 수를 기록합니다. DNS, 노드, 업데이트 방식을 한꺼번에 바꾸지 마세요. 문제가 해결되더라도 어떤 변경이 효과가 있었는지 파악하기 어렵습니다.
- 현재 상태 보존: 현재 사용할 수 있는 노드를 기록하고, 클라이언트의 내보내기 또는 백업 기능으로 설정을 저장하세요. 백업에는 인증 정보가 포함될 수 있으므로 이 기기의 안전한 위치에 보관해야 합니다.
- 그룹 확인: 「구독 그룹」→「구독 그룹 설정」으로 이동해 그룹 메모와 주소를 확인하세요. 버전에 따라 도구 모음이나 주 메뉴에 메뉴가 있을 수 있으니 실제 화면에서 같은 이름의 기능을 찾으세요.
- 그룹 하나만 재시도: 구독 그룹 메뉴에서 해당 그룹의 업데이트 작업을 선택하세요. 모든 구독을 한 번에 업데이트하면 로그가 뒤섞일 수 있습니다.
- 단계별 원인 구분: 시간 초과와 연결 거부는 네트워크 경로를 먼저 확인하세요. HTTP 상태 코드는 서버 측을 살펴보고, 다운로드는 완료됐지만 노드가 보이지 않는다면 콘텐츠 형식을 점검하세요.
2. 구독 링크 만료: 주소와 응답 상태 확인
구독 서비스 계정 페이지에서 v2rayN용 구독 주소를 다시 복사한 뒤 클라이언트에 저장된 주소와 비교하세요. 계정 관리 페이지 주소를 복사했거나, 쿼리 매개변수가 빠졌거나, 끝에 공백이 붙었거나, 이미 재설정된 이전 토큰을 계속 사용하는 경우가 흔합니다. QR 코드도 링크를 담는 방식일 뿐, 그 안의 주소가 여전히 유효하다는 보장은 없습니다.
| 응답 내용 | 우선 확인할 항목 | 다음 조치 |
|---|---|---|
| HTTP 401 | 인증 정보가 없거나 유효하지 않음 | 서비스 계정에 다시 로그인해 현재 유효한 구독 주소를 복사하세요 |
| HTTP 403 | 접근 거부 | 계정 상태, 접속 위치 제한, 클라이언트 호환 요건을 확인하세요 |
| HTTP 404 / 410 | 경로가 없거나 리소스가 삭제됨 | 전체 경로를 확인하고 서비스 제공자가 구독 주소를 변경했는지 확인하세요 |
| HTTP 429 | 요청 빈도 제한 | 반복해서 클릭하지 말고 응답의 Retry-After 안내를 따르세요 |
| HTTP 502 / 503 | 서버 또는 상위 서비스의 일시적인 오류 | 기존 설정을 보존하고 서비스가 복구된 뒤 다시 시도하세요 |
| HTTP 200이지만 가져오기에 실패 | 요청은 성공했지만 응답이 유효한 구독이라는 뜻은 아닙니다 | 로그인 페이지, 인증 페이지 또는 오류 안내가 반환됐는지 확인하세요 |
상태 코드만으로는 원인을 확정할 수 없고 범위만 좁힐 수 있습니다. 예를 들어 403은 구독 서비스나 중간 보안 계층에서 반환됐을 수 있습니다. 이를 보고 계정 만료로 단정하지 마세요. 서비스 관리 페이지에서 유효 기간과 트래픽 상태를 확인하고 응답 안내도 살펴보세요. 구독 토큰을 재설정했다면 다른 기기에 저장된 기존 주소도 새 주소로 바꿔야 합니다.
확인: 브라우저에서 열린다고 클라이언트가 가져올 수 있는 것은 아닙니다
브라우저에는 로그인 상태가 적용될 수 있고 인증 페이지가 표시될 수도 있습니다. 먼저 클라이언트가 인식할 수 있는 노드 콘텐츠가 반환되는지 확인하세요. 계정 페이지가 반환된다면 노드 매개변수를 계속 조정하지 말고 구독 주소를 다시 복사하세요.
3. 직접 연결과 프록시 업데이트: 작동하지 않는 노드에 갇히지 않기
v2rayN 구독 메뉴에는 보통 「현재 구독 업데이트(프록시 사용 안 함)」과 「현재 구독 업데이트(프록시 사용)」 두 가지 작업이 있습니다. 버전에 따라 문구는 다를 수 있습니다. 구독 도메인에 직접 접속할 수 있는 네트워크에서는 전자를, 사용 가능한 프록시를 거쳐야 구독 주소에 도달할 수 있다면 후자를 사용하세요. 같은 그룹에서 두 방식을 각각 수동으로 시험하고, 어느 한쪽을 항상 정답으로 간주하지 마세요.
가장 흔한 악순환은 현재 노드가 이미 작동하지 않는데 구독 업데이트도 그 노드를 거쳐야 하고, 노드를 복구하려면 먼저 구독을 업데이트해야 하는 상황입니다. 이때 프록시 업데이트를 반복해도 해결되지 않습니다. 연결 가능한 직접 경로를 사용하거나 로컬에 보존한 다른 사용 가능한 노드로 전환한 뒤 업데이트하세요.
- 먼저 직접 연결: 프록시를 사용하지 않는 업데이트를 선택하세요. 성공한다면 현재 네트워크에서 구독 주소에 접속할 수 있는 것이므로 일상적인 업데이트에도 이 경로를 우선 사용할 수 있습니다.
- 그다음 프록시 확인: 현재 노드로 일반 HTTPS 웹사이트에 접속할 수 있는지 확인한 뒤 프록시를 통한 업데이트를 시도하세요. 코어가 실행 중이라는 사실만으로 노드가 정상이라고 볼 수는 없습니다.
- 포트 확인: 「설정」→「매개변수 설정」으로 이동해 로컬 수신 포트와 수신 유형을 확인하세요. 화면에 SOCKS 또는 혼합 포트가
10808로 표시된다면 로그에서 해당 값과 일치하는지 확인하세요. 이 예시를 모든 버전의 기본값으로 간주하지 마세요. - 외부 네트워크 제어 확인: 직접 연결 업데이트에 여전히 문제가 있다면 TUN이나 다른 시스템 수준의 네트워크 제어가 켜져 있는지 확인하세요. 앱에서 직접 연결을 선택해도 시스템 계층에서 트래픽을 가로채는 기능까지 우회하는 것은 아닙니다.
- 작동하는 경로 하나로 정리: 사용 가능한 방법을 확인한 뒤 자동 업데이트를 설정하세요. 수동 업데이트 방식이 기억되는지는 버전에 따라 다를 수 있으므로 한 번 클릭한 설정이 계속 유지된다고 가정하지 마세요.
시스템 프록시 스위치만으로 위 테스트를 대신할 수는 없습니다. 클라이언트 내부의 구독 요청은 별도의 네트워크 설정을 사용할 수 있어 브라우저와 같은 프록시 경로를 따르지 않을 수 있습니다. 브라우저에서는 접속되지만 클라이언트에서는 안 된다면 원격 서버의 프로토콜 매개변수를 먼저 바꾸기보다 두 프로그램이 사용하는 노드, 시스템 프록시 상태, DNS 경로를 비교하세요.
4. 오류 메시지로 시간 초과·포트·인증서 문제 찾기
‘업데이트 실패’보다 오류 원문이 더 유용합니다. 아래 문구는 클라이언트 로그나 하위 요청 오류에 표시될 수 있으며, 앞뒤에 주소, 포트 또는 현지화된 설명이 붙을 수도 있습니다. 먼저 핵심 단어를 찾고 해당 단계부터 점검하세요. 구독 HTTPS 인증서와 노드 전송에 사용하는 TLS 인증서는 서로 다른 연결이므로 혼동하면 안 됩니다.
Connection refused
원인 및 해결: 대상 포트에서 연결을 거부했습니다. 대상이 로컬 주소인지 확인하세요. 127.0.0.1이라면 코어가 실행 중인지, 프록시 수신 포트가 일치하는지 확인합니다. 원격 주소라면 구독 서버 포트를 사용할 수 있는지 점검하세요.
The operation has timed out.
원인 및 해결: 제한 시간 안에 요청이 완료되지 않았습니다. 이름 확인, 연결 또는 데이터 읽기 단계에서 멈췄을 수 있습니다. 주소는 그대로 두고 직접 연결과 사용 가능한 프록시를 각각 시험하세요. 한 경로에서만 실패한다면 해당 경로부터 해결하세요.
No such host is known.
원인 및 해결: 도메인 이름을 확인하지 못했습니다. 구독 도메인 철자와 현재 네트워크의 DNS 상태를 확인하세요. 브라우저에서 정상적으로 접속된다면 브라우저가 별도의 보안 DNS를 사용하거나 프록시를 통해 이름을 확인하는지 살펴보세요.
The remote certificate is invalid because of errors in the certificate chain: NotTimeValid
원인 및 해결: 인증서 유효 기간 확인에 실패했습니다. 먼저 기기의 날짜와 시간을 맞추세요. 시간이 정확한데도 오류가 계속되면 서비스 제공자에게 구독 사이트 인증서가 만료됐거나 아직 유효 기간이 시작되지 않았는지 확인해 달라고 요청하세요.
macOS 날짜 및 인증서 확인 방법
- 「시스템 설정」→「일반」→「날짜 및 시간」을 열고 날짜와 시간 자동 설정이 켜져 있는지, 표시된 날짜가 실제와 일치하는지 확인하세요. 시간대만 변경해도 시스템 시계가 바로잡히지 않을 수 있습니다.
- 빠르게 확인하려면 터미널에서
date -u를 실행해 UTC 시간을 확인한 뒤 신뢰할 수 있는 시간 정보와 비교하세요. - 현재 네트워크에서 웹페이지 로그인 절차가 필요한지 확인하세요. 공용 네트워크의 인증 포털이 다른 페이지를 반환하면 다운로드 실패나 인증서 오류가 발생할 수 있습니다.
- 특정 구독 도메인에서만 인증서 오류가 나고 다른 HTTPS 접속은 정상이라면, 민감 정보를 가린 오류 원문을 서비스 제공자에게 전달해 인증서 체인이나 도메인 설정을 확인해 달라고 요청하세요.
5. 다운로드는 성공했지만 노드가 없음: 콘텐츠와 그룹 확인
응답을 정상적으로 받았다는 것은 다운로드 단계가 끝났다는 뜻일 뿐입니다. v2rayN이 콘텐츠를 인식해 노드를 생성하는 과정도 필요합니다. 일반적인 구독은 인코딩된 공유 링크 모음이거나 클라이언트에서 지원하는 다른 형식일 수 있습니다. 임의의 JSON, YAML, 웹페이지를 바로 가져올 수 있는 것은 아닙니다. 파일 확장자만 보고 호환성을 판단하지 말고, 서비스 제공자가 v2rayN용이라고 명시한 주소를 선택하세요.
- 응답 유형 확인: 콘텐츠가
<!DOCTYPE html>이나 로그인 양식으로 시작한다면 먼저 주소, 인증 또는 웹페이지 인증 문제를 해결하세요. 노드 인코딩 오류로 취급하지 마세요. - 계정에서 노드를 제공하는지 확인: 계정 만료, 이용 가능한 노드가 없는 요금제, 서비스 제공자의 일시적인 회선 제거 등으로 구독에서 빈 콘텐츠가 반환될 수 있습니다. 계정 관리 페이지와 서비스 안내를 확인하세요.
- 필터 조건 확인: 노드 검색창을 비우고 대상 그룹을 선택한 뒤 구독 설정의 필터 규칙을 확인하세요. 이름 필터 때문에 다운로드가 성공했는데도 표시되는 노드 수가 0일 수 있습니다.
- 클라이언트 지원 여부 확인: 일부 최신 유형의 노드만 분석할 수 없다면 v2rayN의 전체 버전 번호와 가져오기 오류를 기록한 뒤 해당 버전이 공유 형식이나 매개변수를 지원하는지 확인하세요.
- 가져오기와 연결 구분: VLESS, VMess, Trojan 등의 노드가 목록에 표시된 뒤 연결에 실패하는 것은 별도의 문제입니다. Xray나 다른 코어로 바꿔도 구독 주소에서 웹페이지가 반환되는 문제는 해결되지 않습니다.
문제를 해결할 때 구독 그룹 전체를 먼저 삭제하지 마세요. 업데이트 방식에 따라 새 콘텐츠로 기존 노드를 동기화할 수 있지만, 기존 노드의 보존 여부는 버전과 설정에 따라 달라집니다. 먼저 백업하고 별도의 테스트 그룹에서 새 링크를 확인하세요. 노드 수와 기본 연결이 정상인지 확인한 뒤 기존 주소를 교체하면 됩니다. 클라이언트를 업그레이드할 때도 현재 버전과 설정을 기록해 형식 변화와 네트워크 변화를 혼동하지 않도록 하세요.
6. 자동 업데이트 간격: 수동 업데이트가 성공한 뒤 주기를 설정하세요
자동 업데이트는 같은 요청을 정해진 시간마다 실행할 뿐, 만료된 토큰이나 인증서 오류, 연결할 수 없는 경로를 자동으로 해결하지 않습니다. 먼저 수동 업데이트가 성공하는지 확인한 뒤 「구독 그룹」→「구독 그룹 설정」에서 대상 그룹의 자동 업데이트를 수정하세요. 현재 버전에서 전역 설정에 스위치가 있다면 실제 화면에 맞게 설정하고 각 그룹에 별도의 주기가 있는지도 확인하세요.
| 사용 상황 | 권장 간격 | 설정 이유 |
|---|---|---|
| 회선이 안정적이고 일상 업무에 사용 | 720분, 즉 12시간 | 중복 요청을 줄이면서 노드 변경 사항을 주기적으로 동기화 |
| 서비스 제공자가 노드를 자주 변경 | 360분, 즉 6시간 | 동기화 대기 시간을 줄이되 서비스 제공자의 요청 빈도 제한을 준수 |
| 가끔 사용하는 예비 구독 | 1440분, 즉 24시간 | 낮은 빈도로 동기화하고 사용 전에 한 번 수동으로 확인 |
| 오류가 계속되거나 429 응답을 받음 | 자동 업데이트를 일시적으로 끄기 | 원인을 해결한 뒤 요청 제한 안내에 맞춰 주기를 다시 설정 |
이 값은 설정 권장안이며 클라이언트 기본값이나 속도 측정 결과가 아닙니다. 입력하기 전에 단위를 확인하세요. 입력란이 시간 단위라면 12시간은 12로, 분 단위라면 720으로 입력해야 합니다. 0의 의미를 임의로 추측하지 마세요. 버전에 따라 비활성화 또는 특수 동작을 뜻할 수 있으므로 화면에 명시된 스위치를 사용하세요.
설정 확인: 성공 로그 두 건으로 자동 업데이트 점검
먼저 수동 업데이트가 성공한 시간을 기록하세요. 그다음 클라이언트를 실행한 상태로 두고 컴퓨터가 잠자기 모드에 들어가지 않도록 한 뒤, 다음 예정된 주기에 성공 로그가 남는지 확인하세요. 컴퓨터를 깨운 뒤 곧바로 업데이트가 실행되지 않았다는 이유만으로 구독이 만료됐다고 판단할 수는 없습니다.
노트북이 잠자기 모드에 들어가거나 클라이언트가 종료되거나 시스템이 백그라운드 작업을 중단하면 예약 작업이 예정된 시간에 실행되지 않을 수 있습니다. 잠자기 모드에서 깨어난 뒤 작업을 보충 실행하는 방식도 버전에 따라 다를 수 있습니다. 서비스 제공자가 토큰을 재설정했거나 회선을 긴급 조정했다면 수동 업데이트를 한 번 실행하면 됩니다. 일시적인 동기화를 위해 주기를 계속 1분으로 줄일 필요는 없습니다.
7. 자주 묻는 질문: 업데이트 방식과 설정 보존
구독 업데이트 시간이 초과되면 모든 노드가 고장 난 건가요?
그렇지 않습니다. 먼저 기존 노드로 일반 HTTPS 웹사이트에 접속한 다음 구독을 별도로 업데이트하세요. 노드는 사용할 수 있지만 구독 업데이트 시간이 초과된다면 구독 도메인, 직접 연결 경로, 서비스 상태를 확인하세요. 노드 목록을 바로 비우지 마세요.
프록시 업데이트는 실패하고 직접 연결 업데이트는 성공합니다. 어떤 방식을 선택해야 하나요?
먼저 성공을 확인한 직접 연결 방식을 사용하세요. 그런 다음 현재 프록시 노드와 로컬 수신 포트를 확인합니다. 자동 업데이트에서도 같은 경로를 사용하는지는 현재 버전의 설정과 실제 로그를 기준으로 판단하세요. 시스템 프록시 스위치만 보고 결정하면 안 됩니다.
구독 링크를 다시 복사했는데 기존 노드를 먼저 삭제해야 하나요?
먼저 백업하고 서둘러 삭제하지 않아도 됩니다. 별도의 테스트 그룹을 만들어 새 주소를 확인할 수 있습니다. 노드를 가져오고 연결하는 데 문제가 없는지 확인한 다음 기존 그룹의 구독 주소를 바꾸고, 더 이상 필요하지 않은 중복 그룹을 정리하세요.
네트워크를 바꾸면 업데이트되는데 v2rayN을 다시 설치해야 하나요?
우선 다시 설치하지 마세요. 같은 구독 주소를 사용하면서 두 네트워크의 업데이트 방식과 오류 차이를 기록하고, 문제가 발생하는 네트워크의 DNS, 인증 포털, 접속 제한을 집중적으로 확인하세요. 네트워크 문제는 보통 재설치로 바뀌지 않습니다.
Android에서도 업데이트가 실패하는데 같은 순서로 확인해도 되나요?
링크, 요청 경로, 인증서, 콘텐츠 형식 순서는 그대로 적용할 수 있지만 메뉴 위치는 다릅니다. v2rayNG는 Xray 코어를 사용하고 v2flyNG는 v2fly 코어를 사용합니다. 각 앱에서 구독 형식이 지원되는지 확인하고 데스크톱의 로컬 포트나 메뉴 위치를 그대로 적용하지 마세요.
점검이 끝나면 인증 정보가 없는 간단한 기록을 남겨 두세요. 클라이언트 버전, 시스템 버전, 오류 발생 시간, HTTP 상태 코드나 오류 원문, 성공한 업데이트 경로, 자동 업데이트 주기를 적으면 됩니다. 같은 문제가 다시 생기면 모든 설정을 처음부터 바꾸기보다 가장 최근의 성공 기록과 비교하는 편이 원인을 찾기 쉽습니다.