Surge Geosite

Automatically converts v2fly/domain-list-community datasets into ready-to-use Surge rules.

English | 中文

Open Dashboard

Direct Use

1. Open the dashboard: https://surge.bojin.co.
2. Search and select a dataset.
3. Copy the generated raw URL.
4. Paste it into your Surge rules.

If you want to use rule URLs directly, the format is:

• Rules path: https://surge.bojin.co/geosite/:name_with_filter

name_with_filter has two forms:

• Without filter: apple Returns the full rules for the apple dataset.
• With filter: apple@cn Returns only rules tagged with @cn.

Surge example:

[Rule]
RULE-SET,https://surge.bojin.co/geosite/apple@cn,DIRECT
RULE-SET,https://surge.bojin.co/geosite/strict/category-ads-all,REJECT

Advanced Usage

API

• GET /geosite
• GET /geosite/:name_with_filter (default mode: balanced)
• GET /geosite/:mode/:name_with_filter

Mode Guide

• strict: only lossless regex conversion
• balanced: controlled downgrade (default)
• full: most permissive conversion (widest coverage, highest over-match risk)

For Maintainers

Local dev:

pnpm install
pnpm build
pnpm test
pnpm panel:dev
pnpm worker:dev

Deploy:

pnpm panel:deploy
pnpm worker:deploy

Technical architecture: docs/architecture.md