> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monad.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Solonet

> 在 Docker 中本地运行一个完整的 Monad 网络,用于测试节点运维和验证者工作流。

[Solonet](https://github.com/monad-crypto/monad-solonet) 让您可以在几秒钟内在笔记本电脑上启动一个私有 Monad 网络。它在 Docker 中运行一个自包含的链——验证者节点、执行客户端和 RPC 端点——从创世启动并拥有无限代币。它使用与测试网和主网相同的二进制文件,因此节点行为与生产环境非常接近。原生支持 Linux,macOS 通过一个小型虚拟机层运行。

## 何时使用 Solonet

Solonet 为节点运维人员提供了不依赖公共网络的快速反馈循环:

* **练习节点运维**:在一次性使用的本地链上演练升级、恢复和配置变更。
* **测试验证者工作流**:针对自己的验证者运行 `staking-cli` 操作,无需花费测试网 MON 或等待终局化。
* **开发工具**:在您完全掌控状态的链上验证脚本、监控仪表板或区块传送集成。
* **重现问题**:启动一个多验证者拓扑,以调查共识或 blocksync 的边缘情况。

对于只需要一个快速 EVM 端点的应用开发,`anvil --network monad` 启动更快,通常已足够。当您需要完整的节点行为时(共识、质押、归档 RPC 或类生产环境的时序),请使用 Solonet。

## 前置条件

* Linux x86\_64 主机,或 macOS(Apple Silicon)
* 4 核以上 CPU 和 16 GB 内存
* Linux 上安装 Docker;macOS 上安装 Homebrew(用于安装下方的 Lima + Colima 环境)

## macOS 设置(Apple Silicon)

Solonet 的容器为 x86\_64 Linux,因此在 Apple Silicon 上您需要一个小型 Linux 虚拟机来承载 Docker。[Lima](https://lima-vm.io/) 与 [Colima](https://github.com/abiosoft/colima) 可以处理这个:

```bash theme={null}
brew install lima colima lima-additional-guestagents
```

启动一个资源充足的 x86\_64 Linux 虚拟机:

```bash theme={null}
colima start \
  --arch x86_64 \
  --cpu-type max \
  --cpu 8 \
  --memory 16 \
  --disk 300 \
  --foreground
```

验证 Docker 已连接到该虚拟机(输出应显示 `Architecture: x86_64`):

```bash theme={null}
docker info
```

Docker CLI 会自动指向 Colima 虚拟机,因此下方所有 `docker compose` 命令在 macOS 和 Linux 上运行方式完全相同。

若要在稍后拆除所有内容:

```bash theme={null}
colima delete --data
```

## 快速开始

克隆仓库并启动一个单验证者网络:

```bash theme={null}
git clone https://github.com/monad-crypto/monad-solonet
cd monad-solonet
docker compose up --build
```

网络启动后:

* RPC:`http://localhost:8080`
* WebSocket:`ws://localhost:8081`
* CORS RPC:`http://localhost:8082/rpc/`
* 仪表板:`http://localhost:8082`

## 其他网络配置

多验证者网络:

```bash theme={null}
docker compose -f networks/multi-validators.yaml up --build
```

完整组件网络(验证者加辅助服务):

```bash theme={null}
docker compose -f networks/full-network.yaml up --build
```

## 包含的工具

Solonet 容器附带了节点运维中最常用的工具:

* `forge` 和 `cast`([Foundry](https://book.getfoundry.sh/))
* 用于验证者质押操作的 `staking-cli`
* 用于检查节点健康状况的 `monad-status`

## 备注

* Solonet 从创世启动一个全新的链。其状态和验证者集合与测试网、主网独立,因此适合在您掌控的链上验证您的运维流程。
* 由于链在本地运行,终局化速度很快,gas 实际上是免费的。真实的延迟或负载测试仍需部署到网络中进行。

有关安装详情、环境变量和配置选项,请参阅 [Solonet README](https://github.com/monad-crypto/monad-solonet#readme)。