一、工具背景与核心价值
在现代容器化开发中，网络环境限制常常成为Docker镜像部署的巨大障碍。企业内网安全策略、高算平台离线环境或国外镜像源访问受限，都使得传统的docker pull命令无法直接拉取镜像。
DockerTarBuilder作为一款开源工具，通过预构建tar格式离线镜像包的方式，彻底解决了对网络的依赖问题。其核心价值体现在：
- 自动化构建：利用GitHub Actions的强大能力，自动拉取、构建并打包多架构Docker镜像
- 多架构支持：支持为ARM64、ARM32、AMD64等多种架构平台构建专用镜像包
- 灵活分发方式：通过GitHub Release或Artifact两种方式提供下载，满足不同大小的镜像需求
- 零网络依赖：完全离线环境下的镜像部署，无需任何互联网连接
二、DockerTarBuilder技术原理
DockerTarBuilder的工作流程基于GitHub Actions自动化，其核心原理可以概括为以下步骤：
#mermaid-svg-ZR4y1lwFRUlo74s1{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-ZR4y1lwFRUlo74s1 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-ZR4y1lwFRUlo74s1 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-ZR4y1lwFRUlo74s1 .error-icon{fill:#552222;}#mermaid-svg-ZR4y1lwFRUlo74s1 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-ZR4y1lwFRUlo74s1 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-ZR4y1lwFRUlo74s1 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-ZR4y1lwFRUlo74s1 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-ZR4y1lwFRUlo74s1 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-ZR4y1lwFRUlo74s1 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-ZR4y1lwFRUlo74s1 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-ZR4y1lwFRUlo74s1 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-ZR4y1lwFRUlo74s1 .marker.cross{stroke:#333333;}#mermaid-svg-ZR4y1lwFRUlo74s1 svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-ZR4y1lwFRUlo74s1 p{margin:0;}#mermaid-svg-ZR4y1lwFRUlo74s1 .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-ZR4y1lwFRUlo74s1 .cluster-label text{fill:#333;}#mermaid-svg-ZR4y1lwFRUlo74s1 .cluster-label span{color:#333;}#mermaid-svg-ZR4y1lwFRUlo74s1 .cluster-label span p{background-color:transparent;}#mermaid-svg-ZR4y1lwFRUlo74s1 .label text,#mermaid-svg-ZR4y1lwFRUlo74s1 span{fill:#333;color:#333;}#mermaid-svg-ZR4y1lwFRUlo74s1 .node rect,#mermaid-svg-ZR4y1lwFRUlo74s1 .node circle,#mermaid-svg-ZR4y1lwFRUlo74s1 .node ellipse,#mermaid-svg-ZR4y1lwFRUlo74s1 .node polygon,#mermaid-svg-ZR4y1lwFRUlo74s1 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-ZR4y1lwFRUlo74s1 .rough-node .label text,#mermaid-svg-ZR4y1lwFRUlo74s1 .node .label text,#mermaid-svg-ZR4y1lwFRUlo74s1 .image-shape .label,#mermaid-svg-ZR4y1lwFRUlo74s1 .icon-shape .label{text-anchor:middle;}#mermaid-svg-ZR4y1lwFRUlo74s1 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-ZR4y1lwFRUlo74s1 .rough-node .label,#mermaid-svg-ZR4y1lwFRUlo74s1 .node .label,#mermaid-svg-ZR4y1lwFRUlo74s1 .image-shape .label,#mermaid-svg-ZR4y1lwFRUlo74s1 .icon-shape .label{text-align:center;}#mermaid-svg-ZR4y1lwFRUlo74s1 .node.clickable{cursor:pointer;}#mermaid-svg-ZR4y1lwFRUlo74s1 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-ZR4y1lwFRUlo74s1 .arrowheadPath{fill:#333333;}#mermaid-svg-ZR4y1lwFRUlo74s1 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-ZR4y1lwFRUlo74s1 .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-ZR4y1lwFRUlo74s1 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-ZR4y1lwFRUlo74s1 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-ZR4y1lwFRUlo74s1 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-ZR4y1lwFRUlo74s1 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-ZR4y1lwFRUlo74s1 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-ZR4y1lwFRUlo74s1 .cluster text{fill:#333;}#mermaid-svg-ZR4y1lwFRUlo74s1 .cluster span{color:#333;}#mermaid-svg-ZR4y1lwFRUlo74s1 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-ZR4y1lwFRUlo74s1 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-ZR4y1lwFRUlo74s1 rect.text{fill:none;stroke-width:0;}#mermaid-svg-ZR4y1lwFRUlo74s1 .icon-shape,#mermaid-svg-ZR4y1lwFRUlo74s1 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-ZR4y1lwFRUlo74s1 .icon-shape p,#mermaid-svg-ZR4y1lwFRUlo74s1 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-ZR4y1lwFRUlo74s1 .icon-shape rect,#mermaid-svg-ZR4y1lwFRUlo74s1 .image-shape rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-ZR4y1lwFRUlo74s1 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-ZR4y1lwFRUlo74s1 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-ZR4y1lwFRUlo74s1 :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}
< 2GB
2GB~5GB
> 5GB
用户输入镜像信息
启动GitHub Actions工作流
拉取指定架构镜像
检查镜像大小
发布到Release
上传到Artifact
无法处理需自行解决
用户下载tar包
离线环境加载镜像
部署应用
技术架构与工作流程 DockerTarBuilder本质上是一组GitHub Actions工作流，其技术架构包括：
- ARM32
- ARM64
- x86-64
触发机制：通过手动触发workflow，用户可指定镜像名称、架构等参数 构建环境：利用GitHub提供的免费虚拟机环境，构建指定架构的Docker镜像 分发策略： Release方式：适用于小于2GB的镜像，文件持久化存储，易于下载和分享 github.com Artifact方式：适用于2GB-5GB的镜像，临时存储，保留时间有限（通常90天） github.com 格式转换：将Docker镜像转换为tar格式，便于离线传输和加载
三、实战操作指南
#mermaid-svg-2cnYPhkA2i72dYnU{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-2cnYPhkA2i72dYnU .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-2cnYPhkA2i72dYnU .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-2cnYPhkA2i72dYnU .error-icon{fill:#552222;}#mermaid-svg-2cnYPhkA2i72dYnU .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-2cnYPhkA2i72dYnU .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-2cnYPhkA2i72dYnU .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-2cnYPhkA2i72dYnU .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-2cnYPhkA2i72dYnU .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-2cnYPhkA2i72dYnU .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-2cnYPhkA2i72dYnU .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-2cnYPhkA2i72dYnU .marker{fill:#333333;stroke:#333333;}#mermaid-svg-2cnYPhkA2i72dYnU .marker.cross{stroke:#333333;}#mermaid-svg-2cnYPhkA2i72dYnU svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-2cnYPhkA2i72dYnU p{margin:0;}#mermaid-svg-2cnYPhkA2i72dYnU .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-2cnYPhkA2i72dYnU .cluster-label text{fill:#333;}#mermaid-svg-2cnYPhkA2i72dYnU .cluster-label span{color:#333;}#mermaid-svg-2cnYPhkA2i72dYnU .cluster-label span p{background-color:transparent;}#mermaid-svg-2cnYPhkA2i72dYnU .label text,#mermaid-svg-2cnYPhkA2i72dYnU span{fill:#333;color:#333;}#mermaid-svg-2cnYPhkA2i72dYnU .node rect,#mermaid-svg-2cnYPhkA2i72dYnU .node circle,#mermaid-svg-2cnYPhkA2i72dYnU .node ellipse,#mermaid-svg-2cnYPhkA2i72dYnU .node polygon,#mermaid-svg-2cnYPhkA2i72dYnU .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-2cnYPhkA2i72dYnU .rough-node .label text,#mermaid-svg-2cnYPhkA2i72dYnU .node .label text,#mermaid-svg-2cnYPhkA2i72dYnU .image-shape .label,#mermaid-svg-2cnYPhkA2i72dYnU .icon-shape .label{text-anchor:middle;}#mermaid-svg-2cnYPhkA2i72dYnU .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-2cnYPhkA2i72dYnU .rough-node .label,#mermaid-svg-2cnYPhkA2i72dYnU .node .label,#mermaid-svg-2cnYPhkA2i72dYnU .image-shape .label,#mermaid-svg-2cnYPhkA2i72dYnU .icon-shape .label{text-align:center;}#mermaid-svg-2cnYPhkA2i72dYnU .node.clickable{cursor:pointer;}#mermaid-svg-2cnYPhkA2i72dYnU .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-2cnYPhkA2i72dYnU .arrowheadPath{fill:#333333;}#mermaid-svg-2cnYPhkA2i72dYnU .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-2cnYPhkA2i72dYnU .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-2cnYPhkA2i72dYnU .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-2cnYPhkA2i72dYnU .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-2cnYPhkA2i72dYnU .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-2cnYPhkA2i72dYnU .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-2cnYPhkA2i72dYnU .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-2cnYPhkA2i72dYnU .cluster text{fill:#333;}#mermaid-svg-2cnYPhkA2i72dYnU .cluster span{color:#333;}#mermaid-svg-2cnYPhkA2i72dYnU div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-2cnYPhkA2i72dYnU .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-2cnYPhkA2i72dYnU rect.text{fill:none;stroke-width:0;}#mermaid-svg-2cnYPhkA2i72dYnU .icon-shape,#mermaid-svg-2cnYPhkA2i72dYnU .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-2cnYPhkA2i72dYnU .icon-shape p,#mermaid-svg-2cnYPhkA2i72dYnU .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-2cnYPhkA2i72dYnU .icon-shape rect,#mermaid-svg-2cnYPhkA2i72dYnU .image-shape rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-2cnYPhkA2i72dYnU .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-2cnYPhkA2i72dYnU .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-2cnYPhkA2i72dYnU :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}
注册GitHub账号
Fork项目仓库
配置工作流参数
执行构建流程
下载离线镜像包
离线环境部署
步骤一：Fork项目仓库
访问DockerTarBuilder GitHub仓库仓库，点击右上角Fork按钮，将项目复制到自己的GitHub账号下
步骤二：配置工作流参数
进入到个人仓库的Actions页面，选择合适的架构，点击"Run workflow"按钮，配置以下参数：
Image Name：要构建的Docker镜像名称（如nginx:latest） 
下载与加载离线镜像 构建完成后，可以通过以下方式获取离线镜像包：
离线环境加载镜像 将下载的tar文件传输到目标服务器后，使用以下命令加载镜像：
# 加载镜像到Docker
docker load -i nginx-arm64.tar
# 验证镜像是否加载成功
docker images | grep nginx
四、常见问题与避坑指南
| < 2GB | Release方式 | 文件永久存储，推荐选择 |
| 2GB-5GB | Artifact方式 | 注意下载时效性 |
5GB |无法处理 |需自行解决网络问题 ⚠️ 注意：对于超过5GB的大型镜像（如vllm/vllm-openai:v0.6.4.post1），DockerTarBuilder无法处理。此时建议： 1.使用镜像分层技术 2.拆分为多个小镜像 3.直接解决网络连接问题
希望本文能帮助您更好地理解和使用DockerTarBuilder工具，如果您有任何问题或建议，欢迎在评论区留言讨论！
