explaingit

ducksoft/domain-list-community

Analysis updated 2026-07-15 · repo last pushed 2020-06-07

Audience · ops devopsComplexity · 2/5DormantSetup · easy

TLDR

A community-maintained catalog of internet domain names grouped by category, used to tell proxy software like V2Ray how to route or block traffic for specific websites automatically.

Mindmap

mindmap
  root((repo))
    What it does
      Organizes domains by category
      Feeds routing rules to proxies
      Compiles into binary file
    How it works
      Text files of domain lists
      Named categories like google
      Compiled into dlc.dat
    Use cases
      Route specific website traffic
      Block ad domains entirely
      Bypass internet restrictions
    Audience
      Proxy tool users
      People in restricted regions
      Network configuration tinkerers
    Contribution
      Community-edited via pull requests
      Maintainers review changes
      Neutral on blocking decisions
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Route all traffic for a specific website category through a designated proxy server.

USE CASE 2

Block ad domains entirely by referencing a pre-built category list.

USE CASE 3

Send domestic website traffic directly without using a proxy while routing foreign sites through one.

USE CASE 4

Bypass internet restrictions by routing censored site categories through a proxy.

What is it built with?

GoShell

How does it compare?

ducksoft/domain-list-community0xhassaan/nn-from-scratch0xzgbot/hermes-comfyui-skills
Stars00
LanguagePython
Last pushed2020-06-07
MaintenanceDormant
Setup difficultyeasymoderateeasy
Complexity2/54/51/5
Audienceops devopsdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Using it only requires referencing category names in an existing V2Ray config, contributing requires cloning and submitting a pull request with domain entries.

The license is not specified in the repository explanation, so the terms of use are unclear.

In plain English

This project maintains a shared, community-edited catalog of internet domain names, organized into categories like "google," "netflix," or "category-ads-all." Its main purpose is to feed routing rules for Project V (also known as V2Ray), a popular network proxy tool. If you've ever wanted your proxy software to automatically handle certain websites, say, sending traffic to a specific server or blocking it outright, this catalog provides the raw lists to make that happen. The repository is essentially a folder of text files. Each file is named after a category and contains a simple list of domains, keywords, or patterns. For example, a file named "google" might list various Google-owned domains. The project then compiles all these text files into a single binary file (dlc.dat) that Project V can read. When you configure your proxy, you reference these categories by name (like "geosite:category-media") rather than typing out hundreds of individual domains. Who uses this? Anyone running Project V or compatible proxy tools who wants fine-grained, automated routing. For instance, you could tell your proxy: "Route all traffic matching 'geosite:category-anticensorship' through my main proxy server, send 'geosite:cn' directly without a proxy, and block 'geosite:category-ads-all' entirely." It's especially useful for people in regions with internet restrictions, or anyone who wants different traffic to flow through different network paths based on which website they're visiting. A key design choice is that the project is deliberately neutral. It doesn't take a stance on whether a domain should be blocked, proxied, or allowed directly. It just organizes the domains into useful groups. Decisions about what to do with each group are left entirely to the person configuring their own proxy software. The community contributes by submitting pull requests to add or reorganize domains, with maintainers reviewing changes to keep the catalog accurate and well-structured.

Copy-paste prompts

Prompt 1
How do I add a new domain to an existing category in the domain-list-community repo, and what format should the entry follow?
Prompt 2
Show me how to reference geosite categories from this repo in my V2Ray config file to route Netflix traffic through my proxy and send CN traffic directly.
Prompt 3
I want to contribute a new category of domains to domain-list-community. What is the pull request process and how should I name the category file?
Prompt 4
How does the compilation process turn the text files in domain-list-community into the dlc.dat binary file that V2Ray reads?

Frequently asked questions

What is domain-list-community?

A community-maintained catalog of internet domain names grouped by category, used to tell proxy software like V2Ray how to route or block traffic for specific websites automatically.

Is domain-list-community actively maintained?

Dormant — no commits in 2+ years (last push 2020-06-07).

What license does domain-list-community use?

The license is not specified in the repository explanation, so the terms of use are unclear.

How hard is domain-list-community to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is domain-list-community for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.