How to Use bannedbook/fanqiang on Different Platforms: Complete Setup Guide for Windows, macOS, iOS, Android, and Linux

The bannedbook/fanqiang repository is a curated collection of markdown tutorials and configuration templates for proxy tools including Clash, V2Ray, Shadowsocks, and SSR, designed to work across Windows, macOS, iOS, Android, Linux, and network routers.

Unlike traditional software repositories that distribute compiled binaries, bannedbook/fanqiang operates as a document-driven knowledge base. Each platform directory contains specific markdown files with download links, prerequisite installation steps, and subscription-based configuration workflows. The repository relies on subscription URLs—plain-text lists of proxy nodes that clients fetch periodically to maintain connectivity.

Understanding the bannedbook/fanqiang Architecture

The repository structure emphasizes portability and platform-native clients rather than universal binaries. According to the repository's design philosophy as implemented in bannedbook/fanqiang, users download official client applications from external sources (GitHub releases, App Stores, or APK repositories) and then import configuration data.

Key architectural characteristics:

• Documentation-only distribution: No compiled executables reside in the repository; instead, files like windows/readme.md and macos/ClashX.md contain curated download links and step-by-step instructions.
• Subscription-centric workflow: Most configurations require a subscription URL (often called an "airport" or 机场 link), which functions as a dynamic configuration endpoint that clients poll for updated node lists.
• Inter-linked guides: Platform-specific documentation cross-references shared resources, such as the "V2ray机场" wiki entry cited across Windows, macOS, and iOS tutorials.

Platform-Specific Setup Guides

Windows Configuration

For Windows users, the primary entry point is windows/readme.md, which catalogs clients including Clash for Windows, V2rayN, SSTap, ShadowsocksR, and Tor + V2rayN.

The typical workflow documented in windows/readme.md follows these steps:

1. Download the desired client from the official release page (e.g., ClashDotNetFramework or V2rayN).
2. Install required runtimes, such as .NET 5 for Clash-based clients.
3. Obtain a Clash or V2Ray subscription link from a public proxy provider (referenced as "机场" in the documentation).
4. Import the subscription into the client interface, enable System Proxy, and verify connectivity.

macOS Configuration

macOS users should consult macos/ClashX.md for ClashX setup, though the repository also references V2rayU, Surge, and V2rayX.

According to macos/ClashX.md, the installation process involves:

1. Downloading the .dmg file for ClashX (or alternative clients).
2. Dragging the application into the Applications folder.
3. Granting administrator privileges when prompted for the helper tool installation.
4. Adding your subscription URL via 托管配置 → 管理 (Managed Configuration).
5. Selecting 规则 (Rule) mode, enabling 系统代理 (System Proxy) or 自动代理 (Auto Proxy), and establishing connectivity.

iOS and iPadOS Configuration

Mobile Apple devices utilize ios/Shadowrocket.md as the primary guide, covering Shadowrocket, Quantumult X, Surge, Potatso Lite, and Kitsunebi.

The workflow outlined in ios/Shadowrocket.md requires:

1. Purchasing and downloading the application from the App Store (Shadowrocket requires a one-time purchase).
2. Navigating to Settings → 服务器订阅 (Server Subscription) and enabling 打开时更新 (Update on Open).
3. Adding a Subscribe entry with your subscription URL and enabling automatic updates.
4. Selecting a proxy node from the list and toggling the VPN switch in the iOS system settings.

For applications not available on the App Store (such as Potatso Lite), consult the respective markdown files in the ios/ directory for alternative installation methods.

Android Configuration

Android documentation resides in android/readme.md and specific client guides like android/V2RayNG.md, covering V2RayNG, Clash for Android, BifrostV, Shadowsocks, SSR, and Surfboard.

The Android setup process documented in these files involves:

1. Downloading the APK from the links provided in each tutorial (e.g., android/V2RayNG.md).
2. Installing the APK, enabling 未知来源 (Unknown Sources) if prompted by Android security settings.
3. Importing a subscription URL or manually entering node configurations.
4. Enabling the VPN service, selecting an active profile, and verifying traffic routing.

Linux Configuration

Linux users are directed to linux/readme.md, which focuses on the FirefoxFqLinux bundle and command-line utilities.

The setup process described in linux/readme.md includes:

1. Downloading the "FirefoxFqLinux" package or compiling compatible tools from source.
2. Installing system dependencies (e.g., sudo apt install libssl-dev for Debian/Ubuntu systems).
3. Placing the subscription configuration file at ~/.config/clash/config.yml and starting the Clash daemon.

Routers and Custom Firmware

For network-level proxying, router/Merlin.md provides instructions for Asus Merlin firmware and OpenWRT devices.

The router configuration process involves:

1. Establishing SSH access to the router and copying the provided shell scripts to the device.
2. Installing v2ray or shadowsocks packages via the router's package manager (opkg).
3. Inserting your subscription URL into the router's configuration file and restarting the proxy service to enable LAN-wide connectivity.

Gaming Consoles and Smart TVs

For devices that cannot run native proxy clients, such as PS4/PS5, Xbox, Nintendo Switch, and Apple TV, the repository provides game/PS4-PS5翻墙教程.md and related guides.

This configuration uses a gateway approach:

1. Configure a macOS or Windows computer running ClashX or Clash for Windows with LAN sharing enabled.
2. Connect the gaming console or TV to the same local network segment.
3. Configure the console's network settings to use the computer's IP address as the proxy gateway.
4. Test latency and connectivity to verify the tunnel is active.

Browser Bundles and One-Click Solutions

The repository includes pre-packaged solutions for users seeking minimal configuration:

• ChromeGo: Located in ChromeGo/README.md, this bundle embeds multiple protocols (v2ray, ss, ssr, brook, trojan) into a single executable.
• EdgeGo: Documented in EdgeGo/README.md for Microsoft Edge integration.
• FirefoxFqLinux: Detailed in FirefoxFqLinux/README.md for Linux browser environments.

These bundles require downloading the archive, extracting it to a directory path without Unicode characters or spaces, and running the executable. The application automatically launches the selected proxy client and configures the browser environment.

Automating Subscription Updates

While the repository focuses on manual GUI configuration, you can script subscription updates using the following patterns derived from the repository's workflow examples.

Update Clash configuration on Linux or macOS:

# Example: download a V2Ray subscription and reload Clash (Linux/macOS)

SUB_URL="https://example.com/clash.yaml"
curl -sSfL "$SUB_URL" -o ~/.config/clash/config.yaml && \
systemctl restart clash.service

Update V2RayN on Windows using PowerShell:

# Example: update V2RayN subscription on Windows (PowerShell)

$sub = "https://example.com/v2ray-sub.txt"
Invoke-WebRequest -Uri $sub -OutFile "$env:APPDATA\V2RayN\config.yaml"

# Restart V2RayN (if running)

Stop-Process -Name V2RayN -ErrorAction SilentlyContinue
Start-Process "$env:ProgramFiles\V2RayN\V2RayN.exe"

Fetch node lists for Android (via Termux):

# Example: fetch a ShadowsocksR node list for Android (inside Termux)

wget -O /sdcard/ssr_nodes.txt "https://example.com/ssr_nodes.txt"

# Then import it via the ShadowsocksR UI

Key Repository Files

Understanding the file structure helps navigate the documentation efficiently:

• README.md: The root index linking to all platform-specific tutorials.
• windows/readme.md: Central hub for Windows proxy clients and troubleshooting.
• macos/ClashX.md: Detailed ClashX installation and subscription management.
• ios/Shadowrocket.md: iOS-specific setup with subscription automation.
• android/readme.md and android/V2RayNG.md: Android client installation and APK sources.
• linux/readme.md: Linux CLI and Firefox bundle instructions.
• router/Merlin.md: Router firmware scripting and configuration.
• game/PS4-PS5翻墙教程.md: Console gateway configuration methods.
• ChromeGo/README.md and EdgeGo/README.md: Browser-integrated bundle usage.

Summary

• bannedbook/fanqiang is a documentation repository providing platform-specific markdown guides for proxy client configuration, not a binary distribution.
• Each platform maintains dedicated files: windows/readme.md, macos/ClashX.md, ios/Shadowrocket.md, android/readme.md, and linux/readme.md.
• The workflow relies on subscription URLs that clients poll for updated node lists; treat these URLs as sensitive credentials.
• Windows users typically deploy Clash or V2rayN, while macOS users favor ClashX, and mobile users utilize Shadowrocket (iOS) or V2RayNG (Android).
• Router configurations in router/Merlin.md enable network-wide proxying, while game/PS4-PS5翻墙教程.md explains gateway-based setups for consoles.
• Browser bundles like ChromeGo and EdgeGo provide portable, multi-protocol solutions requiring no installation.

Frequently Asked Questions

Does bannedbook/fanqiang contain executable files or VPN software?

No. The repository does not host compiled binaries or VPN server software. Instead, it contains markdown documentation and configuration templates that link to external client applications. You must download Clash, V2Ray, Shadowsocks, or other clients separately from their official release pages, then use the repository's guides to configure them with subscription URLs.

What is a subscription URL and where do I obtain one?

A subscription URL is a web endpoint (typically ending in .yaml, .txt, or a long encoded string) that returns a list of proxy server nodes in a format your client understands (Clash, V2Ray, or Shadowsocks). The bannedbook/fanqiang documentation references "V2ray机场" (airport) links—public or private proxy providers that generate these URLs. You paste this URL into your client's subscription settings to automatically populate your server list.

Why do some Android and iOS guides mention specific APK files or Apple IDs?

Certain proxy clients, such as Shadowrocket on iOS, require purchase from the App Store, while others like V2RayNG on Android distribute via APK files outside the Google Play Store. The repository's ios/Shadowrocket.md and android/V2RayNG.md files provide direct links to these distribution channels and explain how to handle installation restrictions (such as enabling "Unknown Sources" on Android or using specific Apple ID regions for iOS).

Can I use bannedbook/fanqiang on a device that doesn't support VPN apps, like a PlayStation or Smart TV?

Yes. For devices that cannot run native proxy clients, the repository provides gateway-based solutions in game/PS4-PS5翻墙教程.md. You configure a Windows or macOS computer on the same network to run Clash with LAN sharing enabled, then point your console or TV's network settings to use that computer's IP address as the proxy gateway. This tunnels traffic from the restricted device through the proxy running on your computer.

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