---
title: 历史开发记录：2026-07-29 Docker Hub 构建兜底
type: experience
permalink: main/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/历史开发记录-2026-07-29-docker-hub-构建兜底
stable_id: f8c5300e-3068-4003-a816-b20f997d9715
scope: project
project_id: 6f47523e-e22e-4cdd-bd18-76e5e474ee0c
memory_type: experience
status: active
revision: 1
restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2
created_at: '2026-09-23T14:59:27.643271+00:00'
updated_at: '2026-09-23T14:59:27.643327+00:00'
tags:
- migration
- local-aidocs
- development-history
---

## 2026-07-29 Docker Hub 构建兜底

- Docker Hub OAuth 连接被重置时，`docker build` 无法读取 `ubuntu:24.04` 元数据，并在固件编译开始前终止。
- `build-docker.ps1` 现在会在镜像刷新失败时检查本地 `openwrt-local-builder:25.12`；本地镜像存在则发出警告并继续构建，不存在时仍明确失败。
- 镜像构建正常时行为不变，仍会优先刷新 Docker 构建环境。
- 固定外部包克隆增加 3 次有限重试，并在每次重试前清理失败残留，降低 GitHub TLS 短暂中断导致的构建失败。
- 外部包不再使用 `--filter=blob:none` 部分克隆，避免克隆成功后在签出固定提交时再次联网补取 blob。
- OpenWrt `feeds update -a` 增加 3 次递增等待重试，避免单个 feed 的短暂 TLS 中断直接终止整个构建。