---
title: "使用 Docker Compose 简化 INFINI Console 与 Easysearch 环境搭建"
date: 2025-06-14
lastmod: 2025-06-14
description: "继手动搭建后，本文介绍如何使用 Docker Compose 轻松管理持久化的 INFINI Console 与 Easysearch 环境。"
tags: ["Docker", "Docker Compose", "Easyserach", "Console", "DevOps"]
summary: "前言回顾 #  在上一篇文章《 搭建持久化的 INFINI Console 与 Easysearch 容器环境》中，我们详细介绍了如何使用基础的 docker run 命令，手动启动和配置 INFINI Console (1.29.6) 和 INFINI Easysearch (1.13.0) 容器，并实现了关键数据的持久化，解决了重启后配置丢失的问题。
手动操作虽然能让我们深入理解 Docker 的核心机制，但在管理多个容器、网络和卷时，命令会变得冗长且容易出错。这时，Docker Compose 就派上了用场。它允许我们使用一个 YAML 文件来定义和运行多容器 Docker 应用程序。
本篇文章将演示如何将上一篇的手动步骤转换为使用 Docker Compose，让你更轻松地管理和维护这套本地开发测试环境。
Docker Compose 的优势 #  使用 Docker Compose 带来了诸多好处：
 声明式配置：在一个 docker-compose.yml 文件中定义所有服务、网络和卷，清晰明了。 一键式管理：使用简单的命令（如 docker compose up, docker compose down）即可启动、停止和重建整个应用环境。 简化网络和服务连接：Compose 会自动处理服务间的网络设置和依赖关系。 易于共享和版本控制：docker-compose.yml 文件可以轻松地与团队共享并通过版本控制系统（如 Git）进行管理。  准备工作 #  与上一篇类似，你需要：
 操作系统: macOS (本文示例) Docker 环境: OrbStack ( https://orbstack."
---


## 前言回顾

在上一篇文章《[搭建持久化的 INFINI Console 与 Easysearch 容器环境](/blog/2025/console-easysearch-with-docker/)》中，我们详细介绍了如何使用基础的 `docker run` 命令，手动启动和配置 INFINI Console (1.29.6) 和 INFINI Easysearch (1.13.0) 容器，并实现了关键数据的持久化，解决了重启后配置丢失的问题。

手动操作虽然能让我们深入理解 Docker 的核心机制，但在管理多个容器、网络和卷时，命令会变得冗长且容易出错。这时，Docker Compose 就派上了用场。它允许我们使用一个 YAML 文件来定义和运行多容器 Docker 应用程序。

本篇文章将演示如何将上一篇的手动步骤转换为使用 Docker Compose，让你更轻松地管理和维护这套本地开发测试环境。

## Docker Compose 的优势

使用 Docker Compose 带来了诸多好处：

* **声明式配置**：在一个 `docker-compose.yml` 文件中定义所有服务、网络和卷，清晰明了。
* **一键式管理**：使用简单的命令（如 `docker compose up`, `docker compose down`）即可启动、停止和重建整个应用环境。
* **简化网络和服务连接**：Compose 会自动处理服务间的网络设置和依赖关系。
* **易于共享和版本控制**：`docker-compose.yml` 文件可以轻松地与团队共享并通过版本控制系统（如 Git）进行管理。

## 准备工作

与上一篇类似，你需要：

* **操作系统**: macOS (本文示例)
* **Docker 环境**: OrbStack ([https://orbstack.dev/](https://orbstack.dev/)) 或 Docker Desktop for Mac。
* 确保 Docker Compose V2 (`docker compose`) 或 V1 (`docker-compose`) 已安装并可用。

> 查看 `docker compose` 版本

```bash
docker compose version
Docker Compose version v2.24.5
```

## 步骤一：项目目录结构

我们将继续使用上一篇文章中创建的目录结构。如果你还没有创建，或者想重新开始，可以在你的项目根目录（例如 `~/infini_compose_lab`）下创建如下结构：

```bash
# 1. 创建项目根目录
mkdir -p ~/infini_compose_lab
cd ~/infini_compose_lab

# 2. 为 Console 和 Easysearch 创建持久化子目录
# 这些目录将用于存储配置、数据和日志
mkdir -p console/config console/data console/logs
mkdir -p easysearch/config easysearch/data easysearch/logs
```

## 步骤二：提取初始配置文件

这一步与上一篇完全相同。你在首次启动时使用从镜像中提取的默认配置，请执行以下操作。如果这些目录中已存在配置文件（例如从上一篇博客的操作中保留下来的），Docker Compose 在挂载时会直接使用它们。

**1. INFINI Console (1.29.6) 初始配置**
(容器内配置路径: `/config`)

```bash
# 确保在 ~/infini_compose_lab 目录下
docker pull infinilabs/console:1.29.6
docker run --rm \
-v $PWD/console/config:/temp_host_config \
infinilabs/console:1.29.6 \
sh -c "cp -a /config/. /temp_host_config/ && chmod -R ugo+rw /temp_host_config/"
```

**2. INFINI Easysearch (1.13.0) 初始配置**
(容器内配置路径: `/app/easysearch/config`，初始密码: `INFINILabs01`)

**重要提示：请务必为 Easysearch 设置安全的密码。**

```bash
# 确保在 ~/infini_compose_lab 目录下
docker pull infinilabs/easysearch:1.13.0
docker run --rm \
-e EASYSEARCH_INITIAL_ADMIN_PASSWORD="INFINILabs01" \
-v $PWD/easysearch/config:/temp_host_config \
infinilabs/easysearch:1.13.0 \
sh -c "cp -a /app/easysearch/config/. /temp_host_config/ && chmod -R ugo+rw /temp_host_config/"
```

## 步骤三：创建 `docker-compose.yml` 文件

这是核心步骤。在你的项目根目录 `~/infini_compose_lab` 下，创建一个名为 `docker-compose.yml` 的文件，并填入以下内容。这个文件定义了我们的服务、它们如何运行以及它们如何交互。

```bash
cat <<EOF > docker-compose.yml
services:
  easysearch: 
    image: infinilabs/easysearch:1.13.0
    container_name: infini-easysearch
    environment:
      - cluster.name=infini_compose_cluster
      - node.name=node-01
      - cluster.initial_master_nodes=node-01
      - "ES_JAVA_OPTS=-Xms1g -Xmx1g"
      - EASYSEARCH_INITIAL_ADMIN_PASSWORD=INFINILabs01
    ports:
      - "9200:9200"
      - "9300:9300"
    volumes:
      - ./easysearch/config:/app/easysearch/config
      - ./easysearch/data:/app/easysearch/data
      - ./easysearch/logs:/app/easysearch/logs
    ulimits:
      memlock: {soft: -1, hard: -1}
      nofile: {soft: 65536, hard: 65536}
    networks:
      - infini_app_net

  console:
    image: infinilabs/console:1.29.6
    container_name: infini-console
    ports:
      - "9000:9000"
    volumes:
      - ./console/config:/config
      - ./console/data:/data
      - ./console/logs:/log
    networks:
      - infini_app_net

networks:
  infini_app_net:
    driver: bridge
EOF
```

**`docker-compose.yml` 文件关键点：**

* **`services`**: 定义了 `easysearch` 和 `console` 两个服务。
* **`image`**: 指定了每个服务使用的 Docker 镜像和版本。
* **`container_name`**: 为容器指定一个易于识别的名称。
* **`environment`**: 设置容器的环境变量。
* **Easysearch 单节点配置**: 注意 `cluster.initial_master_nodes` 设置为节点自身的名称。
* **`ports`**: 将容器的端口映射到宿主机的端口。
* **`volumes`**: **实现持久化的核心**。将宿主机当前目录 (`./`) 下的 `console/*` 和 `easysearch/*` 子目录分别映射到容器内对应的路径。
* **`networks`**: 将两个服务都连接到我们定义的 `infini_app_net` 网络。这使得 `console` 服务可以通过服务名 `easysearch` (例如 `https://easysearch:9200`) 来访问 `easysearch` 服务。

## 步骤四：使用 Docker Compose 启动环境

现在，所有配置都在 `docker-compose.yml` 文件中了。启动整个环境只需要一条命令。
在 `~/infini_compose_lab` 目录下（包含 `docker-compose.yml` 文件），执行：

```bash
docker compose up -d
```
* `docker compose` (V2) 或 `docker-compose` (V1)。
* `up`: 创建并启动在 `docker-compose.yml` 中定义的所有服务。
* `-d`: 后台模式运行。

首次运行时，如果本地没有对应的镜像，Docker Compose 会自动拉取。

**常用 Docker Compose 命令：**

* 查看服务状态：
```bash
docker compose ps
```

* 查看所有服务的实时日志：
```bash
docker compose logs -f
```

* 查看特定服务的日志：
```bash
docker compose logs -f console
docker compose logs -f easysearch
```

* 停止所有服务（保留数据）：
```bash
docker compose stop
```

* 停止并移除所有容器、网络和匿名卷（保留通过 `volumes` 映射的本地数据）：
```bash
docker compose down
```

## 步骤五：验证和使用

1. **访问 Console**: 浏览器打开 `http://localhost:9000`。
2. **进行配置**: 在 Console 中连接 Easysearch (`https://easysearch:9200`，因为它们在同一个 Docker 网络中，可以直接使用服务名)，创建用户，查看监控等。
3. **测试持久化**:
```bash
docker compose down # 停止并移除容器
# 稍等片刻
docker compose up -d # 重新启动
```
再次访问 `http://localhost:9000`，你会发现之前的配置都还在！

**操作截图**

{{% load-img "/img/blog/2025/console-easysearch-with-docker-compose/image-001.png" "" %}}
{{% load-img "/img/blog/2025/console-easysearch-with-docker-compose/image-002.png" "" %}}
{{% load-img "/img/blog/2025/console-easysearch-with-docker-compose/image-003.png" "" %}}
{{% load-img "/img/blog/2025/console-easysearch-with-docker-compose/image-004.png" "" %}}

> 彻底清理，包括删除命名卷（如果使用了的话）和本地数据(**可选**)

```bash
# -v 移除命名卷
docker compose down -v
# 然后手动删除本地持久化目录
rm -rf ~/infini_compose_lab/console
rm -rf ~/infini_compose_lab/easysearch
```

## 总结

通过 Docker Compose，我们用一个简洁的 `docker-compose.yml` 文件取代了之前冗长的 `docker run` 命令，极大地简化了 INFINI Console 和 Easysearch 本地环境的搭建和管理过程。同时，通过正确的卷挂载配置，我们依然确保了数据的持久化，解决了重启后配置丢失的问题。

对于开发、测试和快速原型验证，Docker Compose 无疑是一个强大而高效的工具。希望本教程能帮助你更轻松地使用 INFINI Console 进行本地实验和开发！