구성 사례 · Clash 기술 블로그

FlClash geox-url 미적용: Geo 리소스 변경 방법

구독의 geox-url을 바꿔도 FlClash가 다른 Geo 데이터를 사용하나요? 리소스 화면과 최종 구성을 비교하고, 유형에 맞는 신뢰할 수 있는 주소로 변경한 뒤 동기화와 규칙 적용을 확인하세요. 실패하면 원래 URL과 작동하던 구성으로 되돌리세요.

  • FlClash
  • geox-url
  • Geo 리소스
  • 리소스 업데이트
  • Profile
이 글의 목차

데이터 다운로드 주소를 바꾸는 목적은 규칙을 복구하는 것이지만 구독 원문을 올바르게 수정해도 앱이 그 주소를 사용한다는 뜻은 아닙니다. 리소스 페이지 설정은 여러 프로필에 영향을 줄 수 있습니다. 바꿀 파일 종류, 현재 적용된 주소와 기존에 사용하던 사본을 확인한 뒤 되돌릴 수 있는 방식으로 업데이트하세요.

구독의 geox-url을 바꿨는데 왜 다른 Geo 데이터를 받나요?

v0.8.99는 최종 구성을 생성할 때 geox-url을 앱 설정의 geoXUrl 주소 전체로 바꿉니다. 따라서 구독에 입력한 네 주소가 코어에 전달되지 않을 수 있으며 구독만 변경해서는 적용을 보장할 수 없습니다. 아래 확인을 위해 보고자의 브랜치를 설치할 필요는 없고 아직 병합되지 않은 변경을 공식 수정으로 간주해서도 안 됩니다.

구독의 geox-url, FlClash 리소스 설정과 최종 설정을 비교하세요. 신뢰할 수 있는 미러가 구독 원문에만 있고 미리 보기에는 다른 주소 목록이 표시되며 리소스 다운로드나 규칙 로드도 계속 실패한다면 구독을 반복해서 갱신하지 말고 세 곳의 차이를 기록하세요.

공식 저장소 issue #2642는 v0.8.99 Linux AppImage에서 이 현상을 보고했고 Android에서도 재현된다고 했습니다. 이번 확인 시점에 관리자가 확인한 수정 버전은 없습니다. 현재 원인 점검과 임시 복구는 특정 버전 소스를 근거로 하며 모든 Geo 오류를 같은 원인으로 볼 수는 없습니다.

최종 주소가 이미 올바르다면 다운로드 경로에 접근할 수 있는지, 데이터 형식이 맞는지, 규칙이 참조하는 분류가 존재하는지 확인하세요. 이 문제는 이 사이트의 v0.8.98 글에서 다룬 리소스 크기와 시간 표시 갱신 문제와도 다릅니다. 화면의 파일 정보가 갱신됐다고 다운로드 주소의 우선순위까지 바뀐 것은 아닙니다.

어떤 리소스를 바꿔야 하며 기존 규칙과 호환되나요?

Profile, 앱 설정, 현재 정상 작동하는 리소스를 백업하고 리소스 화면의 URL을 항목별로 기록하세요. 오류에 나온 Geo 파일 유형, 규칙, 분류를 확인하고 FlClash의 전체 버전, 운영체제, 처음 테스트한 요청을 남기세요. 구독 인증 정보와 원본 백업은 로컬 기기에만 보관하세요.

리소스 화면의 MMDB, ASN, GEOIP, GEOSITE는 각각 다른 구성 필드에 대응합니다. 실제로 필요한 항목만 조정하고 데이터 관리자가 제공하는 공식 설명에서 내용과 형식을 확인하세요. 다운로드할 수 있다는 이유만으로 같은 파일을 네 항목에 모두 넣으면 안 됩니다.

리소스 항목과 필드 대응표

리소스 화면 항목geox-url 필드확인할 내용
MMDBmmdbGeoIP의 MMDB 계열 데이터입니다. v0.8.99 기본 주소의 파일 이름은 geoip.metadb입니다.
ASNasnASN 데이터입니다. 기본 파일 이름은 GeoLite2-ASN.mmdb이며 국가 분류 파일로 대체하면 안 됩니다.
GEOIPgeoipGeoIP의 dat 데이터입니다. 기본 파일 이름은 geoip.dat입니다.
GEOSITEgeosite도메인 분류 데이터입니다. 기본 파일 이름은 geosite.dat입니다.

Mihomo의 geodata-mode는 GEOIP에 dat와 MMDB 중 어떤 형식을 사용할지 결정합니다. URL을 진단할 때는 기존 모드를 유지하고 다운로드를 성공시키려고 임의로 전환하지 마세요. 사용자 지정 데이터에도 기존 규칙이 참조하는 분류가 있어야 합니다. 없으면 파일을 정상적으로 내려받아도 규칙을 불러오지 못할 수 있습니다.

미러를 바꾸면 다운로드 속도뿐 아니라 데이터 내용도 달라질 수 있습니다. 같은 데이터 원본을 제공하는 것으로 확인된 미러를 우선 사용하고, 원본 배포처가 파일 검증값을 제공한다면 해당 버전의 값과 대조하세요. 로그인 페이지, 공유 페이지, 확장자만 비슷한 오류 페이지를 Geo 데이터로 착각하지 마세요.

리소스 화면에서 주소를 바꾸고 동기화 완료까지 기다리기

v0.8.99는 현재 URL을 미리 채우고 제출하면 앱 수준의 geoXUrl을 업데이트합니다. 기기에서 공유하는 리소스 설정으로 다른 Profile에도 영향을 줍니다. 원래 구독으로 돌아가도 주소 자체는 복원되지 않습니다.

아래는 v0.8.99 리소스 편집과 동기화 메뉴 기준이며 화면 문구는 언어별로 다릅니다. 원래 값을 보관하고 믿을 수 있으며 형식에 맞는 완전한 HTTPS 다운로드 주소만 넣으세요. 확인하지 않은 미러를 쓰거나 인증서 검증과 보안 소프트웨어를 끄지 마세요.

복구에 필요한 리소스만 변경하기

  1. 현재 URL 보관

    FlClash 리소스 화면에서 해당 항목을 찾아 더 보기 메뉴를 열고 편집을 선택하세요. 편집 창의 원래 주소를 로컬 기록에 복사하고 현재 항목이 geox-url의 필드와 대응하는지 확인하세요. 기존에 사용자 지정 주소였어도 전체를 보관하세요.

  2. 새로운 신뢰 가능한 주소 제출

    같은 항목의 편집 입력란에 새 주소를 넣어 제출하고 앱의 구성 갱신을 기다리세요. 입력란과 최종 구성 미리 보기를 다시 열어 값이 바뀌었는지 확인하세요.

  3. 해당 항목 동기화

    항목의 더보기 메뉴에서 동기화를 선택하고 업데이트를 한 번만 시작하세요. 진행 중 표시가 끝날 때까지 기다린 뒤 오류나 건너뜀 알림, 파일 정보를 확인하세요.

  4. 구성 다시 적용 및 규칙 확인

    앱의 일반적인 방법으로 현재 구성을 다시 적용하고, 필요하면 프록시를 정상적으로 중지한 뒤 다시 시작하세요. 처음 사용한 요청으로 관련 규칙의 일치 결과와 실제 아웃바운드를 확인하고 다른 자주 쓰는 Profile도 점검하세요.

동기화 호출이 반환됐다는 것은 코어가 요청을 접수했다는 뜻일 뿐입니다. 완료나 실패는 이후 이벤트로 알려주므로 클릭 직후 업데이트에 성공했다고 판단하지 마세요. 파일 크기와 시간은 보조 증거입니다. 내용이 같거나 업데이트를 건너뛰면 변하지 않을 수 있으므로 완료 상태, 규칙 로딩, 실제 요청을 함께 확인해야 합니다.

편집한 값이 저장되지 않으면 동기화를 반복하지 말고 오류를 보관하세요. 주소는 올바르게 저장됐지만 다운로드가 실패한다면 현재 네트워크에서 해당 출처에 접근할 수 있는지, 리디렉션 대상이 여전히 데이터 파일인지, 로그에 형식이나 분류 오류가 있는지 확인하세요. 관련 없는 리소스까지 계속 바꾸지 마세요.

리소스 URL과 규칙을 확인하고, 해결되지 않으면 원래 리소스 설정 복원하기

복구 확인 체크리스트

  • 구독 원문만 확인하지 않고 리소스 화면과 최종 구성의 해당 URL이 일치하는지 확인함
  • 동기화 업데이트가 끝났으며 처리하지 않은 다운로드 또는 파싱 오류가 없음
  • 현재 데이터에 규칙이 요구하는 분류가 있고 관련 규칙이 정상적으로 로드됨
  • 동일한 실제 요청이 의도한 규칙과 일치하고 예상한 아웃바운드를 사용함
  • 정상 종료 후 다시 시작해도 URL이 올바르며 다른 자주 쓰는 Profile에 문제가 없음

실패하면 같은 리소스 항목의 편집 입력란에 미리 보관한 URL을 다시 넣고 동기화한 뒤, 원래 작동하던 구성을 다시 적용하세요. 대화상자의 초기화는 앱 기본값을 복원합니다. 원래 사용자 지정 주소를 썼다면 초기화가 기존 설정 복원을 뜻하지는 않습니다.

URL을 되돌려도 이미 교체된 데이터 파일이 자동으로 돌아오지는 않습니다. 원래 출처에 접근할 수 있으면 원래 데이터를 다시 동기화하세요. 그 출처도 접근할 수 없다면 현재 파일과 로컬 백업을 보존하고 추가 업데이트를 미루세요. 앱 구성을 복원하기 전에 백업에 무엇이 포함됐는지 확인하고 Geo 파일도 들어 있다고 가정하지 마세요. 호환되지 않는 파일을 수동으로 섞거나 전체 구성을 초기화해서는 안 됩니다.

여전히 규칙을 불러오지 못하면 영향을 받은 구성을 먼저 비활성화하고 정상 작동이 확인된 Profile을 선택하세요. 앱 전체의 리소스는 계속 공유되므로 전환한 뒤에도 검증해야 합니다. 사용할 수 있는 구성이 없다면 프록시를 정상적으로 중지하고 일반 네트워크를 확인하세요. 반드시 프록시를 거쳐야 하는 업무나 서비스의 접속은 미루세요.

프로젝트에 보고할 때 전체 버전, 시스템, 민감 정보를 가린 원문과 최종 geox-url, 리소스 항목, 업데이트 상태, 첫 오류와 재시작 후 규칙 적용 결과를 제공하세요. 분류명과 필드 구조는 유지하고 구독 토큰, 개인 미러 인증 정보와 개인 주소는 가리세요.

참고 자료