# 用 CLI 运行本地测试网

{% hint style="info" %}
💡 **用源代码或 Docker 来运行本地测试网** 

如果你想用 Docker 或者 `aptos-core` 源代码来启动并运行本地测试网，参阅[用验证器运行本地测试网](/aptos-kai-fa-zhe-wen-dang/jie-dian/ben-di-ce-shi-wang/yong-yan-zheng-qi-yun-xing-ben-di-ce-shi-wang.md)。
{% endhint %}

运行 Aptos 区块链的本地测试网，不会被连接到 Aptos 开发网，它将在你的本地机器上运行，独立于其他的 Aptos 网络。你可以使用这个本地测试网进行测试和开发。本地测试网可以针对已知版本的代码库进行本地开发，而不需要与实时网络互动或处理实时网络的现实成本。

{% hint style="info" %}
💡 **Aptos CLI 文档** 如果你还不了解 Aptos CLI，可以先看看这份全面的 [Aptos CLI 文档](/aptos-kai-fa-zhe-wen-dang/aptos-cli.md)。
{% endhint %}

### 从水龙头开始一个本地测试网

可以用下面这条命令来开始一个本地测试网：

```
aptos node run-local-testnet --with-faucet
```

上面的命令回启动一个本地验证器节点，并且会显示类似下面的终端输出：

```
Completed generating configuration:
        Log file: "/Users/greg/.aptos/testnet/validator.log"
        Test dir: "/Users/greg/.aptos/testnet"
        Aptos root key path: "/Users/greg/.aptos/testnet/mint.key"
        Waypoint: 0:74c9d14285ec19e6bd15fbe851007ea8b66efbd772f613c191aa78721cadac25
        ChainId: TESTING
        REST API endpoint: 0.0.0.0:8080
        Fullnode network: /ip4/0.0.0.0/tcp/6181

Aptos is running, press ctrl-c to exit

Faucet is running.  Faucet endpoint: 0.0.0.0:8081
```

上述命令将使用验证器节点的默认配置。

{% hint style="info" %}
**不要在同一时间使用同一命令的两个实例**

注意，同一命令的两个实例不能同时运行。这会导致验证器节点的端口冲突。
{% endhint %}

### 用本地测试网进行测试

你可以使用 Aptos CLI 进行全方位的本地测试网操作。关于如何配置 CLI，请先看下文。

#### 配置 Aptos CLI 来使用本地测试网

你可以添加一个单独的配置文件，如下所示：

```
aptos init --profile local --rest-url <http://localhost:8080> --faucet-url <http://localhost:8081>
```

会得到如下的输出。在 `Enter your private key...` 命令提示符i啊，按回车键生成一个随机的新密钥。

```
Configuring for profile local
Using command line argument for rest URL <http://localhost:8080/>
Using command line argument for faucet URL <http://localhost:8081/>
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 7100C5295ED4F9F39DCC28D309654E291845984518307D3E2FE00AEA5F8CACC1 doesn't exist, creating it and funding it with 10000 coins
Aptos is now set up for account 7100C5295ED4F9F39DCC28D309654E291845984518307D3E2FE00AEA5F8CACC1!  Run `aptos help` for more information about commands
{
  "Result": "Success"
}
```

此时，你应该在命令中添加 `--profile local` 以便在本地测试网上运行这些命令。

### 创建帐户并为帐户注资

要在本地测试网上创建新帐户，我们建议使用上述说明并使用不同的配置文件名称：

```
PROFILE=local
aptos init --profile $PROFILE --rest-url <http://localhost:8080> --faucet-url <http://localhost:8081>
```

为帐户注资：

```
aptos account fund --profile $PROFILE --account $PROFILE
```

创建资源帐户：

```
aptos account create-resource-account --profile $PROFILE --seed 1
```

### 将模块发布到本地测试网

可以通过添加 `--profile $PROFILE` 标志来运行任何命令。在这种情况下，我们也使用 `$PROFILE` 来作为 `HelloBlockchain` 示例中的命名地址。

```
aptos move publish --profile $PROFILE --package-dir /opt/git/aptos-core/aptos-move/move-examples/hello_blockchain --named-addresses HelloBlockchain=$PROFILE
{
  "Result": {
    "changes": [
      {
        "address": "7100c5295ed4f9f39dcc28d309654e291845984518307d3e2fe00aea5f8cacc1",
        "data": {
          "authentication_key": "0x7100c5295ed4f9f39dcc28d309654e291845984518307d3e2fe00aea5f8cacc1",
          "coin_register_events": {
            "counter": "1",
            "guid": {
              "id": {
                "addr": "0x7100c5295ed4f9f39dcc28d309654e291845984518307d3e2fe00aea5f8cacc1",
                "creation_num": "0"
              }
            }
          },
          "sequence_number": "4"
        },
        "event": "write_resource",
        "resource": "0x1::account::Account"
      },
    ...
    ],
    "gas_used": 59,
    "success": true,
    "version": 6261,
    "vm_status": "Executed successfully"
  }
}
```

### 重置本地状态

如果你更新了你的代码库，并进行了向后不兼容的修改，或者只是想重新开始，你可以用 `--force-restart` 标志运行命令：

```
aptos node run-local-testnet --with-faucet --force-restart
```

然后，它将提示你是否真的要重新启动链，以确保你不会意外地删除你的工作。

```
Are you sure you want to delete the existing chain? [yes/no] >
```

### 常见问题

#### 提示地址已被使用该怎么办？

如果你得到一个类似这样的错误：

```
'panicked at 'error binding to 0.0.0.0:9101: error creating server listener: Address already in use (os error 48)'
```

这意味着你要么已经在运行一个节点，要么你有另一个进程在该端口上运行。

在 macOS 和 Linux 上，你可以运行以下命令来获得使用该端口的进程的名称和 PID：

```
PORT=9101
lsof -i :$PORT
```

#### 在哪里可以得到关于 run-local-testnet 命令的更多信息？

更多 CLI 帮助可以运行这个命令看到：

```
aptos node run-local-testnet --help
```

这将提供关于该命令的每个标志的信息。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gushi10546.gitbook.io/aptos-kai-fa-zhe-wen-dang/jie-dian/ben-di-ce-shi-wang/yong-cli-yun-xing-ben-di-ce-shi-wang.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.