hackl0us/ss-rule-snippet

SS-Rule-Snippet is a curated collection of network proxy routing rules for several popular proxy client apps used primarily by Chinese-speaking users: Surge, Quantumult X, Shadowrocket, and Clash. These proxy tools route internet traffic through servers to access content that might otherwise be blocked, and they rely on rule files to decide which traffic to proxy and which to send directly. This repository provides ready-made rule files for each supported app so users do not have to build their own configurations from scratch. The rules are organized into categories. Basic rules cover the minimum needed for typical use and form what the project calls "lazy rules," meaning pre-built complete configurations a user can import without modification. App-specific rules handle special routing needs for particular services like streaming platforms or social apps. Optional rules target specific user groups such as students or frequent video watchers. Functional rules address advanced scenarios like fixing high latency in Siri or enabling global proxy on older Surge versions. The README explains in detail why the project does not include ad-blocking rules. The main reasons are that ad-blocking rules change frequently and become outdated quickly, proxy tools have limited matching capabilities compared to dedicated browser extensions, and loading too many rules slows down the proxy tool or can even cause it to crash, especially on jailbroken devices. The author recommends using dedicated browser extensions like uBlock Origin or AdGuard instead. Contributions are accepted through pull requests and GitHub issues. The README notes that verifying whether a domain is genuinely needed often requires packet capture rather than just trying to visit it in a browser. The project is written primarily in Chinese and is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0, meaning it can be shared and adapted for non-commercial purposes with credit.