mrkeyoor.com_
Sat 26 Sept 10:51 UTC
Dataevaluationupdated 26 Sept 2026

gfwlist review

Chinese is the primary documentation language for GFWList, and a parallel English README is available. The repository publishes a community-maintained set of web-address rules for compatible proxy clients; it does not provide the proxy client or a live censorship detector.

Verdict

Our lab did not run commit c192925 because GFWList has no supported language ecosystem or Dockerfile; it is a rules subscription, not software you deploy. Use it when your client already understands AutoProxy-style rules and you accept tested, delayed updates. Choose a smaller or client-native ruleset if file size, instant additions, or V2Ray categories matter more.

We ran it

Screenshot of gfwlist (github.com/gfwlist/gfwlist)

Answers from our run

Did you run gfwlist yourself?

No. GitHub reports no primary language for it, and it carries no manifest our lab installs from, and no Dockerfile, so there was nothing standard to install, build or test. This review is written from the repository's own documentation.

Who should not use gfwlist?

Anyone looking for a proxy or VPN application: this repository contains the rule data and update workflow, not a network client.

What are the alternatives to gfwlist?

TinyList, Domain List Community, v2ray-rules-dat. Use it when your client already understands AutoProxy-style rules and you accept tested, delayed updates.

Setup4/5One subscription URL, but you must supply a compatible client
Docs3/5Bilingual delivery notes, with little client configuration help
Community5/525,628 stars and same-day list and issue activity
Maturity4/5Active since 2015, though it publishes no GitHub releases

Who it’s for

People who already use a client that can consume AutoProxy 0.2.9 rules.
Operators who want a public, inspectable China-focused routing list with CDN subscription links.
Maintainers who can review exceptions and domain changes before distributing the list to users.
Users who prefer a community issue process over a vendor-controlled rule feed.

Who it’s NOT for

Anyone looking for a proxy or VPN application: this repository contains the rule data and update workflow, not a network client.
Users who need a newly reported domain added immediately: the README says submissions are tested and updates are not real time.
Teams that need a small common-sites list: the project points those users to gfwlist/tinylist instead.
Operators who cannot use a public CDN or run an internal mirror: the README warns that GitHub raw links may be hard to reach in parts of China and that the other official mirrors may lag or respond slowly.
Anyone treating one static file as a complete record of Great Firewall behavior: the list header says it is unlikely to contain every deployed rule.

Setup reality

Our lab did not run commit c192925 because the repository has no supported language ecosystem and no Dockerfile. The allocated sandbox had 3 CPUs and 8 GB of RAM, but there was no install, build, or test step to execute.

Using GFWList requires a compatible proxy client and a subscription URL, or your own conversion and distribution step. It needs no account or secret for ordinary downloads. The repository carries list.txt plus a Base64-encoded gfwlist.txt, and its workflow uses Perl and OpenSSL to refresh the checksum and generated file.

The operational catch is delivery. GitHub raw access may fail in parts of China, so the README recommends three jsDelivr addresses. It also warns that the two official mirrors can be slow or out of sync. Submitted URLs are tested before inclusion rather than published in real time.

GFWList supplies 4,484 lines of rules and no proxy runtime

GFWList is a data source for a proxy client you already operate. At commit c192925, list.txt contained 4,484 lines and identified its syntax as AutoProxy 0.2.9. Rules include domains, exact URLs, regular expressions, comments, and direct-connection exceptions. The repository does not tunnel traffic or configure a device. Arrive expecting a downloadable VPN and you have the wrong project.

The repository keeps a readable source file and a Base64 subscription file. Its GitHub Actions workflow copies scripts from the gfwlist/apollyon submodule, checks that list.txt is ASCII with Unix line endings, refreshes the checksum, then generates gfwlist.txt with OpenSSL. The decoded subscription at commit c192925 carries a September 26, 2026 timestamp. You can inspect the source before distributing the generated rules.

A 6-hour expiry header does not promise real-time additions

The generated list advertises a 6-hour expiry, yet the English README says submitted URLs are not updated in real time. Maintainers test availability before adding an address. That delay is reasonable for a file that changes traffic routes, though it makes GFWList a poor match for incident response. A domain reported this morning may remain absent while it is checked.

Recent issue handling shows that the delay is not neglect. Requests for linux.sb, write.as, and several August domains were closed within hours or days. A September 26 request was still open when we fetched the repository. GitHub reported 2 open issues and pull requests, including the long-standing posting-guidelines issue. The master branch had changed the same day.

What happened when we ran it

The lab marked commit c192925 as not run because its scanner found no supported language ecosystem and no Dockerfile. The sandbox allocation was 3 CPUs and 8 GB of RAM, but there was no supported install, build, or test command. The primary deliverable is a text subscription, while conversion happens in GitHub Actions. This result says nothing about whether a particular proxy client accepts every rule.

There are no lab timings, package counts, test results, or vulnerability results for this project. The repository has one CI workflow, which installs file, Git, OpenSSL, and Perl before validating and encoding the list. That workflow documents publication mechanics. It does not test client compatibility or network reachability.

Three CDN links solve delivery only if your client supports the format

The README recommends 3 jsDelivr URLs because raw GitHub content may be difficult to reach in parts of China. It also lists GitLab and Repo.or.cz mirrors, warning that they may be slow or out of sync. No credentials are needed. A production setup should choose one source, set a refresh policy, and retain a known file when that source fails.

The file header names AutoProxy 0.2.9, while modern V2Ray and Clash-family setups often use other rule databases or generated formats. GFWList does not document client-by-client import steps. If a client cannot consume the subscription directly, conversion becomes your responsibility, including preservation of exceptions and regular expressions. A successful HTTP download says nothing about whether the client parsed the result.

The list itself says it cannot describe every deployed rule

The source header says GFWList is unlikely to contain the full set of rules deployed inside the Great Firewall. Static community reports can miss new blocks, regional differences, short-lived behavior, and domains that later become reachable. Direct-connection exceptions matter too. Sending every matching hostname through a remote route without review can produce breakage or needless exposure.

Use GFWList as one input to a routing policy. Pin the file you distribute, review diffs, and test important services from the networks your users occupy. The September 26 source change added one domain, while the automated follow-up regenerated 1,573 changed Base64 lines because encoding and metadata shifted. The plain one-line source diff is more useful than reading that churn as 1,573 policy changes.

Chinese documentation leads, with an English copy for delivery basics

The main README is in Simplified Chinese, and README-EN.md supplies an English version. Both cover subscription URLs, TinyList, Apollyon, and encrypted reporting. The English file was updated on September 5, 2026. It is enough to locate the list, though it does not explain the rule grammar or show a complete configuration for a named client.

A URL submission may reveal what a person is trying to reach. The README offers 2 encrypted email routes, requires OpenPGP for one, and warns against sending reports to personal maintainer accounts. Public GitHub issues remain visible. If a report is sensitive, read the submission rules before posting rather than copying an example from the issue queue.

Same-day changes matter more here than the missing release page

GitHub showed 25,628 stars, 3,986 forks, and a last push on September 26, 2026. The project has no GitHub release entry, but that is a weak signal for a continuously updated subscription. Same-day source and generated-file commits, plus recently closed URL requests, show that the list is maintained. Its history since 2015 also predates newer geosite formats.

Choose GFWList for an AutoProxy-compatible client when you want visible changes and an active submission queue. Choose gfwlist/tinylist for common sites, v2fly/domain-list-community for categorized V2Ray geosite data, or Loyalsoldier/v2ray-rules-dat for prebuilt files spanning several clients. The deciding detail is the format your client reads, because a well-maintained rule file is useless after a silent import failure.

Alternatives

ProjectWhat it isPick it when
TinyListA reduced GFWList variant focused on commonly used sites.pick this instead when a smaller rule file matters more than broad coverage.
Domain List Community gh↗A community domain database that generates `geosite.dat` for V2Ray.pick this instead when your routing stack consumes V2Ray geosite categories rather than AutoProxy rules.
v2ray-rules-datPrebuilt GeoIP and geosite rule files for V2Ray, Xray, mihomo, and related clients.pick this instead when you want ready-made regional routing files for those clients, not one GFW-focused URL list.

What people are saying

  1. [velocity-scout] gfwlist/gfwlist

Sources

  1. GFWList repository
  2. GFWList English README
  3. GFWList publication workflow
  4. GFWList measured commit c192925
  5. GFWList issues

More data reviews

simdjson · go-stock · sqlitebrowser · hydradb · DouYin_Spider · helix-db · the whole board →