/ˈɡæpʊl/ · GitHub Actions Pull
通过 GitHub Actions 在云端拉取 Docker 镜像，打包成 .tar.gz，下载到本地离线加载。
| 全称 | GitHub Actions Pull |
| 发音 | /ˈɡæpʊl/，"ga"如 gap 中的 /ɡæ/，"pull" 如 pull /pʊl/ |
| 快捷指令 | dp（Docker Pull 缩写） |
本地输入镜像名
↓
gapull 触发 GitHub Actions（云端网络）
↓
Runner: docker pull → docker save | gzip
↓
上传到 Release 或 Artifact
↓
gapull 多线程下载 → docker load
使用前必读： gapull 通过触发你自己仓库里的 GitHub Actions 来拉取镜像，因此你必须先 fork 本仓库，再配置 Token，才能正常使用。
点击页面右上角的 Fork 按钮，将本仓库 fork 到你自己的 GitHub 账号下。
Fork 完成后，必须手动开启 Actions：进入你 fork 后的仓库 → 点击顶部 Actions 标签页 → 页面会提示 "Workflows aren't being run on this forked repository"，点击 I understand my workflows, go ahead and enable them 按钮。 不操作此步骤将无法触发任何 workflow。
GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
→ Generate new token → 勾选 workflow 权限 → 复制生成的 Token。
curl -fsSL -H 'Cache-Control: no-cache' https://raw.githubusercontent.com/029527/gapull/main/install.sh | bash脚本自动检测系统和架构（Linux/macOS × amd64/arm64），下载对应二进制到 /usr/local/bin，
并向当前 Shell 的配置文件注入快捷指令 dp。
手动安装：前往 Releases 下载对应平台的二进制，
重命名为 gapull 并放入 $PATH 即可。
gapull config set --token ghp_xxxxxxxxxxxxxxxx工具会自动通过 Token 查询你的 GitHub 用户名并设置为 owner。
若 fork 时修改了仓库名，需额外指定 --repo：
gapull config set --token ghp_xxxxxxxxxxxxxxxx --repo my-repo-name也可手动指定
--owner your-github-username覆盖自动检测结果。
使 alias 生效后（或重启终端），直接用 dp 指令：
# 拉取单个镜像（自动检测当前系统架构，保存到当前目录）
dp nginx:latest
# 拉取多个镜像
dp nginx:latest,redis:7,alpine:3.20
# 指定架构
dp nginx:latest --arch arm64
# 下载到指定目录
dp nginx:latest --output ~/images
# 镜像大于 2GB 时使用 artifact 模式
dp pytorch/pytorch:2.3.0-cuda12.1-cudnn8-runtime --type artifact不用 alias 的完整写法：
gapull pull nginx:latest| 镜像大小 | 推荐类型 | 说明 |
|---|---|---|
| < 2 GB | release（默认） |
上传到 GitHub Release，下载无需认证 |
| 2 ~ 5 GB | artifact |
上传到 Actions Artifact，有效期 1 天 |
| > 5 GB | ❌ 不支持 | 文件体积超限 |
支持架构：amd64（x86-64）、arm64（树莓派 4 等）、arm32（树莓派 3 等）。
docker load -i nginx_latest-amd64.tar.gzArtifact 模式下载的是
.zip，解压后得到.tar.gz，再执行docker load。
触发后 404？
Token 需要 workflow 权限，且目标仓库必须是你自己的（fork 后使用）。
架构不对？
ARM 设备需指定 --arch arm64，不能加载 amd64 的镜像。
下载慢？
设置代理环境变量即可自动生效：export HTTPS_PROXY=http://127.0.0.1:7890
无代理时工具自动启用 16 线程 + 5MB 分块重试模式。