8000 GitHub - xxxbrian/Surge-Geosite: Geosite ruleset for Surge · GitHub
[go: up one dir, main page]

Skip to content

About

Geosite ruleset for Surge

Resources

Stars

67 stars

Watchers

1 watching

Forks

Repository files navigation

Surge Geosite

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

English | 中文

Open Dashboard

Surge Geosite 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 returns { [listName]: filters[] }
  • GET /geosite/:name_with_filter (default mode: balanced)
  • GET /geosite/:mode/:name_with_filter

Mode Guide

  • strict: only lossless regex conversion
  • balanced: conservative conversion that prioritizes avoiding false matches; omissions are allowed (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

About

Geosite ruleset for Surge

Resources

Stars

67 stars

Watchers

1 watching

Forks

Used by

Contributors

Languages

0