当你在社区里检索「Clash Verge Rev GeoSite 路径」「Catalog geodata」或「mihomo geo 手动更新」时,十有八九已经遇上了这类症状:GEOSITE/GEOIP 规则看起来像摆设,海外站点被当成国内 CDN 走直连;国内域名反而被误判为境外 IP 扔进代理策略组;或者内核日志里断续出现 Geo 数据库下载失败。与此同时,你自己的 规则分流 其实已经写得不薄,却仍然觉得「语义对、结果不对」——这往往不是你的策略组起名有问题,而是离线 Geo 二进制库版本、文件名格式与内核读取路径三件事没有对齐。
本文标题里的「离线库手动更新」,对应的正是:Clash Verge Rev GeoSite 路径怎么设、GeoIP 离线库如何用一次可追溯的替换校准。面向使用 Clash Verge Rev 且后端为 Mihomo(Clash Meta)内核 的用户:先解释官方 Wiki 里的 geox-url(坊间有时笼统称作 catalog/geodata,或误写成 geodata-url),再结合 geodata-mode(mmdb/dat)讲清文件应落在磁盘何处,最后给出一套可记录来源与哈希的手工离线替换顺序。以下内容以 Mihomo General configuration 为字段语义基准;若与你的客户端内置内核版本不一致,请以发行说明为准逐条核验。
为什么会出现「GEOIP/GEOSITE 看起来像失效」?
在规则语义上,GEOIP,CN,DIRECT 这一类写法依赖两件事:把当前连接的远端 IP 映射到国家或地区字段;GEOSITE,cn,DIRECT 则更依赖内置或下载的域名分类数据库与相应加载器配对。任一环节掉队,你都会看到「我写对了关键字,却始终命不中那条规则」的假阳性感受。
典型诱因可以压缩成三张清单:第一,文件根本没被当前进程读到。 例如配置里写的是相对路径,但 Clash Verge Rev 启动内核时的工作目录与你在 Finder/资源管理器里盯着的目录不是同一个;或者用图形界面改过「配置目录」,旧路径里还躺着一份没被引用的冗余 Country.mmdb,让你误以为已经完成替换。第二,格式选择与内核期望不一致。 geodata-mode 决定优先走 Legacy .dat 语义还是 MaxMind 风格的 .mmdb(详见 Wiki:false 对应 mmdb 思路,true 切到 dat 思路)。你只更新了其中一种后缀,却仍然开着另一种模式时,控制台可能安静无报错——因为「旧的那份还在」,只是内容与预期大相径庭。第三,远端镜像被拦截或哈希不一致。 这种情况下自动更新会悄无声息失败或被重试节流,离线手工同步反而更可追溯。
因此,与其说我们在做「玄学调参」,不如说是在排查一种带版本号的静态资源加载问题:文件名、后缀、哈希、镜像 URL、工作目录五条信息必须能对上同一套发行管线。下面把 Mihomo 侧暴露给用户的关键杠杆拆开叙述,便于你与 Verge 的图形界面逐项勾对。
Mihomo 里与 GeoSite/GeoIP 最直接相关的几项配置
geodata-mode 与装载器:mmdb 还是 dat?
geodata-mode 是很多人对「为什么我明明换了 geoip.dat 却仍显示旧 ASN」这一类问题的第一层答案。设为 true,内核语义上更偏向 Legacy 的 dat 组合;设为 false,则更倾向于走常见的 MaxMind 风格 mmdb 路径。不要凭记忆死记 true/false「谁更正统」,而应以你手头订阅模版、规则集提供者文档及当前内核默认为准;跨版本跳槽时这一项是最常被抄写掉但影响最大的。
与此同时,Wiki 还提供 geodata-loader:standard 与默认的 memconservative 针对不同内存环境下的装载策略(路由器与桌面端体感不同)。一般说来,当你在极低内存路由器上运行时,若在更新大体积 geosite 后出现 OOM,可尝试切换到更省内存的模式;但这是性能与内存的权衡,与「磁盘上文件是否最新」是两件事,不要混在一起解释现象。
geox-url:自定义下载源,常被误叫做 geodata-url
在 Mihomo Wiki 里,这一项写作 geox-url,其子键分别对应不同资源:geoip、geosite、mmdb(以及可选的 ASN 相关镜像)。当你在搜索引擎里看到的是「catalog geodata」或模糊的「geo 远端地址」,多数教程最终仍会落回这一条 YAML 结构上——只是用词不同。
# Example skeleton — URLs from upstream wiki; swap mirrors you trust
geox-url:
geoip: "https://testingcf.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/geoip.dat"
geosite: "https://testingcf.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/geosite.dat"
mmdb: "https://testingcf.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/country.mmdb"
asn: "https://github.com/xishang0128/geoip/releases/download/latest/GeoLite2-ASN.mmdb"
社区讨论里偶有「把整个 catalog 叫作 geodata」的习惯说法,YAML 字段却未必沿用同一单词;你在 Verge 的「配置文件」编辑器里应当以字段名完全一致为准,而不要凭聊天截图里的缩写去对齐缩进。把 geox-url 换成国内可达镜像或与单位合规要求匹配的私有网关,往往比反复点击 UI 的重载更有意义——前提是你要记录这次替换的版本号。
geo-auto-update 与时间间隔
Wiki 中与自动更新配套的开关叫 geo-auto-update(默认常为 false),以及以小时计的 geo-update-interval。若你在弱网或对下载来源持保守态度,完全可以长期关闭自动更新,改为「节假日手工 bump 一份」的策略;相反,若在多设备间希望行为一致,可以打开自动更新但必须保证 geox-url 指向稳定源,并在日志层面确认 etag 校验未异常。
在 Clash Verge Rev 里,「路径」到底相对谁?
Clash Verge Rev 的职责之一,是把 Mihomo 以「服务形态」拉起,并提供订阅、可视化编辑与运行时目录管理。对你来说,最关键的只有一个问题:当你写 ./geo/Country.mmdb 这类相对路径时,圆点代表的是哪一个磁盘目录? 它与「应用本体安装位置」往往不是同一个概念。
通用实践建议是:在客户端内打开「打开配置目录」「打开日志目录」一类的入口,用系统文件管理器直接观察真实路径(不同操作系统与安装渠道:官方包、便携版、用户目录下的配置同步目录——都会改变圆点的落点);如果你曾启用过「多配置」或「工作区切换」,要确保当前激活的那份配置与磁盘上的 geo 副本一致。与纯命令行跑的 mihomo -d /path 相比,图形客户端多了一层封装,误以为「我只要往程序旁边塞一个 mmdb」就能生效,是最容易踩的路径幻觉。
当你准备手工替换时,可以顺手做一张极简运维表(记在笔记软件或工单里):文件名、绝对路径、sha256、来源 tag/日期、是否匹配 geodata-mode。这张表就是「可追溯」四字的具象化——下次同事接手或你自己三个月后复盘,也不至于对着两份体积相近的二进制发呆。
一次可追溯的手动离线替换:建议顺序
下面这套顺序刻意避开「玄学点击」,尽量让每一步有可观察的输出,便于你与团队共享同一套 playbook。
- 读出当前运行时配置片段。 在 Verge 中导出或打开正在使用的
config.yaml(或等价合并结果),逐项记录geodata-mode、geox-url、geo-auto-update;若你还有自定义文件名或挂载路径的旧字段遗留,顺手标红。 - 定位工作目录并把旧库改名为带时间后缀的备份。 例如将
Country.mmdb、geosite.dat、geoip.dat按需复制为.bak-20260511,避免不可逆覆盖;若磁盘空间极度紧张,也至少保留一份最近一次「确认可用」的版本。 - 从可信来源下载离线包并校验哈希。 若你从内网镜像拉取,请确保镜像侧的同步任务与上游 tag 对齐;若没有现成哈希,至少记录 release 页的 commit 或版本号写入你的运维表。
- 按 geodata-mode 放置正确后缀的文件。 若模式与文件类型不一致(mmdb/dat 混用),先调整模式再替换文件,而不要指望内核「凑合读」——那样只会得到静默偏差。
- 通过 Verge 重载配置或重启内核。 观察日志中与 geo 装载相关的行是否有路径报错、权限报错或哈希校验告警(具体关键字随版本变化,以控制台为准)。
- 做一次最小化命中测试。 选择一条你肯定应落入
GEOIP,CN的国内站点域名,和一条你肯定应归入某海外区域集合的域名,对照连接面板或内核日志的策略组命名,确认是否与规则优先级的预期相符;如发现仍异常,再回到「规则排序」维度复查,而不是急着再次覆盖 geo 文件。
如果你对「远端 rule-provider 的规则集本体」也有所怀疑,可把本文与「订阅链路」拆分思考:rule-provider 出问题会导致规则文本本身缺失或陈旧;geo 二进制出问题则偏向「语义都在,但 GEOIP/GEOSITE 标签翻译错了」。两件事可以并行失效,也可以用日志中的下载失败前缀快速分流到不同排查支线。
替换完成后如何自检(不用猜)
经验上最有效的自检不是「体感网速变快」,而是能对上一条确切的规则命中链路。你可以准备两张便签:A 面写 DNS 视角(解析得到哪些 IP);B 面写规则视角(这些 IP 在最新 Country.mmdb 里应当归属哪个区位)。当 A、B、C(策略组命名)任一环节漂移,就把它单独拎出来记在工单上。
若你同时拥有多台设备,而其中只有一台出现 Geo 库异常,优先对比三份 diff:geox-url 是否完全一致、磁盘绝对路径是否一致、geodata-mode 是否被某个「一键导入模版」静默改过。三台机器里只需有一台抄写错误,就足够制造「别人都正常就我玄学」的长期困惑。
DOMAIN 类规则形同虚设,可先读《Clash Meta 嗅探与 SNI》理顺「主机名从何而来」,勿一味归咎于 Geo 二进制。进阶坑位:别把「文件名对了」当成「内核读对了」
第一类坑是冗余副本:升级客户端或切换便携版路径后,旧目录里残留的 mmdb 仍占用磁盘,却不再被引用;当你在聊天里跟朋友对比文件体积时说得头头是道,真正运行时的进程却仍然指向 Application Support 底下的另一棵树。第二类坑是编码与格式化污染:用手动下载的文本编辑器另存二进制、或在网盘同步过程中被「优化」改写,都会造成难以名状的装载失败——尽量用二进制直传与校验。第三类坑是多配置切换:你在 A 配置里改了 geox-url,却忘了当前启动的是 B 配置的合并结果。
长期维护角度看,离线 Geo 二进制与ASN、mmdb、geosite 往往来自同一家发行合集;若你希望精细化「某 CDN ASN 直通」一类的玩法,要确保 ASN 的那份库也与国家库版本节奏匹配,避免出现「Country 更新了、ASN 还停留在上个季度」的撕裂感。细节上仍以你的规则作者说明为准——有人强烈依赖 asn mmdb,有人只用 country,不必强行对齐别人的全套。
常见问题
文档写 geox-url,教程写 geodata-url,我该信谁?
以 Mihomo Wiki 与同版本内核实际能吃下的字段名为准。geox-url 是当前文档化名称;若你在旧模版里看到别名,建议全文搜索配置文件并统一替换后再试,避免重复的键层级导致静默覆盖。
图形界面里没有「GEO 文件夹」菜单怎么办?
这是正常现象:不同版本 Verge 对「一键打开 geo 路径」封装程度不一。你可以通过「打开配置目录」再配合系统搜索 mmdb/dat 后缀定位;必要时分屏对照内核日志中报错的路径字符串(若有)。
一定需要 asn 这一项吗?
仅当你的规则文本或远端规则集中显式用到 ASN/运营商维度的条目时才必须保持更新;否则会表现为局部策略偶尔漂移。可按需关闭或改为直连可信镜像后低频同步。
写在最后
把 Clash Verge Rev 视作「可调度的 Mihomo Shell」而不是魔法黑盒,你会很自然地把 GEO 问题放回版本化二进制资源管理这一栏:geodata-mode 选对格式,geox-url(而不是口头上的 catalog geodata 简称)对齐可信镜像,再在 Verge 实际工作目录下做一次带哈希的手工替换,最后用最小化流量验证 GEOIP/GEOSITE——这条路径比漫无目的地开关 UI 省电得多。TUN、DNS、规则排序若仍并联存在疑问,可把本文当成「Geo 专项检查单」,逐项划掉再继续折腾策略组语义。
不少同类桌面客户端要么把离线 Geo 缓存路径藏得过深且缺少可追溯记录,要么在自动更新失败后只给一句含糊提示,用户在社区帖之间来回试错,却很难形成可复盘的变更记录。相比之下,ClashSky 面向 Mihomo/Clash 系常见痛点整理了可落地的操作说明与分发入口,把「散装搜索」收成更可执行的路径——你在 Verge Rev 上要反复确认的 geodata-url/geox-url 与工作目录对齐,若在一体化工具链里能减少手工拼接过时片段的成本,就能把精力放回规则质量与节点选择本身。→ 立即免费下载 Clash,开启流畅上网新体验。