Meilisearch搜索配置教程

2026-07-21 发布于OneNav

Meilisearch 是一个开源的、基于 Rust 编写的搜索引擎，专为现代 Web 应用设计。其核心优势包括：

  • 毫秒级响应：即使面对百万级文档，搜索延迟仍低于 50ms
  • 中文分词友好：内置 jieba 分词器，无需额外配置即可支持中文搜索
  • 容错与模糊匹配：支持拼写错误纠正、前缀搜索、同义词扩展
  • 即搜即得：输入即搜索，无需回车，体验类似 Algolia
  • 自托管可控：数据完全私有，无第三方依赖

对于 WordPress 网站，Meilisearch 能替代传统的 SQL LIKE 搜索，实现“输入关键词→高亮匹配→分类过滤”的流畅体验，大幅提升用户查找效率。

宝塔面板 Docker 搭建 Meilisearch

其他环境可参考自行处理。

前提条件

  • 宝塔面板已安装 Docker 管理器
  • 服务器内存 ≥ 1GB（推荐 2GB 以上）

操作步骤

  1. 创建数据持久化目录
    在服务器上创建文件夹（例如 /www/wwwroot/meilisearch），用于存储索引数据，防止容器删除后丢失。
  2. 运行容器
    使用以下命令启动，master-key 可以自己修改一个：

    docker run -d --restart=always -p 7700:7700 -v /www/wwwroot/meilisearch:/meili_data getmeili/meilisearch:latest meilisearch --master-key=112233

    参数说明：

参数 作用
-p 7700:7700 映射容器端口到宿主机
-v /www/wwwroot/meilisearch:/meili_data 数据持久化
--master-key=xxx 设置主密钥（API 调用需携带）
Meilisearch搜索配置教程

部署完成后，在docker容器列表中，看到在运行中即可。

OneNav 主题配置 Meilisearch 智能搜索

前置条件

  • OneNav 主题版本 ≥ v6.00
  • 已安装 Meilisearch 并记下服务器地址（例如 http://127.0.0.1:7700）和主密钥

配置步骤

  1. 进入主题设置
    登录后台 → 主题设置 → 搜索设置里设置【Meilisearch智能搜索】的配置。
  2. 配置设置模块
    看图
Meilisearch搜索配置教程
  1. 保存并重建索引
    保存设置后，点查看状态是否正常，然后点一遍其他按钮。
  1. 测试搜索
    在前台搜索框输入任意关键词，观察是否实时返回结果。若返回空，检查 OneNav 是否已同步数据（可手动触发一次重建索引）。

通过以上步骤，你的 OneNav 站点即可拥有媲美商业搜索引擎的智能搜索能力，用户输入即得结果，告别传统搜索的“无结果”或“慢响应”。

One Nav 导航主题