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/fanqiangcontaining ten pre‑configured proxy tools for immediate circumvention use. - The Windows bundle (
ChromeGo.7z) requires 7‑Zip for extraction and invokesChromeGoLauncher.batto start Chrome through a proxy. - The macOS variant (
ChromeGoMac.tar.gz) usesChromeGoMacLauncher.shto 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:
curl -s "https://instagit.com/install.md" Maintain an open-source project? Get it listed too →