Domain list community
This project manages a list of domains, to be used as geosites for routing purposes in Project V.
Purpose of this project
This project is not opinionated. In other words, it does NOT endorse, claim or imply that a domain should be blocked or proxied. It can be used to generate routing rules on demand.
Download links
Notice
- Rules with
@!cn attribute have been cast out from cn lists. geosite:geolocation-cn@!cn is no longer available. Check #390, #3119 and #3198 for more information.
- Dedicated non-category ad lists like
geosite:xxx-ads have been removed. Use geosite:xxx@ads instead. geosite:category-ads[-xx] is not affected.
Please report if you have any problems or questions.
Usage example
Each file in the data directory can be used as a rule in this format: geosite:filename.
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"outboundTag": "Reject",
"domain": [
"geosite:category-ads-all",
"geosite:category-porn"
]
},
{
"type": "field",
"outboundTag": "Direct",
"domain": [
"domain:icloud.com",
"domain:icloud-content.com",
"domain:cdn-apple.com",
"geosite:cn",
"geosite:private"
]
},
{
"type": "field",
"outboundTag": "Proxy-1",
"domain": [
"geosite:category-anticensorship",
"geosite:category-media",
"geosite:category-vpnservices"
]
},
{
"type": "field",
"outboundTag": "Proxy-2",
"domain": [
"geosite:category-dev"
]
},
{
"type": "field",
"outboundTag": "Proxy-3",
"domain": [
"geosite:geolocation-!cn"
]
}
]
}
Generate dlc.dat manually
- Install
golang and git
- Clone project code:
git clone https://github.com/v2fly/domain-list-community.git
- Navigate to project root directory:
cd domain-list-community
- Install project dependencies:
go mod download
- Generate
dlc.dat (without datapath option means to use domain lists in data directory of current working directory):
go run ./go run ./ --datapath=/path/to/your/custom/data/directory
Run go run ./ --help for more usage information.
For anyone who wants to generate custom .dat files, you may read #3370.
Structure of data
All data are under data directory. Each file in the directory represents a sub-list of domains, named by the file name. File content is in the following format.
# comments
include:another-file
domain:google.com @attr1 @attr2
full:analytics.google.com @ads
keyword:google
regexp:^odd[1-7]\.example\.org(\.[a-z]{2})?$
Syntax:
[!NOTE]
Adding new regexp and keyword rules is discouraged because it is easy to use them incorrectly, and proxy software cannot efficiently match these types of rules.
[!NOTE]
The following types of rules are NOT fully compatible with the ones defined by users in the V2Ray config file. Do NOT copy and paste directly.
[!NOTE]
Adding attributes after include:filename means selective inclusion. It's filtering, not flagging.
- Comment begins with
#. It may begin anywhere in the file. The content after # is treated as comment and will be ignored in production.
- Subdomain begins with
domain:, followed by a valid domain name. The prefix domain: may be omitted.
- Full domain begins with
full:, followed by a complete and valid domain name.
- Keyword begins with
keyword:, followed by a substring of a valid domain name.
- Regular expression begins with
regexp:, followed by a valid regular expression (per Golang's standard).
- Domain rules (including
domain, full, keyword, and regexp) may have none, one or more attributes. Each attribute begins with @ and is followed by the name of the attribute. Attributes will remain available in final lists and dlc.dat.
- Domain rules may have none, one or more affiliations, which additionally adds the domain rule into the affiliated target list. Each affiliation begins with
& and is followed by the name of the target list (no matter whether the target has a dedicated file in data path). This is a method for data management, and will not remain in the final lists or dlc.dat.
- Inclusion begins with
include:, followed by the name of another valid domain list. include:list2 in file data/list1 means adding all domain rules of list2 into list1. Inclusions with attributes stand for selective inclusion. include:list2 @attr1 @-attr2 means only adding those domain rules with @attr1 and without @attr2. This is a special type for data management, and will not remain in the final lists or dlc.dat.
How it works
The entire data directory will be built into an external geosite file for Project V. Each file in the directory represents a section in the generated file.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
