在使用 Rust 的包管理工具 Cargo 拉取依赖时，有时候会遇到 SSL 证书验证失败的问题。别着急，这篇文章就会给大家详细讲讲怎么通过关闭证书验证和配置本地证书来解决这个问题。

一、问题背景

咱们在使用 Cargo 拉取依赖时，它需要和远程仓库进行安全的通信，这就依赖于 SSL 证书来验证对方身份。但有时候，由于网络环境、证书过期或者其他原因，就会出现 SSL 证书验证失败的提示。比如你在公司的内网环境，可能存在网络代理，或者使用的是自签名证书，这些都有可能导致验证失败。

二、关闭证书验证

2.1 原理

关闭证书验证其实就是让 Cargo 不去验证远程服务器的 SSL 证书。这样做虽然能解决验证失败的问题，但也会带来一定的安全风险，因为你无法确认和你通信的服务器是不是合法的。所以，这只能作为一个临时的解决方案。

2.2 操作步骤

2.2.1 在命令行中临时关闭

在执行 cargo 命令时，可以通过设置环境变量来临时关闭证书验证。以下是在不同操作系统下的示例（技术栈：Rust）：

// 在 Linux 或 macOS 系统下
export CARGO_HTTP_CHECK_REVOKE=false
cargo build  // 执行你需要的 cargo 命令

// 在 Windows 系统下的 PowerShell
$env:CARGO_HTTP_CHECK_REVOKE = "false"
cargo build  // 执行你需要的 cargo 命令

2.2.2 在配置文件中永久关闭

你也可以在 Cargo 的配置文件中永久关闭证书验证。Cargo 的配置文件一般位于 ~/.cargo/config（Linux 或 macOS）或者 %USERPROFILE%\.cargo\config（Windows）。在这个文件中添加以下内容：

[http]
check-revoke = false

2.3 示例说明

假设你正在开发一个 Rust 项目，当你执行 cargo build 时，出现了 SSL 证书验证失败的提示。你可以先尝试在命令行中临时关闭证书验证：

# Linux 系统
export CARGO_HTTP_CHECK_REVOKE=false
cargo build

如果这样能成功拉取依赖并编译项目，说明问题可能出在证书验证上。如果你之后每次使用 Cargo 都不想进行证书验证，就可以在配置文件中永久关闭。

三、配置本地证书

3.1 原理

配置本地证书就是让 Cargo 使用你提供的合法证书来进行验证。这样既能保证通信的安全性，又能解决验证失败的问题。

3.2 操作步骤

3.2.1 获取证书

首先你需要获取合法的 SSL 证书。如果你使用的是公司内部的仓库，可能需要向管理员索要证书文件。证书文件一般是 .crt 或 .pem 格式。

3.2.2 配置 Cargo

在 Cargo 的配置文件（~/.cargo/config 或 %USERPROFILE%\.cargo\config）中添加以下内容：

[http]
# 指定本地证书文件的路径
cafile = "/path/to/your/certificate.crt"

3.3 示例说明

假设你从公司管理员那里拿到了一个名为 company_cert.crt 的证书文件，并且把它放在了 ~/certs 目录下。你可以在 Cargo 配置文件中这样配置：

[http]
cafile = "~/certs/company_cert.crt"

然后再执行 cargo build，Cargo 就会使用你提供的证书来进行验证。

四、应用场景

4.1 公司内网环境

在公司的内网中，可能存在网络代理或者使用的是自签名证书。这时候使用默认的证书验证可能会失败，就可以采用关闭证书验证或者配置本地证书的方法。比如，公司内部搭建了一个 Rust 包仓库，使用的是自签名证书，开发人员在拉取依赖时就会遇到验证问题。

4.2 测试环境

在测试环境中，有时候为了方便快速搭建环境，可能会使用一些临时的证书或者不规范的证书。这时候关闭证书验证可以让测试工作顺利进行。

五、技术优缺点

5.1 关闭证书验证

5.1.1 优点

  • 操作简单，只需要设置一个环境变量或者修改配置文件就可以。
  • 能快速解决验证失败的问题，让项目可以继续开发。

5.1.2 缺点

  • 存在安全风险，无法确认通信的服务器是否合法，可能会遭到中间人攻击。
  • 不适合在生产环境中使用。

5.2 配置本地证书

5.2.1 优点

  • 保证了通信的安全性，使用合法的证书进行验证。
  • 适用于生产环境和对安全性要求较高的场景。

5.2.2 缺点

  • 获取证书和配置证书的过程可能比较复杂，需要和管理员沟通。
  • 如果证书过期或者配置错误，仍然会出现验证失败的问题。

六、注意事项

6.1 安全问题

关闭证书验证虽然能解决问题，但带来了安全风险。在生产环境中，一定要使用配置本地证书的方法来保证通信的安全性。

6.2 证书有效期

如果使用配置本地证书的方法，要注意证书的有效期。一旦证书过期，就需要及时更新证书，否则仍然会出现验证失败的问题。

6.3 路径问题

在配置本地证书的路径时，要确保路径的正确性。不同操作系统的路径格式可能不同，要仔细检查。

七、文章总结

当我们使用 Cargo 拉取依赖时遇到 SSL 证书验证失败的问题，可以通过关闭证书验证和配置本地证书这两种方法来解决。关闭证书验证操作简单，但存在安全风险，适合临时解决问题或者在测试环境中使用。配置本地证书能保证通信的安全性，但过程相对复杂，适合生产环境和对安全性要求较高的场景。在实际应用中，我们要根据具体的情况选择合适的方法，同时要注意安全问题和证书的有效期。