Typical Use Cases for bannedbook/fanqiang: A Complete Guide to Circumvention Tools

The bannedbook/fanqiang repository provides platform-specific tutorials, automated server deployment scripts, and ready-to-run browser bundles for circumventing network restrictions across Windows, macOS, Linux, Android, iOS, and routers.

The bannedbook/fanqiang repository is a comprehensive collection of circumvention tools and configuration scripts designed to help users bypass internet censorship. This open-source project organizes proxy client setups, self-hosted server deployments, and pre-configured application bundles into modular documentation covering every major operating system. Whether you need to configure V2Ray on a personal laptop or deploy a Shadowsocks server on a VPS, the repository provides copy-paste commands and detailed walkthroughs.

Personal Client Setup

The repository segregates client configuration by operating system, with each platform having dedicated markdown guides in the root directory. These guides cover importing subscription URLs, configuring routing rules, and enabling system-wide proxy settings.

Windows (V2RayN)

Setting up a Windows client requires installing .NET Framework 4.8 before downloading the proxy software.

1. Download v2rayn.zip from the link provided in windows/V2RayN.md.
2. Import a subscription URL from a free V2Ray service or paid provider.
3. Enable "自动配置系统代理" (Auto-configure system proxy) so browsers automatically route traffic through the proxy.

The complete workflow is documented in windows/V2RayN.md, which includes troubleshooting steps for common connection errors.

macOS (ClashX)

For macOS users, the repository recommends ClashX as the primary client.

1. Open macos/ClashX.md and follow the step-by-step instructions to copy the subscription into the ClashX dashboard.
2. Choose a proxy rule set such as "绕过局域网及大陆地址" (Bypass LAN and mainland addresses) to optimize performance.

Source: macos/ClashX.md contains specific download links and configuration screenshots.

Android (V2RayNG)

Android deployment follows a similar subscription-based model.

1. Install the client from its GitHub releases page (linked in android/V2RayNG.md).
2. Paste the subscription URL into "订阅设置" (Subscription settings).
3. Switch the routing mode to "绕过局域网及大陆地址" to avoid proxying domestic traffic.

The guide in android/V2RayNG.md includes QR code scanning options for quick subscription import.

iOS (Quantumult X)

iOS configuration requires manual profile setup due to App Store restrictions.

1. Open ios/QuantumultX.md to access the specific configuration syntax.
2. Import the subscription file, enable the proxy, and optionally adjust DNS settings for encrypted DNS resolution.

Source: ios/QuantumultX.md provides template configuration files compatible with Quantumult X.

Router-Level Deployment

For network-wide proxying, the repository supports Merlin firmware.

1. Flash a Merlin-compatible firmware onto your router.
2. Apply the router/Merlin.md configuration to run V2Ray or Shadowsocks directly on the router.

This approach proxies all connected devices without individual client installation.

Self-Hosted Server Deployment

The repository supplies a ready-to-run Bash installer that automates V2Ray deployment on fresh VPS instances. Located at v2ss/server-cfg/v2ray-init.sh, this script handles binary installation, system hardening, and subscription file generation.

Deploy a server using the one-line installer:

wget -O - https://raw.githubusercontent.com/bannedbook/fanqiang/master/v2ss/server-cfg/v2ray-init.sh | bash

The v2ray-init.sh script performs the following actions:

• Installs dependencies via apt-get install curl wget.
• Pulls V2Ray binaries using the official install-release.sh.
• Enables persistent service with systemctl enable v2ray.
• Hardens the system by increasing file-descriptor limits, replacing hosts with a block-list, and setting the timezone.
• Deploys Nginx using v2ss/server-cfg/v2ss-nginx.conf for TLS termination and subscription file serving.

After execution, the VPS hosts a subscription URL such as https://<your-vps>/sub.json, which can be imported into any client. Configure Nginx manually using:

wget https://raw.githubusercontent.com/bannedbook/fanqiang/master/v2ss/server-cfg/v2ss-nginx.conf -O /etc/nginx/nginx.conf
systemctl restart nginx

One-Click Browser Bundles

For users needing immediate access without manual configuration, the repository provides ChromeGo and EdgeGo bundles. These directories contain portable browser packages pre-configured with multiple proxy binaries (V2Ray, Shadowsocks, Brook, Trojan) and pre-populated free server lists.

The workflow for these bundles:

1. Download the zip from the links in the README's "ChromeGo – Chrome一键翻墙包" section.
2. Extract to a directory without spaces or non-ASCII characters (the README warns against Chinese-named paths to prevent execution errors).
3. Run the starter script (e.g., StartChromeBrowser.cmd in the portable TorBrowser bundle).
4. The script automatically launches the browser with system proxy settings configured.

Source: ChromeGo/README.md and EdgeGo/README.md detail the specific binaries included and update frequencies.

Summary

• bannedbook/fanqiang organizes circumvention tools into platform-specific guides located in directories like windows/, macos/, android/, and ios/.
• Self-hosted deployment is automated through v2ss/server-cfg/v2ray-init.sh, which installs V2Ray, hardens the OS, and configures Nginx for subscription serving.
• Ready-to-run bundles (ChromeGo, EdgeGo) provide portable solutions for users who cannot manually configure clients.
• All workflows rely on subscription URLs that standardize configuration across different client applications.

Frequently Asked Questions

What is bannedbook/fanqiang and who maintains it?

The bannedbook/fanqiang repository is an open-source collection of circumvention tools, tutorials, and automation scripts maintained by the bannedbook organization. It provides legal, open-source proxy technologies (V2Ray, Shadowsocks, Trojan) to help users bypass network restrictions, with documentation covering client setup and server deployment.

How do I deploy my own V2Ray server using the bannedbook/fanqiang scripts?

Execute the v2ss/server-cfg/v2ray-init.sh script on a fresh Ubuntu VPS using the one-line wget command provided in the repository. This script automatically downloads V2Ray binaries, configures iptables firewall rules, installs Nginx for HTTPS subscription serving, and generates a subscription URL you can import into any compatible client.

What is the difference between ChromeGo and EdgeGo bundles?

ChromeGo packages Google Chrome Portable with embedded proxy clients and free subscription links, while EdgeGo provides the same functionality using Microsoft Edge. Both are located in their respective directories and include StartChromeBrowser.cmd or similar starter scripts that automatically configure the system proxy before launching the browser.

Can I use bannedbook/fanqiang tools on mobile devices?

Yes, the repository includes specific guides for Android (android/V2RayNG.md) and iOS (ios/QuantumultX.md). Android users can install V2RayNG from GitHub releases, while iOS users typically configure Quantumult X or Shadowrocket using the subscription URLs and configuration templates provided in the platform-specific markdown files.

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