# 镜像路径速查

SparkCR 支持两种镜像引用方式：

| 模式 | 形式 | 适合场景 |
| --- | --- | --- |
| 路径前缀 | `REGISTRY/upstream/repository:tag` | 推荐默认使用，命令最统一。 |
| 别名入口 | `alias.REGISTRY/repository:tag` | 更接近原生 Registry 写法。 |

首次接入建议使用路径前缀模式。

## 公共上游

### 路径前缀入口

| 上游 | 镜像引用 |
| --- | --- |
| Docker Hub 官方镜像 | `sparkcr.cn/docker.io/library/hello-world:latest` |
| Docker Hub 用户镜像 | `sparkcr.cn/docker.io/valkey/valkey:latest` |
| GHCR | `sparkcr.cn/ghcr.io/astral-sh/uv:latest` |
| Quay | `sparkcr.cn/quay.io/prometheus/node-exporter:latest` |
| GCR | `sparkcr.cn/gcr.io/distroless/static-debian13` |
| Kubernetes Registry | `sparkcr.cn/registry.k8s.io/pause:latest` |
| MCR | `sparkcr.cn/mcr.microsoft.com/playwright/mcp:latest` |
| Elastic | `sparkcr.cn/docker.elastic.co/elasticsearch/elasticsearch:9.4.1` |
| NVIDIA | `sparkcr.cn/nvcr.io/nvidia/k8s/dcgm-exporter:4.5.3-4.8.2-distroless` |

### 别名入口

| 上游 | 镜像引用 |
| --- | --- |
| Docker Hub 官方镜像 | `docker.sparkcr.cn/library/hello-world:latest` |
| Docker Hub 用户镜像 | `docker.sparkcr.cn/valkey/valkey:latest` |
| GHCR | `ghcr.sparkcr.cn/astral-sh/uv:latest` |
| Quay | `quay.sparkcr.cn/prometheus/node-exporter:latest` |
| GCR | `gcr.sparkcr.cn/distroless/static-debian13` |
| Kubernetes Registry | `k8s.sparkcr.cn/pause:latest` |
| MCR | `mcr.sparkcr.cn/playwright/mcp:latest` |
| Elastic | `elastic.sparkcr.cn/elasticsearch/elasticsearch:9.4.1` |
| NVIDIA | `nvcr.sparkcr.cn/nvidia/k8s/dcgm-exporter:4.5.3-4.8.2-distroless` |

Docker Hub 官方镜像必须保留 `library/`：

```bash
docker pull sparkcr.cn/docker.io/library/hello-world:latest
```

不要写成：

```bash
docker pull sparkcr.cn/docker.io/hello-world:latest
```

## 私有上游

私有镜像仓库的路径由 [`Private Registries`](/settings/private-registries) 页面生成。一般形式为：

```text
sparkcr.cn/<owner-slug>-<registry-slug>/<repo>:<tag>
```

示例：

```bash
docker login sparkcr.cn
docker pull sparkcr.cn/acme-harbor/myapp:latest
docker push sparkcr.cn/acme-harbor/myapp:latest
```

私有上游不允许匿名访问。拉取需要 `pull:private`，推送需要 `push`。

## Digest 引用

Tag 和 digest 都可以作为镜像引用：

```bash
docker pull sparkcr.cn/docker.io/library/hello-world@sha256:<digest>
```

digest 引用适合 CI、正式发布和可复现交付。