172 字
1 分钟
Docker 配置私服自签名证书信任
2026-01-31

在内网部署私有镜像仓库(如 Harbor)时,通常使用自签名证书。客户端需要手动信任该证书,否则 docker push / docker pull 会报证书验证失败。

如果你使用 Harbor 作为私服,参见 Harbor 私有镜像仓库安装指南

Linux#

# 1. 获取 Harbor 服务器的证书
openssl s_client -connect harbor.example.com:443 -showcerts </dev/null 2>/dev/null \
| openssl x509 -outform PEM > harbor-cert.pem
# 2. 创建 Docker 证书目录
sudo mkdir -p /etc/docker/certs.d/harbor.example.com
# 3. 复制证书到 Docker 信任目录
sudo cp harbor-cert.pem /etc/docker/certs.d/harbor.example.com/ca.crt
# 4. 同时添加到系统 CA 证书(推荐)
sudo cp harbor-cert.pem /usr/local/share/ca-certificates/harbor.example.com.crt
sudo update-ca-certificates
# 5. 重启 Docker 服务
sudo systemctl restart docker

Windows#

在 Git Bash 中执行以下命令获取证书:

echo | openssl s_client -connect harbor.example.com:443 -servername harbor.example.com 2>/dev/null \
| openssl x509 > harbor-ca.crt

然后将 harbor-ca.crt 安装到系统受信任的根证书:

  1. 双击 harbor-ca.crt
  2. 点击 安装证书…
  3. 选择 本地计算机 → 下一步
  4. 选择 将所有证书放入下列存储 → 浏览
  5. 选择 受信任的根证书颁发机构 → 确定 → 下一步 → 完成
  6. 重启 Docker Desktop
分享

如果这篇文章对你有帮助,欢迎分享给更多人!

Docker 配置私服自签名证书信任
https://blog.olinl.com/posts/docker-private-cert/
作者
顾拾柒
发布于
2026-01-31
许可协议
CC BY-NC-SA 4.0

目录