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

> Install bannedbook/fanqiang easily with our platform-specific guide. Download archives for Windows, Linux, macOS, or Android and follow simple steps to get started.

- Repository: [如何翻墙/fanqiang](https://github.com/bannedbook/fanqiang)
- Tags: how-to-guide
- Published: 2026-06-15

---

**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`](https://github.com/bannedbook/fanqiang/blob/main/stun/client.go), [`box.go`](https://github.com/bannedbook/fanqiang/blob/main/box.go), [`crypto.go`](https://github.com/bannedbook/fanqiang/blob/main/crypto.go), and [`http.go`](https://github.com/bannedbook/fanqiang/blob/main/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:

```powershell
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:

```cmd
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`](https://github.com/bannedbook/fanqiang/blob/main/config.ini) or the batch script. See issue **[#178](https://github.com/bannedbook/fanqiang/issues/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`](https://github.com/bannedbook/fanqiang/blob/main/macos/V2RayU.md).
- **V2rayX**: Same drag-and-drop method. See [`macos/V2rayX.md`](https://github.com/bannedbook/fanqiang/blob/main/macos/V2rayX.md).
- **ClashX**: Download the `.dmg`, open it, and copy ClashX to `/Applications`. See [`macos/ClashX.md`](https://github.com/bannedbook/fanqiang/blob/main/macos/ClashX.md).
- **Surge**: Follow the third-party Surge installation guide linked in [`macos/Surge.md`](https://github.com/bannedbook/fanqiang/blob/main/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:
   ```bash
   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:
   ```bash
   ./run.sh
   ```

Full instructions are documented in [`FirefoxFqLinux/README.md`](https://github.com/bannedbook/fanqiang/blob/main/FirefoxFqLinux/README.md).

## Installing on Android and iOS

**Android**: Download the pre-packed **fqnews2** APK from the releases page. The [`fqnews2/README.md`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/router/Merlin.md) for Asus Merlin firmware or [`router/OpenWRT.md`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/fqnews2/libcore/stun/client.go): STUN client implementation for tunnel tools.
- [`fqnews2/libcore/box.go`](https://github.com/bannedbook/fanqiang/blob/main/fqnews2/libcore/box.go): Cross-platform wrapper for launching external binaries.
- [`fqnews2/libcore/crypto.go`](https://github.com/bannedbook/fanqiang/blob/main/fqnews2/libcore/crypto.go): Crypto primitives including AES-GCM and ChaCha20-Poly1305.
- [`fqnews2/libcore/http.go`](https://github.com/bannedbook/fanqiang/blob/main/fqnews2/libcore/http.go): Minimal HTTP client for the auto-update subsystem.

Clone and build the repository:

```bash
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`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/config.ini) file or the `start.bat` script to specify the correct path to `chrome.exe`. Refer to issue **[#178](https://github.com/bannedbook/fanqiang/issues/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`](https://github.com/bannedbook/fanqiang/blob/main/fqnews2/libcore/stun/client.go), [`box.go`](https://github.com/bannedbook/fanqiang/blob/main/box.go), [`crypto.go`](https://github.com/bannedbook/fanqiang/blob/main/crypto.go), and [`http.go`](https://github.com/bannedbook/fanqiang/blob/main/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.