OpenLiteSpeed环境WordPress子比主题安装启用Meilisearch搜索优化设置详细图文教程

使用WordPress搭建网站的站长，会发现WordPress默认的搜索引擎不能模糊搜索，例如搜索WP优化教程，如果使用标题为WordPress优化详细教程就无法搜索到。如果将搜索内容进行分词，涉及到特别是中文、韩文、日文等语言，它不像英语使用固定的空格分词，所以想要在WordPress上实现分词搜索、模糊搜索一直都是一大难点！

熟悉WordPress站点且了解MySQL数据库的人会发现WordPress搜索功能十分耗时的，因为使用like %关键词%语法就无法使用索引，而且还无法做缓存，如果你的文章数量很大，比如十来万几十万等，那搜索将要你的命！如何解决WordPress搜索又慢、又不能模糊匹配查询的问题呢？

最近，主题铺发现WordPress子比主题在新版本中正式启用了对Meilisearch搜索的支持，这无疑为内容创作者和网站运营者带来了福音。而且WordPress子比主题官方也介绍了图文安装教程，而不少小伙伴安装的是OpenLiteSpeed，不是BT宝塔面板，如何在自己的OpenLiteSpeed环境中安装Meilisearch，并将其与WordPress子比主题完美结合，可能还存在一些疑问。别担心，主题铺将为您带来一份详细的图文教程，手把手教您完成OpenLiteSpeed环境下的Docker及Meilisearch安装，并最终配置好WordPress子比主题的搜索优化设置。

本次部署好后，可以极大提升WordPress网站的搜索速度，还支持模糊查询，如官方介绍的那样。实际效果可以查看主题铺的搜索效果。

本次版本更新新增了功能如下：

特点简介

• 基于Meilisearch搜索引擎，完美实现智能分词，搜索WordPress优化详细教程时候，会智能分词为WordPress、优化、详细、教程，完美适配几乎所有语言，真正实现模糊搜索
• 超高性能，Meilisearch是内存驱动索引，据官方说上亿数据都能实现毫秒级响应，我自己测试，10万加数据，仅需零点几毫秒，而MySQL需要3秒以上
• 搭建配置极其简单：使用Docker命令搭建，一个命令即可搞定，真正的有手就行
• 搜索结果排序更加智能，系统会自动计算关键词匹配得分并排序，让更加符合用户需求的内容排在前面
• 支持智能筛选，根据搜索关键词自动显示有关联的分类、标签、话题等筛选方式
• 支持设置近义词、同义词、错词纠正
• 建议云主机的内存≥4GB，因为Meilisearch会根据索引量不同而占用内存。

一、什么是Meilisearch？

在深入安装之前，我们先来了解一下Meilisearch。直接上官方效果图。

Meilisearch是一个开源、闪电般快速且高度相关的搜索后端。它专为提供卓越的用户搜索体验而设计，拥有以下突出特点：

1. 实时搜索：输入即时显示结果，用户无需等待。
2. 容错性强：即使拼写错误也能智能纠正并给出相关结果。
3. 高度相关：通过智能排名算法，确保搜索结果最符合用户意图。
4. 易于集成：提供友好的API接口，方便与各种应用集成。
5. 高性能：采用Rust语言编写，数据处理速度极快，即使在大型数据集中也能保持卓越性能。
6. 零配置：部署简单，开箱即用，省去了复杂的配置步骤。

对于WordPress子比主题将默认的WordPress搜索升级为Meilisearch，能够显著提升用户找到所需内容的效率和满意度，从而有效提高网站的用户留存率和活跃度。

其实大致内容主要分为两个步骤：

一、安装配置Docker及Meilisearch
二、配置WordPress子比主题选项

这里先说第一个步骤。先介绍容易的，在BT宝塔面板下安装配置，如果你没有BT宝塔面板，而是OpenLiteSpeed环境，那么直接跳到第三节介绍。

二、BT宝塔环境下安装Docker及Meilisearch

Meilisearch使用Docker部署，也就是说任何服务器都支持，虚拟主机只要有Docker的都可以

1.安装Docker：进入宝塔，找到Docker，点击安装

2.然后新建一个文件夹，用于存放Meilisearch数据，方便在Docker中映射，例如/www/wwwroot/meilisearch

2.点击容器，创建容器。选择命令创建，输入以下命令即可。以下命令注意和上面说的保持一致

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

也可选择容器编译，输入以下代码：（和上面的命令创建二选一）

services:
  meilisearch:
    # 镜像及版本
    image: getmeili/meilisearch:v1.29
    # 容器名称
    container_name: meilisearch-service
    # 端口映射 宿主机:容器
    ports:
      - "7700:7700"
    # 数据卷挂载
    volumes:
      - /www/wwwroot/meilisearch:/meili_data
    # 启动命令设置密钥
    command: meilisearch --master-key=112233
    # 重启策略
    restart: always

然后就可以等待部署完成，然后在Docker容器列表中，看到在运行中即可。
然后，因为宝塔会记录日志，建议设置一下日志保存时间，以免日志慢慢积累过大。

三、OpenLiteSpeed环境下安装Docker及Meilisearch

而对于要在OpenLiteSpeed环境下部署Meilisearch，比如主题铺这样，最便捷且推荐的方式就是使用Docker。Docker提供了一个轻量级的虚拟化环境，可以轻松隔离和部署应用程序，避免复杂的环境依赖问题。

这里先介绍在OpenLiteSpeed环境下安装Docker。

A. 安装Docker

更新系统软件包列表：
首先，通过SSH登录到您的服务器，并执行以下命令更新软件包列表，确保获取最新版本的软件。

sudo apt update
sudo apt upgrade -y

安装必要软件包：
安装一些必要的工具，以便Docker能够通过HTTPS使用存储库。

sudo apt install apt-transport-https ca-certificates curl gnupg-agent software-properties-common -y

添加Docker官方GPG密钥：
为了验证下载的Docker软件包的真实性，我们需要添加Docker的官方GPG密钥。

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

设置Docker稳定版存储库：
将Docker的稳定版存储库添加到您的系统。

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

安装Docker Engine：
现在，您可以安装Docker Engine、Docker CLI和containerd。

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io -y

启动并启用Docker服务：
确保Docker服务已启动并设置为开机自启。

sudo systemctl start docker
sudo systemctl enable docker

验证Docker安装：
运行一个简单的Docker命令，检查Docker是否正确安装并运行。如果看到“Hello from Docker!”，则表示安装成功。

sudo docker run hello-world

（可选） 如果您不想每次运行Docker命令都使用sudo，可以将当前用户添加到docker用户组。

执行后请退出并重新登录SSH会话才能生效。

sudo usermod -aG docker $USER

小技巧-如何配置 Docker 镜像加速器

你需要配置 Docker 使用国内的镜像源或者是代理镜像源来下载。

编辑 Docker 配置文件
输入以下命令编辑（如果文件不存在会新建）：

nano /etc/docker/daemon.json

写入加速地址
将以下内容粘贴进去。注意：由于国内 Docker 镜像源经常变动，如果以下源失效，你需要寻找最新的可用源（或者使用阿里云的专属加速器）。

如果文件里原本有内容，请确保格式符合 JSON 规范（注意逗号）。

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://huecker.io",
    "https://dockerhub.timeweb.cloud",
    "https://noohub.ru"
  ]
}

重启 Docker 服务
保存退出（按 Ctrl+O 回车，然后 Ctrl+X）后，执行以下命令使配置生效：

systemctl daemon-reload
systemctl restart docker

如果还是很卡或者安装失败，可能是主机的DNS设置不对，很多主机默认的DNS是1.1.1.1，这个IP在国内是无法访问的，而且很慢，可以进行修改。

修改方式：

通过SSH工具登录云主机，然后打开/etc文件夹，找到resolv.conf，打开后，进行修改，如果是腾讯云主机可以修改为：

nameserver 183.60.83.19
nameserver 8.8.8.8

如果是阿里云主机可以修改为

nameserver 100.100.2.136 
nameserver 8.8.8.8

B. 运行Meilisearch容器

Docker安装完成后，我们就可以轻松地部署Meilisearch了。

一键拉取安装Meilisearch Docker镜像：
首先，从Docker Hub拉取Meilisearch的官方镜像。使用下面的一键安装命令。

注意里面的路径及对应的密钥。

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

运行Meilisearch容器：
接下来，我们将运行Meilisearch容器。在运行命令时，有几个关键参数需要注意：

• -p 7700:7700：将容器的7700端口映射到服务器的7700端口。Meilisearch默认监听7700端口。-v meili_data:/meili_data：创建一个名为meili_data的Docker卷，用于持久化存储Meilisearch的数据。这样即使容器被删除，数据也不会丢失。--env MEILI_MASTER_KEY='您的安全秘钥'：非常重要！ 设置Meilisearch的Master Key，这是访问Meilisearch API的认证凭据。请务必将您的安全秘钥替换为一个足够长且复杂的随机字符串。-d：让容器在后台运行（分离模式）。--name meilisearch：为容器指定一个名称，方便管理。

docker run -d \
  --name meilisearch \
  -p 7700:7700 \
  -v meili_data:/meili_data \
  --env MEILI_MASTER_KEY='请替换为你的安全秘钥' \
  getmeili/meilisearch:latest \
  --master-key='请替换为你的安全秘钥' --http-addr='0.0.0.0:7700'

请注意，--env MEILI_MASTER_KEY是Docker传递环境变量给容器，而--master-key是Meilisearch应用程序本身的启动参数。两者都设置确保Meilisearch正确使用您指定的秘钥。

验证Meilisearch是否运行：
使用以下命令查看正在运行的Docker容器。如果看到Meilisearch容器，则表示已成功运行。

docker ps

您还可以尝试在浏览器中访问 http://您的服务器IP地址:7700。如果看到“Meilisearch is running”或类似信息，则说明Meilisearch服务已启动。

防火墙设置：如果您的服务器启用了防火墙（如UFW或firewalld），请确保开放7700端口，否则WordPress将无法连接到Meilisearch。

UFW (Ubuntu/Debian): sudo ufw allow 7700/tcp

firewalld (CentOS/RHEL): sudo firewall-cmd --zone=public --add-port=7700/tcp --permanent 后 sudo firewall-cmd --reload

四、如何设置WordPress子比主题的Meilisearch搜索

现在Meilisearch后端服务已经准备就绪，接下来我们将把WordPress子比主题与其连接起来。请确保您的子比主题已更新到最新版本（8.5或以上），因为新版本才集成了Meilisearch的支持。

开启Meilisearch智能搜索功能很简单。流程一共两步：

1. 填入相关参数并保存
2. 首次配置，需要同步索引数据

进入主题设置->全局功能->搜索功能，开启Meilisearch智能搜索，并填入参数

说明：这里的api地址，默认为http://127.0.0.1:7700，也就是本地服务器地址加7700端口，API密钥就是部署时-master-key=后面的值，可以自定义。

五、注意事项

• 同一个服务器多个网站时，主题设置中的索引前缀必须保证唯一性，不能与其他网站的案引前缀相同
• 首次配置好，必须要保存，然后重建索引数据，不然搜索不到内容
• 后面当有内容新增或变化时系统会自动同步对应的索引数据，一般无需再次手动重建索引数据，但是如果遇到搜索结果有问题的时候，或者修改过数据库内容，都可以手动重建索引数据
• 修改部分主题配置，也需要手动重建索引数据，具体有影响的配置，都有红色提醒文字
• 启用Meilisearch智能搜索后，会自动显示智能筛选，会根据搜索关键词自动显示分类、话题等筛选，就无需再手动配置手动筛选了
• Meilisearch是内存驱动，所以需要占用服务器内存，所以需要关注服务器内存使用情况。当然Meilisearch也是我测试过所有搜索引擎中内存占用最小了，5万数据，大于占用1GB内存，仅供参考

Meilisearch智能搜索的智能筛选截图示例：

六、最后总结

在整个设置过程中，务必确保您服务器的IP地址和Meilisearch Master Key填写无误，并且服务器防火墙已开放7700端口。如果遇到任何问题，可以查看子比主题的官方文档，或在GitHub上寻求Meilisearch社区的帮助。通过Meilisearch，您的WordPress网站搜索功能将焕然一新，为访客带来卓越的内容探索体验！