zhiyi7/gfw-pac

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

1245 stars · 326 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A PAC (Proxy Auto-Config) file generator and ready-made gfw.pac file for routing traffic around the GFW. It matches domains first, then falls back to CN IP-range matching via a Radix Tree, sending Chinese traffic direct and everything else through a proxy, with IPv6 support.

Use cases

• generate a PAC file for system-wide proxy auto-configuration
• route Chinese websites direct and foreign sites through a proxy
• use a PAC file with IPv6 enabled without breaking IP rules
• customize proxy and direct domain lists for a PAC file
• avoid sending domestic traffic through the proxy client for better performance
• configure system proxy for iOS, macOS, Windows, or Android

When to choose

• you want system-level PAC-based proxy routing instead of routing all traffic through a proxy client
• you need IPv6-compatible CN IP matching in a PAC file
• you want a small, maintainable PAC file with weekly-updated GeoIP data

When to avoid

• you need full traffic routing rules inside Clash, Surge, or Xray rather than a PAC file
• you need ad blocking or privacy filtering built into your proxy rules
• you cannot handle DNS pollution yourself, since this project does not solve it

Facets

cli-tool · maturity active

proxy networking cli developer-tools censorship-circumvention networking privacy cross-platform windows cli pac proxy-auto-config gfw geoip cnip ipv6 clash v2ray surge shadowrocket command-line macos android ios

Member repositories

For agents

markdown · JSON · MCP: product_card(name="zhiyi7/gfw-pac")