The v2fly/domain-list-community repository is a community-managed collection of domain lists designed to generate geosite.dat files for V2Ray, a network proxy tool. Written in Go, the project serves as a neutral data repository that does not endorse blocking or proxying specific domains but instead provides raw domain data that users can apply to their own routing rules as needed.
The repository maintains domain lists organized by file in a data directory, where each file represents a distinct category of domains, typically named after domain owners such as companies. The project supports multiple domain rule types including standard subdomains, full domains, keywords, and regular expressions. Each rule can be tagged with attributes beginning with the @ symbol for subcategorization, such as @ads for advertising domains or @cn for services with China mainland access points. The system also supports inclusions and affiliations for efficient data management, allowing lists to reference and incorporate rules from other lists with optional attribute filtering.
The build process converts these organized text-based domain lists into binary geosite.dat files through a multi-step pipeline. The system reads source files, parses and resolves domain rules while handling affiliations and inclusions, deduplicates and sorts entries, exports plain text versions, and finally generates the binary dat file by converting each rule type into appropriate V2Ray routing rule formats. Users can download pre-built dlc.dat files along with SHA256 checksums and plain YAML versions from the releases page, or generate custom dat files locally using the Go-based build tool.
The repository's contributor base overlaps with major projects including Microsoft's VSCode and TypeScript implementations as well as the Rust language project, indicating involvement from developers across multiple ecosystems.
Recent project changes include the removal of rules with @!cn attributes from Chinese domain lists and the deprecation of dedicated ad list files in favor of attribute-based filtering. The project explicitly discourages adding new regexp and keyword rules due to potential misuse and performance concerns in proxy software implementations. Contributions follow a structured process requiring fork-based pull requests, single-file modifications for initial contributions, peer review approval, and automated testing through GitHub Actions. Contributors demonstrating consistent successful contributions can apply for manager access to the repository.
