What Is ChromeGo and How to Use It: The Complete Guide to the bannedbook/fanqiang Proxy Bundle

ChromeGo is a pre‑configured censorship‑circumvention suite from the bannedbook/fanqiang repository that bundles ten proxy tools—including Clash, Xray, and Sing‑Box—into a single 7z archive, enabling one‑click launching of Chrome with pre‑set anti‑blocking servers.

ChromeGo (also marketed as Chrome一键翻墙包) provides a turnkey solution for Windows and macOS users who need immediate access to blocked internet resources. Rather than configuring individual proxy clients manually, users extract the archive and run a launcher script that automatically routes Chrome traffic through the selected protocol. According to the project source code, the bundle ships with free, frequently‑rotated servers maintained by the repository maintainers, eliminating the need for personal VPS setup or subscription fees.

What Is ChromeGo?

ChromeGo is a compilation package distributed by the bannedbook/fanqiang project. It aggregates multiple open‑source proxy implementations into a unified directory structure, each pre‑populated with working server endpoints. The package targets users in regions with strict network filtering, offering a no‑configuration workflow: unzip, run the launcher, and browse.

The Windows distribution is packaged as ChromeGo.7z, while the macOS variant is named ChromeGoMac.tar.gz. Both versions follow the same architectural principle but contain platform‑specific binaries and shell scripts.

Included Proxy Tools and Protocols

The archive contains ten distinct proxy engines, giving users redundancy if one protocol is blocked by their ISP:

  • Clash – Rule‑based tunnel supporting Shadowsocks and VMess
  • Xray – Core implementation of the VLESS and XTLS protocols
  • v2go – Lightweight V2Ray build optimized for single‑file deployment
  • Hysteria – QUIC‑based proxy designed for high‑latency networks
  • Hysteria2 – Updated revision with improved congestion control
  • Sing‑Box – Universal proxy platform supporting multiple outbound types
  • NaïveProxy – Chromium‑based transport that mimics regular HTTPS traffic
  • Psiphon – VPN‑like tunnel using SSH and obfuscation layers
  • Quick – Minimalist relay tool for rapid deployment

All configurations reside in their respective subdirectories within the extracted archive, allowing advanced users to edit JSON or YAML files before launching.

System Requirements and Prerequisites

Before extracting ChromeGo, verify the following constraints documented in ChromeGo/README.md and ChromeGoMac/README.md:

  • Operating System: Windows 7/8/10/11 for the standard bundle; macOS for ChromeGoMac
  • Browser Dependency: Google Chrome must be installed and accessible; the launcher invokes chrome.exe (Windows) or /Applications/Google Chrome.app (macOS) directly
  • Extraction Tool: Windows users require 7‑Zip (7z.exe); the built‑in Windows extractor cannot handle the 7z format reliably
  • Path Restrictions: Extract to a directory path containing no Chinese characters or spaces to prevent launcher script failures

How to Use ChromeGo on Windows

Download the Archive

Retrieve the latest release from the official mirror. The canonical URL referenced in ChromeGo/README.md is:

curl -L -o ChromeGo.7z https://d1a.mygrok.top/ChromeGo.7z

Extract with 7‑Zip

Use the command‑line or GUI version of 7‑Zip to unpack the archive. Avoid Windows Explorer’s native unzip utility to prevent corruption:

"C:\Program Files\7-Zip\7z.exe" x ChromeGo.7z -o"C:\Tools\ChromeGo"

Ensure the destination path (C:\Tools\ChromeGo in the example above) contains only ASCII characters and no spaces.

Launch the Proxy

Navigate to the extracted folder and consult the 使用说明(必看) file (mandatory reading) for protocol‑specific instructions. Then execute the launcher:

cd "C:\Tools\ChromeGo"
start ChromeGoLauncher.bat

The batch script ChromeGoLauncher.bat automatically selects an available proxy tool from the bundled set, configures the system proxy settings (or launches Chrome with command‑line proxy flags), and opens the browser. Traffic is immediately routed through the chosen tunnel.

How to Use ChromeGoMac on macOS

Download and Extract

For Apple Silicon or Intel Macs, download the tarball referenced in ChromeGoMac/README.md:

curl -L -o ChromeGoMac.tar.gz https://d1a.mygrok.top/ChromeGoMac.tar.gz
tar -zxvf ChromeGoMac.tar.gz
cd ChromeGoMac

Run the macOS Launcher

Inside the directory, locate the usage guide (使用说明(必看)) and the shell script:

./ChromeGoMacLauncher.sh

ChromeGoMacLauncher.sh performs the same function as its Windows counterpart: it detects Chrome, sets the appropriate proxy environment variables, and launches the browser through the selected protocol.

Troubleshooting Common Issues

Chrome.exe Not Found If the launcher reports “找不到 Chrome.exe” (Chrome.exe not found), verify that Google Chrome is installed in the default location. If the issue persists after installation, refer to GitHub issue #178 in the bannedbook/fanqiang repository for registry‑path workarounds and manual chrome.exe location flags.

Extraction Failures When 7‑Zip reports corrupt or incomplete archives, download the file again using a stable connection. The project maintainers recommend the official 7‑Zip download page rather than third‑party unzip utilities.

Protocol Connection Drops Because the bundled servers are free and publicly shared, individual nodes may become congested. Restart ChromeGoLauncher.bat or ChromeGoMacLauncher.sh to cycle to a different proxy tool in the rotation, or manually edit the configuration files in the respective tool directories (e.g., Clash/config.yaml) to select alternative endpoints.

Summary

  • ChromeGo is an all‑in‑one archive from bannedbook/fanqiang containing ten pre‑configured proxy tools for immediate circumvention use.
  • The Windows bundle (ChromeGo.7z) requires 7‑Zip for extraction and invokes ChromeGoLauncher.bat to start Chrome through a proxy.
  • The macOS variant (ChromeGoMac.tar.gz) uses ChromeGoMacLauncher.sh to achieve the same on Apple systems.
  • Both versions depend on Google Chrome being pre‑installed and require extraction paths free of Chinese characters or spaces.
  • Users should consult the included 使用说明(必看) documentation before running launchers.

Frequently Asked Questions

What proxy protocols does ChromeGo support?

ChromeGo supports Shadowsocks, VMess, VLESS, XTLS, QUIC (Hysteria), NaïveProtocol, and Psiphon tunnels through its bundled clients. Each protocol is handled by a dedicated subdirectory containing pre‑configured binaries and JSON/YAML configs.

Can I use ChromeGo if I don’t have Chrome installed?

No. The launcher scripts—ChromeGoLauncher.bat on Windows and ChromeGoMacLauncher.sh on macOS—explicitly call chrome.exe or the macOS Chrome application bundle. If Chrome is missing, the script exits with an error; install Chrome first using the wiki link provided in ChromeGo/README.md.

Why does the Windows launcher fail when the path contains Chinese characters?

The batch files and underlying proxy executables rely on standard ASCII path parsing and environment variables. Chinese characters or spaces in the extraction directory can cause 7z.exe path resolution errors or prevent ChromeGoLauncher.bat from locating configuration files. Always extract to a simple path like C:\ChromeGo.

Is ChromeGo free to use?

Yes. The servers bundled inside ChromeGo are maintained by the bannedbook/fanqiang project contributors and provided at no cost. However, because they are public shared resources, speeds and availability may vary; users requiring guaranteed bandwidth should consider importing private server details into the included Clash or Sing‑Box configurations.

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →