Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Rainsheep/halo-plugin-meilisearch

halo2 支持 meilisearch
https://github.com/Rainsheep/halo-plugin-meilisearch

Last synced: about 1 month ago
JSON representation

halo2 支持 meilisearch

Awesome Lists containing this project

README

        

# 更强大的搜索功能

[体验网站](https://blog.rainsheep.cn)

## 功能介绍

为 halo 适配 meilisearch,提供搜索引擎的功能。

## 插件原理

插件搜索功能基于 [meilisearch](https://www.meilisearch.com),做了适配工作。

## 使用教程

### 启动 meilisearch(可选)

> 如果已有 meilisearch 服务或者使用 [meilisearch cloud](https://www.meilisearch.com/cloud),则不需要此步。
>
> 当然,你也可以通过别的方式搭建 meilisearch

修改 docker-compose.yml

```yaml
version: "3"

services:
halo:
image: halohub/halo:2.17.0-beta.1
container_name: halo
restart: on-failure:3
depends_on:
- meilisearch
networks:
- halo_network
volumes:
- ./halo2:/root/.halo2
ports:
- 8090:8090
command:
# 修改为自己已有的 MySQL 配置
- --spring.r2dbc.url=r2dbc:pool:mysql://localhost:3306/halo
- --spring.r2dbc.username=root
- --spring.r2dbc.password=
- --spring.sql.init.platform=mysql
# 外部访问地址,请根据实际需要修改
- --halo.external-url=http://localhost:8090/
- --server.port=8090

# 这部分为新增内容,创建一个 meilisearch 容器
meilisearch:
image: getmeili/meilisearch:v1.8
container_name: meilisearch
restart: on-failure:3
networks:
- halo_network
environment:
- MEILI_ENV=production
# 可以改成自己的密码,对长度有限制,不建议修改
- MEILI_MASTER_KEY=95d031f029c0f93289791d39f01a7f42a2211973
- MEILI_NO_ANALYTICS=true

networks:
halo_network:
```

* MEILI_MASTER_KEY 可自定义

通过 `docker compose up -d` 启动 halo 和 meilisearch。

### 插件设置

> 插件需配合 [搜索组件](https://www.halo.run/store/apps/app-DlacW) 一起使用,搜索组件提供了前端界面, Meilisearch 提供了后端搜索服务。

进入插件详情 -> 基本设置
* host: meilisearch 的 url,默认 http://meilisearch:7700
* masterKey: meilisearch 的 masterKey,需要与 docker-compose.yml 中配置的一致。
* 搜索结果的长度: 每条搜索结果的长度。
* 搜索私有文档: 搜索结果中展示非公开的文档。
* 搜索已回收: 搜索结果中展示回收站中的文档。

首次启动需进入 console → 插件 → 右上角的“扩展配置” → 搜素引擎 → 选择 Meilisearch Search Engine

![启动搜索引擎](https://oss.rainsheep.cn/save/image/meilisearchEnable.png)

## FAQ

### 搜索不到文档

请确认进行了以下两步操作,进行后还不可以的话请反馈。

1. 请确认在扩展配置中选择了 “Meilisearch Search Engine”
2. 进入后台 → 仪表盘 → 快捷访问 → 刷新搜索引擎

## 代办事项

- [ ] 对搜索内容进行后置处理、删除图片信息等。
- [ ] 将 meilisearch 集成到插件中,不再需要单独启动。