stagex/ca-certificates

Mozilla CA证书Docker镜像

镜像概述和主要用途

本镜像包含Mozilla官方维护的常用CA（证书颁发机构）证书PEM文件集合，这些证书是互联网上广泛信任的根证书，构成SSL/TLS通信中的信任基础。主要用途是为容器化应用提供可信的CA证书库，解决因缺少根证书导致的SSL/TLS证书验证失败问题（如"x509: certificate signed by unknown authority"错误），确保HTTPS通信的安全性和可靠性。

核心功能和特性

• 权威可信来源：证书集合源自Mozilla官方CA证书列表，包含全球主流CA机构的根证书，确保广泛信任度
• 标准PEM格式：证书以PEM格式提供，兼容大多数SSL/TLS应用程序（如curl、wget、Python requests等）
• 定期更新机制：镜像会定期同步Mozilla CA证书更新，包含最新可信证书，移除已吊销或不再信任的证书
• 轻量级设计：通常基于Alpine等轻量级基础镜像构建，体积小，拉取速度快
• 易于集成：证书路径标准化，可通过复制或挂载方式快速集成到其他Docker容器

使用场景和适用范围

适用场景

• 运行curl、wget等HTTPS客户端工具的容器，需要验证服务器证书
• 微服务架构中服务间HTTPS通信时的证书验证
• 自定义开发的容器化应用（如API客户端、爬虫）进行HTTPS请求时
• CI/CD流程中需要验证HTTPS资源的场景

适用范围

• 所有需要进行SSL/TLS证书验证的Docker容器环境
• 基于精简基础镜像（如scratch、alpine）且缺少系统CA证书的容器
• 需要统一管理CA证书版本的企业容器平台

详细使用方法和配置说明

获取镜像

从Docker仓库拉取最新版本（以实际镜像名称为准，此处示例为mozilla/ca-certificates）：

bash
docker pull mozilla/ca-certificates:latest

使用方法示例

方法1：Dockerfile中复制证书

在应用镜像构建过程中，从本镜像复制CA证书到应用容器：

dockerfile
# 应用基础镜像
FROM python:3.11-alpine

# 从CA证书镜像复制证书到系统CA目录
COPY --from=mozilla/ca-certificates:latest /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/

# 安装应用依赖和代码
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY app.py .
CMD ["python", "app.py"]

方法2：运行时挂载证书

通过卷挂载方式临时使用CA证书：

bash
# 创建临时容器获取证书路径
docker run --rm \
  -v $(docker create mozilla/ca-certificates:latest):/etc/ssl/certs/ca-certificates.crt:ro \
  alpine:latest \
  curl -v https://example.com

此命令将CA证书挂载到alpine容器的系统CA路径，使curl能验证HTTPS证书。

方法3：作为基础镜像

直接以本镜像为基础构建应用镜像：

dockerfile
FROM mozilla/ca-certificates:latest

# 安装应用组件
RUN apk add --no-cache nodejs npm
COPY . /app
WORKDIR /app
RUN npm install
CMD ["node", "server.js"]

证书路径说明

镜像中CA证书默认路径（具体以实际镜像为准）：

/etc/ssl/certs/ca-certificates.crt

应用配置示例：

• Python requests库：requests.get("https://example.com", verify="/etc/ssl/certs/ca-certificates.crt")
• Node.js：process.env.NODE_EXTRA_CA_CERTS = "/etc/ssl/certs/ca-certificates.crt"
• Java：-Djavax.net.ssl.trustStore=/etc/ssl/certs/ca-certificates.crt

注意事项

• 建议使用具体版本标签（如mozilla/ca-certificates:20231117）而非latest，确保环境一致性
• 定期更新镜像以获取最新CA证书，避免因证书过期导致验证失败
• 仅从可信渠道获取镜像，防止***CA证书引入安全风险