Surge Geosite & GeoIP

1. Open the dashboard: https://surge.chisan1230.workers.dev.
2. Search and select a dataset (Geosite or GeoIP).
3. Copy the generated raw URL.
4. Paste it into your Surge rules.

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

• Geosite rules path: https://surge.chisan1230.workers.dev/geosite/:name_with_filter
• GeoIP rules path: https://surge.chisan1230.workers.dev/geoip/:country (e.g. /geoip/cn)

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.chisan1230.workers.dev/geosite/apple@cn,DIRECT
RULE-SET,https://surge.chisan1230.workers.dev/geosite/strict/category-ads-all,REJECT
RULE-SET,https://surge.chisan1230.workers.dev/geoip/cn,DIRECT

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

• GET /geoip
• GET /geoip/:country (returns raw rules list for country code)

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

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