cargo-login(1)

名称

cargo-login — 登录到注册表

概要

cargo login [选项] [令牌] [-- 参数]

描述

此命令将运行凭据提供程序以保存令牌,以便需要身份验证的命令(例如 cargo-publish(1))将自动进行身份验证。

两个破折号 (--) 之后的所有参数都将传递给凭据提供程序。

对于默认的 cargo:token 凭据提供程序,令牌保存在 $CARGO_HOME/credentials.toml 中。CARGO_HOME 默认为您主目录中的 .cargo

如果注册表指定了凭据提供程序,则将使用该提供程序。否则,将尝试使用配置值 registry.global-credential-providers 中的提供程序,从列表的末尾开始。

如果未指定 令牌 参数,则将从标准输入中读取。

crates.io 的 API 令牌可以从 https://crates.io/me 获取。

请注意保管好令牌,不要与他人共享。

选项

登录选项

--registry 注册表
要使用的注册表名称。注册表名称在 Cargo 配置文件 中定义。如果未指定,则使用默认注册表,该注册表由 registry.default 配置键定义,默认为 crates-io

显示选项

-v
--verbose
使用详细输出。可以指定两次以获得“非常详细”的输出,其中包括额外的输出,例如依赖项警告和构建脚本输出。也可以使用 term.verbose 配置值 指定。
-q
--quiet
不打印 cargo 日志消息。也可以使用 term.quiet 配置值 指定。
--color 何时
控制何时使用彩色输出。有效值

  • auto(默认):自动检测终端上是否支持颜色。
  • always:始终显示颜色。
  • never:从不显示颜色。

也可以使用 term.color 配置值 指定。

常用选项

+工具链
如果使用 rustup 安装了 Cargo,并且 cargo 的第一个参数以 + 开头,则它将被解释为 rustup 工具链名称(例如 +stable+nightly)。有关工具链覆盖如何工作的更多信息,请参阅 rustup 文档
--config 键=值路径
覆盖 Cargo 配置值。参数应采用 键=值 的 TOML 语法,或作为额外配置文件的路径提供。此标志可以指定多次。有关更多信息,请参阅 命令行覆盖部分
-C 路径
在执行任何指定的操作之前更改当前工作目录。这会影响 Cargo 默认查找项目清单 (Cargo.toml) 的位置,以及搜索 .cargo/config.toml 的目录等。此选项必须出现在命令名称之前,例如 cargo -C path/to/my-project build

此选项仅在 夜间版通道 上可用,并且需要 -Z unstable-options 标志才能启用(请参阅 #10098)。

-h
--help
打印帮助信息。
-Z 标志
Cargo 的不稳定(仅限夜间版)标志。运行 cargo -Z help 以获取详细信息。

环境

有关 Cargo 读取的环境变量的详细信息,请参阅 参考

退出状态

  • 0:Cargo 成功。
  • 101:Cargo 未能完成。

示例

  1. 保存默认注册表的令牌

    cargo login
    
  2. 保存特定注册表的令牌

    cargo login --registry my-registry
    

另请参阅

cargo(1)cargo-logout(1)cargo-publish(1)