検索意図:どんなときに GeoSite/GeoIP の手動更新を疑うべきか
Clash Verge Rev を運用していると、購読やプロキシ自体は稼働しているのにだけGEOIP や GEOSITE 系が期待どおり効かず、国内サイトまで海外経路へ流れたり、その逆が起きたりすることがあります。典型的には、(1) 社内ネットワークや一部リージョンから公式の自動取得 URL が遮断されていてデータが古いまま/空振りしている、(2) ドキュメントにあるデフォルトの鏡と、GUI で指定した別鏡やローカル配置が食い違っている、(3) テンプレの RULE-SET が更新された一方で名前付きカタログ側のファイルが対応世代を追えていない、といった背景が重なります。
本記事では、その検索意図──「GeoSite と GeoIP(いわゆる geodata)の実体ファイルのパスと、Mihomo が内部で使うダウンロード元(geox-url 相当)を揃え、必要なら手動で一度差し替えてからログで追跡可能な形にしたい」──に沿って手順を並べます。購読 URL や Fake-IP の切り分けは別軸のため、DNS 周りの深掘りは Fake-IP/DNS の整理記事、初回導線は macOS 向け Verge Rev 導入手順 や関連の Windows・購読記事へ委ねます。
geox-url と、実際の geoip/geosite バイナリ(多くは .dat 系)の両方を扱います。ビルドやコア世代で YAML のキー名が微妙に違う場合があるため、「GUI のラベル名」だけで決めつけず、生成された一式を一度開くのが安全です。
Mihomo 側で Geo データが効くレイヤーを分けて捉える
Mihomo(旧 Clash Meta 系)は、ポリシより上の評価段階で「このホスト/この IP がどのカテゴリか」を引くために geodata を読み込みます。ここが古い/壊れていると、ユーザーが書いたYAMLの意図は正しくても名前解決結果とルール評価の前提がずれたままになります。一方で、いま主流の構成では単独の GEOSITE 行だけでなく、rule-providers 由来の RULE-SET を併用することも多く、前者と後者で「更新の仕組み」がまったく別だと誤解が生じやすいです。
ざっくり言えば、RULE-SET は HTTP やローカルファイルからルール断片を取りに行く仕組みで、更新間隔はプロバイダ単位の interval などに従います。対して GEOSITE や名前付きのカテゴリ参照は、別途配布されている巨大なインデックス(一般ユーザーから見れば geosite.dat などひとつの塊)に依存します。そのため、「ルールプロバイダは更新されたのに Geo 判定だけ妙だ」というパターンは、まさに両系統のデータ鮮度のズレとして説明できることがあります。GEOIP についても同様で、国コードや地域コードの対応が古いままでは、CDN のエッジ切り替えのあとでも誤って直結側へ落ち続けるような症状が現れます。
ユーザーが Verge の画面から触れるのは、多くの場合自動更新のオンオフや取得元 URL、既定の保存フォルダであり、細かなルール順序そのものとは別問題です。そのため本章では、まず「どの機能がどのファイルに依存しているか」を頭のなかで二分しておくことを推奨します。以降のディレクトリ操作も、この二分ができているほど間違いが減ります。
保存先と「実行中プロファイル」を一致させる
手動更新で最も多いミスは、ドキュメントにある一般論のパスだけを見てコピーし、実際にコアが起動するときに掴んでいるのは別の作業ディレクトリだった、というタイプです。Clash Verge Rev はプロファイル複数運用があるため、アクティブなプロファイル名と、そのプロファイル生成物が置かれるレイアウトが環境により異なります。ここでの実務ポイントは次の三点です。
- (1) UI の「GEO / Geo Data / Catalog」 に相当する項目で明示されたディレクトリをメモし、Explorer または Finder で実在するか確認する。
- (2) 「マージ後のランタイム設定」またはエディタのプレビューで
geox-urlブロックがある場合、自動取得が指している URL と、その成果物が落ちてくる先が上記ディレクトリと論理的につながっているかを読み解く。 - (3) 置き換え操作の直前に、既存の
geoip/geosite類を名前を変えて退避し、「いつ」「どのバイト列が」動いていたかを残す。
Windows と macOS でパスの見え方は違っても、「UI が指した場所=ユーザーが書き換えてよい場所」であるかはアプリ実装により揺れるため、最終確認は起動ログにファイルパスらしき行が出るか、もしくは置き換え直後にルール評価の挙動が変わったかで行うほうが堅実です。サイトのドキュメントと併せ、自身の環境での「シングルソース・オブ・トゥルース」を一文で書いておくと、数か月後の自分が助かります。
geox-url・自動更新間隔と「鏡」を揃える意味
生成 YAML に geox-url: が並んでいる場合、多くは geoip と geosite の二つの文字列鍵があり、それぞれ HTTPS の配布エンドポイントを指します。社内プロキシのせいで GitHub Releases に届かない、といったときにミラーを自分で立てたり、企業運用ではアーティファクトを社内オブジェクトストレージに置いたりすると思いますが、その際は両方とも同じ配布系列に寄せてください。geoip だけ新しいソースに切り替えて geosite が古いまま、という非対称が続くと、カテゴリ名の解釈とルールセット側の語彙の前提がゆっていきやすくなります。
# Illustration only — keys and URLs MUST match YOUR core README
geox-url:
geoip: "https://example-mirror/geoip.dat"
geosite: "https://example-mirror/geosite.dat"
geo-auto-update: true
geo-update-interval: 24
上記は構造イメージ用の架空例であり、ご利用の Mihomo のマイナー版で非推奨になっているキーや、真偽値のデフォルトの差は必ず changelog を確認してください。ポイントは、geo-auto-update をオンにしているのに鏡へ到達できない環境では、手動運用との競合で「置き換えたはずなのに起動時に上書き戻しになる」ような挙動が起きうるということです。完全に手へ切り替えるなら、その意図を設定に明示し、不要な自動フェッチとの二重化管理をやめるのが安全側です。geo-update-interval が時間単位として解釈されるのが一般的ですが、この数字を極端に短くすると、そもそもルールセットの更新よりも上流の取得トラフィックが目立ち始めます。取得頻度を下げて差分だけ手で持ち込む、という運用のほうが向いているチームも多いです。
geox-url を検証されていない第三者の短縮 URL に差し替えるのは危険です。geodata が改ざんされると、悪意あるルールセット以上に静かな誤誘導が可能になります。手動運用でも、チェックサム確認や組織内の標準鏡のみを許可する方針に寄せてください。
手動更新の実測フロー(バックアップから検証まで)
以下は、開発者でもなくてよい一般ユーザーでも再現できる順序です。順番を変えると、「どこで壊れたか」がログから追えなくなるので、この並びを意識してください。
- 完全終了:TUN などカーネル側フックがある場合、アプリだけでなくサービスまで落ちたか確認し、ロックされたファイルへの上書き失敗を防ぎます。
- バックアップ:
geoipおよびgeositeと思われるバイナリを、日時入りファイル名へコピーします。サイズやハッシュまでメモすると「次回いつまで新しかったか」が客観化します。 - 入手:コアが読める形式のみを公式に近いソースから取得します。ブラウザでのダウンロードログと、ファイルのサイズ異常がないかを見ます。
- コピー:既定名で上書きするか、アプリ側が名前をハードコードしていないか README を読みます。名前違いのコピーを二重にもつと読み込み優先順で迷うので、残骸は退避または削除します。
- 起動とログ:コアまたは Verge を起動し、geodata ロード関連のログに明示的な失敗がないか、HTTP フェッチばかり走っていないかを確認します。必要なら一時的にログレベルを上げますが、運用復帰後は戻してください。
- 機能検証:わかりやすいテストサイトや、自分が困っていたホストで
GEOIP/GEOSITEが期待グループへ入るかを見ます。異常時はDNS モードとの相互作用も疑います(特に Fake-IP 周り)。
検証フェーズでは、既存の自動テスト機能でなく意図的に既知ホストだけを試すほうが速いことが多いです。すでに url-test とフォールバック をチューニングしている構成では、上流の GEO 判定が直っていれば体感のレイテンシ分布が変わって見えるはずです。変わらない場合は、問題が geodata ではなく別レイヤにあるサインでもあります。
つまずきどころ:よくある切り分け
「置き換えたのに挙動が変わらない」場合、まず Mixed コンテキストとプロファイル読み込み順を疑ってください。「エディタに開いているドラフト」「購読で上書きされるテンプレ」「ローカルの override」の三つのどれを現行コアが食べているか、一本化できていない例が続出します。そのうえで geodata に絞ると、(a) 形式不一致(コア世代が読めないヘッダ)による静かな読み込み失敗、(b) TUN と DNS の組み合わせで別経路評価が走っている、(c) ルール側の名前がインデックスに存在しない、の三つが多いです。(c) はカテゴリ名タイポや時代遅れのテンプレに典型なのでルールセット作者の changelog を読み、(a) はファイルサイズ異常ですぐ判別できることがあります。
また、(b) は「Fake-IP のフィルタに入っていなくて名前解決だけ特殊」など、本記事の主題より手前で事件が終わっていることもあります。切り分けのコツは、一時的に評価を単純化して原因の当たりを付けることです。上流を疑うときは GEO、下流も含めブラウザ挙動まで見るときは RULE-SET と DNS に視点を広げます。
よくある質問
自動取得だけ止めて、自分で定期的にファイルを運び込む運用でも問題ありませんか?
問題ありません。むしろ隔離環境では現実解です。そのかわり運用規律が必要になります:誰がいつファイルを入手し、どのディレクトリへ反映し、異常時にはどこまでロールバックするかが文書化されていないチームほど、「たまたま三か月放置で古かった」状態に気づかず問題を深掘りしがちです。
RULE-SET だけ更新すれば GEOSITE も新しくなりますか?
一般には別物です。セットを更新しても名前付きカタログ側が古ければ、その参照は古い視界のままです。運用チェックリストに「ルールセットと geodata は別チェック」と一行足すだけで見落としが減ります。
Windows と macOS で手順は変わりますか?
概念は同じで、変わるのはパス表現と権限モデルだけです。特に後者では、ユーザー権限しかない場所へのコピーをアプリ側が許可しない/逆に昇格しないとロックが外れない、といった差が出ます。いずれの OS でも「UI が示したフォルダ」か「ログが指したファイル」で最終判断してください。
まとめ
GeoSite と GeoIP が効かなく感じたら、購読やノードだけでなくgeodata 本体の経路と鮮度を疑うことが重要です。Clash Verge Rev ではディレクトリ指定と geox-url、さらには自動更新の有無という三つのノブが強く関連し、手動での差し替えはそれらとの一貫性が取れているときだけ意味を持ちます。差し替え後はログと単純なテストホストで評価が変わったかを確認すれば、「設定ミス」「データ破損」「DNS 側のレイヤ入れ替わり」のどれに近いかがかなり絞られます。
一方で、派生 GUI は画面ラベルと実際のキー対応がリリースのたびに微調整され、読み込み順やマージ結果の置き場所も追記なしには分かりづらい場面があります。公式 README を断片的に読み返すだけでは、問題が geodata にあるのか RULE-SET にあるのか切り分けに時間がかかりがちです。ClashSky は、そのような環境差での迷いを減らすことを意識した導線と資料の整理を進めています。同種の検証をまとめて試したい方は ClashSky クライアントを無料で入手し、体感を比べてください。