Elasticvue安装与使用指南

2026-02-06 05:00:27作者：凤尚柏Louis

Elasticvue是一个免费开源的Elasticsearch图形化管理界面，支持浏览器扩展、桌面应用、Docker容器和Web版本等多种使用方式。本文将详细介绍Elasticvue的安装配置和使用方法。

项目概述

Elasticvue是一个基于Vue 3开发的Elasticsearch管理工具，提供以下核心功能：

集群概览和健康状态监控
索引和别名管理
分片管理
文档搜索和编辑
REST查询接口
快照和存储库管理
多语言支持（中文、英文、法文、俄文、日文、意大利文）

安装方式

桌面应用（推荐）

桌面应用提供最佳的使用体验，支持Windows、macOS和Linux系统：

Windows: 下载 .msi安装包
macOS: 下载 x86 .dmg 或 aarch64 .dmg
Linux: 下载 .AppImage

浏览器扩展

Elasticvue提供主流浏览器的扩展版本：

Docker容器

使用Docker运行Elasticvue：

docker run -p 8080:8080 --name elasticvue -d cars10/elasticvue

Web版本

直接访问 https://app.elasticvue.com 即可使用在线版本。

集群配置

使用Docker或Web版本时，需要为Elasticsearch集群启用CORS配置。编辑Elasticsearch配置文件（如/etc/elasticsearch/elasticsearch.yml）：

# 启用CORS
http.cors.enabled: true

# 根据运行方式设置允许的源
# Docker/本地运行
http.cors.allow-origin: "http://localhost:8080"
# 在线版本
http.cors.allow-origin: /https?:\/\/app.elasticvue.com/

# 如果集群使用认证，还需添加
http.cors.allow-headers: X-Requested-With,Content-Type,Content-Length,Authorization

使用Docker运行Elasticsearch时，可以通过环境变量配置：

docker run -p 9200:9200 \
           -e "http.cors.enabled=true" \
           -e "http.cors.allow-origin=/.*/" \
           elasticsearch

默认集群配置

环境变量方式

通过环境变量ELASTICVUE_CLUSTERS配置默认集群：

docker run -p 8080:8080 -e ELASTICVUE_CLUSTERS='[{"name": "prod cluster", "uri": "http://localhost:9200", "username": "elastic", "password": "elastic"}]' cars10/elasticvue

配置文件方式

创建集群配置文件clusters.json：

[
  {
    "name": "开发集群",
    "uri": "http://localhost:9200"
  },
  {
    "name": "生产集群", 
    "uri": "http://localhost:9501",
    "username": "elastic",
    "password": "password"
  }
]

通过卷挂载配置文件：

docker run -p 8080:8080 -v /path/to/clusters.json:/usr/share/nginx/html/api/default_clusters.json cars10/elasticvue

从源码构建

环境要求

Node.js
npm 或 yarn
TypeScript

构建步骤

克隆项目代码：

git clone https://gitcode.com/gh_mirrors/el/elasticvue
cd elasticvue

安装依赖：

npm install

开发模式运行：

npm run dev

构建生产版本：

npm run build

运行测试：

# 单元测试
npm run test:unit

# E2E测试
npm run test:e2e

项目结构

Elasticvue采用现代化的Vue 3架构：

src/
├── components/          # Vue组件
│   ├── clusterselection/ # 集群选择组件
│   ├── home/           # 主页组件
│   ├── indices/        # 索引管理组件
│   ├── nodes/          # 节点管理组件
│   └── search/         # 搜索组件
├── composables/        # Composition API
├── store/             # Pinia状态管理
├── locales/           # 多语言文件
└── helpers/           # 工具函数