Docker 镜像拉取时怎么跳过不安全的 HTTPS 证书校验

舞夢輝影

舞夢輝影

2026-08-04

747人浏览

原创

答案是配置 insecure-registries 或添加可信根证书。前者通过编辑 /etc/docker/daemon.json 添加目标仓库地址(含端口),重启 docker 守护进程生效,适用于内网测试;后者将 pem 格式 ca 证书复制到 /etc/docker/certs.d/:/ca.crt 并重启服务,更安全,适合内网 ca 环境。

docker 镜像拉取时怎么跳过不安全的 https 证书校验

直接跳过 HTTPS 证书校验不推荐,但确有临时调试或内网测试场景需要。Docker 本身不提供全局“跳过证书验证”的开关,必须通过配置信任链或放宽安全策略来实现——本质是让 Docker daemon 认可目标仓库的证书,而非真正“跳过”验证。

配置 insecure-registries(最常用)

适用于私有仓库使用自签名证书、且无法立即部署可信证书的场景。该方式禁用指定地址的 TLS 证书校验,仅限 HTTP 或 HTTPS 但证书不可信的 registry。

  • 编辑 /etc/docker/daemon.json(Linux/macOS Docker Desktop 需通过设置导入)
  • 添加 insecure-registries 列表,例如:
    {"insecure-registries": ["192.168.1.100:5000", "registry.local:443"]}
  • 保存后重启 Docker 守护进程:
    sudo systemctl restart docker(Linux)或重启 Docker Desktop(macOS/Windows)
  • 注意:地址必须带端口,即使 HTTPS 默认 443 也要显式写上;不能写 https:// 前缀

为特定 registry 添加可信根证书

比 insecure-registries 更安全,适合内网 CA 签发的证书。Docker daemon 只读取 /etc/docker/certs.d/:/ca.crt 这一固定路径。

Docker Desktop
Docker Desktop

Docker Desktop 可用于构建容器化 PHP 开发环境,适合 Laravel、Symfony、WordPress 等项目统一运行依赖。

下载
  • 将根证书(PEM 格式)复制为:
    sudo mkdir -p /etc/docker/certs.d/registry.example.com:443/
    sudo cp root-ca.crt /etc/docker/certs.d/registry.example.com:443/ca.crt
  • 确保文件权限合理(如 644),文件名严格为 ca.crt
  • 重启 docker 服务生效
  • 验证:运行 curl -v https://registry.example.com:443/v2/ 应返回 200 或 401;再执行 docker login registry.example.com:443

容器内访问外部 HTTPS 服务失败?补全系统证书

这不是拉取镜像的问题,而是容器运行时调用外部 API(如调用 HTTPS 接口)报 x509: certificate signed by unknown authority。常见于 Alpine 镜像。

  • 在 Dockerfile 中安装 ca-certificates:
    RUN apk --no-cache add ca-certificates && update-ca-certificates
  • 对于 Debian/Ubuntu 基础镜像:
    RUN apt-get update && apt-get install -y ca-certificates && rm -rf /var/lib/apt/lists/*
  • 避免在运行中的容器里手动安装后不重启应用进程——证书加载通常在进程启动时完成

不建议的方式:改环境变量或跳过客户端校验

Docker CLI 不响应 HTTPS_PROXY_SKIP_VERIFY=1 或类似环境变量;docker pull 命令也无 --skip-tls-verify 参数。网上部分教程提到的 ENV HTTPS_PROXY_SKIP_VERIFY 1 在 Dockerfile 中仅对容器内进程有效,且前提是该进程自身支持该变量(如某些 Go 编写的工具),与 Docker daemon 的镜像拉取行为无关。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

421

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

1979

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2432

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

984

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

138

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

183

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

237

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

183

24

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

325

15

热门下载

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

精品课程

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

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

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

共0课时 | 0人学习