Clash 구독 업데이트 실패 원인과 자동 업데이트 설정 방법

업데이트 실패 오류, 크게 네 가지로 구분하기

업데이트 버튼을 누르고 몇 초 기다리면 빨간 글씨로 오류가 뜹니다. 클라이언트마다 표현은 다르지만 결국 네 가지 유형으로 좁혀지고, 각각 원인 점검 방향이 완전히 다릅니다. 먼저 지금 마주한 오류가 어떤 유형인지 확인한 뒤 작업을 시작하세요.

흔한 오해 하나: 오류 종류를 따지지 않고 무조건 클라이언트를 재설치하는 것입니다. 재설치는 링크도 네트워크도 바꾸지 않으므로 위 네 가지 문제 중 하나도 해결하지 못하고 시간만 낭비하게 됩니다.

1단계: 구독 링크 자체 점검하기

구독 링크는 모든 설정의 시작점이니 30초만 투자해 먼저 확인하세요. 링크 전체를 브라우저 주소창에 붙여넣고 엔터를 누른 뒤 반환된 내용을 확인합니다.

• proxies:로 시작하는 긴 YAML 텍스트나 불규칙한 base64 문자열이 나온다면: 링크는 살아 있으며 문제는 클라이언트 또는 네트워크 쪽입니다. 계속 다음 단계로 진행하세요.
• 403 오류, 만료 안내, 트래픽 소진 공지가 뜬다면: 계정 쪽이 정지된 상태입니다. 서버 제공처 홈페이지에 로그인해 요금제 상태를 확인하고, 갱신하거나 트래픽 리셋을 기다린 뒤 다시 업데이트하세요.
• 로그인 페이지로 리다이렉트되거나 링크가 존재하지 않는다는 메시지가 뜬다면: 구독 토큰이 초기화된 것으로 보입니다. 홈페이지에서 최신 링크를 새로 복사한 뒤 클라이언트에서 해당 설정을 편집해 기존 주소를 전체 교체하세요.

정상적인 구독이 반환하는 내용은 (YAML 형식 예시) 아래처럼 시작합니다.

proxies:
  - name: "홍콩 01"
    type: ss
    server: hk01.example.com
    port: 8388
    cipher: aes-128-gcm
    password: "your-password"

추가로 함께 확인해두면 좋은 두 가지가 있습니다.

• 링크를 복사할 때 앞뒤에 공백이나 줄바꿈이 섞이면 클라이언트가 곧바로 잘못된 주소로 판단합니다. 붙여넣은 뒤 앞뒤 문자를 확인하고 불필요한 부분은 모두 삭제하세요.
• 일부 서버는 User-Agent에 따라 다른 내용을 반환합니다. 브라우저에서 열린다고 해서 클라이언트에서도 정상 수신된다는 뜻은 아니며, 그 반대도 마찬가지입니다. 브라우저 확인은 「링크 존재 여부」만 검증할 뿐, 클라이언트 실제 테스트를 대신할 수 없습니다.

2단계: 네트워크 환경 점검, 악순환 끊기

구독 업데이트는 본질적으로 일반적인 HTTPS 요청입니다. 문제는 많은 서버의 구독 도메인 자체가 이미 차단되어 있고, 하필 노드가 전부 만료된 경우입니다. 업데이트하려면 사용 가능한 프록시가 필요하고, 프록시를 확보하려면 업데이트가 먼저 성공해야 합니다. 이는 구독 문제 해결에서 가장 흔한 악순환입니다. 이를 끊는 세 가지 방법이 있습니다.

프록시를 통해 업데이트하기

연결 가능한 노드가 하나라도 남아 있다면 그것을 활용할 수 있습니다. Clash Verge Rev에서 「설정」 페이지를 열고 대상 구독을 마우스 우클릭해 「편집」을 선택한 뒤, 「프록시로 업데이트」(일부 버전은 「프록시를 통해 업데이트」로 표기) 옵션을 체크하고 저장한 다음 다시 업데이트를 누르면 요청이 현재 프록시를 거쳐 전송됩니다.

네트워크를 바꿔서 업데이트하기

집 인터넷으로 안 되면 휴대폰 테더링으로 전환해보세요. 이동통신망과 유선 인터넷은 같은 도메인에 대해 차단 정책이 다른 경우가 많아, '도무지 안 되던' 업데이트가 4G/5G로 바꾸는 순간 한 번에 성공하는 경우가 흔합니다. 업데이트 후에는 원래 네트워크로 다시 전환해도 사용에는 문제가 없습니다.

TUN 모드를 켜고 업데이트하기

TUN 모드는 가상 네트워크 카드를 통해 전체 트래픽을 처리하므로, 클라이언트가 직접 보내는 업데이트 요청도 프록시를 거치게 되어 강제로 프록시 경유 업데이트와 같은 효과를 냅니다. 다만 커널이 정상 작동 중이고 사용 가능한 노드가 남아 있어야 합니다.

3단계: 클라이언트와 구독 변환 점검하기

• 구독 변환은 오류가 발생할 지점이 하나 더 늘어난다는 뜻입니다. 변환 링크 = 원본 구독 + 변환 백엔드 + 규칙 템플릿이므로, 이 중 어느 한 곳이라도 장애가 나면 업데이트가 실패합니다. 문제 확인 시 먼저 서버가 제공한 원본 링크로 되돌려 테스트해보세요. 원본 링크가 정상이라면 문제는 변환 서비스에 있으므로 백엔드를 바꾸거나 원본 링크를 그대로 사용하세요.
• 로컬 설정 캐시 손상. 업데이트를 눌러도 반응이 없거나 파싱 오류가 반복되는 증상으로 나타납니다. 해당 설정을 삭제하고 링크를 새로 붙여넣어 다시 만드는 것이 클라이언트 재설치보다 훨씩 빠릅니다.
• 클라이언트 커널이 오래됨. 최근 서버 구독은 mihomo 전용 프로토콜 필드(hysteria2, tuic, vless 등)를 포함하는 경우가 많은데, 오리지널 Clash 커널은 이런 유형을 인식하지 못해 업데이트 후 노드가 대량으로 사라지거나 파싱 오류가 바로 발생합니다. mihomo(Clash Meta) 커널을 사용하는 클라이언트로 바꾸면 정상적으로 인식되며, 플랫폼별 버전은 다운로드 페이지에서 확인할 수 있습니다.
• 권한 및 디렉터리 문제(드문 경우). 클라이언트가 읽기 전용 디렉터리에 설치되어 있거나 설정 디렉터리가 보안 소프트웨어에 잠겨 있으면, 가져오기는 성공하지만 캐시에 쓰지 못하는 상황이 발생합니다. 일반 디렉터리로 옮겨 재설치하면 해결됩니다.

자동 업데이트 주기 설정하기

수동으로 업데이트 버튼을 누르는 건 매번 잊어버리기 마련입니다. 주요 클라이언트는 시간 간격 기반 자동 가져오기를 지원하므로 한 번만 설정해두면 됩니다.

Clash Verge Rev

「설정」 페이지를 연 뒤 대상 구독을 마우스 우클릭 →「편집」→「업데이트 주기」(단위: 분) 항목을 찾아 값을 입력하고 저장하세요. 설정 화면에서 전역 기본 주기를 지정해두면 이후 새로 추가하는 구독에 자동으로 적용됩니다.

FlClash / Clash for Android

설정 목록에서 대상 구독을 길게 눌러(또는 오른쪽 편집 버튼으로) 상세 페이지로 들어간 뒤 자동 업데이트 주기를 설정하고 저장하세요.

주기는 360~720분 사이로 설정하는 것을 권장합니다. 너무 짧으면 빈번한 요청이 서버 측 속도 제한을 유발해 오히려 업데이트가 실패할 수 있고, 너무 길면 노드 변경이나 접속 IP 교체를 따라가지 못합니다. 서버 측에서 「업데이트 주기를 줄여달라」는 공지를 하면 그때 임시로 줄이면 됩니다.

전제 하나를 기억하세요: 자동 업데이트는 같은 요청을 정해진 시간마다 반복 실행하는 것일 뿐입니다. 실패 원인이 네트워크 차단이라면 자동 업데이트 역시 똑같이 실패합니다. 앞의 두 단계로 네트워크를 먼저 정상화해야 주기 설정이 의미를 가집니다.

점검 순서 한눈에 보기

1. 브라우저로 구독 링크를 열어 링크 자체가 살아 있는지 확인합니다.
2. 서버 제공처 홈페이지에 로그인해 요금제 유효기간과 트래픽 잔량을 확인합니다.
3. 휴대폰 테더링으로 전환해 한 번 업데이트해보고 로컬 네트워크 차단 여부를 판단합니다.
4. 「프록시로 업데이트」를 체크하거나 TUN 모드를 켠 뒤 다시 업데이트합니다.
5. 구독 변환을 거치지 않고 서버 원본 링크를 사용합니다.
6. 설정을 삭제하고 다시 만들며, 여전히 실패하면 mihomo 커널 클라이언트로 업그레이드합니다.