구독을 가져왔지만 업데이트 시간 초과, 인증서 오류 또는 노드 가져오기 실패가 발생한 경우에 적합한 안내입니다. 먼저 로그를 확인해 주소·네트워크·파싱 문제를 구분하고, 같은 구독을 직접 연결과 프록시 연결로 각각 업데이트해 보세요. 마지막으로 자동 업데이트 간격을 설정하면 됩니다. 문제를 해결하는 동안 기존 노드를 유지하고, 그룹을 먼저 삭제하거나 인증서 검증을 끄는 방식으로 오류를 우회하지 마세요.
1. 구독 업데이트가 어느 단계에서 실패하는지 확인
구독 업데이트는 클라이언트가 구독 주소에 요청을 보내고, 내용을 내려받아 노드 목록으로 파싱하는 과정입니다. VMess 또는 VLESS 노드 연결을 테스트하는 것도, Xray 코어를 업데이트하는 것도 아닙니다. 기존 노드에 연결할 수 있더라도 해당 노드의 연결 경로가 여전히 작동한다는 뜻일 뿐, 현재 구독 서버에 접속할 수 있다는 의미는 아닙니다.
먼저 메인 화면의 정보 또는 로그 영역을 열고 그룹 하나만 업데이트하세요. 오류가 발생한 시간, 선택한 업데이트 방식, 오류 전후의 로그 몇 줄을 기록합니다. DNS 변경, 노드 전환, 구독 주소 변경을 한꺼번에 하지 마세요. 문제가 해결되더라도 어떤 변경이 효과가 있었는지 알 수 없습니다. 아래 오류 문구는 단계별 구분을 위한 예시이며, 실제 문구는 실행 환경과 클라이언트 버전에 따라 다를 수 있습니다.
오류: No such host is known
원인: 구독 도메인을 확인하지 못했습니다. 주소 오타, 도메인 만료 또는 현재 DNS에서 도메인을 확인할 수 없는 경우일 수 있습니다.
해결: 먼저 서비스 제공자 사이트에서 주소를 다시 복사하고 도메인을 확인하세요. 그런 다음 시스템 DNS와 현재 네트워크를 점검합니다. 노드 프로토콜 설정은 바로 변경하지 마세요.
오류: The operation has timed out
원인: 제한 시간 안에 요청이 완료되지 않았습니다. 연결, 프록시 전달 또는 서버 응답 단계에서 지연됐을 수 있습니다.
해결: 같은 그룹에서 프록시를 사용하지 않는 업데이트와 프록시 업데이트를 각각 테스트하세요. 프록시로 업데이트하려면 먼저 실제로 작동하는 노드를 선택해야 합니다.
오류: The SSL connection could not be established
원인: TLS 연결을 설정하지 못했습니다. 내부 예외를 추가로 확인해 인증서, 프로토콜 협상 또는 연결 중단 문제인지 구분해야 합니다.
해결: 먼저 시스템 시간을 맞춘 다음 인증서의 유효 기간과 도메인 일치 여부를 확인하세요. 이 오류 한 줄만으로 구독이 만료됐다고 단정하지 마세요.
2. 링크 오류와 HTTP 상태 코드: 구독 그룹 설정부터 확인
「구독 그룹」→「구독 그룹 설정」을 열고 오류가 발생한 그룹의 구독 주소를 확인하세요. 화면에 따라 그룹을 두 번 클릭하거나 편집 버튼을 눌러 수정할 수 있지만, 확인할 곳은 해당 그룹의 URL 입력란입니다. 서비스 제공자가 안내한 전체 구독 주소를 복사해야 합니다. 계정 로그인 페이지, 요금제 안내 페이지 또는 브라우저 주소창에 표시된 관리 패널 주소를 사용하면 안 됩니다.
- 주소를 다시 복사하세요: 경로와 쿼리 매개변수를 그대로 두고 앞뒤 공백, 줄바꿈, 메신저에서 붙은 문장부호가 있는지 확인합니다. 무작위 문자열처럼 보이는 토큰을 임의로 삭제하지 마세요.
- 계정 상태를 확인하세요: 요금제 만료 여부, 구독 토큰 재발급 여부, 서비스 제공자의 구독 도메인 이전 여부를 확인합니다. 클라이언트를 다시 시작해도 이전 주소가 복구되지는 않습니다.
- 대상 그룹만 수정하세요: 기존 주소를 기록한 뒤 새 주소로 바꾸고 저장한 다음 해당 그룹만 수동 업데이트합니다. 기존 노드는 당분간 삭제하지 마세요.
- 주소 문제와 형식 문제를 구분하세요: 요청은 성공했지만 노드가 표시되지 않는다면 서비스 제공자가 v2rayN에서 사용할 수 있는 구독 형식을 제공하는지 확인하세요. 아무 설정 파일이나 노드 구독으로 사용할 수 있는 것은 아닙니다.
| 응답 결과 | 우선 확인할 사항 | 다음 조치 |
|---|---|---|
| HTTP 401 | 인증 정보 누락, 토큰 만료 또는 인증 방식 변경 | 서비스 제공자 사이트에 로그인해 새 전체 구독 주소를 가져옵니다 |
| HTTP 403 | 접근 정책, 계정 권한 또는 외부 IP 제한 | 계정 상태를 확인하고 직접 연결과 프록시 연결의 외부 IP를 비교합니다 |
| HTTP 404 / 410 | 이전 경로 또는 삭제된 구독 메뉴 | 관리 페이지에 안내된 최신 주소를 확인합니다. 경로를 임의로 추측하지 마세요 |
| HTTP 429 | 요청 횟수 제한에 걸림 | 연속으로 다시 시도하지 말고 응답 내용이나 서비스 제공자의 안내에 따라 기다린 뒤 재시도합니다 |
| HTTP 5xx | 구독 서비스 또는 상위 서버 장애 | 기존 노드를 유지하고 잠시 후 다시 시도하거나 서비스 제공자 공지를 확인합니다 |
| HTTP 200이지만 파싱 실패 | 로그인 페이지, 인증 페이지, 빈 내용 또는 호환되지 않는 형식이 반환됨 | 상태 코드만 보지 말고 응답 내용 형식과 구독 형식을 확인합니다 |
확인 방법: HTTP 상태 코드가 반환되면 노드 프로토콜보다 응답 내용을 먼저 확인
401, 403 또는 404 응답을 받았다면 서버가 요청에 응답한 것입니다. 먼저 주소, 권한, 반환된 내용을 확인하세요. VMess, VLESS 또는 노드 전송 설정부터 살펴볼 필요는 없습니다.
구독 링크에는 계정 토큰이 포함되는 경우가 많으므로 비밀번호처럼 취급하세요. 공개 게시판이나 낯선 온라인 변환 사이트에 올리지 마세요. 로그를 공유할 때는 전체 URL, 쿼리 매개변수, 노드 인증 정보를 가려야 합니다. 응답 내용을 확인할 때도 로컬에서 확인하고, 브라우저에 표시된 개인 구독 내용을 캡처해 공개하지 마세요.
3. 네트워크 시간 초과: 직접 연결과 프록시 업데이트 비교
브라우저에서 서비스 제공자의 홈페이지가 열린다고 해서 구독 주소에도 접속할 수 있는 것은 아닙니다. 홈페이지와 구독 API는 도메인이나 접근 정책이 다를 수 있고, 브라우저에서 별도 프록시를 사용 중일 수도 있습니다. v2rayN의 구독 요청이 프록시를 사용하는지는 구독 업데이트 작업의 옵션을 기준으로 확인하세요. 시스템 프록시 설정만으로 판단해서는 안 됩니다.
- 먼저 프록시 없이 테스트하세요: 「구독 그룹」 메뉴에서 해당 그룹의 ‘프록시를 사용하지 않고 업데이트’ 항목을 선택해 현재 그룹만 업데이트합니다. 시간 초과, 주소 확인 실패, HTTP 상태 코드 반환 중 어떤 결과인지 기록하세요.
- 프록시 노드가 작동하는지 확인하세요: 기존 노드 중 실제로 인터넷에 접속할 수 있는 노드를 선택하고 코어가 실행 중인지 확인합니다. 목록에 노드가 있거나 테스트 결과가 표시된다고 해서 구독 요청까지 반드시 완료되는 것은 아닙니다.
- 이어서 프록시로 테스트하세요: ‘프록시를 사용해 업데이트’ 항목을 선택하고 같은 주소의 결과를 비교합니다. 일부 버전에서는 업데이트 메뉴에 방식 선택이 모여 있으므로 실제 화면의 항목명을 확인해 선택하세요.
- 네트워크 변수를 분리하세요: 두 방식 모두 실패하면 권한이 허용되는 범위에서 다른 네트워크로 전환해 테스트할 수 있습니다. 매번 조건 하나만 바꾸고 라우팅과 DNS를 동시에 조정하지 마세요.
로컬 포트도 실제 설정을 기준으로 확인해야 합니다. 예를 들어 이 컴퓨터의 프록시 수신 포트가 10808인데 다른 프로그램은 10809를 가리킨다면 같은 진입점을 사용하는 것이 아닙니다. 이는 포트 불일치의 예시일 뿐, 특정 기본값으로 통일하라는 뜻은 아닙니다. 「설정」→「매개변수 설정」에서 로컬 수신 관련 항목을 확인하고 로그를 통해 포트가 정상적으로 수신 중인지 점검하세요. 포트 충돌이나 코어 종료도 프록시 업데이트 실패의 원인이 될 수 있습니다.
- 직접 연결은 실패하고 프록시는 성공한 경우: 작동하는 노드를 유지하고 이후에는 프록시로 업데이트하세요. 구독 그룹의 자동 작업에서 어떤 업데이트 방식을 사용하는지도 확인합니다.
- 직접 연결은 성공하고 프록시는 실패한 경우: 현재 노드, 프록시 포트, 외부 연결 제한을 확인하세요. 구독 주소를 서둘러 바꿀 필요는 없습니다.
- 두 방식 모두 시간 초과인 경우: 구독 도메인, 서비스 상태, 현재 네트워크를 확인한 다음 DNS 변경을 고려하세요.
- 두 방식에서 같은 인증 오류가 반환되는 경우: 프록시 노드를 계속 바꾸기보다 계정이나 토큰 문제를 먼저 해결하세요.
4. 인증서 오류: 시스템 시간을 맞춘 뒤 TLS 인증 체인 확인
HTTPS 구독은 서버 인증서를 검증합니다. 시스템 날짜가 맞지 않으면 정상 인증서도 ‘아직 유효하지 않음’ 또는 ‘만료됨’으로 판단될 수 있습니다. 서버 인증서 만료, 도메인 불일치, 불완전한 인증서 체인도 연결을 차단합니다. 브라우저와 클라이언트는 서로 다른 신뢰 환경을 사용할 수 있으므로 브라우저에서 열린다는 사실만으로 판단하지 말고 클라이언트 로그를 확인하세요.
- 시스템 시간을 확인하세요: Windows에서는 「설정」→「시간 및 언어」→「날짜 및 시간」으로 이동해 시간대와 자동 시간 설정을 확인하고 ‘지금 동기화’를 실행하세요. 완료한 뒤 구독 업데이트를 다시 시도합니다.
- 구독 도메인을 확인하세요: HTTPS 주소에 포함된 도메인을 IP 주소로 직접 바꾸지 마세요. 인증서는 보통 도메인에 발급되므로 IP로 변경하면 이름 불일치 오류가 발생할 수 있습니다.
- 네트워크 인증 상태를 확인하세요: 공용 네트워크에서 먼저 로그인해야 한다면 네트워크 인증을 완료하세요. 인증 페이지로 리디렉션된 요청은 인증서 오류나 HTML 페이지 반환으로 나타날 수 있습니다.
- 조직 네트워크 정책을 확인하세요: 관리 대상 기기는 조직의 인증서를 통해 HTTPS를 검사할 수 있습니다. 관리자에게 신뢰 설정을 확인하고, 출처가 불분명한 루트 인증서는 설치하지 마세요.
- 서버 측 문제인지 확인하세요: 이 컴퓨터의 시간이 정확하고 다른 네트워크에서도 같은 인증서 오류가 발생한다면 오류 상세 내용과 발생 시간을 서비스 제공자에게 전달하세요.
오류: RemoteCertificateNameMismatch
원인: 요청한 호스트 이름과 서버 인증서의 이름이 일치하지 않습니다. 주소가 잘못됐거나 비정상적인 리디렉션이 발생했을 수 있습니다.
해결: 서비스 제공자가 안내한 HTTPS 구독 도메인을 다시 확인하세요. IP 주소로 바꾸거나 인증 검증을 꺼서 문제를 우회하지 마세요.
오류: RemoteCertificateChainErrors
원인: 인증서 체인 검증에 실패했습니다. 유효 기간, 누락된 중간 인증서 또는 신뢰할 수 없는 발급 기관이 원인일 수 있습니다.
해결: 먼저 시스템 시간을 동기화하고 시스템의 신뢰 환경을 업데이트하세요. 해당 구독 도메인에서만 문제가 발생하면 서비스 제공자에게 인증서 설정을 점검해 달라고 요청합니다.
노드 설정의 ‘인증서 검증 건너뛰기’는 해당 노드의 연결에 적용되는 옵션이지, HTTPS 구독 다운로드를 고치는 공통 설정이 아닙니다. 구독 주소를 HTTP로 낮추면 전송 보호도 사라지므로 장기적인 해결책으로 사용할 수 없습니다. 올바른 순서는 시간, 도메인, 신뢰 체인을 확인한 뒤 서버 측에서 인증서를 수정하는 것입니다.
5. 자동 업데이트 간격과 프록시 방식 설정
수동 업데이트가 성공한 다음 자동 작업을 설정하세요. 「구독 그룹」→「구독 그룹 설정」으로 이동해 대상 그룹을 편집하고 자동 업데이트 간격 및 해당 버전에서 제공하는 프록시 업데이트 옵션을 확인합니다. 버전에 따라 항목 위치와 단위, 자동 작업 방식이 다를 수 있습니다. ‘프록시로 업데이트’를 한 번 수동 실행했더라도 자동 작업에 같은 방식이 적용된다고 볼 수는 없습니다.
- 단위를 확인한 뒤 숫자를 입력하세요: 입력란의 단위가 분이면 6시간은
360, 시간이라면6으로 입력합니다. 단위 환산 예시이며 실제 간격은 서비스 제공자의 안내를 따르세요. - 비활성화 값의 의미를 확인하세요:
0을 ‘계속 업데이트’로 해석하지 마세요. 비활성화를 뜻하는지는 현재 입력란의 안내를 확인해야 합니다. 자동 업데이트를 사용하려면 화면에서 유효한 양수를 설정하세요. - 프록시 정책을 확인하세요: 그룹 편집 화면에 ‘프록시로 업데이트’ 옵션이 있다면 테스트에서 성공한 방식으로 설정하고 저장하세요. 해당 버전에 업데이트 메뉴 옵션만 있다면 메뉴를 눌러 본 결과만으로 추측하지 말고 자동 작업의 실제 설정과 로그를 확인합니다.
- 저장 후 작업 실행 여부를 확인하세요: 저장 시간을 기록하고 클라이언트가 계속 실행 중이며 네트워크를 사용할 수 있는 상태에서 이후 로그를 확인합니다. 클라이언트가 종료되거나 기기가 절전 모드인 동안에는 데스크톱 프로그램이 작업을 계속 실행할 것으로 기대할 수 없습니다.
- 재시도 횟수를 제한하세요: 429 오류 또는 명확한 요청 제한이 표시되면 연속 재시도를 중단하세요. 여러 기기에서 같은 구독을 사용하는 경우 각 기기에서 발생하는 요청이 누적될 수 있습니다.
설정 원칙: 먼저 한 번 성공시킨 뒤 주기 작업을 켜세요
같은 그룹에서 ‘유효한 주소, 작동하는 업데이트 방식, 노드 파싱 성공’ 세 가지 조건을 확인한 다음 업데이트 간격을 설정하세요. 주기 작업은 정해진 요청을 반복할 뿐, 만료된 토큰이나 인증서 오류, 작동하지 않는 프록시 경로를 해결하지는 못합니다.
수동 업데이트는 안정적으로 되는데 자동 업데이트 로그가 전혀 없다면 올바른 그룹을 편집했는지, 간격이 저장됐는지, 프로그램이 계속 실행 중인지 먼저 확인한 다음 작업 설정을 점검하세요. 자동 작업에서 실제 요청이 발생했지만 실패했다면 로그에 기록된 네트워크 방식으로 다시 테스트합니다. ‘작업이 실행되지 않음’과 ‘실행 후 실패’를 혼동하지 마세요.
6. 자주 묻는 질문과 복구 후 확인 사항
업데이트 실패 후에도 기존 노드를 사용할 수 있나요?
노드 자체가 여전히 유효한지에 따라 다릅니다. 먼저 노드 목록을 유지하고 기존 노드를 선택해 실제 연결을 확인하세요. 구독 다운로드 실패가 모든 노드의 동시 만료를 뜻하지는 않습니다. 업데이트 전에 클라이언트의 백업 또는 내보내기 기능을 사용해 인증 정보가 포함된 데이터를 안전하게 보관할 수도 있습니다.
업데이트 성공으로 표시되는데 노드 수가 늘지 않는 이유는 무엇인가요?
구독 내용에 변경이 없었거나 그룹 필터 조건에 의해 걸러졌을 수 있습니다. 방금 업데이트한 그룹으로 이동해 필터 설정과 로그의 가져오기 결과를 확인하세요. 전체 노드 수가 늘었는지만으로 업데이트 성공 여부를 판단하지 마세요.
브라우저에서는 구독 주소가 열리는데 v2rayN에서 계속 실패하면 어떻게 하나요?
먼저 브라우저에 구독 내용이 표시되는지 확인하세요. 로그인 페이지나 인증 페이지라면 구독 응답이 아닙니다. 그런 다음 브라우저와 클라이언트의 프록시 경로를 비교합니다. 클라이언트 로그에서 인증서 오류, HTTP 상태 코드, 파싱 오류를 확인하고 한 번에 한 항목만 변경하세요.
다시 가져온 뒤 중복 그룹이 생겼습니다. 전부 삭제해야 하나요?
먼저 각 그룹의 주소와 노드가 어느 그룹에 속하는지 확인하세요. 새 그룹의 업데이트와 노드 연결이 정상인지 확인한 뒤 중복 항목을 정리하면 됩니다. 그룹 이름이 비슷하다는 이유만으로 삭제하지 마세요. 그룹마다 출처나 필터 조건이 다를 수 있습니다.
복구한 뒤 두 가지를 따로 확인하세요. 구독을 정상적으로 가져와 파싱할 수 있는지, 선택한 노드에 정상적으로 연결되는지 확인합니다. 전자는 구독 관리 문제이고 후자는 노드 설정, 코어, 시스템 프록시, 라우팅과 관련됩니다. 둘 중 하나라도 여전히 문제가 있다면 문제 해결 가이드를 참고해 계속 확인하세요. 접속 경로와 라우팅의 관계를 정리하려면 전체 설정 가이드를 확인하세요.
- 로그에서 대상 그룹의 업데이트가 완료됐고 다운로드 또는 파싱 오류가 남아 있지 않은 것을 확인합니다.
- 그룹에 필요한 노드가 유지되고 있으며 필터 조건과 출처가 일치합니다.
- 실제 연결이 정상이고 자동 업데이트 방식과 간격이 저장되어 있습니다.
- 다른 사람에게 전달하는 스크린샷과 로그에서 구독 토큰 및 노드 인증 정보를 가렸습니다.