crosh

README

crosh

A lightweight network acceleration tool for Chinese developers.

What it does

crosh automatically configures package manager mirrors and proxy settings to speed up downloads in China.

• Mirrors: npm, pip, apt, cargo, go, docker
• Proxy: Xray-core based proxy with subscription support
• Simple: One command to enable/disable everything

Installation

# Recommended for users in China (via Cloudflare CDN)
curl -fsSL https://crosh.boomyao.com/scripts/install.sh | bash

# Alternative (directly from GitHub)
curl -fsSL https://raw.githubusercontent.com/boomyao/crosh/main/scripts/install.sh | bash

Or build from source:

make build
sudo make install

Usage

# Enable acceleration (mirrors only)
crosh

# Configure with proxy subscription
crosh https://your-subscription-url

# Disable all acceleration
crosh off

# Check current status
crosh status

That's it!

How it works

• Mirrors: Updates config files for package managers to use Chinese mirrors
• Proxy: Downloads and runs Xray-core with your subscription URL
• All changes are reversible with crosh off

License

MIT License - see LICENSE