将Elasticsearch作为WordPress站内搜索-docker安装elasticSearch，kibana和ik分词器

免费网站 2024年03月15日 13:37

文章目录一、Elasticsearch准备工作1.1 准备一台VPS1.2 准备好docker二、安装elasticSearch及插件2.1 docker装elasticSearch2.2 docker安装kibana2.3 启动ES和kibana2.4 安装ik分词器2.5 Compose启动三、WP整合Elasticsearch四、可能存在的问题4.1 虚拟内存太小4.2 同名容器存在4.3 Docker常用命令五、总结

WordPress自带的搜索功能实在有点弱了，不仅容易给数据库增加查询负担，而且搜索出来的结果还不一定准确，很难满足于我们日常的Wordpress站内搜索需求。于是强化Wordpress默认搜索就非常有必要了，之前有分享过用Algolia给WordPress添加实时站内搜索功能。

Algolia是一个专业的第三方搜索服务商，Algolia接入Wordpress非常方便，官方也提供了插件直接启用即可。Algolia作为Wordpress的默认搜索，不仅搜索质量高、结果准，而且还是即时搜索，可以完美整合到Wordpress，推荐给土豪朋友使用。

为什么说要推荐给土豪朋友使用？原因是Algolia虽然也有免费的搜索额度，但是额度太低了，低到只能满足一个小博客使用，企业用户建议使用Algolia的专业版，可以省去一笔自建搜索的费用。Algolia作Wordpress的搜索具体效果请参考右上角搜索功能。

这篇文章主要是来分享一下如何利用Elasticsearch来自建Wordpress搜索，采用docker方式安装elasticSearch，kibana和ik分词器。过程非常地简单，更多的Wordpress建站教程，这里有：

WordPress文章目录侧边固定滚动-Easy Table 和LuckyWP Table插件WordPress子主题创建与使用方法-防止修改过的CSS,JS和代码失效让图片飞一会儿！网站图片WebP格式批量转换设置及加速效果体验一、Elasticsearch准备工作1.1 准备一台VPS

不建议将Elasticsearch与Wordpress安装在同一台VPS主机上，这样有一定的风险，建议实行搜索与WP分离保证安全。便宜的VPS主机可以参考这里：VPS主机排行榜单，内存越大越好，实测1GB的内存运行流畅。

1.2 准备好docker

首先，你需要先安培安装 Docker CE (社区版)和Docker Compose，以下命令是基于Debian系统的演示，如果你是CentOS、Ubuntu，请参考官网：

安装 Docker CE (社区版)：https://docs.docker.com/install/linux/docker-ce/ubuntu/

安装 Docker Compose：https://docs.docker.com/compose/install/#install-compose

Debian 9系统安装Docker CE 和Docker Compose如下：

#卸载sudo apt-get remove docker docker-engine docker.io containerd runc#SET UP THE REPOSITORYsudo apt-get updatesudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg2 \ software-properties-commoncurl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -#检测是否安装成功sudo apt-key fingerprint 0EBFCD88#有以下输出就表示成功添加Docker’s official GPG key:root@hostfbc9e58d73:~# sudo apt-key fingerprint 0EBFCD88pub rsa4096 2017-02-22 [SCEA] 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88uid [ unknown] Docker Release (CE deb) <docker@docker.com>sub rsa4096 2017-02-22 [S]#添加stable repositorysudo add-apt-repository \ "deb [arch=amd64] https://download.docker.com/linux/debian \ $(lsb_release -cs) \ stable"#开始安装sudo apt-get updatesudo apt-get install docker-ce docker-ce-cli containerd.io#验证 Docker Engine - Community是否安装正确sudo docker run hello-world#有以下输出就表示正确安装root@hostfbc9e58d73:~# sudo docker run hello-worldUnable to find image 'hello-world:latest' locallylatest: Pulling from library/hello-world1b930d010525: Pull complete Digest: sha256:b8ba256769a0ac28dd126d584e0a2011cd2877f3f76e093a7ae560f2a5301c00Status: Downloaded newer image for hello-world:latestHello from Docker!This message shows that your installation appears to be working correctly.To generate this message, Docker took the following steps: 1. The Docker client contacted the Docker daemon. 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. (amd64) 3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading. 4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal.To try something more ambitious, you can run an Ubuntu container with: $ docker run -it ubuntu bashShare images, automate workflows, and more with a free Docker ID: https://hub.docker.com/For more examples and ideas, visit: https://docs.docker.com/get-started/ #安装 Docker Composesudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose#检测是否安装成功docker-compose --version#有输出即表示成功docker-compose version 1.24.1, build 4667896b#如果提示命令不存在，可以手动创建链接sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose二、安装elasticSearch及插件2.1 docker装elasticSearch

镜像：

https://hub.docker.com/_/elasticsearch

docker装elasticSearch非常地简单，只需要一个命令：

docker pull elasticsearch:5.6.112.2 docker安装kibana

镜像：

https://hub.docker.com/_/kibana

docker安装kibana也是一行命令，如下：

#版本号要与ES版本号一致docker pull kibana:5.6.11

如下图：

2.3 启动ES和kibana

在开发模式下直接使用以下命令启用即可：

docker run -d --name elasticsearch --net somenetwork -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" elasticsearch:5.6.11docker run -d --name kibana --net somenetwork -p 5601:5601 kibana:5.6.11

打开你的浏览器访问：IP+9200，可以看到elasticSearch启动成功。

打开你的浏览器访问：IP+5601，可以看到kibana启动成功。（如果提示未准备好，请稍等一会儿）

这是5.6.11版本的kibana：

2.4 安装ik分词器

项目：

https://github.com/medcl/elasticsearch-analysis-ik/releases

使用以下命令可以安装ik分词器：

#查看当前运行的容器docker ps#执行命令进入到elasticsearch容器里，具体名称请根据自己的实现情况修改docker exec -it elasticsearch /bin/bash#使用elasticsearch-plugin进行下载，版本号要与ES版本号一致./bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v5.6.11/elasticsearch-analysis-ik-5.6.11.zip# 退出容器ctrl+p+q

如下图：

2.5 Compose启动

在正式的使用环境里，建议使用Docker-Compose启动elasticSearch及插件，首先是创建yml文件：vim docker-compose.yml，填写以下内容：

version: '2.2'services: # 包含需要操作的容器 elasticsearch: #容器名称 image: docker.elastic.co/elasticsearch/elasticsearch:5.6.11 #ES镜像 container_name: elasticsearch #容器名称 environment: - cluster.name=docker-cluster #集群名称，可以不用管 - bootstrap.memory_lock=true - "ES_JAVA_OPTS=-Xms512m -Xmx512m" #JVM大小 ulimits: memlock: soft: -1 hard: -1 volumes: - esdata1:/usr/share/elasticsearch/data ports: #端口 - 9200:9200 networks: - esnet kibana: image: docker.elastic.co/kibana/kibana:5.6.11 environment: SERVER_NAME: kibana ELASTICSEARCH_HOSTS: http://150.95.177.167:9200 #替换你的ES地址

然后后台启动elasticSearch及插件：

#后台启动 docker-compose up -d三、WP整合Elasticsearch

插件：

https://wordpress.org/plugins/elasticpress/https://github.com/10up/ElasticPress

WordPress强大之处在于有着非常多的插件，Elasticsearch就是一个整合elasticSearch搜索到Wordpress的插件，下载插件后填写你的elasticSearch地址。

也可以在wp-config.php指定：

// ElasticPress Hostdefine( 'EP_HOST', 'http://127.0.0.1:9200' );

保存后elasticSearch插件会自动添加索引，你也可以在设置中给不同的文件、分类、标签等设置启用或者不启用索引。（点击放大）

另外，插件还提供了权重设置，请根据自己的需求来调整，确保搜索结果更加精准。（点击放大）

四、可能存在的问题4.1 虚拟内存太小

启用Elasticsearch时可能会提示虚拟内存不足，解决办法如下：

#提示错误max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]#切换到root用户,执行命令：vim /etc/sysctl.conf# 添加vm.max_map_count=262144#保存退出，执行sysctl -p4.2 同名容器存在

解决办法就是列出所有容量，存在同名的给予删除，如果正在运行则先Kill再删除：

docker ps -adocker rm esdocker kill kibanadocker kill elasticsearchdocker rm kibanadocker rm elasticsearch4.3 Docker常用命令

Docker常用基本命令如下：

#Docker常用基本命令#拉取镜像docker image pull 镜像名#查看镜像列表docker images#或者docker image ls#删除镜像docker irm image_id#或者docker image rm 镜像名或镜像id#镜像备份docker save -o 保存的文件路径以及文件名镜像名#镜像迁移/加载到本地docker load -i 镜像路径#容器相关操作#创建容器docker run -itd --restart always --name 容器名镜像名执行的命令#其他参数含义：--network=host 表示将主机的网络环境映射到容器中，容器的网络与主机相同-p 表示端口映射，前者是宿主机端口，后者是容器内的映射端口。可以使用多个-p 做多个端口映射-v 表示目录映射关系(前者是宿主机目录，后者是映射到宿主机上的目录，即宿主机目录:容器中目录)，可以使用多个-v 做多个目录或文件映射。注意:最好做目录映射，在宿主机上做修改，然后共享到容器上。-i 表示以“交互模式”运行容器 -t 表示容器启动后会进入其命令行。加入这两个参数后，容器创建就能登录进去。即分配一个伪终端。--name 为创建的容器命名-d 在run后面加上-d参数,则会创建一个守护式容器在后台运行(这样创建容器后不会自动登录容器，如果只加-i -t 两个参数，创建后就会自动进去容器)。-e 为容器设置环境变量 -e username="ritchie": 设置环境变量--net="bridge": 指定容器的网络连接类型，支持 bridge/host/none/container: 四种类型--link=[]: 添加链接到另一个容器 --expose=[]: 开放一个端口或一组端口 -h "RidingRoad": 指定容器的hostname#启动容器docker container start container_name或container_id#停止容器docker container stop container_name或container_id#kill容器docker container kill container_name或container_id#查看容器列表# 查看正在运行的容器docker ps 或 docker container ls# 查看所有容器docker ps -a 或 docker container ls --all#向容器传入和执行命令docker container exec container_id 命令#进入容器终端docker attach container_id#或docker container exec container_id /bin/bash#容器转入后台运行Ctrl + p 然后 Ctrl + q#删除容器docker rm container_id#或docker container rm container_id五、总结

Elasticsearch建立了索引之后，下次我更新Wordpress的文章或者评论时就会自动更新索引了，特别需要提醒的是如果你的Wordpress有运行Redis等缓存请关闭，否则会造成PHP死循环。

检测Elasticsearch有没有生效的办法就是到你的Wordpress前台搜索关键字，看看有没有自动建议或者精准结果，一般来说启用了插件后搜索出来的结果都调用的Elasticsearch的索引内容。