Best Practices for Using bannedbook/fanqiang: A Complete Guide to Proxy Configuration

The best practices for using bannedbook/fanqiang include starting from the README.md to select platform-specific guides, downloading the latest client binaries from official sources, treating subscription URLs as sensitive credentials, and validating system proxy settings before trusting the connection.

The bannedbook/fanqiang repository is a curated collection of proxy and VPN tools (翻墙) designed to bypass network restrictions across Windows, macOS, Linux, Android, iOS, and routers. Following these best practices ensures you maintain security, stability, and proper functionality when configuring clients like V2RayN or ClashX. Whether you rely on free subscription nodes or self-hosted V2Ray servers, adhering to the repository's documented workflows prevents common configuration errors.

Start with the Central README Hub

Every user should begin at [README.md](https://github.com/bannedbook/fanqiang/blob/master/README.md), which serves as the navigation hub linking to every platform-specific folder. This file contains quick-start links and disclaimers that direct you to the appropriate subdirectory for your operating system.

Selecting the correct folder first guarantees you follow client-specific steps rather than mixing incompatible Windows and macOS instructions. The repository organizes guides into modular folders including /windows, /macos, /linux, /android, /ios, /router, and /game, each containing detailed setup markdown files.

Download and Configure Platform-Specific Clients

Always download the latest released client binaries linked within each platform guide. Older binaries may be blocked by network filters or lack critical bug fixes.

Windows (V2RayN)

For Windows users, the [windows/V2RayN.md](https://github.com/bannedbook/fanqiang/blob/master/windows/V2RayN.md) guide specifies downloading the most recent V2RayN release. Before installing, ensure .NET Framework 4.8 runtime is installed (as noted in line 9 of the guide).

Activate the system proxy by enabling "自动配置系统代理" (Auto Configure System Proxy) in the V2RayN client (lines 46-48). This setting automatically configures Windows system proxy settings when the client starts.

# Start V2RayN with proxy activation

$exe = "C:\Program Files\V2RayN\v2rayN.exe"
Start-Process $exe -ArgumentList "/proxy"

macOS (ClashX)

macOS users should follow [macos/ClashX.md](https://github.com/bannedbook/fanqiang/blob/master/macos/ClashX.md), which requires allowing the application through Gatekeeper via "Open Anyway" (lines 52-53). After adding your subscription URL, enable "设置为系统代理" (Set as System Proxy) in the menu bar (lines 63-64).

# Append subscription to ClashX config

CONFIG="$HOME/.config/clash/config.yml"
cat <<EOF >> "$CONFIG"
proxy-providers:
  my-sub:
    type: http
    url: "<YOUR_SUBSCRIPTION_URL>"
    interval: 86400
EOF

# Restart ClashX

osascript -e 'quit app "ClashX"'
open -a ClashX

Linux Environment Variables

Linux users should configure environment variables according to /linux/readme.md. Set http_proxy and https_proxy to route traffic through the local proxy client.

# Add to ~/.bashrc

export http_proxy="http://127.0.0.1:1080"
export https_proxy="http://127.0.0.1:1080"
export no_proxy="localhost,127.0.0.1,::1"

source ~/.bashrc

Secure Your Subscription URLs and Credentials

Treat subscription URLs as passwords. The V2RayN guide explicitly warns (lines 29-30): "把它当做密码一样妥善保管" (Keep it safe like a password). Store these URLs in encrypted password managers and never commit them to public repositories.

Free subscription lists like 免费ss账号.md and v2ray免费账号.md provide quick access for users who cannot run their own servers, but these nodes may disappear without notice.

Validate System Proxy Configuration

After configuring any client, verify the proxy works by attempting to access sites blocked by the Great Firewall. Each platform requires specific validation:

• Windows: Confirm "自动配置系统代理" is enabled in V2RayN
• macOS: Verify "设置为系统代理" is checked in ClashX
• Linux: Check that environment variables are properly exported and applications respect them

Avoid Common Setup Pitfalls

File Path Restrictions

Never extract client archives to folders containing Chinese characters or spaces. The Chrome package documentation (lines 86-87) warns that paths with Chinese characters or spaces cause the client to crash.

Security Prompts and Prerequisites

Follow platform-specific security requirements:

• macOS: Approve applications from unknown developers via System Preferences
• Windows: Install prerequisite runtimes like .NET Framework 4.8 before launching clients

Maintain Long-Term Stability

Self-Hosted V2Ray Servers

For reliable long-term access, deploy your own server using the v2ss/V2Ray之TLS+WebSocket+Nginx+CDN配置方法.md tutorial. This eliminates dependence on free nodes that frequently rotate.

The repository provides v2ss/server-cfg/v2ray.service, a systemd unit file for running persistent V2Ray servers on Linux VPS instances.

Regular Subscription Updates

Free node providers rotate URLs frequently. Use the update subscription button in your client (V2RayN line 42, ClashX via "订阅/更新订阅") to refresh node lists. Document any custom configuration changes in ~/.config/clash/config.yml or V2Ray JSON files, keeping backups of original files since altering ports can break the UI (ClashX guide line 75).

Summary

• Start at [README.md](https://github.com/bannedbook/fanqiang/blob/master/README.md) to find your platform-specific guide
• Download latest binaries from official links in platform folders like [windows/V2RayN.md](https://github.com/bannedbook/fanqiang/blob/master/windows/V2RayN.md) or [macos/ClashX.md](https://github.com/bannedbook/fanqiang/blob/master/macos/ClashX.md)
• Protect subscription URLs as sensitive credentials and store them in password managers
• Enable system proxy settings specifically: "自动配置系统代理" for Windows, "设置为系统代理" for macOS, or environment variables for Linux
• Avoid Chinese character paths when extracting client archives
• Prefer self-hosted servers using the V2Ray + Nginx + CDN configuration for stability
• Update subscriptions regularly and document configuration changes

Frequently Asked Questions

How do I choose the right client for my operating system?

Navigate to the [README.md](https://github.com/bannedbook/fanqiang/blob/master/README.md) and select the folder matching your OS. Windows users should use V2RayN (documented in [windows/V2RayN.md](https://github.com/bannedbook/fanqiang/blob/master/windows/V2RayN.md)), macOS users should use ClashX ([macos/ClashX.md](https://github.com/bannedbook/fanqiang/blob/master/macos/ClashX.md)), and Linux users follow the environment variable configuration in /linux/readme.md. Each guide contains download links to the latest stable binaries for that platform.

Why should I avoid using free subscription nodes for long-term use?

Free nodes listed in 免费ss账号.md and v2ray免费账号.md frequently change or disappear without notice. For stable access, deploy your own server using the v2ss/V2Ray之TLS+WebSocket+Nginx+CDN配置方法.md tutorial and the provided v2ray.service systemd file to maintain continuous connectivity.

What should I do if the client fails to set the system proxy?

Ensure you have enabled the specific system proxy option for your platform: "自动配置系统代理" in V2RayN (lines 46-48) or "设置为系统代理" in ClashX (lines 63-64). On macOS, verify you approved the application via "Open Anyway" (lines 52-53). On Windows, confirm .NET Framework 4.8 is installed. If using Linux, verify http_proxy and https_proxy environment variables are exported in your shell configuration.

How do I contribute updates to the repository safely?

Use the [gitupdate.sh](https://github.com/bannedbook/fanqiang/blob/master/gitupdate.sh) helper script to synchronize your local markdown with upstream changes. Never commit confidential subscription URLs, credentials, or personal configuration files. When editing guides, keep copies of original configuration files and document any port changes, as modifying default ports in ClashX can break the UI functionality (line 75).

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