FlClash 구독 업데이트 실패 해결 방법: 원인과 자동 업데이트 주기 설정

구독 업데이트 실패: 다운로드, 파싱, 노드 연결 문제 구분하기

FlClash에서 구독을 업데이트하려면 먼저 구독 주소에 접속해 설정 내용을 가져온 다음, 파싱하여 저장해야 합니다. 노드 연결은 별도의 과정입니다. 따라서 ‘구독 업데이트 실패’와 ‘노드 연결 테스트 시간 초과’는 따로 해결해야 합니다. 기존 설정의 노드가 계속 작동하더라도 구독 주소가 유효하다는 뜻은 아니며, 구독 업데이트에 성공해도 모든 노드에 연결할 수 있다는 의미는 아닙니다.

문제를 확인하기 전에 현재 사용할 수 있는 설정을 보존하세요. 오류가 발생한 시간, 오류 메시지, 사용한 네트워크를 기록해 두세요. 기존 구독을 삭제하거나 DNS, TUN, 규칙 모드를 한꺼번에 바꾸지 마세요. 한 번에 한 가지 조건만 변경해야 어떤 단계가 영향을 주었는지 파악할 수 있습니다.

오류 코드는 단서일 뿐, 원인을 단정할 수는 없습니다. 예를 들어 403은 구독 권한이 만료되었거나 웹사이트의 접근 보호 기능이 작동했음을 나타낼 수 있습니다. 200은 HTTP 요청에 응답이 있었다는 뜻일 뿐, 응답 내용이 로그인 페이지일 수도 있습니다.

수동 새로고침 위치: 설정 항목에서 업데이트 결과 확인

일반적인 경로는 ‘설정’ → 해당 원격 설정 찾기 → 항목의 업데이트 아이콘 클릭 또는 항목 메뉴에서 ‘업데이트’ 선택입니다. 플랫폼과 앱 버전에 따라 카드 오른쪽이나 더보기 메뉴에 있을 수 있습니다. 홈 화면의 연결 스위치를 다시 켜는 대신 해당 구독 항목에서 직접 업데이트하세요.

1. 설정 유형을 확인하세요. 링크로 추가한 원격 설정만 구독 주소에 다시 요청할 수 있습니다. 로컬 파일에서 가져온 설정은 파일을 다시 가져오거나 원격 링크를 별도로 추가해야 합니다.
2. 항목 하나만 업데이트하세요. 구독이 여러 개라면 먼저 오류가 난 항목만 업데이트해 보세요. 여러 요청을 한꺼번에 보내면 오류 메시지가 뒤섞일 수 있습니다.
3. 요청이 끝날 때까지 기다리세요. 성공 알림, 오류 세부 정보, 업데이트 시간을 확인하세요. 연속으로 눌러도 만료된 링크는 복구되지 않으며 요청 빈도 제한이 걸릴 수 있습니다.
4. 현재 선택된 항목을 확인하세요. 설정 A를 업데이트했더라도 설정 B가 선택된 상태라면 프록시 그룹과 노드 목록이 바뀌지 않을 수 있습니다.

링크 만료 및 권한 문제: 올바른 구독 주소 다시 받기

구독 링크, 관리 페이지, 공유 링크 구분하기

FlClash에는 설정 내용을 직접 반환하는 주소가 필요합니다. 계정 페이지 주소, 로그인해야 열리는 다운로드 페이지, 일반 노드 공유 링크는 완전한 Clash 구독 링크가 아닙니다. 제공업체의 구독 메뉴에서 Clash, Clash Meta 또는 mihomo로 표시된 주소를 선택하세요. 클라이언트별로 주소가 나뉘어 있다면 FlClash 지원이 명시된 항목을 우선 사용하세요.

복사한 뒤 메신저에서 주소가 잘리지 않았는지, 끝에 공백이나 줄바꿈 또는 한글 문장 부호가 붙지 않았는지 확인하세요. 쿼리 매개변수의 토큰은 그대로 유지해야 합니다. 불필요해 보이는 매개변수를 임의로 삭제하거나 특수 문자를 반복해서 디코딩·인코딩하지 마세요.

응답 상태에 따라 권한 및 요청 제한 확인하기

• 401 또는 403: 계정 상태와 구독 권한을 확인하고 토큰이 재설정되었는지 살펴보세요. 브라우저에 CAPTCHA나 접근 인증 화면이 표시된다면 클라이언트에서 웹페이지처럼 인증을 진행하기 어려울 수 있습니다. 제공업체에 클라이언트에서 사용할 수 있는 주소를 문의하세요.
• 404 또는 410: 기존 구독 API가 이전되었는지 확인하세요. 관리 페이지에서 링크를 다시 복사하고, 기존 주소의 도메인만 바꿔서 시도하지 마세요.
• 429: 수동 업데이트와 다른 기기의 잦은 요청을 잠시 중단하세요. 응답에 Retry-After가 포함되어 있다면 안내된 시간만큼 기다린 뒤 다시 시도하세요.
• 500, 502 또는 503: 구독 서비스나 상위 서버에 일시적인 문제가 있을 수 있습니다. 기존 설정을 보존하고 잠시 후 다시 시도하세요. 문제가 계속되면 제공업체에 문의하세요.

요청 시간 초과 및 인증서 오류: 실제 접속 경로 확인

구독 요청은 브라우저와 다른 경로로 나갈 수 있습니다. 브라우저는 시스템 프록시를 사용할 수 있지만, 클라이언트의 설정 다운로드 요청은 자체 요청 정책을 따를 수 있습니다. TUN을 켜면 트래픽 경로가 달라질 수도 있습니다. 따라서 브라우저에서 구독 주소가 열리는 것은 한 경로에 접속할 수 있다는 뜻일 뿐, FlClash의 업데이트 요청도 성공한다는 보장은 아닙니다.

두 가지 비교로 원인 범위 좁히기

1. 로컬 네트워크 비교: Wi-Fi에서 오류를 한 번 기록한 뒤 휴대전화 핫스팟이나 신뢰할 수 있는 다른 네트워크로 바꿔 같은 구독을 수동 업데이트하세요. 한 네트워크에서만 실패한다면 해당 네트워크의 DNS, 포털 인증 또는 접근 제한을 먼저 확인하세요.
2. 외부 연결 경로 비교: 기존 설정을 보존하세요. 현재 버전에서 구독 업데이트 프록시를 선택할 수 있다면 직접 연결과 기존에 작동하는 프록시를 각각 테스트하세요. 해당 옵션이 없다면 ‘전역 모드로 전환’하면 구독 다운로드 경로도 반드시 바뀐다고 가정하지 마세요.

no such host와 같은 오류가 발생하면 도메인 철자와 DNS 조회부터 확인하세요. connection refused가 나타나면 더 이상 연결을 받지 않는 로컬 프록시 포트에 접속한 것은 아닌지 살펴보세요. 오류에 127.0.0.1:7890이 표시되더라도 7890은 해당 요청에서 사용된 포트일 뿐입니다. 클라이언트의 실제 설정과 비교해야 하며 모든 설치 환경의 기본값으로 간주하면 안 됩니다.

인증서 오류가 발생하면 먼저 시스템 날짜와 시간대, 자동 시간 설정을 확인하세요. certificate has expired는 서버 인증서가 만료되었거나 기기 시간이 잘못되었을 때 나타날 수 있습니다. 인증서 도메인이 일치하지 않는다면 구독 도메인과 리디렉션된 주소를 확인하세요. 인증서 검증을 끄는 방식으로 문제를 덮지 마세요. 구독 토큰은 HTTPS로 보호해야 합니다.

처음 가져오는 주소가 프록시를 통해서만 접속 가능하고 클라이언트에 사용할 수 있는 설정이 없다면, 제공업체에 직접 연결 가능한 구독 주소나 로컬 설정 파일 가져오기 방법을 문의하세요. 접속할 수 없는 주소를 반복해서 새로고침해도 최초 접속 경로가 만들어지지는 않습니다.

형식 파싱 실패: 응답이 Clash / mihomo 설정인지 확인

Clash 계열 클라이언트는 일반적으로 YAML 설정을 사용합니다. 다른 클라이언트용 JSON 설정이나 인코딩된 노드 URI 목록은 파일 확장자만 바꾼다고 Clash 설정으로 사용할 수 없습니다. FlClash에서 사용하는 mihomo 코어는 기능 지원 면에서 원본 Clash와 차이가 있으므로 실제 클라이언트가 지원하는 형식의 구독이 필요합니다.

확장자만 보지 말고 내용 확인하기

• 본문이 <!DOCTYPE html> 또는 로그인 양식으로 시작함: 설정이 아닌 웹페이지를 받은 것입니다. 로그인, 리디렉션 또는 접근 인증 문제를 먼저 해결하세요.
• 본문 대부분이 vmess://, ss:// 등의 링크임: 노드 목록 구독을 선택했을 수 있습니다. 제공업체의 Clash / mihomo 형식 출력 주소를 사용하세요.
• 오류에 행과 열 번호가 표시됨: 해당 위치와 바로 앞 줄의 들여쓰기, 따옴표, 콜론을 확인하세요. YAML 들여쓰기에는 공백을 사용하고 Tab은 넣지 마세요.
• 지원되지 않는 프록시 유형이나 필드라는 안내가 표시됨: 설정 요구 사항과 현재 클라이언트 및 코어 버전을 확인한 뒤, 클라이언트를 업데이트하거나 호환되는 형식을 선택하세요.

아래 예시는 YAML의 계층 구조와 규칙 구성만 보여 줍니다. 노드는 포함되어 있지 않으며 프록시에 사용할 수 있는 완전한 구독 설정도 아닙니다. 실제 원격 설정에는 proxies가 있을 수도 있고 proxy-providers를 통해 노드 출처를 참조할 수도 있습니다. 특정 필드 하나가 없다는 이유만으로 파일이 잘못되었다고 판단하지 마세요.

proxy-groups:
  - name: 아웃바운드 선택
    type: select
    proxies:
      - DIRECT

rules:
  - MATCH,아웃바운드 선택

설정 자체는 다운로드되었지만 특정 proxy-providers 또는 rule-providers 업데이트가 실패했다면 해당 리소스의 주소와 오류 메시지를 확인하세요. 이는 설정 내부 리소스 다운로드 문제로, 기본 구독 주소를 다운로드할 수 없는 문제와는 다른 단계입니다.

일부 서비스는 요청의 User-Agent에 따라 서로 다른 형식을 반환합니다. 브라우저에서 다운로드한 내용과 클라이언트가 받은 내용이 다를 수 있습니다. 이런 경우 요청 식별자를 임의로 바꾸거나 출처가 불분명한 온라인 변환 서비스에 비공개 구독을 넘기지 말고, 제공업체에 FlClash용 주소를 문의하세요.

자동 업데이트 주기: 원격 설정 편집 메뉴에서 지정

먼저 수동 업데이트에 성공한 뒤 자동 업데이트를 설정하세요. 일반적인 경로는 ‘설정’ → 해당 원격 설정의 더보기 메뉴 → ‘편집’ → 자동 업데이트 스위치 및 업데이트 주기입니다. 항목 이름과 선택 가능한 단위, 메뉴 위치는 설치된 버전에 따라 다를 수 있습니다. 로컬 파일 설정에는 일반적으로 같은 구독 업데이트 옵션이 없습니다.

단위를 확인한 뒤 값을 입력하세요

자동 업데이트 주기는 예약된 두 업데이트 사이의 시간입니다. 요청 시간 초과나 노드 연결 테스트 주기와는 다릅니다. 예를 들어 1시간은 60분 또는 3600초이고, 24시간은 1440분 또는 86400초입니다. 화면의 단위가 분이라면 1시간마다 업데이트하려면 60을 입력해야 합니다. 초 단위 값을 분 입력란에 그대로 넣으면 안 됩니다.

표의 주기는 설정 권장값이며 FlClash의 기본값이 아닙니다. 0을 입력하면 자동 업데이트가 꺼진다고 단정하지 마세요. 버전에 따라 0을 다르게 처리할 수 있습니다. 자동 업데이트를 중지하려면 명시적인 스위치를 사용하고, 저장한 뒤 편집 화면을 다시 열어 설정이 유지되었는지 확인하세요.

자동 업데이트가 예정대로 실행되지 않을 때 확인할 항목

자동 업데이트는 일반적으로 클라이언트 실행 여부와 시스템 스케줄러에 따라 동작합니다. 데스크톱 앱을 종료하거나 컴퓨터가 절전 모드에 들어간 경우, 휴대전화에서 백그라운드 활동을 제한한 경우 실행이 늦어질 수 있습니다. 특히 Android에서는 배터리 최적화와 백그라운드 네트워크 권한을 확인하세요. 설정을 바꾸기 전에 배터리 소모에 미치는 영향을 확인하고 모든 백그라운드 제한을 한꺼번에 해제할 필요는 없습니다.

설정을 저장한 뒤 마지막으로 업데이트에 성공한 시간을 기록하세요. 클라이언트를 계속 실행한 상태로 설정 주기가 지난 다음 확인합니다. 그사이에 절전 모드에 들어갔거나 네트워크가 끊겼다면 복구 후 수동 업데이트로 링크가 여전히 유효한지 확인하세요. 자동 업데이트는 만료된 토큰, 잘못된 형식, 서버의 요청 제한을 해결하지 못하며 초 단위로 정확하게 실행되는 시스템 작업도 아닙니다.

복구 후 확인 순서와 문제 제보에 필요한 정보

1. 구독 요청 성공 여부를 확인하세요. 홈 화면의 연결 상태만 보지 말고 해당 설정의 성공 알림과 업데이트 시간을 확인하세요.
2. 설정이 선택되어 있는지 확인하세요. 프록시 그룹, 규칙, 노드 출처가 방금 업데이트한 설정에 속하는지 확인하세요.
3. 노드 연결을 따로 테스트하세요. 업데이트는 성공했지만 접속이 계속 실패한다면 구독 주소를 반복해서 바꾸지 말고 노드, 규칙 적용 결과, 시스템 프록시, TUN을 확인하세요.
4. 마지막으로 적절한 업데이트 주기를 설정하세요. 여러 클라이언트가 같은 구독에 짧은 간격으로 동시에 요청하지 않도록 하세요.

문제가 계속되면 운영체제 종류, FlClash 버전, 코어 버전, 오류 발생 시간, 네트워크 유형, 민감한 정보를 가린 오류 메시지를 정리하세요. ‘네트워크를 바꾸면 성공하는지’, ‘기존 설정은 계속 사용할 수 있는지’, ‘기본 구독과 내부 리소스 중 어느 쪽에서 실패하는지’를 함께 알려 주면 단순히 ‘업데이트 실패’만 표시된 스크린샷보다 원인을 파악하는 데 도움이 됩니다.

원격 설정을 처음 추가할 때는 구독 가져오기 안내에서 절차를 확인하세요. 구독 주소와 클라이언트의 관계가 궁금하다면 구독 출처 안내를 참고하세요.