# How to Use bannedbook/fanqiang for Internet Access: Complete Setup Guide

> Access the internet freely with bannedbook/fanqiang. This guide offers a complete setup for Windows, macOS, Linux, Android, iOS, and routers using V2Ray, Shadowsocks, and Xray.

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

---

**bannedbook/fanqiang is a curated collection of open-source proxy tools and free server nodes that provides one-click internet access solutions for Windows, macOS, Linux, Android, iOS, and routers through pre-configured V2Ray, Shadowsocks, and Xray clients.**

The bannedbook/fanqiang repository distributes ready-to-use proxy packages rather than proprietary software, organizing client binaries and configuration files into platform-specific directories like `windows/`, `macos/`, and `android/`. By downloading the appropriate bundled package for your operating system and executing the provided startup scripts, you can establish a secure proxy connection to bypass network restrictions within minutes.

## Understanding the Repository Architecture

The repository structures its components into distinct categories to create a plug-and-play experience. All heavy lifting is handled by pre-compiled binaries and automated scripts, eliminating manual configuration.

### Client Binaries and Proxy Engines

Pre-compiled executables reside in platform-specific folders (`windows/`, `macos/`, `android/`, `ios/`, `router/`). These include `v2ray.exe`, `clash.exe`, and `ss-local`, which perform the actual traffic forwarding to free proxy servers.

### Server Node Lists and Configuration

Free V2Ray, Shadowsocks, and Xray node information (IP addresses, ports, protocols, UUIDs) is stored in [`v2ss/v2free.md`](https://github.com/bannedbook/fanqiang/blob/main/v2ss/v2free.md) and supporting markdown files. The repository parses these human-readable tables to generate [`config.yaml`](https://github.com/bannedbook/fanqiang/blob/main/config.yaml) or [`config.json`](https://github.com/bannedbook/fanqiang/blob/main/config.json) files automatically.

### Startup Scripts and Automation

Batch files and shell scripts located in each package directory handle client initialization. The Windows `run.bat` script, for example, launches the proxy client and configures Chrome to use the local SOCKS5/HTTP proxy at `127.0.0.1:1080`.

## Windows Setup Using ChromeGo

ChromeGo provides a one-click solution for Windows users that bundles Chrome browser configuration with V2Ray proxy connections.

1. **Download the package** from the mirrors listed in [`ChromeGo/README.md`](https://github.com/bannedbook/fanqiang/blob/main/ChromeGo/README.md), such as `https://d1a.mygrok.top/ChromeGo.7z`.

2. **Extract the archive** to a folder path containing no Chinese characters or spaces (e.g., `C:\fanqiang\ChromeGo`). This requirement is enforced by the startup scripts.

3. **Read the usage guide** (`使用说明（必看）`) inside the extracted folder to identify the correct batch file.

4. **Execute the startup script** (typically `run.bat`), which performs the following actions:

```bat
@echo off
rem Launch V2Ray with bundled config
start "" "v2ray.exe" -config "config.json"
rem Wait for proxy initialization
timeout /t 5 >nul
rem Launch Chrome using the local proxy
start "" "C:\Program Files\Google\Chrome\Application\chrome.exe" --proxy-server="http://127.0.0.1:1080"

```

If Chrome fails to launch, verify that `chrome.exe` exists in the expected path or consult the troubleshooting guide in the repository's Issues section (e.g., issue #432).

## macOS Configuration with ClashX

For macOS users, the repository provides GUI-based proxy management through ClashX.

1. Navigate to [`macos/ClashX.md`](https://github.com/bannedbook/fanqiang/blob/main/macos/ClashX.md) in the repository root.

2. Download the ClashX application (DMG format) and install it on your system.

3. Import the bundled [`config.yml`](https://github.com/bannedbook/fanqiang/blob/main/config.yml) from the `macos/` directory into the ClashX interface.

4. Enable the **System Proxy** toggle within the ClashX menu bar application to route all system traffic through the selected V2Ray or Shadowsocks node.

## Android Setup with V2RayNG

The Android implementation uses the V2RayNG application, which functions as a standard VPN client.

1. Refer to [`android/V2RayNG.md`](https://github.com/bannedbook/fanqiang/blob/main/android/V2RayNG.md) for the specific configuration instructions.

2. Install the V2RayNG APK (available in the repository or via Google Play Store).

3. Import the [`v2ray.json`](https://github.com/bannedbook/fanqiang/blob/main/v2ray.json) configuration file generated from the free node list in [`v2ss/v2free.md`](https://github.com/bannedbook/fanqiang/blob/main/v2ss/v2free.md).

4. Activate the VPN toggle within the V2RayNG application to establish the encrypted tunnel.

## iOS Configuration via Shadowrocket

iOS devices require Shadowrocket or alternative clients like Potatso Lite.

1. Consult [`ios/Shadowrocket.md`](https://github.com/bannedbook/fanqiang/blob/main/ios/Shadowrocket.md) for detailed setup instructions.

2. Install Shadowrocket from the App Store (paid application) or use a free alternative like Potatso Lite.

3. Import the [`Shadowrocket.conf`](https://github.com/bannedbook/fanqiang/blob/main/Shadowrocket.conf) configuration file provided in the repository, or manually copy the node list from [`v2ss/v2free.md`](https://github.com/bannedbook/fanqiang/blob/main/v2ss/v2free.md).

4. Activate the proxy within the application to enable system-wide VPN functionality.

## Router Installation on OpenWRT and Merlin

For network-wide proxy coverage, the repository supports router firmware configurations.

1. Access [`router/OpenWRT.md`](https://github.com/bannedbook/fanqiang/blob/main/router/OpenWRT.md) or [`router/Merlin.md`](https://github.com/bannedbook/fanqiang/blob/main/router/Merlin.md) depending on your firmware type.

2. Flash the appropriate firmware (if not already installed) and navigate to the VPN settings in the web administration panel.

3. Add the free V2Ray or Shadowsocks node information manually or import the configuration file.

4. The `v2ss/server-cfg/v2ray.service` file provides a systemd service template for persistent Linux-based router deployments.

## Updating Free Proxy Nodes

The repository maintains current free nodes in [`v2ss/v2free.md`](https://github.com/bannedbook/fanqiang/blob/main/v2ss/v2free.md). Each platform package includes helper scripts to refresh these configurations.

On Windows, the update process typically involves:

```bat
rem Fetch latest node table from GitHub
curl -L https://raw.githubusercontent.com/bannedbook/fanqiang/master/v2ss/v2free.md > nodes.txt
rem Parse and regenerate configuration
python generate_config.py nodes.txt > config.json

```

The exact script names vary by package, but the `使用说明` (usage instructions) file in each archive specifies the correct update command for refreshing server nodes without re-downloading the entire client package.

## Summary

- **bannedbook/fanqiang** provides open-source proxy clients and free server nodes for multiple platforms without proprietary software dependencies.
- **Windows users** should download ChromeGo, extract to an ASCII-only path, and run `run.bat` to launch Chrome through a V2Ray proxy.
- **macOS, Android, and iOS** users import configurations from [`v2ss/v2free.md`](https://github.com/bannedbook/fanqiang/blob/main/v2ss/v2free.md) into ClashX, V2RayNG, or Shadowrocket respectively.
- **Router configurations** utilize OpenWRT or Merlin firmware guides to enable network-wide proxy coverage.
- **Node updates** are performed via helper scripts that parse the latest [`v2free.md`](https://github.com/bannedbook/fanqiang/blob/main/v2free.md) tables without requiring full package reinstallation.

## Frequently Asked Questions

### Is bannedbook/fanqiang legal to use?

The repository distributes only open-source proxy software (V2Ray, Shadowsocks, Xray) and publicly available configuration data. The legality of using these tools depends on your local jurisdiction's regulations regarding internet circumvention. The project itself contains no proprietary software or copyrighted material.

### Why must I extract the Windows package to a path without Chinese characters?

The batch scripts (`run.bat`, `start.bat`) and some legacy proxy clients in the Windows package use legacy encoding or command-line parsing that fails when encountering non-ASCII characters or spaces in file paths. Extracting to `C:\fanqiang\ChromeGo` ensures the scripts execute correctly without path resolution errors.

### How do I update the proxy server nodes when they stop working?

Each platform package includes an update mechanism (typically `update_nodes.bat` on Windows or manual import on mobile) that pulls the latest node list from [`v2ss/v2free.md`](https://github.com/bannedbook/fanqiang/blob/main/v2ss/v2free.md). Run this update script periodically, as free public nodes frequently change their IP addresses or ports to maintain connectivity.

### Where can I get help if the proxy connection fails?

Consult the repository's **Issues** page on GitHub for troubleshooting specific error messages (e.g., Chrome startup failures documented in issue #432). For real-time assistance, join the Telegram discussion group linked in the main [`README.md`](https://github.com/bannedbook/fanqiang/blob/main/README.md) (`https://t.me/fqchat`), where community members provide configuration support.