Geo data

What GeoSite and GeoIP are

GeoSite and GeoIP are V2Ray format databases that let you work with whole categories of sites and IP addresses instead of adding them one by one.

• GeoSite (sitedat.dat) - file with domains grouped into categories. For example, the youtube category contains every domain related to YouTube (youtube.com, googlevideo.com, ytimg.com, etc.)
• GeoIP (ipdat.dat) - file with IP ranges grouped by country and ASN

Why it matters

Instead of manually adding dozens of YouTube or Discord domains, you pick the category in the set settings. When the database is updated, new domains are picked up automatically.

Sources

b4 supports several preset sources and lets you specify a custom URL.

Source	Contents	Link
Loyalsoldier	Global database of domains and IPs (China + worldwide)	GitHub
RUNET Freedom	Database tuned for Russian blocking	GitHub
b4geoip	Official b4 GeoIP database - IP ranges by ASN (GeoIP only)	GitHub

For users in Russia

Try RUNET Freedom for GeoSite (domains) and b4geoip for GeoIP (IP ranges).

b4geoip

The official GeoIP database of the b4 project. It is built automatically from RIPE NCC data - actual announced IP prefixes by ASN. It contains categories for:

• Cloud providers - AWS, Google Cloud, Azure, DigitalOcean, Hetzner, OVH, Scaleway, Oracle Cloud, Contabo, AEZA
• CDN - Cloudflare, Akamai, Fastly, CDN77
• Gaming companies - Roblox, Valve/Steam, Sony/PlayStation, Nintendo, EA, Riot Games, Ubisoft, Epic Games, Wargaming, Bungie, Take-Two, CCP
• Platforms - Telegram, GitHub, Apple, Adobe, Amazon, Blizzard

Unlike country-based databases, b4geoip groups IPs by service, which allows precise routing of traffic for specific platforms.

Configuration

1. Go to Settings -> Geodat settings
2. Enter the Destination directory - where to save the files (default /etc/b4)
3. Pick a Source from the dropdown or enter a URL manually
4. Click Download

The file status is shown next to the name:

• Active - the file is found, size and date are shown
• Not Found - a path is configured but the file is missing, it has to be downloaded
• Disabled - no path is configured, the database is not in use

Files can also be added manually through the Upload button (upload a .dat file).

Changing the destination directory

The destination directory is not a saved setting, so editing the field does not enable the Save button. It takes effect on the next Download or Upload: the file is written to the new directory, and the copy b4 previously wrote at the old path is deleted. Files under a name b4 did not write itself (anything other than geosite.dat / geoip.dat) are left alone.

Removing a database

The Remove button on each card deletes the file from disk and clears its path and source URL. The database is switched off until you download or upload it again - scheduled and startup auto-update do not bring it back, because there is no source URL left to fetch from.

Only files b4 wrote itself are deleted, meaning a geosite.dat or geoip.dat outside the excluded system directories. If the path points at something else - a database shared with another program, or a file under a custom name - the database is still switched off, but the file is left on disk and the status line says so.

Sets that reference categories from a removed database keep their category list, but those categories match nothing until the database is restored. The confirmation dialog names the sets that are affected.

Freeing space

On a device with little storage, removing a database you do not use in any set frees the full file size at once. geoip.dat is often unnecessary if your sets only match by domain.

File size

GeoSite and GeoIP files can take up 5-15 MB each. On routers with limited storage, make sure there is enough space.

Using in sets

After the databases are loaded, the categories become available in set settings (the Targets tab):

• GeoSite categories - pick domain categories for bypass
• GeoIP categories - pick IP categories for bypass

The number of domains/IPs in each category is shown next to it. Click a category to view its contents.

Updating

Databases are updated manually - go to settings and click Download again. No b4 restart is required - new data is picked up automatically.

Tools

Project	Description
GeodatExplorer	Web application for viewing the contents of .dat files - categories, domains, IP ranges. Helps you understand what a category contains before using it in a set
v2dat	CLI utility for extracting V2Ray .dat files into text lists. Useful for scripts and automation
b4geoip	Official b4 GeoIP database (described above)