# slim-solr-admin

**Repository Path**: wsitm/slim-solr-admin

## Basic Information

- **Project Name**: slim-solr-admin
- **Description**: 轻量级 Apache Solr 管理工具，提供简洁的 Web 界面管理 Solr Collection 和 ConfigSet。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-05
- **Last Updated**: 2026-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Slim Solr Admin

轻量级 Apache Solr 管理工具，提供简洁的 Web 界面管理 Solr Collection 和 ConfigSet。

## 技术栈

- **后端**: Java 17 + Spring Boot 3.2.5 + SolrJ 8.5.2
- **前端**: Vue 3 + TypeScript + Element Plus + Vite

## 主要功能

- **Collection 管理**：查看、创建、删除、重载 Collection
- **ConfigSet 管理**：查看、上传（ZIP）、删除、基于模板创建
- **Cloud 集群管理**：SolrCloud 集群可视化运维
  - **Nodes**：查看 Live Nodes 列表与 Collections 概览（Shards、Replicas 状态统计）
  - **ZK Tree**：浏览 ZooKeeper 树形结构，点击节点查看 ZNode 详细属性（版本、数据长度、子节点数等）及数据内容，支持 ephemeral 节点标识
  - **ZK Status**：查看 ZooKeeper 集群状态（模式、健康状态、Ensemble 大小），展示每个 ZK 节点的角色、延迟、连接数、ZNode 数等运行指标
- **Kerberos 认证**：可选的 Kerberos 安全认证
- **DNS 映射**：JVM 级别 DNS 映射，适用于无法修改系统 hosts 的环境

## 快速开始

### 环境要求

- JDK 17+
- Node.js 18+
- Maven 3.6+
- Apache Solr 8.x+ (SolrCloud 模式)

### 配置说明

编辑 `solr-admin/src/main/resources/application.yml`：

```yaml
server:
  port: 8985

# Solr 集群地址（多个节点用逗号分隔）
solr:
  admin:
    solrUrl: http://node-71:8983/solr,http://node-72:8983/solr,http://node-73:8983/solr
    kerberosAuth: false  # 如需 Kerberos 认证设为 true
    krb5Path: ./doc/kerberos/krb5.conf
    solrJaasPath: ./doc/kerberos/solr_jaas.conf

# DNS 映射（可选，用于无法修改系统 hosts 的情况）
hosts:
  enable: true
  configs:
    - 192.168.80.71 node-71
    - 192.168.80.72 node-72
    - 192.168.80.73 node-73
```

### 启动服务

**后端：**
```bash
cd solr-admin
mvn spring-boot:run
```
后端服务运行在 `http://localhost:8985`

**前端：**
```bash
cd solr-ui
npm install
npm run dev
```
前端开发服务器运行在 `http://localhost:8983`

访问 `http://localhost:8983` 即可使用。

### 生产部署

**后端打包：**
```bash
cd solr-admin
mvn clean package
java -jar target/solr-admin-1.0-SNAPSHOT.jar
java -jar -Djdk.attach.allowAttachSelf=true --add-opens java.base/java.net=ALL-UNNAMED target/solr-admin-1.0-SNAPSHOT.jar
```

**前端构建：**
```bash
cd solr-ui
npm run build
```
构建产物在 `solr-ui/dist/` 目录，可部署到 Nginx 等静态服务器。



## 注意事项

- 确保 Solr 服务正常运行且地址配置正确
- 如使用主机名，需配置 DNS 映射或修改系统 hosts 文件
- 启用 Kerberos 时需正确配置 `krb5.conf` 和 `solr_jaas.conf`
- 当前版本无用户认证，建议在内网环境使用
- 上传的 ConfigSet 必须是标准 ZIP 格式，包含 `managed-schema`、`solrconfig.xml` 等必要文件

## 常见问题

**无法连接 Solr**
- 检查 `solrUrl` 配置是否正确
- 确认 Solr 服务正在运行
- 检查网络连接和防火墙设置

**前端无法访问后端**
- 确认后端服务已启动（默认端口 8985）
- 检查浏览器控制台是否有错误信息

**ConfigSet 上传失败**
- 确认文件格式为 ZIP
- 检查 ConfigSet 内部结构是否符合 Solr 要求
- 查看后端日志获取详细错误

**ZK Tree 加载为空**
- 确认 Solr 运行在 SolrCloud 模式（非单机模式）
- 检查后端日志中 ZK 树请求的响应数据
- ZK 树数据量大时首次加载可能较慢，请耐心等待