Clash Verge

Updated July 2026 · 6 min read

Update GeoIP and GeoSite data

Rules like GEOIP,CN and GEOSITE are not built into the core. They rely on separate data files, and when those go stale or fail to download, whole classes of rules stop matching.

SponsoredNo working nodes yet?Our partner provider gives you 1 GB of high-speed Hong Kong data at signup, with one-click import.Get high-speed nodes
01

Which rules depend on it

GEOIP reads an IP-to-country database, GEOSITE reads a domain category database, and ASN rules read an autonomous-system database. They are three separate files, and a missing one breaks exactly that family of rules.

If the core cannot find or parse them at startup, the log says so plainly and the symptom on screen is a profile that refuses to apply. Read the log before touching your rules.

SponsoredWhere does the subscription link come from?Our partner provider gives you 1 GB of high-speed Hong Kong data at signup — import it in one click.Get high-speed nodes
02

Turn on automatic updates

Set geo-auto-update to true and add geo-update-interval, which is measured in hours. Once a day is plenty for almost everyone; setting it to 1 just wastes bandwidth.

A failing auto-update is usually not a config mistake, it is an unreachable source. The download error appears in the log, and switching sources helps more than retrying.

Start here

Geo data is loaded when the core starts. After replacing a file you have to restart the core — reloading the profile is not enough.

03

Point it at a source you can actually reach

Under geox-url there are separate keys for geoip, geosite, mmdb and asn, each of which can point somewhere else. If GitHub times out on your connection, a working mirror raises the success rate noticeably.

Check the format matches before you switch: geoip and geosite are dat files, mmdb is the MaxMind format. The core does not fall back automatically on a mismatch, it simply fails to load.

04

Replacing a file by hand

Open the app data folder, drop the downloaded file in with the same filename, and restart the core. When automatic updates keep failing, this is the quickest way out.

Do not take geo files from unknown sources. They decide which traffic goes direct, and a tampered category database can quietly send domains you meant to proxy straight out unprotected.

What is the project?

Clash Verge Rev is a Tauri-based GUI for Mihomo with profile management, system proxy, TUN mode, rule editing and WebDAV backups.

Official source