如何配置Cargo从私有crates仓库拉取依赖而非crates.io？

要让Cargo完全从私有仓库拉取依赖而非crates.io，可通过全局或项目本地配置实现，以下是具体步骤和示例：

1. 全局配置（所有Cargo项目生效） #

编辑用户目录下的Cargo配置文件：

• Linux/macOS：~/.cargo/config.toml
• Windows：%USERPROFILE%\.cargo\config.toml

添加如下配置，将默认crates.io源替换为你的私有仓库：

[registries]
# 定义私有仓库，替换为你的仓库索引地址（通常是Git仓库URL）
my_private_registry = { index = "https://your-private-registry-url/index.git" }

[source.crates-io]
# 将默认源替换为私有仓库
replace-with = "my_private_registry"

如果需要在私有仓库找不到依赖时 fallback 到crates.io，可补充配置：

[source.my_private_registry]
registry = "https://your-private-registry-url/index.git"
fallback = "crates-io"

2. 项目本地配置（仅当前项目生效） #

在项目根目录创建.cargo/config.toml文件，写入与全局配置相同的内容即可。这种方式不会影响其他Cargo项目，适合单个项目的独立配置。

3. 私有仓库认证配置 #

如果私有仓库需要身份验证，根据认证方式添加对应配置：

HTTP/HTTPS 认证（令牌或用户名密码） #

编辑~/.cargo/credentials.toml（Windows同路径）：

[registries.my_private_registry]
# 使用令牌认证（推荐）
token = "your-private-registry-auth-token"
# 或使用用户名密码
# username = "your-username"
# password = "your-password"

SSH 认证 #

若私有仓库通过Git SSH访问，确保本地已配置SSH密钥并添加到对应平台。如需强制Cargo使用系统Git命令拉取索引（避免内置Git实现的问题），可在config.toml中添加：

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

4. 验证配置 #

执行cargo run -v查看详细日志，检查依赖拉取的地址是否指向你的私有仓库，确认配置生效。

内容的提问来源于stack exchange，提问作者dharmendra chaudhary