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

> Learn how to use bannedbook/fanqiang on Windows, macOS, iOS, Android, and Linux. This comprehensive guide provides easy setup instructions for proxy tools like Clash, V2Ray, and Shadowsocks.

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

---

**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`](https://github.com/bannedbook/fanqiang/blob/main/windows/readme.md) and [`macos/ClashX.md`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/windows/readme.md), which catalogs clients including **Clash for Windows**, **V2rayN**, **SSTap**, **ShadowsocksR**, and **Tor + V2rayN**.

The typical workflow documented in [`windows/readme.md`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/macos/ClashX.md) for **ClashX** setup, though the repository also references **V2rayU**, **Surge**, and **V2rayX**.

According to [`macos/ClashX.md`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/ios/Shadowrocket.md) as the primary guide, covering **Shadowrocket**, **Quantumult X**, **Surge**, **Potatso Lite**, and **Kitsunebi**.

The workflow outlined in [`ios/Shadowrocket.md`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/android/readme.md) and specific client guides like [`android/V2RayNG.md`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/linux/readme.md), which focuses on the **FirefoxFqLinux** bundle and command-line utilities.

The setup process described in [`linux/readme.md`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/ChromeGo/README.md), this bundle embeds multiple protocols (v2ray, ss, ssr, brook, trojan) into a single executable.
- **EdgeGo**: Documented in [`EdgeGo/README.md`](https://github.com/bannedbook/fanqiang/blob/main/EdgeGo/README.md) for Microsoft Edge integration.
- **FirefoxFqLinux**: Detailed in [`FirefoxFqLinux/README.md`](https://github.com/bannedbook/fanqiang/blob/main/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:

```bash

# 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:

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

```bash

# 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`](https://github.com/bannedbook/fanqiang/blob/main/README.md)**: The root index linking to all platform-specific tutorials.
- **[`windows/readme.md`](https://github.com/bannedbook/fanqiang/blob/main/windows/readme.md)**: Central hub for Windows proxy clients and troubleshooting.
- **[`macos/ClashX.md`](https://github.com/bannedbook/fanqiang/blob/main/macos/ClashX.md)**: Detailed ClashX installation and subscription management.
- **[`ios/Shadowrocket.md`](https://github.com/bannedbook/fanqiang/blob/main/ios/Shadowrocket.md)**: iOS-specific setup with subscription automation.
- **[`android/readme.md`](https://github.com/bannedbook/fanqiang/blob/main/android/readme.md)** and **[`android/V2RayNG.md`](https://github.com/bannedbook/fanqiang/blob/main/android/V2RayNG.md)**: Android client installation and APK sources.
- **[`linux/readme.md`](https://github.com/bannedbook/fanqiang/blob/main/linux/readme.md)**: Linux CLI and Firefox bundle instructions.
- **[`router/Merlin.md`](https://github.com/bannedbook/fanqiang/blob/main/router/Merlin.md)**: Router firmware scripting and configuration.
- **`game/PS4-PS5翻墙教程.md`**: Console gateway configuration methods.
- **[`ChromeGo/README.md`](https://github.com/bannedbook/fanqiang/blob/main/ChromeGo/README.md)** and **[`EdgeGo/README.md`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/windows/readme.md), [`macos/ClashX.md`](https://github.com/bannedbook/fanqiang/blob/main/macos/ClashX.md), [`ios/Shadowrocket.md`](https://github.com/bannedbook/fanqiang/blob/main/ios/Shadowrocket.md), [`android/readme.md`](https://github.com/bannedbook/fanqiang/blob/main/android/readme.md), and [`linux/readme.md`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/ios/Shadowrocket.md) and [`android/V2RayNG.md`](https://github.com/bannedbook/fanqiang/blob/main/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.