{"id":34943160,"url":"https://github.com/team-cloudchaser/domain-db","last_synced_at":"2026-01-23T18:21:03.802Z","repository":{"id":37509989,"uuid":"423165385","full_name":"team-cloudchaser/domain-db","owner":"team-cloudchaser","description":"🛡 Several domain lists compiled into a database file used by V2Ray.","archived":false,"fork":false,"pushed_at":"2026-01-16T16:55:20.000Z","size":21236,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-01-17T23:41:57.480Z","etag":null,"topics":["blocklist","geosite","v2ray","xtls"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/team-cloudchaser.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-10-31T14:07:41.000Z","updated_at":"2026-01-03T07:59:57.000Z","dependencies_parsed_at":"2023-09-26T21:50:52.047Z","dependency_job_id":"f7de3a8f-80d8-46b0-8be1-22741497cf15","html_url":"https://github.com/team-cloudchaser/domain-db","commit_stats":null,"previous_names":["team-cloudchaser/domain-db"],"tags_count":376,"template":false,"template_full_name":null,"purl":"pkg:github/team-cloudchaser/domain-db","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/team-cloudchaser%2Fdomain-db","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/team-cloudchaser%2Fdomain-db/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/team-cloudchaser%2Fdomain-db/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/team-cloudchaser%2Fdomain-db/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/team-cloudchaser","download_url":"https://codeload.github.com/team-cloudchaser/domain-db/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/team-cloudchaser%2Fdomain-db/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28697428,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T17:25:48.045Z","status":"ssl_error","status_checked_at":"2026-01-23T17:25:47.153Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blocklist","geosite","v2ray","xtls"],"created_at":"2025-12-26T19:33:18.134Z","updated_at":"2026-01-23T18:21:03.785Z","avatar_url":"https://github.com/team-cloudchaser.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Domain list database\n\nThis project was pulled and forked from `v2fly/domain-list-community`, with only its data changed to use several blocklists.\n\nThis project does not need to appear to be maintained, as almost every update is conducted automatically without need of manual intervention. The blocklists are built twice a week.\n\n## Purpose of this project\n\nMake your *ray instance a powerful adblocker, either on servers or on clients.\n\nBuild status: [![Build dlc.dat](https://github.com/ltgcgo/domain-db/actions/workflows/build.yml/badge.svg)](https://github.com/ltgcgo/domain-db/releases/latest/download/dlc.dat) (Click to download!)\n\n## Download links\n\n- **dlc.dat**：[GitHub Releases](https://github.com/ltgcgo/domain-db/releases/latest/download/dlc.dat)\n- **dlc.dat.sha256sum**：[GitHub Releases](https://github.com/ltgcgo/domain-db/releases/latest/download/dlc.dat.sha256sum)\n\n## Usage example\n\nEach file in the `data` directory can be used as a rule in this format: `geosite:filename`.\n\n```json\n\"routing\": {\n  \"domainStrategy\": \"IPIfNonMatch\",\n  \"rules\": [\n    {\n      \"type\": \"field\",\n      \"outboundTag\": \"Reject\",\n      \"domain\": [\n        \"geosite:category-ads-all\",\n        \"geosite:category-porn\"\n      ]\n    },\n    {\n      \"type\": \"field\",\n      \"outboundTag\": \"Direct\",\n      \"domain\": [\n        \"domain:icloud.com\",\n        \"domain:icloud-content.com\",\n        \"domain:cdn-apple.com\",\n        \"geosite:cn\",\n        \"geosite:private\"\n      ]\n    },\n    {\n      \"type\": \"field\",\n      \"outboundTag\": \"Proxy-1\",\n      \"domain\": [\n        \"geosite:category-anticensorship\",\n        \"geosite:category-media\",\n        \"geosite:category-vpnservices\"\n      ]\n    },\n    {\n      \"type\": \"field\",\n      \"outboundTag\": \"Proxy-2\",\n      \"domain\": [\n        \"geosite:category-dev\"\n      ]\n    },\n    {\n      \"type\": \"field\",\n      \"outboundTag\": \"Proxy-3\",\n      \"domain\": [\n        \"geosite:geolocation-!cn\"\n      ]\n    }\n  ]\n}\n```\n\n## Generate `dlc.dat` manually\n\n- Install `golang` and `git`\n- Clone project code: `git clone https://github.com/ltgcgo/domain-db.git`\n- Navigate to project root directory: `cd domain-db`\n- Install project dependencies: `go mod download`\n- Generate `dlc.dat` (without `datapath` option means to use domain lists in `data` directory of current working directory):\n  - `go run ./`\n  - `go run ./ --datapath=/path/to/your/custom/data/directory`\n\nRun `go run ./ --help` for more usage information.\n\n## Structure of data\n\nAll 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.\n\n```\n# comments\ninclude:another-file\ndomain:google.com @attr1 @attr2\nkeyword:google\nregexp:www\\.google\\.com$\nfull:www.google.com\n```\n\n**Syntax:**\n\n\u003e The following types of rules are **NOT** fully compatible with the ones that defined by user in V2Ray config file. Do **Not** copy and paste directly.\n\n* Comment begins with `#`. It may begin anywhere in the file. The content in the line after `#` is treated as comment and ignored in production.\n* Inclusion begins with `include:`, followed by the file name of an existing file in the same directory.\n* Subdomain begins with `domain:`, followed by a valid domain name. The prefix `domain:` may be omitted.\n* Keyword begins with `keyword:`, followed by a string.\n* Regular expression begins with `regexp:`, followed by a valid regular expression (per Golang's standard).\n* Full domain begins with `full:`, followed by a complete and valid domain name.\n* Domains (including `domain`, `keyword`, `regexp` and `full`) may have one or more attributes. Each attribute begins with `@` and followed by the name of the attribute.\n\n## How it works\n\nThe 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.\n\nTo generate a section:\n\n1. Remove all the comments in the file.\n2. Replace `include:` lines with the actual content of the file.\n3. Omit all empty lines.\n4. Generate each `domain:` line into a [sub-domain routing rule](https://github.com/v2fly/v2ray-core/blob/master/app/router/config.proto#L21).\n5. Generate each `keyword:` line into a [plain domain routing rule](https://github.com/v2fly/v2ray-core/blob/master/app/router/config.proto#L17).\n6. Generate each `regexp:` line into a [regex domain routing rule](https://github.com/v2fly/v2ray-core/blob/master/app/router/config.proto#L19).\n7. Generate each `full:` line into a [full domain routing rule](https://github.com/v2fly/v2ray-core/blob/master/app/router/config.proto#L23).\n\n## How to organize domains\n\n### File name\n\nTheoretically any string can be used as the name, as long as it is a valid file name. In practice, we prefer names for determinic group of domains, such as the owner (usually a company name) of the domains, e.g., \"google\", \"netflix\". Names with unclear scope are generally unrecommended, such as \"evil\", or \"local\".\n\n### Attributes\n\nAttribute is useful for sub-group of domains, especially for filtering purpose. For example, the list of `google` domains may contains its main domains, as well as domains that serve ads. The ads domains may be marked by attribute `@ads`, and can be used as `geosite:google@ads` in V2Ray routing.\n\n## Contribution guideline\n\n* Fork this repo, make modifications to your own repo, file a PR.\n* Please begin with small size PRs, say modification in a single file.\n* A PR must be reviewed and approved by another member.\n* After a few successful PRs, you may apply for manager access to this repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteam-cloudchaser%2Fdomain-db","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteam-cloudchaser%2Fdomain-db","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteam-cloudchaser%2Fdomain-db/lists"}