Surge-rules generates rule sets (DOMAIN-SET and RULE-SET) for Surge for iOS and Surge for Mac clients. This project automates the creation of up-to-date rules using GitHub Actions, ensuring the lists remain current. The rules are primarily sourced from @Loyalsoldier/v2ray-rules-dat, @v2fly/domain-list-community, and other reliable sources like felixonmars/dnsmasq-china-list and 17mon/china_ip_list. It offers a variety of rule sets including domain lists, CIDR blocks and rulesets,catering to specific user needs such as direct connections, proxy configurations, and filtering.
The project distinguishes itself with its automated update process via GitHub Actions, maintaining high rule freshness. It offers both direct download links (raw and CDN) for easy integration, with CDN providing a readily available source even when raw links are unavailable. The categorization into direct and ruleset files promotes efficient configuration and customization. The inclusion of numerous lists for different use cases gives users flexibility and control.
- Regular Updates: Rules are automatically generated daily via GitHub Actions, ensuring up-to-date ad-blocking and filtering capabilities.
- Multiple Rule Sets: Provides separate domain-set and ruleset files allowing customization of configuration.
- Diverse Domain Lists: Includes a wide range of domain lists including direct connections, proxies, and specific categories like Apple and Google domains.
- CDN Availability: Offers CDN links for quick and consistent rule acquisition, even when raw links are unavailable.
- CN COVID-19 CIDR: Includes lists for CIDR expressions enabling fine-grained network control.
- Extensive Coverage: Includes comprehensive lists for global domains, gfw lists, and private domain blocks.
- Developer Friendly: Provides clear and organized directory structure facilitating easy integration and customization.
The project appears actively maintained with regular updates and a growing number of forks, indicating community interest and support. The GitHub Actions workflow ensures the rulesets are automatically refreshed. The documentation is comprehensive covering various domains and rule types but could be improved with more detailed explanations of the usage. The project actively uses GitHub for issue tracking and maintains a responsive maintainer presence.
This project benefits users seeking comprehensive and regularly updated rules for Surge, enabling effective ad-blocking, censorship circumvention, and network control. It provides valuable functionality for users operating in environments with network restrictions or those looking for advanced filtering options. By offering pre-built rule sets, it simplifies the configuration process compared to manually compiling lists from disparate sources.