# acl4ssr/acl4ssr

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/acl4ssr-acl4ssr).**

5,778 stars · 1,953 forks

## Links

- GitHub: https://github.com/ACL4SSR/ACL4SSR
- Homepage: https://t.me/ACL4SSR
- awesome-repositories: https://awesome-repositories.com/repository/acl4ssr-acl4ssr.md

## Topics

`acl` `acl4ssr` `clash` `gfwlist`

## Description

ACL4SSR is a rule set generation and conversion system that produces ready-to-use proxy configuration files for multiple client formats, including Clash, Quantumult, Surge, Surfboard, and Trojan. It combines modular rule fragments from a curated library, applies user-defined overrides, and filters traffic by domain category or geo-IP to produce optimized routing configurations.

The project distinguishes itself through its format-agnostic conversion pipeline, which transforms proxy rule sets between different client formats using external open-source converters as a middleware layer. It provides a pre-built rule fragment library for common services like Netflix and Telegram, and supports a user-override priority layer that ensures custom domain rules take precedence over default entries. The system also implements geo-IP-based traffic splitting, routing domestic connections directly and foreign traffic through proxies based on China IP lists.

The broader capability surface includes content filtering through curated domain lists for ads, trackers, malware, and adult content, as well as the ability to block download domains and malicious sites. The project offers downloadable pre-configured ACL files for whitelist, blacklist, global proxy, and GFWList modes that apply directly to proxy clients.

## Tags

### Content Management & Publishing

- [Proxy Configuration Converters](https://awesome-repositories.com/f/content-management-publishing/content-processing-transformation/document-processing-conversion/proxy-configuration-converters.md) — Transforms subscription links between proxy formats including Clash, Quantumult, Surge, SSR, and V2Ray. ([source](https://github.com/ACL4SSR/ACL4SSR))

### Data & Databases

- [Proxy Rule Format Converters](https://awesome-repositories.com/f/data-databases/tabular-data-structures/format-agnostic-converters/proxy-rule-format-converters.md) — Transforms proxy rule sets between Clash, Quantumult, Surge, Surfboard, and Trojan formats using external converters.

### Development Tools & Productivity

- [Proxy Rule Migrators](https://awesome-repositories.com/f/development-tools-productivity/configuration-importing/proxy-rule-migrators.md) — Transforms ACL rule sets into formats compatible with Clash, Quantumult, Surge, Surfboard, and Trojan clients. ([source](https://cdn.jsdelivr.net/gh/acl4ssr/acl4ssr@rm/README.md))
- [Subscription Format Translators](https://awesome-repositories.com/f/development-tools-productivity/subscription-management/subscription-format-translators.md) — Translates ACL rule sets into formats compatible with Clash, Quantumult, Surge, Surfboard, and Trojan using open-source converters. ([source](https://github.com/ACL4SSR/ACL4SSR/blob/master/README.md))

### Networking & Communication

- [Domain Traffic Filters](https://awesome-repositories.com/f/networking-communication/domain-traffic-filters.md) — Directs network traffic through a proxy or direct connection based on domain lists for domestic and foreign websites. ([source](https://cdn.jsdelivr.net/gh/acl4ssr/acl4ssr@rm/README.md))
- [Geographic Traffic Routing](https://awesome-repositories.com/f/networking-communication/geographic-traffic-routing.md) — Direct domestic traffic to local servers and foreign traffic through proxies using IP ranges and domain lists. ([source](https://github.com/ACL4SSR/ACL4SSR))
- [Domestic Traffic Classifiers](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/network-traffic-management/domestic-traffic-classifiers.md) — Use a China IP list to direct domestic traffic directly and foreign traffic through the proxy. ([source](https://github.com/ACL4SSR/ACL4SSR/tree/master/Acl))
- [Geo-IP Routing Configurations](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/network-traffic-management/domestic-traffic-classifiers/geo-ip-routing-configurations.md) — Direct domestic traffic straight to the destination while sending foreign traffic through a proxy based on IP and domain lists. ([source](https://github.com/ACL4SSR/ACL4SSR/tree/master/.github/workflows))
- [Proxy Routing Rules](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/network-traffic-management/proxy-routing-rules.md) — Directs network connections through proxy or direct paths based on domain, IP, and service rules for optimized access. ([source](https://github.com/ACL4SSR/ACL4SSR))
- [Geo-IP Routing Configurations](https://awesome-repositories.com/f/networking-communication/network-policy-enforcement/ip-range-routing/geo-ip-routing-configurations.md) — Directs domestic traffic directly and foreign traffic through proxies based on China IP lists and regional rules.
- [Network Traffic Routing](https://awesome-repositories.com/f/networking-communication/network-traffic-routing.md) — Direct traffic through proxy or direct paths based on domain and IP rules for optimized routing. ([source](https://github.com/ACL4SSR/ACL4SSR/custom-properties))
- [Format Converters](https://awesome-repositories.com/f/networking-communication/proxy-configuration-formats/format-converters.md) — Translates ACL rule sets into formats compatible with Clash, Quantumult, Surge, Surfboard, and Trojan. ([source](https://github.com/ACL4SSR/ACL4SSR))
- [Proxy Configuration Rules](https://awesome-repositories.com/f/networking-communication/proxy-configuration-rules.md) — Combines and converts proxy rule sets across multiple client formats from modular fragments.
- [IP Range Routing](https://awesome-repositories.com/f/networking-communication/network-policy-enforcement/ip-range-routing.md) — Routes traffic by matching destination IP addresses against a China IP list to decide direct or proxy paths.
- [Rule Fragment Combiners](https://awesome-repositories.com/f/networking-communication/proxy-configuration-rules/rule-fragment-combiners.md) — Combines modular rule fragments for ad blocking, direct connection, and proxying into a single configuration. ([source](https://github.com/ACL4SSR/ACL4SSR))

### Programming Languages & Runtimes

- [Proxy Rule Fragment Libraries](https://awesome-repositories.com/f/programming-languages-runtimes/fragment-integration/proxy-rule-fragment-libraries.md) — Apply modular rule fragments for ad blocking, direct connection, and proxy routing that integrate into existing proxy configurations. ([source](https://cdn.jsdelivr.net/gh/acl4ssr/acl4ssr@rm/README.md))

### Software Engineering & Architecture

- [Proxy Rule Set Generators](https://awesome-repositories.com/f/software-engineering-architecture/functional-composition-rules/proxy-rule-fragment-composers/proxy-rule-set-generators.md) — Generating ready-to-use proxy rule sets for Clash, Quantumult, Surge, Surfboard, and Trojan from modular rule fragments.
- [Proxy Rule Fragment Composers](https://awesome-repositories.com/f/software-engineering-architecture/functional-composition-rules/proxy-rule-fragment-composers.md) — Combines modular rule fragments from separate files into a single proxy configuration by concatenation.

### Web Development

- [Proxy Client Output Generators](https://awesome-repositories.com/f/web-development/api-client-generators/multi-language-client-generation/proxy-client-output-generators.md) — Generates ready-to-use proxy configuration files for Clash, Quantumult, Surge, Surfboard, and Trojan clients.

### DevOps & Infrastructure

- [User-Defined Proxy Override Rules](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/configuration-resolution-engines/configuration-overrides/module-system-overrides/proxy-config-overrides/module-proxy-override-rules/user-defined-proxy-override-rules.md) — Applies a user-editable rule file that overrides default ACL entries for custom domain rules.

### Security & Cryptography

- [Content Filtering and Blocking](https://awesome-repositories.com/f/security-cryptography/application-and-system-security/browser-security/content-filtering-blocking.md) — Blocks ads, trackers, malware, adult content, and unwanted categories by applying curated domain rule sets.
- [Content Filtering Rules](https://awesome-repositories.com/f/security-cryptography/content-filtering-rules.md) — Filters out unwanted content categories such as adult sites, social media, or streaming services using rule sets. ([source](https://github.com/ACL4SSR/ACL4SSR/custom-properties))
- [Domain Name Blocking](https://awesome-repositories.com/f/security-cryptography/domain-based-access-controls/domain-name-blocking.md) — Block domains known for malware, phishing, or other security threats to prevent harmful connections. ([source](https://github.com/ACL4SSR/ACL4SSR/tree/master/.github/workflows))
- [Domain Blocklists](https://awesome-repositories.com/f/security-cryptography/domain-blocklists.md) — Applies curated domain blocklists for ads, trackers, malware, and adult content as proxy rule fragments.
- [Privacy and Ad Blocking](https://awesome-repositories.com/f/security-cryptography/privacy-and-ad-blocking.md) — Block system, app, and video ads by applying curated ACL rules that route ad traffic through a proxy or direct connection. ([source](https://cdn.jsdelivr.net/gh/acl4ssr/acl4ssr@rm/README.md))