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

# Docker 部署多节点测试集群

> Deploy a scalable AutoMQ 3-node cluster using Docker to test Kafka-compatible features like partition reassignment and automatic data balancing efficiently.

本文档介绍如何在本地开发环境中部署三节点的 AutoMQ 集群（通过部署 MinIO 提供对象存储服务），用户可在该开发环境中验证例如分区迁移、数据自动均衡等集群相关的功能特性。

除了 Docker 部署方案，用户可参考以下文档体验其他部署方案，用于验证集群相关的功能特性：

* [Kubernetes 部署多节点集群▸](/zh/automq/deployment/deploy-multi-nodes-cluster-on-kubernetes)

* [Linux 主机部署多节点集群▸](/zh/automq/deployment/deploy-multi-nodes-cluster-on-linux)

<Tip>
  面向生产环境负载的 AutoMQ 部署和参数调优相对复杂，您可以通过[此处表单](https://www.automq.com/contact)联系 AutoMQ 团队获取必要的协助和最佳实践。
</Tip>

此外，如果您期望完全避免安装部署的工作负担，可以通过以下链接体验 AutoMQ 团队提供的全托管云服务，当前各云市场均提供了免费 30 天的试用体验。

* [从 AWS Marketplace 免费体验 AutoMQ Cloud](https://docs.automq.com/automq-cloud/getting-started/install-byoc-environment/aws/install-automq-on-aws)。

* [从阿里云云市场体验 AutoMQ Cloud](https://docs.automq.com/zh/automq-cloud/getting-started/install-byoc-environment/alibaba-cloud)。

## 前置条件

* Linux/Mac/Windows Subsystem for Linux

* Docker

* Docker Compose 版本 > 2.22.0

* 8GB 以上空闲内存

## 安装并启动三节点 AutoMQ 集群

输入下方命令即可下载单节点部署方案的 docker-compose 配置文件，并通过 Docker Compose 启动单节点的 AutoMQ 集群。

```bash theme={null}

curl -O https://raw.githubusercontent.com/AutoMQ/automq/refs/tags/1.5.5/docker/docker-compose-cluster.yaml && docker compose -f docker-compose-cluster.yaml up -d

```

启动成功后，将在名为 automq\_net 的 docker 网络下暴露集群地址，集群的 bootstrap 地址为“**server1:9093,server2:9093,server3:9093** ”，后续可以通过该地址连接集群。

<img src="https://mintcdn.com/automq/C1RFhd9pcTVZzYyW/zh/automq/getting-started/deploy-multi-nodes-test-cluster-on-docker/1.webp?fit=max&auto=format&n=C1RFhd9pcTVZzYyW&q=85&s=8464f2e828f9317955b34b94e10b1b54" width="2780" height="470" data-path="zh/automq/getting-started/deploy-multi-nodes-test-cluster-on-docker/1.webp" />

<Tip>
  **注意：**

  上述测试环境中 AutoMQ 使用名为 automq\_net 的 docker 网络，如需连接该集群，需要配置 *--network automq\_net*选项，使用相同的 docker 网络连接集群。
</Tip>

## 测试消息收发

在安装启动 AutoMQ 集群后，可以通过运行以下命令，测试消息发送、消费等功能。

1. 运行以下命令，通过在 docker 环境运行 Kafka CLI 命令 kafka-topics.sh 创建 Topic。

```bash theme={null}

docker run --network automq_net automqinc/automq:1.5.5 /bin/bash -c "/opt/kafka/kafka/bin/kafka-topics.sh --create --topic quickstart-events --bootstrap-server server1:9092,server2:9092,server3:9092"

```

2. 运行以下命令，通过在 docker 环境运行 Kafka CLI 命令 kafka-console-producer.sh 发送测试消息。

```bash theme={null}

docker run -it --network automq_net automqinc/automq:1.5.5 /bin/bash -c "/opt/kafka/kafka/bin/kafka-console-producer.sh --topic quickstart-events --bootstrap-server server1:9092,server2:9092,server3:9092"

```

3. 运行以下命令，通过在 docker 环境运行 Kafka CLI 命令 kafka-console-consumer.sh 消费测试消息。

```bash theme={null}

docker run --network automq_net automqinc/automq:1.5.5 /bin/bash -c "/opt/kafka/kafka/bin/kafka-console-consumer.sh --topic quickstart-events --from-beginning --bootstrap-server server1:9092,server2:9092,server3:9092"

```

## 体验 AutoMQ 集群功能

除了基础的消息生产和消费功能，AutoMQ 支持秒级分区迁移、自动数据重平衡等能力，解决了 Apache Kafka 无法快速迁移、扩缩容等问题。可以参考如下文档进行测试验证：

* [示例：验证秒级分区迁移▸](/zh/automq/getting-started/explore-automq/example-partition-reassignment-in-seconds)

* [示例：持续数据自平衡▸](/zh/automq/getting-started/explore-automq/example-continuous-data-self-balancing)

* [示例：集群节点变化触发分区自平衡▸](/zh/automq/getting-started/explore-automq/example-self-balancing-when-cluster-nodes-change)

## 停止并卸载三节点 AutoMQ 集群

完成功能测试后，请运行以下命令以停止和卸载当前 AutoMQ 集群。

```bash theme={null}

curl -O https://raw.githubusercontent.com/AutoMQ/automq/refs/tags/1.5.5/docker/docker-compose-cluster.yaml && docker compose -f docker-compose-cluster.yaml down -v

```