讲师中心 微信公众号
AI工具推荐 视频效率加速

怎么解决内网拉取自建仓库镜像时提示证书不受信报错

星敏吖_3758

星敏吖_3758

发布时间:2026-06-29 11:13:21

|

1007人浏览过

|

来源于php中文网

原创

核心是让容器运行时信任内网仓库CA证书而非跳过验证;需将PEM格式ca.crt置于/etc/docker/certs.d/域名:端口/目录(Docker)或/etc/pki/ca-trust/source/anchors/(containerd),并确保域名、端口、协议与证书SAN及配置严格匹配。

怎么解决内网拉取自建仓库镜像时提示证书不受信报错

核心是让容器运行时(Docker 或 containerd)明确信任你内网自建仓库的 CA 证书,而不是跳过验证。错误提示 x509: certificate signed by unknown authority 表明 TLS 握手时证书链无法追溯到它认可的根证书,和网络通不通、镜像存不存在无关。

确认访问地址与证书目录严格匹配

容器运行时按“完整访问地址(含端口)”查找证书,差一个字符都不行:

  • 如果你执行 docker pull registry.internal:443/app,证书必须放在 /etc/docker/certs.d/registry.internal:443/
  • 如果用 IP 访问,比如 10.10.20.5:30500,目录名就得是 /etc/docker/certs.d/10.10.20.5:30500/,不能省略端口,也不能写成 /etc/docker/certs.d/10.10.20.5/
  • 目录下文件名必须是 ca.crt(全小写,无其他扩展名),内容为 PEM 格式(以 -----BEGIN CERTIFICATE----- 开头)

正确安装证书到运行时信任路径

不要改系统级 CA 存储(如 /usr/local/share/ca-certificates/),Docker 和 containerd 默认不读那里:

Dolphindb Docker
Dolphindb Docker

自动化 DolphinDB Docker 部署,支持自动架构检测(ARM64/x86_64),智能内存分配(50% 规则)以及完整数据持久化。

下载
  • 对 Docker:创建目录 sudo mkdir -p /etc/docker/certs.d/your-registry:port,复制证书 sudo cp ca.crt /etc/docker/certs.d/your-registry:port/ca.crt,权限设为 644,再 sudo systemctl restart docker
  • 对 containerd(openEuler 等系统推荐方式):把 ca.crt 复制到 /etc/pki/ca-trust/source/anchors/,运行 sudo update-ca-trust extract,然后 sudo systemctl restart containerd

区分协议与登录方式,避免混用

HTTPS 仓库和 HTTP 仓库配置逻辑完全不同,混用会引发看似矛盾的错误:

  • 若仓库启用了 HTTPS(如 Harbor 默认),docker login 必须带 https:// 前缀:docker login https://registry.internal
  • 若仓库是纯 HTTP 模式(如本地 registry:2 监听 :5000),docker login 不加协议:docker login localhost:5000,同时必须在 /etc/docker/daemon.json 中配置 "insecure-registries": ["localhost:5000"] 并重启 dockerd
  • 否则容易出现“登录成功但拉取失败”,或报 server gave HTTP response to HTTPS client

验证证书本身是否合规

即使放对了位置,证书自身问题也会导致失败:

  • 用 openssl s_client -connect your-registry:port -showcerts 查看实际返回的证书,确认其 Subject 或 SAN 域名与你访问的地址完全一致(比如访问 IP 就不能只签了域名)
  • 检查证书有效期:openssl x509 -in ca.crt -noout -dates,确保当前时间在 notBefore 和 notAfter 之间
  • 确认你放的是根 CA 证书(不是服务端证书),且能完整构建信任链

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

80

2026.10.10

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

40

2026.10.10

Kratos框架Protobuf接口定义与代码生成合集
Kratos框架Protobuf接口定义与代码生成合集

本专题讲解Kratos框架接口定义体系,涵盖proto编写规范、proto add/client/server生成命令、http注解路由、validate校验、OpenAPI文档生成、跨服务proto复用与兼容性设计。

20

2026.10.10

C++虚函数怎么定义和调用
C++虚函数怎么定义和调用

C++虚函数是实现运行时多态的重要机制。本专题从virtual关键字的基本用法入手,介绍基类与派生类之间的函数重写、基类指针调用派生类方法,以及动态绑定的执行过程,帮助初学者掌握虚函数的核心语法。

40

2026.10.10

C++类与对象的封装方法教程
C++类与对象的封装方法教程

C++封装是面向对象编程的核心特性之一,通过类将数据与操作数据的函数组织在一起,并利用访问权限控制外部访问。本专题介绍类的定义、成员变量、成员函数以及public、private和protected的使用方法,帮助初学者掌握封装的基本原理。

20

2026.10.10

C++构造函数定义与调用方法
C++构造函数定义与调用方法

C++构造函数用于初始化类对象,是面向对象编程的重要基础。本专题从构造函数的定义、声明和调用入手,介绍默认构造函数、带参数构造函数、拷贝构造函数及成员初始化列表,帮助初学者掌握对象创建与初始化的基本方法。

20

2026.10.10

Kratos框架零基础入门教程
Kratos框架零基础入门教程

本专题整理Kratos框架入门内容,涵盖Go环境准备、kratos CLI安装升级、new命令创建项目、目录结构分层说明、服务启动与双协议端口、依赖下载报错排查,帮助开发者快速跑通第一个Kratos框架微服务应用。

20

2026.10.10

C++条件判断语句怎么写
C++条件判断语句怎么写

C++条件判断是控制程序执行流程的重要基础。本专题介绍if、if-else、else if和switch等常见分支语句,结合条件表达式、比较运算符与代码示例,帮助初学者掌握不同场景下的判断逻辑。

20

2026.10.10

C++变量怎么声明和赋值
C++变量怎么声明和赋值

C++变量是编写程序和存储数据的基础。本专题围绕变量声明、定义、初始化、赋值和类型选择等内容展开,帮助初学者理解不同变量的用法,并掌握在实际代码中定义和使用变量的方法。

20

2026.10.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn