gh-proxy is a GitHub content acceleration proxy that speeds up downloads of releases, archives, and project files from GitHub.
The tool solves the problem of slow GitHub downloads by intercepting requests to GitHub URLs and routing them through faster infrastructure. It works by accepting a GitHub URL, prepending the proxy domain to it, and serving the content through accelerated channels. The project offers two deployment options: a Cloudflare Workers serverless version for minimal setup, and a Python version for more control.
The Python version provides capabilities the Workers version does not: file size limits that return the original URL if content exceeds a threshold, and per-user or per-repository access controls including blocklists, whitelists, and bypass rules. The tool supports cloning private repositories by accepting credentials in the URL. It handles multiple GitHub content types including branch source archives, release archives, release files, individual branch files, commit-specific files, and gists. Anyone considering adoption should deploy their own instance for heavy usage rather than relying on public demonstration services. The tool suits developers and teams in regions or networks with poor GitHub connectivity who need reliable access to releases and source archives.
Development activity shows consistent maintenance with bug fixes and feature additions driven by user issues. The project accepts contributions and maintains both implementation paths, indicating responsiveness to different deployment preferences. Documentation is provided in Chinese with examples covering the main use cases.
