bannedbook/fanqiang: A Crowdsourced Guide to Bypassing Censorship, Not a Tool
GitHub describes it as Tools for bypassing internet censorship and accessing the open internet. The repository metadata lists Kotlin as its primary language. This article stays within the project description and details documented in the GitHub repository README.
At a glance
- What is it?
- This repository is a collection of tutorials, wiki pages, and a companion Android app for circumventing internet censorship. It is not a single tool but a constantly updated index of methods, and its value depends entirely on the freshness of its links and accounts.
- Who is it for?
- Adopt bannedbook/fanqiang if you are a non-technical user in a censored region who needs a single, community-maintained index of circumvention methods across Windows, Android, iOS, macOS, Linux, routers, and game consoles. Do not rely on it if you need a stable, production-grade tool: the free accounts and one-click packages are volatile and may break without notice.
- Can I use it commercially?
- Not without permission. GitHub finds no licence file in the repository, and without a licence all rights are reserved by default: you may read the code but not reuse it. Check the README, or ask the authors, before using it.
- Is it still maintained?
- Yes. The repository last received commits 4 days ago.
- What is it written in?
- Mainly Kotlin, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- bannedbook/fanqiang56,703 ★ · +6,462
| Repository | 2026-08-13 | 2026-11-15 |
|---|---|---|
| bannedbook/fanqiang | 50.2k | 56.7k |
6,462 Stars in the last 94 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
What This Project Actually Is
The repository named bannedbook/fanqiang is not a program you install. It is a documentation hub, written mostly in Chinese, that aggregates links to tutorials, wiki pages, and configuration guides for circumventing internet censorship. The README lists resources for Windows, Android, iOS, macOS, Linux, routers, and game consoles. It also hosts a small Android application called FQNews, which is the only actual software component in the repository. The primary language is listed as Kotlin, which likely refers to that app. For an engineer evaluating this as a codebase, the first surprise is that almost all value lives in Markdown files and wiki entries, not in source code. The project solves a practical problem: finding reliable, current methods to access blocked websites, especially for users in mainland China. It is aimed at people who need step-by-step instructions for tools like V2ray, Shadowsocks, Clash, and Tor, rather than at developers who want to build their own circumvention stack.
How the Repository Is Organized
The README acts as a table of contents. It branches into directories for each platform: windows, android, ios, macos, linux, router, and game. Each directory contains Markdown files with specific tool names, such as V2RayN.md, ClashDotNetFramework.md, Shadowrocket.md, and OpenWRT.md. The wiki extends this with pages for free SS accounts, v2ray accounts, and platform-specific guides. The structure is flat and predictable, which makes navigation easy. A user lands on the main page, picks their platform, and opens the relevant tutorial. There is no build system, no API, and no data flow in the traditional sense. The only mechanism at work is hyperlinking. The FQNews app, found in the fqnews2 directory, is a separate Android project that presumably delivers news about circumvention tools and updates, though the README does not describe its internals. The repository's utility comes from the curation of links, not from any code logic.
Getting Started: Commands and Config Keys
Because this is a documentation repository, there is no single install command. Instead, the entry point is a browser. You clone the repository or visit the GitHub page, then click into the tutorial for your platform. For example, the Windows section points to V2RayN.md, which presumably explains how to download V2RayN, import server addresses, and configure a local SOCKS5 proxy. The Android section links to V2RayNG.md and Shadowsocks.md. The self-hosted server guides, such as the one for V2ray, are also Markdown files. The README mentions a 'Chrome一键翻墙包' (Chrome one-click circumvention package) and a Mac version, which are likely browser extensions or pre-configured profiles. The practical setup involves downloading a client, obtaining server credentials from the free account wiki pages, and entering those credentials into the client. There are no config keys to memorize because each tutorial provides its own. The FQNews app is the only thing you install from an APK, and the release notes show versions like FQNews-v1.3.8 from August 2024.
The FQNews Android App: A Small Software Component
The repository includes an Android app called FQNews, which the release notes describe as '翻墙新闻(FQNews)安卓APP' (circumvention news Android app). The latest release, FQNews-v1.3.8, was pushed in August 2024. The app's purpose appears to be delivering news and updates related to circumvention tools, possibly including status of free accounts or new methods. The code is in Kotlin, which is the only clue about its architecture. The README does not explain how the app fetches data, whether it uses a backend server, or how it handles updates. For an engineer, this is a thin slice of the project. The app is not the core offering; it is a companion to the documentation. The release history spans from v1.2.1 in 2021 to v1.3.8 in 2024, suggesting intermittent maintenance.
Real Limitations and Failure Modes
The most obvious limitation is volatility. Free SS and v2ray accounts listed in the wiki are shared and often change or die without notice. A tutorial that works today may be obsolete tomorrow. The project does not provide a monitoring system or a guarantee of uptime. The repo's last push was on 2026-09-13, but the ChromeGo release is dated 2022, which suggests that package may be stale. For a user in a high-risk environment, relying on stale packages is dangerous. Another failure mode is the lack of a license. The GitHub metadata shows 'unknown' for license, which means you cannot legally reuse the content without asking permission. The project also mixes third-party tools, like Clash and Shadowsocks, which have their own licenses and security postures. The documentation does not audit those tools. If you are an engineer, this is not a codebase you can fork and extend with confidence; it is a link farm with an app on the side.
Alternatives: Different Approaches to the Same Problem
The README is organised by platform, with guides for Windows, iOS, Android, macOS, routers, Linux and game consoles, and it links to tutorials for individual clients such as V2rayN, Clash, Shadowrocket and Surge rather than replacing those tools.
Maintenance and Upgrade Cost
The repository's last push was on 2026-09-13, and its newest release, FQNews-v1.3.8, is from August 2024. However, the maintenance is uneven. The ChromeGo package has not been updated since 2022, while the FQNews app gets occasional releases. The wiki pages may be updated more frequently, but the README does not show a changelog. For users, the cost is constant vigilance: you must check the last commit date for each tutorial before following it. For developers, there is no upgrade path because there is no software to upgrade. The only component with a version is FQNews, and its release notes do not specify what changed. The lack of a license is a legal cost if you want to reuse the content. You cannot simply copy the Markdown files into your own project without permission. The project's value decays quickly because circumvention methods are a cat-and-mouse game. A tutorial written in 2021 may reference servers that no longer exist. The maintainer's effort is real, but it is a maintenance burden that falls on the user to verify.
Editorial conclusion
Adopt bannedbook/fanqiang if you are a non-technical user in a censored region who needs a single, community-maintained index of circumvention methods across Windows, Android, iOS, macOS, Linux, routers, and game consoles. Do not rely on it if you need a stable, production-grade tool: the free accounts and one-click packages are volatile and may break without notice. Before using any method, verify the current status of the links, check the last commit date for the relevant tutorial, and be aware that the repository has no formal license, so reuse of its content is legally ambiguous. The project is best treated as a starting point for research, not as a maintained software product.
Frequently asked questions
Which VPN is not blocked in China?
It links to pages for free ss accounts and free v2ray accounts, plus V2ray机场.md for commercial providers, and the guides cover client software (V2rayN, Clash, Shadowrocket, Surge, V2RayNG) rather than services.
Can China detect VPN usage?
This is an index of guides rather than a study of detection. It holds configuration guides for named clients, self-hosting walkthroughs for V2ray and Shadowsocks servers, and its last push on master is dated 2026-09-13.
Does China have an Internet firewall?
The project is named and described in terms of 翻墙, crossing the wall, and its whole index exists to reach services that ordinary access does not cover. The repository is organised around how to configure clients on each platform.
What is the best VPN for gaming in China?
The game section covers consoles rather than ranking a VPN: PS4 and PS5 over a local network, Switch, PlayStation, and Xbox using a Mac as a side router, Windows sharing a Wi-Fi adapter as a hotspot, and ClashX Pro on a Mac acting as the gateway.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/bannedbook-fanqiang)Star history chart for your README
[](https://hysenlabs.com/projects/bannedbook-fanqiang)Was this useful?