注册中心

Cargo 安装 crate 并从 "注册中心" 中获取依赖。 默认的注册中心是 [crates.io] 。注册中心包含一个 "索引" ，其中包含可搜索的可用 crate 的列表 。 注册中心也可以提供网络 API ，支持通过 Cargo 直接发布新的 crate 。

注意: 如果你对镜像或拓展现有的注册中心感兴趣，请查看 源替换 。

如果你想搭建注册中心服务器，请参阅 运行注册中心 了解更多关于Cargo和注册中心之间协议的细节。

使用备用注册中心

要使用 [crates.io] 以外的注册中心，必须将注册中心的名称和URL索引添加到 .cargo/config.toml file 。 registries 表中每个键对应一个注册中心，例如:

[registries]
my-registry = { index = "https://my-intranet:8080/git/index" }

index 键应该是一个指向具有注册中心索引的git仓库的URL。 通过指定 registry 键和 Cargo.toml 中的依赖中的注册中心名称， crate 可以依赖不同注册中心的 crate。

# Sample Cargo.toml
[package]
name = "my-project"
version = "0.1.0"
edition = "2021"

[dependencies]
other-crate = { version = "1.0", registry = "my-registry" }

就像大多数配置一样，索引可以用环境变量而不是配置文件来指定。 例如，设置以下环境变量将与定义配置文件完成相同的事情:

CARGO_REGISTRIES_MY_REGISTRY_INDEX=https://my-intranet:8080/git/index

注意: [crates.io] 不接受依赖其他注册中心的crate的包。

发布到备用注册中心

如果注册中心支持 Web API 访问，那么包可以直接从 Cargo 发布到注册中心。 Cargo 的一些命令，如 cargo publish ，可以通过 --registry 命令行标志来指示使用哪个注册中心。 例如，要发布当前目录下的包:

  1. cargo login --registry=my-registry

    这只需要执行一次。需要输入从注册中心网站获得的私密API令牌。 另外，令牌可以通过 --token 命令行标志直接传递给 publish 命令，或者用注册中心的名称作为环境变量，如CARGO_REGISTRIES_MY_REGISTRY_TOKEN。

  2. cargo publish --registry=my-registry

可以在 .cargo/config.toml 中用 registry.default 键设置默认注册中心，而不必总是传递 "--registry" 命令行选项。比如说:

[registry]
default = "my-registry"

在 Cargo.toml 配置清单中设置 package.publish 键，可以限制包发布到哪些注册中心。这可以防止不小心将闭源包发布到 [crates.io] 。该值可以是一个注册中心名称的列表，例如:

[package]
# ...
publish = ["my-registry"]

publish 值可以是 false ，以限制所有发布，这与空列表相同。

由 cargo login 存储的认证信息被保存在Cargo主目录 (默认 $HOME/.cargo) 下的 credentials.toml 文件中。 对于每个注册中心对应一个单独的表，例如。

[registries.my-registry]
token = "854DvwSlUwEHtIo3kWy6x7UCPKHfzCmy"