Motrix Server 拉取镜像返回 manifest unknown如何确认发布版本与 registry 选择【免费下载链接】MotrixA full-featured download manager.项目地址: https://gitcode.com/GitHub_Trending/mo/Motrix在 NAS 或家用服务器上部署 Motrix Server 时docker compose pull server或 NAS 图形界面拉取镜像可能返回 404 或manifest unknown。这篇文章只处理这一个问题判断你请求的 repository/tag 是否真实存在确认当前发布是否已包含容器镜像并在这两个官方 registry 之间做出选择。适用对象是使用仓库自带 Compose 文件compose.yaml或等效docker run部署 Motrix Server 的用户依据来自 Docker Server 部署文档。manifest unknown 在 Motrix 文档中的含义Motrix Server 的带 tag 正式发布会把同一个镜像发布到两个 registryDocker Hubdocker.io/motrixapp/motrix-serverGitHub Container Registryghcr.io/agalwood/motrix-server仓库 Compose 默认使用 Docker Hub因为多数 NAS 界面无需额外配置即可搜索和拉取GHCR 是内容相同的 GitHub 原生镜像源可作为备用。文档对manifest unknown给出两层判断首个包含容器镜像的版本发布之前返回 404 或manifest unknown表示公开镜像尚未发布——这不是改用 fork 构建未验证镜像的理由。发布之后仍然出现该错误则按文档排查表处理检查 repository/tag 拼写确认是否已经存在包含镜像的 release可在另一个 registry 尝试相同不可变 tag不要改用名称相似的第三方镜像。下面按这三步排查。第一步核对 repository 与 tag 拼写拉取引用必须落在上面两个官方 repository 之一且 tag 必须符合发布规则。文档给出的 tag 语义如下2.3.4为文档示例版本号引用行为建议用途:2.3.4不可变正式版本生产与回滚:2.32.3 系列最新稳定补丁自动接收补丁升级:2主版本 2 的最新稳定版本自动接收次版本和补丁升级:stable最新稳定版本明确选择稳定通道的用户:latest与stable指向同一 digestNAS 界面默认值:2.3.4-beta.2不可变预发布版本仅用于评估两条容易误判的规则预发布版本不会更新2.3、2、stable或latest项目不发布edge或nightly镜像。如果你请求了:nightly、:edge之类的 tagmanifest unknown是必然结果这些 tag 从来不存在。只有两个 registry 的不可变 manifest digest 一致后发布流程才会推进 floating tag。因此某个 floating tag 暂时缺失而不可变 tag 可用属于发布顺序而非错误。第二步确认该版本是否包含容器镜像Motrix 的 release notes 会列出该版本容器镜像的准确引用。例如 2.0.0-beta.33 release notes 写明所有容器门禁通过后带版本镜像引用为docker.io/motrixapp/motrix-server:2.0.0-beta.33和ghcr.io/agalwood/motrix-server:2.0.0-beta.33linux/amd64、linux/arm64双架构。同一篇 notes 也说明 beta 容器 tag 是不可变的不会更新latest、stable或其他稳定 floating tag。因此判断方法直接落到 release notes找到你所请求版本对应的 release notes确认其中列出了容器镜像输出Docker Hub / GHCR 一行如果 notes 只列出桌面端分发而没有容器镜像条目说明该版本不包含 Server 镜像换一个带镜像的版本号如果请求的是预发布 tag注意它只在所有容器门禁通过后才可用。第三步在另一个 registry 尝试相同不可变 tag确认 tag 应该存在但当前 registry 拉取失败时把同一个不可变 tag 换到另一个 registry 验证。仓库 Compose 文件不需要编辑用MOTRIX_IMAGE环境变量即可切换2.3.4为文档示例版本号请替换为你已确认发布的版本export MOTRIX_IMAGEghcr.io/agalwood/motrix-server:2.3.4 docker compose up -d --wait如果 GHCR 上同一 tag 可拉取而 Docker Hub 上不行先按文档结论处理继续等待 Docker Hub 侧发布完成不要改用名称相似的第三方镜像。结果验证拉取成功后按文档的常规验证路径确认部署可用docker compose ps服务变为 healthy 后公开的GET /healthz只有在 HTTP 服务和 aria2 均就绪时才成功curl --fail http://127.0.0.1:8080/healthz需要最高可复现性时文档建议直接 pin 到 release 或 registry 显示的 digest并用buildx检查 manifestmanifest-digest替换为 release 或 registry 界面显示的 manifest digestexport MOTRIX_IMAGEmotrixapp/motrix-serversha256:manifest-digest docker buildx imagetools inspect $MOTRIX_IMAGEmanifest 包含 OCI source、revision、version、license、documentation labels以及 SPDX SBOM 和 SLSA provenance。带 tag 的 digest 使用 GitHub Actions OIDC 签名文档给出的 cosign 校验示例2.3.4与 digest 同样按实际发布值替换VERSION2.3.4 DIGESTsha256:manifest-digest cosign verify \ --certificate-identity https://github.com/agalwood/Motrix/.github/workflows/release.ymlrefs/tags/v${VERSION} \ --certificate-oidc-issuer https://token.actions.githubusercontent.com \ docker.io/motrixapp/motrix-server${DIGEST}与 no matching manifest 的区分文档把两种拉取错误分开处理不要混用排查路径manifest unknown/ 404该 tag 在所选 registry 上不存在——按本文核对拼写、版本发布状态与 registry 选择。no matching manifest架构不匹配——用docker info确认 NAS 是 64 位amd64或arm64Intel/AMD NAS 用amd64ARMv8 NAS 用arm64镜像不支持 32 位 ARM。如果两个 registry 上确认无误的不可变 tag 仍都返回manifest unknown按文档结论理解包含该镜像的 release 尚未完成发布保持现有可用部署等待发布完成后再拉取文档明确反对用 fork 构建未验证镜像来绕过这一状态。【免费下载链接】MotrixA full-featured download manager.项目地址: https://gitcode.com/GitHub_Trending/mo/Motrix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考