# Aityp

> 通过渡渡鸟镜像站加速拉取容器镜像（自动 mirror + retag）。当用户请求拉镜像、国内加速、重命名镜像 tag 时使用。

- Skill: `cnife/aityp` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cnife/aityp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cnife/aityp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cnife (https://skillmd.com/u/cnife)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cnife/aityp

---


# aityp

aityp 通过渡渡鸟镜像同步站（docker.aityp.com）加速拉取容器镜像：自动查询国内 mirror → 拉取 → retag 为原始名 → 删除 mirror tag，本地直接可用。专治从 Docker Hub / gcr.io / ghcr.io / quay.io 等拉镜像慢的场景。

支持的镜像源：docker.io, gcr.io, ghcr.io, quay.io, k8s.gcr.io, registry.k8s.io, docker.elastic.co, mcr.microsoft.com, docker.n8n.io, skywalking.docker.scarf.sh

## 命令

### aityp
无参即实时数据：显示站点状态、今日新增同步、最新镜像。

### aityp pull <image>...
核心**加速**命令：同步状态检查 → mirror 拉取 → retag 原始名 → 删除 mirror tag。
- 批量：`aityp pull python:3.11 nginx:1.27`
- `--platform <p>` 指定平台（默认当前架构）
- 简写自动补齐：`python:3.11` 查 `docker.io/python:3.11`，retag 回输入原名
- 未同步镜像报错（exit 1），需在 https://docker.aityp.com/manage/add 手动提交（约 1 小时同步）
- 幂等：已存在镜像按 digest 判断是否更新

### aityp search <query>
模糊搜索已同步镜像。
- `--site <s>` 按源过滤
- `--platform <p>` 按平台过滤
- `--limit <n>` 返回条数（默认 20，最大 50）
- `--fields <f>` 附加字段（mirror,createdAt）

### aityp info <image>
精确查镜像同步状态（含 mirror 地址、平台、大小、同步时间）。未同步返回 `synced: false`（exit 0）。

## 输出与退出
TOON 格式（紧凑表格）。退出码：0 成功，1 错误，2 用法错误。

## 示例
```sh
aityp pull python:3.11-slim
aityp pull gcr.io/google-containers/coredns:1.2
aityp pull python:3.11 nginx:1.27 --platform linux/arm64
aityp search python --platform linux/arm64
aityp info nginx:1.27
```