One Repo, Every Tutorial You Need for V2ray, Shadowsocks, and Clash

So you've decided to set up your own proxy. You've got a server somewhere, maybe a domain, and a vague sense that you need to install "something" and configure "something else." Then you open a search engine and find forty conflicting blog posts, half of them outdated, all of them written for a different client than the one you're using. The bannedbook/fanqiang repository is an attempt to solve exactly that problem: it's a single collection of tutorials covering V2ray, Shadowsocks, SSR, and Clash across nearly every platform you might be running.

What It Does

This is a tutorial aggregation project rather than a piece of software. The repository collects setup guides, configuration walkthroughs, and client-specific instructions for circumvention tools, organized by operating system and client. The README itself functions as a table of contents, linking out to individual markdown files and wiki pages for each topic.

The coverage breaks down into a few broad categories. There are self-hosting guides for building your own V2ray and Shadowsocks servers, written as "简明教程" (concise tutorials). There are client-specific guides for Windows (Clash for Windows, V2rayN, SSTap, ShadowsocksR, TorBrowser plus V2rayN), iOS (Shadowrocket, Quantumult X, Surge, Potatso, plus a guide to registering a US Apple ID so you can actually buy those apps), Android (V2free, Clash for Android, BifrostV), and macOS. Beyond the core proxy clients, the repo also bundles one-click packages for Chrome, Edge, and Firefox, a TorBrowser bundle, and a handful of adjacent topics like configuring chained proxies in v2rayN and registering for ChatGPT from mainland China.

The project is maintained in Chinese, which makes sense given its focus, and it lives entirely as documentation and scripts in a GitHub repo. There's no build system to speak of—you read the guide for your platform and follow the steps.

Why It's Cool

• It covers the full matrix, not just one corner of it. Most tutorials assume you're on Windows with a specific client. This repo has separate guides for Windows, iOS, Android, macOS, and Linux, and it acknowledges that the client you use on iOS (Shadowrocket, Quantumult X, Surge) is a genuinely different piece of software from what you'd run on desktop. That's a small thing, but it saves you from translating a Windows guide into iOS terms.

• The self-hosting guides sit next to the client guides. This matters more than it sounds. When you're setting up your own V2ray server, the hard part isn't usually the server—it's getting the client config to match. Having both halves in one place, with consistent terminology, reduces the amount of cross-referencing you have to do.

• It includes the unglamorous prerequisites. The "注册苹果美区 Apple ID 帐号并购买APP指南" (guide to registering a US Apple ID and buying apps) is a good example. Shadowrocket and Quantumult X aren't available in the Chinese App Store, so before you can follow any iOS tutorial you need a US account. Plenty of guides skip that step and leave you stuck. This one doesn't.

• The one-click browser packages lower the floor. Not everyone wants to run a system-wide proxy. The Chrome, Edge, Firefox, and TorBrowser packages let you get a browser working without touching your OS-level network settings. For someone who just needs to reach a specific site, that's a much smaller commitment.

• It's honest about scope. The repo is a pile of tutorials, and it presents itself as exactly that. There's no pretense of being a unified tool or a polished product.

How to Try It

There's nothing to install. You clone or browse the repo and find the guide that matches your situation.

1. Start at the repository: https://github.com/bannedbook/fanqiang
2. Decide whether you're self-hosting or using a client. If you're self-hosting, begin with the V2ray or Shadowsocks server tutorial under the v2ss/ directory.
3. Find your platform in the README's section list—Windows, iOS, Android, or macOS—and open the guide for the client you intend to use.
4. If you're on iOS and don't have a US Apple ID yet, read the Apple ID guide before anything else, since you'll need it to install the client apps.

If you'd rather clone it locally:

git clone https://github.com/bannedbook/fanqiang.git

Then browse the markdown files directly. The windows/, ios/, and android/ directories hold the platform-specific guides.

Final Thoughts

This repo won't win any design awards, and it's not trying to. It's a reference collection, and it's most useful to someone who already knows roughly what they want to do—set up a V2ray server, configure Clash on Android, get Shadowrocket working—and just needs the steps written down in one consistent place. If you're completely new to this space, the sheer number of links might be overwhelming at first; start with a single platform section rather than trying to absorb the whole README. The main caveat is that the project is Chinese-language throughout, so if you don't read Chinese you'll be relying on translation. For everyone else, it's a solid bookmark to keep around the next time you're setting up a new device.

Follow @githubprojects for more developer tools and open source projects.