Skip to content
🎉 Welcome to the new Aptos Docs! Click here to submit feedback!

设置 CLI 初始配置

如果您使用 CLI 在链上尝试操作,您需要配置网络、水龙头和凭据,以便 CLI 使用。

这使得使用 CLI 更加方便和安全,因为您不会被迫重复复制地址或私钥。

⚠️

如果您仍然需要安装CLI,请按照这些步骤

  1. 运行 aptos init 并按照命令行中的指示操作。

    ℹ️

    如果要使用默认设置,您可以不提供任何输入,只需按 “Enter”。例如:

    Terminal
     aptos init
    Output
    Configuring for profile default
    Enter your rest endpoint [Current: None | No input: https://api.devnet.aptoslabs.com]
     
    No rest url given, using https://api.devnet.aptoslabs.com...
    Enter your faucet endpoint [Current: None | No input: https://faucet.devnet.aptoslabs.com]
     
    No faucet url given, using https://faucet.devnet.aptoslabs.com...
    Enter your private key as a hex literal (0x...) [Current: None | No input: Generate new key (or keep one if present)]
     
    No key given, generating key...
    Account 00f1f20ddd0b0dd2291b6e42c97274668c479bca70f07c6b6a80b99720779696 doesn't exist, creating it and funding it with 10000 coins
    Aptos is now set up for account 00f1f20ddd0b0dd2291b6e42c97274668c479bca70f07c6b6a80b99720779696!  Run `aptos help` for more information about commands
     
    {
      "Result": "Success"
    }
  2. 稍后,如果您想更新这些设置,可以通过再次运行 aptos init 来完成。

  3. 这些额外的配置步骤不是必需的,主要是为了改善用户体验。若想根据您的需求继续使用命令行界面(CLI),请参照这里的使用指南

(可选)创建命名配置(配置文件)

对于测试更复杂的情况,您通常希望在链上有多个账户。实现此目的的一种方法是创建一个我们称为配置文件的命名配置。 在进行复杂场景测试时,你往往需要创建多个区块链账户。为此,你可以为此创建一个配置文件。

要创建一个配置文件,运行 aptos init --profile <配置文件名称>。您生成的配置将在调用 CLI 命令时用作参数的替代品。

例如:

Terminal
aptos init --profile bob
...
aptos account fund-with-faucet --profile bob
{
  "Result": "Added 100000000 Octas to account 0x63169727b08fc137b8720e451f7a90584ccce04c301e151daeadc7b8191fdfad"
}

(可选)设置 Shell 补全

你可以启用 Shell 自动补全的特性,它能够提升你的使用体验。

  1. 确定您正在使用哪个 shell(如果您不确定,可以运行 echo $SHELL)。
  2. 查找该 shell 的 shell 补全配置文件的位置(每个 shell 都不同)。支持补全的 shell 是 [bash, zsh, fish, PowerShell, elvish]
  3. 结合您所使用的 Shell 环境及相应的补全输出文件来执行以下命令:
Terminal
aptos config generate-shell-completions --shell <YOUR_SHELL_HERE> --output-file <YOUR_SHELL_OUTPUT_DESTINATION>

oh my zsh 的示例命令:

Terminal
aptos config generate-shell-completions --shell zsh --output-file ~/.oh-my-zsh/completions/_aptos

(可选)全局配置

默认情况下,CLI 会在每个工作区目录中的 .aptos/config.yaml 查找配置。如果您想为所有工作区使用共享配置,可以按照以下步骤操作:

  1. 在您的主目录中创建一个名为 .aptos 的文件夹(因此路径为 ~/.aptos)。
  2. .aptos 内部创建一个名为 global_config.yaml 的 yaml 文件。
  3. 运行命令:
Terminal
aptos config set-global-config --config-type global

您应该看到:

{
  "Result": {
    "config_type": "Global"
  }
}