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

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 and supporting markdown files. The repository parses these human-readable tables to generate config.yaml or 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, 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:

@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 in the repository root.

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

3. Import the bundled 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 for the specific configuration instructions.

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

3. Import the v2ray.json configuration file generated from the free node list in 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 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 configuration file provided in the repository, or manually copy the node list from 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 or 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. Each platform package includes helper scripts to refresh these configurations.

On Windows, the update process typically involves:

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 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 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. 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://t.me/fqchat), where community members provide configuration support.

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