Docker--解决x509: certificate signed by unknown authority

### 解决 Docker 构建过程中的 x509: certificate signed by unknown authority 错误 当遇到 `x509: certificate signed by unknown authority` 错误时，通常是因为 Docker 客户端尝试连接到一个使用自签名证书的安全 HTTPS 服务器。为了使 Docker 能够信任该证书，可以采取以下几种方法之一。 #### 方法一：配置不安全注册表 对于特定的私有仓库，可以通过修改 `/etc/docker/daemon.json` 文件来允许 Docker 使用不安全的注册表： ```json { "insecure-registries": ["harbor.xxxx.com:1111"] } ``` 保存更改并重启 Docker 服务以应用设置： ```bash sudo systemctl restart docker ``` 这使得 Docker 可以忽略 SSL 验证并与指定的主机通信[^3]。 #### 方法二：导入 CA 证书至系统受信库 如果希望更安全地解决问题而不是禁用SSL验证，则应该获取用于签署目标站点证书的CA根证书，并将其添加到系统的可信证书存储中。具体操作取决于操作系统版本和类型；对于基于Debian/Ubuntu Linux发行版来说，可按照如下方式处理： 1. 将下载好的 `.crt` 或者 `.pem` 格式的 CA 证书放置于 `/usr/local/share/ca-certificates/` 目录下； 2. 运行命令更新本地证书数据库： ```bash sudo update-ca-certificates ``` 完成上述步骤之后再次启动 Docker 应能正常工作而不再提示此错误消息[^4]。 #### 方法三：通过环境变量临时绕过校验 作为最后的选择，在开发环境中测试期间也可以考虑利用环境变量的方式暂时跳过 TLS 检查（注意这不是推荐的做法）。可以在执行任何涉及网络请求的操作之前设置这些变量： ```bash export DOCKER_TLS_VERIFY="0" export DOCKER_HOST="tcp://your-docker-host:port" ``` 这种方法仅适用于短期解决方案或调试目的，生产环境下应始终启用完整的TLS保护措施[^2]。