How to Install bannedbook/fanqiang: A Complete Platform-Specific Guide

To install bannedbook/fanqiang, download the platform-specific archive (ChromeGo for Windows, FirefoxFqLinux for Linux, or the macOS/Android client), extract it with 7-Zip, and run the provided starter script.

The bannedbook/fanqiang repository is a comprehensive collection of open-source anti-censorship tools, scripts, and tutorials supporting Windows, macOS, Linux, Android, iOS, and network routers. Because the project distributes platform-specific binaries rather than a unified installer, the installation process varies by operating system and device. This guide references the actual source files and README documentation from the repository to provide exact, authoritative installation steps.

Prerequisites for All Platforms

Before installing any component, ensure you have the necessary tools to extract and run the software.

• 7-Zip: Required to extract the .7z archives distributed for Windows and Linux packages. Download from the official site linked in the top-level README.
• Google Chrome: The Windows ChromeGo package specifically requires Chrome to open proxy-enabled pages. Install it from the official site or the repository’s wiki page "下载安装Chrome浏览器".
• Git (optional): Needed only if cloning the repository to compile tools manually. Install via sudo apt-get install git on Linux or from the Git website for other platforms.
• Go 1.20+ (optional): Required only for building the core networking utilities from source. These utilities are located in fqnews2/libcore/ and include stun/client.go, box.go, crypto.go, and http.go.

Installing bannedbook/fanqiang on Windows (ChromeGo)

The ChromeGo package is the most popular distribution for Windows users. It contains pre-configured Clash, Xray, and Hysteria tunnels.

Downloading the Archive

Download ChromeGo.7z from one of the four official mirrors. The first two mirrors are typically fastest for users in China:

1. https://d1a.mygrok.top/ChromeGo.7z
2. https://d1.mygrok.top/ChromeGo.7z
3. https://d2.mygrok.top/ChromeGo.7z
4. https://github.com/bannedbook/fanqiang/releases

Extracting and Running

Extract the archive to a folder path containing no Chinese characters or spaces, as paths with non-ASCII characters cause the program to fail. Use PowerShell or 7-Zip:

7z x ChromeGo.7z -oC:\fanqiang\ChromeGo

Navigate to the extracted folder and read the bundled 使用说明（必看） file, which explains which executable to launch. Typically, you run the starter batch file:

cd C:\fanqiang\ChromeGo
start.bat

On first launch, the program will open Chrome, request permission to modify proxy settings, and initiate background tunnels. If Chrome cannot be found automatically, manually configure the path in config.ini or the batch script. See issue #178 in the repository for specific path configuration instructions.

Installing on macOS

macOS users install dedicated GUI clients via drag-and-drop. The repository provides specific guides for each client in the macos/ directory:

• V2RayU: Drag the .app bundle into /Applications. See macos/V2RayU.md.
• V2rayX: Same drag-and-drop method. See macos/V2rayX.md.
• ClashX: Download the .dmg, open it, and copy ClashX to /Applications. See macos/ClashX.md.
• Surge: Follow the third-party Surge installation guide linked in macos/Surge.md.

After installation, grant Full Disk Access and allow applications from unidentified developers in System Preferences to ensure the proxy clients can modify system settings.

Installing on Linux (FirefoxFqLinux)

For Linux users, the repository provides the FirefoxFqLinux package, a Firefox-based proxy bundle.

1. Install the required dependency:

   sudo apt-get -y install curl

2. Download the archive listed under "Firefox一键翻墙包Linux版" in the top-level README.

3. Extract the archive and execute the launch script:

   ./run.sh

Full instructions are documented in FirefoxFqLinux/README.md.

Installing on Android and iOS

Android: Download the pre-packed fqnews2 APK from the releases page. The fqnews2/README.md file explains how to side-load the APK and import proxy profiles.

iOS: The repository contains configuration tutorials for apps like Potatso Lite, Shadowrocket, Quantumult X, and Surge. Refer to ios/README.md for specific setup instructions and profile import steps.

Router and Gaming Console Installation

Routers (OpenWRT/Merlin): The router/ folder contains Markdown guides for flashing firmware and installing v2ray or shadowsocks packages. See router/Merlin.md for Asus Merlin firmware or router/OpenWRT.md for OpenWRT devices.

Gaming Consoles: The game/ folder provides guides for using a Windows or macOS machine as a 旁路由 (bypass gateway) for PS4, PS5, Nintendo Switch, and Xbox. For example, game/Mac电脑使用ClashX Pro给switch开启游戏加速.md details how to route Switch traffic through a Mac running ClashX Pro.

Building from Source (Go Components)

Developers can compile the core networking tools from the fqnews2/libcore/ directory. These files implement the STUN client, crypto primitives, and HTTP subsystems:

• fqnews2/libcore/stun/client.go: STUN client implementation for tunnel tools.
• fqnews2/libcore/box.go: Cross-platform wrapper for launching external binaries.
• fqnews2/libcore/crypto.go: Crypto primitives including AES-GCM and ChaCha20-Poly1305.
• fqnews2/libcore/http.go: Minimal HTTP client for the auto-update subsystem.

Clone and build the repository:

git clone https://github.com/bannedbook/fanqiang.git
cd fanqiang
go build ./...

Summary

• bannedbook/fanqiang provides platform-specific archives rather than a universal installer.
• Windows users should download ChromeGo.7z, extract it to an ASCII-only path with 7-Zip, and run start.bat.
• Linux users should use the FirefoxFqLinux package and execute run.sh after installing curl.
• macOS users install V2RayU, ClashX, or similar clients via drag-and-drop and grant system permissions.
• Source code for core networking logic resides in fqnews2/libcore/ and requires Go 1.20+ to compile.
• All detailed platform guides are located in the respective subdirectories: ChromeGo/, FirefoxFqLinux/, macos/, ios/, router/, and v2ss/ for server setups.

Frequently Asked Questions

Why does ChromeGo fail to find Chrome.exe?

This occurs when Chrome is not installed in the default %ProgramFiles% directory or when the extraction path contains spaces. Edit the config.ini file or the start.bat script to specify the correct path to chrome.exe. Refer to issue #178 for community-verified solutions.

Can I install this on Windows 11?

Yes, but ensure you download the latest release. Earlier versions contained incompatible DLLs that crash on Windows 11, but the changelog indicates these issues were resolved in recent updates dated October 2025.

How do I compile the Go-based tools myself?

Install Go 1.20 or higher, clone the repository, and run go build ./... from the root directory. The core networking implementations are located in fqnews2/libcore/stun/client.go, box.go, crypto.go, and http.go.

What if my extraction path contains Chinese characters?

The ChromeGo and FirefoxFqLinux packages will fail to launch if extracted to paths containing Chinese characters or spaces. Re-extract the archive to a simple ASCII path like C:\fanqiang\ChromeGo or /home/user/fanqiang to resolve this issue.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}