How to Bypass the Great Firewall with Tor Browser: A Complete Guide Using the Fanqiang Repository

You can bypass the Great Firewall by running Tor Browser Portable alongside V2rayN, routing traffic through Tor's local SOCKS5 proxy at 127.0.0.1:9050 to create an encrypted, censorship-resistant tunnel that evades regional filters.

The bannedbook/fanqiang repository hosts open-source circumvention tools and step-by-step documentation for users facing internet censorship. This guide explains how to bypass the Great Firewall with Tor Browser using the repository's portable Windows build and V2rayN integration, combining Tor's anonymity network with V2ray's performance optimizations to create a robust anti-censorship workflow.

Understanding the Tor Browser Portable Architecture

The fanqiang repository implements a two-layer approach for bypassing the Great Firewall. The architecture relies on Tor Browser Portable providing the censorship-evasion backbone, while V2rayN handles protocol-level optimization and server communication.

Tor Browser Portable Components

Located in tor-browser-portable/readme.md, the portable package provides a self-contained Windows build of the official Tor Browser that requires no system-wide installation. Users extract the archive to any local folder (such as D:\torbrowser) and launch via StartTorBrowser.cmd. The browser comes pre-configured to connect to the Tor network, automatically encrypting traffic and routing it through a worldwide volunteer relay network to bypass regional filtering.

V2rayN Integration Layer

The windows/tor-v2ray.md file documents how to configure V2rayN, a Windows GUI client supporting the VMess protocol. V2rayN acts as the application-layer proxy, forwarding outbound traffic to V2ray servers while leveraging Tor's local SOCKS5 proxy for the initial connection. This setup shields the user's IP address from the V2ray server while allowing V2ray's transport optimizations—such as TLS + WebSocket—to bypass ISP throttling that often affects pure Tor connections.

Step-by-Step Configuration to Bypass Great Firewall with Tor Browser

Setting up this hybrid tunnel requires coordinating both applications so that V2rayN routes its traffic through Tor's local proxy.

Setting Up Tor Browser Portable

First, extract the Tor Browser Portable bundle to your preferred directory. The repository recommends extracting to D:\torbrowser for consistency with the provided documentation. Launch the browser by executing StartTorBrowser.cmd from the extraction folder. Wait approximately 10 seconds for Tor to establish circuits and verify connectivity—the browser will indicate when it successfully connects to the Tor network.

Configuring V2rayN for Tor Proxy Chaining

Once Tor is running, configure V2rayN to use Tor's SOCKS5 proxy as its outbound dialer. In the V2rayN configuration, set the Outbound proxy to 127.0.0.1:9050, which is the default Tor local port. According to windows/tor-v2ray.md, this configuration allows V2rayN to establish its VMess connections through Tor's encrypted tunnel, providing both the censorship resistance of Tor and the performance benefits of V2ray's transport protocols.

Implementation Code Examples

Below is the minimal quick-start workflow for Windows command prompt after extracting Tor Browser Portable to D:\torbrowser.

Launch Tor Browser and wait for circuit establishment:

:: Launch Tor Browser (portable) – this opens the Tor network
D:\torbrowser\StartTorBrowser.cmd

:: Wait for Tor to establish circuits
timeout /t 10

:: Start V2rayN pointing at the local Tor SOCKS5 proxy
:: Assumes V2rayN is installed and its config file is v2rayn.json
v2rayn.exe -config "C:\Program Files\V2rayN\v2rayn.json" -proxy "socks5://127.0.0.1:9050"

Configure V2rayN with the following outbound JSON to route VMess traffic through Tor's SOCKS5 proxy:

{
  "outbounds": [
    {
      "protocol": "vmess",
      "settings": { 
        "vnext": [{ 
          "address": "your.v2ray.server", 
          "port": 443, 
          "users": [{ 
            "id": "uuid", 
            "alterId": 64, 
            "security": "auto" 
          }] 
        }] 
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "wsSettings": { "path": "/yourpath" }
      },
      "sockopt": {
        "tcpNoDelay": true,
        "tproxy": "tcp",
        "dialerProxy": "socks5://127.0.0.1:9050"
      }
    }
  ]
}

Running these commands creates a Tor-wrapped V2ray tunnel that any application respecting the system proxy can utilize.

Key Repository Files and Documentation

The fanqiang repository maintains specific documentation for this workflow:

• tor-browser-portable/readme.md – Contains download links, installation instructions, and launch procedures for the portable Tor Browser on Windows.
• windows/tor-v2ray.md – Provides the complete tutorial on combining Tor Browser with V2rayN, including configuration screenshots and advanced troubleshooting.
• windows/readme.md – Serves as the index for all Windows-specific circumvention tools, linking to the Tor + V2ray guide.
• README.md (root) – Acts as the central hub linking to all platform-specific guides, including the Tor Browser one-click package references.

Summary

• Bypass the Great Firewall with Tor Browser by combining the bannedbook/fanqiang portable packages with V2rayN proxy chaining.
• Tor Browser Portable runs from any folder (e.g., D:\torbrowser) via StartTorBrowser.cmd without requiring installation.
• The default Tor SOCKS5 proxy listens on 127.0.0.1:9050, which V2rayN uses as its dialerProxy in the outbound configuration.
• This hybrid approach provides privacy (Tor hides your IP from V2ray servers) and reliability (V2ray's TLS + WebSocket bypasses ISP throttling).
• All configuration steps are documented in tor-browser-portable/readme.md and windows/tor-v2ray.md.

Frequently Asked Questions

What is the default SOCKS5 proxy port when running Tor Browser Portable?

Tor Browser binds its SOCKS5 proxy to 127.0.0.1:9050 by default on Windows. You must configure V2rayN or any other client to use this specific address and port to route traffic through the Tor network.

Can I run Tor Browser Portable without administrator privileges?

Yes. Because the portable version extracts to a user-controlled directory (such as D:\torbrowser) and launches via StartTorBrowser.cmd, it does not require Windows administrator rights or system-wide installation, making it suitable for restricted environments.

Why should I combine V2rayN with Tor instead of using Tor alone?

Combining both tools creates a hybrid tunnel where Tor provides censorship resistance and IP anonymity for the first hop, while V2rayN provides VMess protocol optimization with TLS and WebSocket transport that can bypass ISP throttling and deep packet inspection that sometimes targets pure Tor traffic.

Where are the configuration files located in the fanqiang repository?

The primary documentation resides in tor-browser-portable/readme.md (setup instructions) and windows/tor-v2ray.md (integration tutorial), both accessible from the root of the bannedbook/fanqiang repository on GitHub.

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