使用 Docker Compose 輕松實(shí)現(xiàn) INFINI Console 離線部署與持久化管理

本文是 INFINI Console 環(huán)境搭建系列的第四篇，專為需要在離線或內(nèi)網(wǎng)環(huán)境中容器化部署 INFINI Console 與 Easysearch 的用戶設(shè)計(jì)。

系列回顧與引言

在我們的 INFINI 本地環(huán)境搭建系列博客中：

第一篇《搭建持久化的 INFINI Console 與 Easysearch 容器環(huán)境》，我們深入探討了如何使用基礎(chǔ)的 docker run 命令，一步步構(gòu)建起 Console 和 Easysearch 服務(wù)，并重點(diǎn)解決了數(shù)據(jù)持久化的問題。
第二篇《使用 Docker Compose 簡(jiǎn)化 INFINI Console 與 Easysearch 環(huán)境搭建》，我們學(xué)習(xí)了如何利用 Docker Compose 的聲明式配置，將多容器應(yīng)用的定義和管理變得更加簡(jiǎn)潔高效。
第三篇《一鍵啟動(dòng)：使用 start-local 腳本輕松管理 INFINI Console 與 Easysearch 本地環(huán)境》，我們介紹了如何在聯(lián)網(wǎng)環(huán)境下，一鍵安裝 INFINI Console。

接下來，我們將聚焦于離線環(huán)境，詳細(xì)講解如何使用 Docker Compose 部署 INFINI Console 和 Easysearch。

簡(jiǎn)介

INFINI Console 是一款強(qiáng)大的集群管理與可觀測(cè)性平臺(tái)，而 INFINI Easysearch 則是一個(gè)輕量級(jí)、高性能的搜索與分析引擎。官方提供的離線部署包將兩者整合，非常適合在無外網(wǎng)或需要快速搭建演示環(huán)境的場(chǎng)景下使用。

本文將詳細(xì)介紹如何下載資源、正確加載鏡像、以及最關(guān)鍵的——如何根據(jù)您的需求修改 docker-compose.yml 中的各項(xiàng)配置。

1. 準(zhǔn)備工作

請(qǐng)確保您的環(huán)境中已安裝以下軟件：

Docker
Docker Compose

2. 下載離線資源

從官方地址下載兩個(gè)核心文件：

infini-console.tar.gz: 包含 docker-compose.yml 和相關(guān)腳本。
infini-console-easysearch-1.14.2.tar: 包含 infinilabs/console 和 infinilabs/easysearch 的 Docker 鏡像。

wget https://release.infinilabs.com/easysearch/archive/offline/amd64/infini-console.tar.gz
wget https://release.infinilabs.com/easysearch/archive/offline/amd64/infini-console-easysearch-1.14.2.tar

3. 正確加載 Docker 鏡像

注意：infini-console-easysearch-1.14.2.tar 是一個(gè)包含多個(gè)鏡像的歸檔包，不能直接使用 docker load 加載。

正確的加載步驟如下：

創(chuàng)建目錄并解壓鏡像歸檔包：
```
mkdir -p images
tar -xvf infini-console-easysearch-1.14.2.tar -C images
```
這會(huì)將 console.tar 和 easysearch.tar 等文件解壓到 images/ 目錄中。
批量加載所有鏡像：
```
cd images
ls *.tar | xargs -I {} docker load -i {}
```
該命令會(huì)自動(dòng)為目錄下的每個(gè) .tar 文件執(zhí)行 docker load 操作。
驗(yàn)證鏡像加載結(jié)果：
```
docker images
```
您應(yīng)該能看到 infinilabs/console:1.29.8 和 infinilabs/easysearch:1.14.2 等鏡像。

4. 修改配置文件

解壓 infini-console.tar.gz 后，找到 .env 文件。所有自定義配置都應(yīng)在此文件中修改。

以下是各項(xiàng)配置的詳細(xì)說明和修改建議：

核心路徑配置

WORK_DIR_ABS=/data/infini-console

作用: 定義所有持久化數(shù)據(jù)（日志、配置、索引）的根目錄。
修改建議: （必改） 強(qiáng)烈建議修改為您服務(wù)器上一個(gè)有足夠空間的路徑，例如 /opt/infini-console。確保該目錄存在且 Docker 擁有寫入權(quán)限。

網(wǎng)絡(luò)配置

APP_NETWORK_NAME=infini-local-net

作用: 定義 Docker 內(nèi)部網(wǎng)絡(luò)的名稱。
修改建議: 通常無需修改。

Console 配置

CONSOLE_IMAGE=infinilabs/console
CONSOLE_VERSION_TAG=1.29.8
CONSOLE_CONTAINER_NAME=infini-console
CONSOLE_PORT_HOST=9000
CONSOLE_PORT_CONTAINER=9000

作用: 定義 Console 的鏡像、版本、容器名及端口映射。
修改建議:
- CONSOLE_PORT_HOST: 如果宿主機(jī)的 9000 端口已被占用，請(qǐng)修改為其他可用端口（如 8080）。

Easysearch 配置

EASYSEARCH_IMAGE=infinilabs/easysearch
EASYSEARCH_VERSION_TAG=1.14.2
EASYSEARCH_NODES=1
EASYSEARCH_CLUSTER_NAME=infini-console

作用: 定義 Easysearch 的鏡像、版本、節(jié)點(diǎn)數(shù)和集群名。
修改建議:
- EASYSEARCH_NODES: 單機(jī)部署保持 1 即可。

訪問與安全配置

EASYSEARCH_INITIAL_ADMIN_PASSWORD=ShouldChangeme123.

作用: 設(shè)置 Easysearch admin 用戶的初始密碼。
修改建議: （必改） 請(qǐng)務(wù)必將其替換為一個(gè)強(qiáng)密碼。登錄 Console 時(shí)需要使用此密碼。

EASYSEARCH_HTTP_PORT_HOST=9200
EASYSEARCH_TRANSPORT_PORT_HOST=9300

作用: 定義 Easysearch HTTP 和 Transport 接口在宿主機(jī)上的映射端口。
修改建議: 如果 9200 或 9300 端口沖突，請(qǐng)修改。

JVM 參數(shù)配置

ES_JAVA_OPTS_DEFAULT="-Xms8g -Xmx8g"

作用: 設(shè)置 Easysearch 的 JVM 堆內(nèi)存大小。
修改建議: （必改） 請(qǐng)根據(jù)服務(wù)器物理內(nèi)存進(jìn)行調(diào)整，避免超過物理內(nèi)存的 50%。
- 8GB 內(nèi)存服務(wù)器: 建議設(shè)為 -Xms2g -Xmx2g。
- 16GB 內(nèi)存服務(wù)器: 建議設(shè)為 -Xms4g -Xmx4g。

數(shù)據(jù)持久化路徑

CONSOLE_HOST_DATA_SUBPATH_REL=console/data
CONSOLE_HOST_LOGS_SUBPATH_REL=console/logs
EASYSEARCH_HOST_NODES_BASE_SUBPATH_REL=easysearch

作用: 定義數(shù)據(jù)和日志在 WORK_DIR_ABS 下的相對(duì)子路徑。
修改建議: 通常無需修改。

5. 啟動(dòng)服務(wù)

完成配置修改后，在 docker-compose.yml 所在目錄下執(zhí)行：

docker-compose up -d

等待服務(wù)完全啟動(dòng)。

6. 訪問控制臺(tái)

打開瀏覽器，訪問 http://<你的服務(wù)器IP>:9000。

使用默認(rèn)用戶名 admin 和您在 EASYSEARCH_INITIAL_ADMIN_PASSWORD 中設(shè)置的密碼進(jìn)行初始化。

總結(jié)

通過以上步驟，您可以靈活地部署一套功能完整的 INFINI Console + Easysearch 環(huán)境。關(guān)鍵在于理解并根據(jù)實(shí)際情況修改 .env 文件中的參數(shù)，特別是 WORK_DIR_ABS、EASYSEARCH_INITIAL_ADMIN_PASSWORD 和 ES_JAVA_OPTS_DEFAULT，這能確保部署的穩(wěn)定性和安全性。

希望這篇詳細(xì)的指南能幫助您順利完成部署！

作者：羅厚付，極限科技（INFINI Labs）云上產(chǎn)品設(shè)計(jì)與研發(fā)負(fù)責(zé)人，擁有多年安全風(fēng)控及大數(shù)據(jù)系統(tǒng)架構(gòu)經(jīng)驗(yàn)，主導(dǎo)過多個(gè)核心產(chǎn)品的設(shè)計(jì)與落地，日常負(fù)責(zé)運(yùn)維超大規(guī)模 ES 集群（800+節(jié)點(diǎn)/1PB+數(shù)據(jù)）。
原文：https://infinilabs.cn/blog/2025/console-easysearch-with-docker-compose-offline/

posted @ 2025-11-03 20:32 極限實(shí)驗(yàn)室閱讀(6) 評(píng)論(0) 收藏舉報(bào)

刷新頁(yè)面返回頂部