rust crate.io 配置国内源（cargo 国内源） warning: spurious network error (2 tries remainin...

rust 笔记 Crate 国内源配置

---

作者：李俊才 （jcLee95）：https://blog.csdn.net/qq_28550263?spm=1001.2101.3001.5343
邮箱 ：291148484@163.com
本文地址：https://blog.csdn.net/qq_28550263/article/details/130758057

---

---

1. 概述

Rust 官方默认的 Cargo 源服务器为 crates.io，其同时也是 Rust 官方的 crate 管理仓库，但是由于官方服务器部署在北美洲，中国大陆用户下载速度较慢，甚至反复中断下载——你是否正在经历 cargo 安装模块太慢？甚至进度卡停？

cargo add xxxx
    Updating crates.io xxxx
warning: spurious network error (2 tries remaining): failed to receive response: 操作超时
; class=Os (2)
       Fetch [======>                  ]  30.16%, 415.60KiB/s

… enmm，不用担心。当你主动来查找时，那么就如你所猜想的，作为 rust 语言的包管理器的 cargo，当然也有国内源。

2. Window 下配置国内源

2.1 新建配置文件

如果你安装好了 rust，在你的 用户主目录 中有一个.cargo 目录。其中用户主目录一般是 C:\Users\ +当前用户名 为路径的目录。

2.2 编辑配置文件

如果安装完成了 rust 当前用户目录下有一个 .cargo 目录。新建 config 文件，编辑内容：

[source.crates-io]
replace-with='rsproxy'

[source.rsproxy]
registry="https://rsproxy.cn/crates.io-index"

[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"

[net]
git-fetch-with-cli = true

2.3 也可以直接打开编辑器编辑

使用 Windows 的系统环境变量 $HOME 可以直接指向主目录。如果你安装了 VSCode，可以打开一个终端，输入以下命令：

code $HOME/.cargo/config

其中，code 所使用的是 VScode 的可执行文件：code.exe。运行上面命令后，VSCode 自动打开一个指向 config 文件的空文件：

然后编辑之前的内容，并保存即可。

2.4 powershell 命令添加环境变量

如果尽在本窗口有效，则可以使用以下命令：

$env:RUSTUP_DIST_SERVER="https://mirrors.sjtug.sjtu.edu.cn/rust-static"
$env:RUSTUP_UPDATE_ROOT="https://mirrors.sjtug.sjtu.edu.cn/rust-static/rustup"

你可以使用以下方式查看是否设置成功：

Write-Host $env:RUSTUP_DIST_SERVER
Write-Host $env:RUSTUP_UPDATE_ROOT

如需要写入为长期的环境变量则需要使用以下命令（其中User表示环境变量级别为当前用户，你也可以设置为系统级变量）：

[System.Environment]::SetEnvironmentVariable('RUSTUP_DIST_SERVER','https://mirrors.sjtug.sjtu.edu.cn/rust-static','User')
[System.Environment]::SetEnvironmentVariable('RUSTUP_UPDATE_ROOT','https://mirrors.sjtug.sjtu.edu.cn/rust-static/rustup','User')

3. Linux 下配置 cargo 国内源

3.1 安装 vim

如果已经安装有 vim / vi 或之类编辑工具则可以忽略。

# linux 的 debin 版本如 ubuntu 使用 apt 包管理器。如使用 centOS 的改用 yum 包管理器安装
sudo apt update
sudo apt install vim

（如果你在 docker 容器中，不需要 sudo）

3.2 编写配置文件

使用 vim 新建（或编辑已有）一个config文件：

sudo vim ~/.cargo/config

（如果你在 docker 容器中，不需要 sudo）

这时 vim 建立一个新的为保存config文件，英文输入模式下，输入 i 进入编辑模式，添加以下内容（和在Windows 时编辑的配置文件一样）：

[source.crates-io]
replace-with='rsproxy'

[source.rsproxy]
registry="https://rsproxy.cn/crates.io-index"

[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"

[net]
git-fetch-with-cli = true

依次 exit、:wq! 保存退出。

4. 关于 cargo 国内源

除了上面给出的配置，你可可以参考本节挑选一个自己喜欢的国内源进行配置。

字节跳动源

文档地址：https://rsproxy.cn/

crates.io 镜像

~/.cargo/config:

[source.crates-io]
# To use sparse index, change 'rsproxy' to 'rsproxy-sparse'
replace-with = 'rsproxy'

[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"
[source.rsproxy-sparse]
registry = "sparse+https://rsproxy.cn/index/"

[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"

[net]
git-fetch-with-cli = true

Rustup 镜像：

~/.zshrc or ~/.bashrc:

export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn/rustup"

上海交大源

地址：https://mirrors.sjtug.sjtu.edu.cn/docs/rust-static

使用方法：安装rustup，将以下环境变量加入~/.bashrc或类似文件中：

export RUSTUP_DIST_SERVER=https://mirror.sjtu.edu.cn/rust-static
export RUSTUP_UPDATE_ROOT=https://mirror.sjtu.edu.cn/rust-static/rustup

清华源

Rust crates.io 索引镜像

文档地址：https://mirrors.tuna.tsinghua.edu.cn/help/crates.io-index.git/

编辑 ~/.cargo/config 文件，添加以下内容：

[source.crates-io]
replace-with = 'mirror'

[source.mirror]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"

Rust crates.io 稀疏索引镜像

文档地址：https://mirrors.tuna.tsinghua.edu.cn/help/crates.io-index/

编辑 ~/.cargo/config 文件，添加以下内容：

[source.crates-io]
replace-with = 'mirror'

[source.mirror]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

注：sparse+ 表示在使用稀疏索引，链接末尾的 / 不能缺少。

截至目前，可以通过 cargo +nightly -Z sparse-registry update 使用稀疏索引。

cargo 1.68 版本开始支持稀疏索引：不再需要完整克隆 crates.io-index 仓库，可以加快获取包的速度。如果您的 cargo 版本大于等于 1.68，可以直接使用而不需要开启 nightly。

中科大源

文档地址：http://mirrors.ustc.edu.cn/help/crates.io-index.html

Windows 用户在使用 crates 源时可能会出现 next InitializeSecurityContext failed: Unknown error 错误（见 https://github.com/ustclug/discussions/issues/339 和 https://github.com/rust-lang/cargo/issues/7096）。一个 workaround 是在运行 cargo 的时候加入环境变量 CARGO_HTTP_CHECK_REVOKE=false，或者在配置中增加：

[http]
check-revoke = false

cargo 1.68 版本开始支持稀疏索引：不再需要完整克隆 crates.io-index 仓库，可以加快获取包的速度。如果您的 cargo 版本大于等于 1.68，可以在 $HOME/.cargo/config 中添加如下内容：

[source.crates-io]
replace-with = 'ustc'

[source.ustc]
registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"

在 $HOME/.cargo/config 中添加如下内容：

[source.crates-io]
replace-with = 'ustc'

[source.ustc]
registry = "git://mirrors.ustc.edu.cn/crates.io-index"

如果所处的环境中不允许使用 git 协议，可以把上述地址改为：

registry = "https://mirrors.ustc.edu.cn/crates.io-index"