---
name: gatecdn-infra
description: GateCDN 基础设施服务清单与用法。在项目中需要引用 CDN 静态资源、拉取 Docker/GHCR/Quay 镜像、npm/Go/Rust 包时使用。
---

# GateCDN Infrastructure

GateCDN 提供开发者基础设施，香港节点，HTTPS 可用。

## 何时使用

- 项目需要引用前端 JS/CSS 库（jQuery、Vue、Bootstrap 等）
- Docker 项目需要加速 Docker Hub 拉取
- 需要拉取 ghcr.io 或 quay.io 镜像
- Node 项目需要 npm 包加速
- Go 项目需要 module 代理
- Rust 项目需要 crates.io 镜像
- Python 项目需要 pip / PyPI 加速
- CI/CD 或 Agent 需要统一的 endpoint

## 服务清单

| 服务 | Endpoint | 上游 | 用法 |
|------|----------|------|------|
| Frontend CDN | `cdn.gatecdn.com` | cdnjs | 替换 cdnjs 域名，路径不变 |
| Docker Hub | `hub.gatecdn.com` | docker.io | `registry-mirrors` 配置 |
| GHCR | `ghcr.gatecdn.com` | ghcr.io | 替换 `ghcr.io` 前缀 |
| Quay | `quay.gatecdn.com` | quay.io | 替换 `quay.io` 前缀 |
| npm | `npm.gatecdn.com` | npmjs.org | `registry=https://npm.gatecdn.com` |
| Go modules | `go.gatecdn.com` | proxy.golang.org | `GOPROXY=https://go.gatecdn.com,direct` |
| Rust crates | `rust.gatecdn.com` | crates.io | sparse index 配置 |
| PyPI (pip) | `pip.gatecdn.com` | pypi.org | `index-url=https://pip.gatecdn.com/simple/` |
| NORA hub | `nora.gatecdn.com` | 多格式 | Web UI + Maven/Terraform 等 |

## 配置示例

### Frontend CDN

```html
<script src="https://cdn.gatecdn.com/ajax/libs/vue/3.2.36/vue.global.prod.js"></script>
```

### Docker Hub (daemon.json)

```json
{
  "registry-mirrors": ["https://hub.gatecdn.com"]
}
```

配置后 `docker pull nginx:latest` 自动走加速。

### GHCR

```bash
# ghcr.io/owner/image:tag →
docker pull ghcr.gatecdn.com/owner/image:tag
```

### Quay

```bash
# quay.io/org/repo:tag →
docker pull quay.gatecdn.com/org/repo:tag
```

### npm

```ini
# .npmrc
registry=https://npm.gatecdn.com
```

### Go modules

```bash
export GOPROXY=https://go.gatecdn.com,direct
go env -w GOPROXY=https://go.gatecdn.com,direct
```

### Rust (Cargo)

```toml
# ~/.cargo/config.toml
[source.crates-io]
replace-with = "gatecdn"

[source.gatecdn]
registry = "sparse+https://rust.gatecdn.com/index/"
```

### PyPI (pip)

```ini
# ~/.pip/pip.conf
[global]
index-url = https://pip.gatecdn.com/simple/
trusted-host = pip.gatecdn.com
```

```bash
pip install -i https://pip.gatecdn.com/simple/ requests
export UV_INDEX_URL=https://pip.gatecdn.com/simple/
```

### NORA (multi-format)

- Web UI: https://nora.gatecdn.com/ui/
- PyPI: https://nora.gatecdn.com/simple/
- Maven: https://nora.gatecdn.com/maven2/
- Terraform: https://nora.gatecdn.com/terraform/

### Kubernetes (containerd)

```yaml
# /etc/rancher/k3s/registries.yaml
mirrors:
  docker.io:
    endpoint: ["https://hub.gatecdn.com"]
  ghcr.io:
    endpoint: ["https://ghcr.gatecdn.com"]
  quay.io:
    endpoint: ["https://quay.gatecdn.com"]
```

## 机器可读 Manifest

在线 manifest：`https://gatecdn.com/infra.json`

## 注意事项

- `registry-mirrors` 仅对 Docker Hub（无域名前缀的镜像）生效
- ghcr/quay 必须显式替换镜像前缀
- 镜像站 API 路径为 `/v2/`，首页 `/` 为说明页

## 更多信息

- 门户首页：https://gatecdn.com
- 详细参考：https://gatecdn.com/agents/reference.md