nextcloud 搜尋很好用,若能有全文檢索能力就更棒了,於是外掛 fulltextsearch_elasticsearch 就登場了。
開發團隊只針對還在維護的nextcloud版本進行更新,也就是說一旦我們的nextcloud已經EOL了,就不會再收到ElasticSearch的更新。
以下是甘苦談
原本使用的nextcloud 25.x 能搭配ElasticSearch 7.x ,但遇到外掛存在非常嚴重效能低下問題(兩萬個檔案有設定分享,100人使用,建立索引表算一算需要至少三、四個月,太誇張了 );由於nextcloud 25版已經停止維護,於是我只剩下升級nextcloud一途。 我的nextcloud架設在 CentOS 7,docker上面跑好多容器,很穩定;但nextcloud要升級到26時候,出現容器dns錯亂,無法進行dns查詢,只好先還原回25版。 初步認定是CentOS 7或docker版本過於老舊,但我不敢隨意升級docker,最後只能將nextcloud資料複製到新的虛擬主機(RockyLinux 9.4),測試由25升級到26,然後26升級27 結果就很正常,沒有出現dns錯亂問題。 移轉注意事項請參考「將nextcloud從CentOS7移轉到RockyLinux9。 」** 升級nextcloud到27,搭配新fulltextsearch外掛,初始索引要18小時,效率差了百倍以上。
開始安裝囉
安裝 ElasticSearch 8.x(ES 8) 引擎
Nextcloud 26或以上必須搭配 ES 8 ,最新docker版本可至此查詢 https://hub.docker.com/_/elasticsearch #RockyLinux 9.4、docker 27.0.2
############## 檔案 ./docker-compose.yaml ################ version: "3.9" services: elasticsearch: build: context: . dockerfile: ./docker/es/Dockerfile container_name: elasticsearch environment: - discovery.type=single-node - xpack.security.enabled=false - xpack.security.http.ssl:enabled=false ports: - 9200:9200 - 9300:9300 networks: - elastic restart: always volumes: - indexdata:/usr/share/elasticsearch/data # 索引過的資料將存放到 /usr/share/elasticsearch/data裡面 networks: elastic : driver: bridge volumes: indexdata : driver: local ########################################################### ################ 檔案 ./docker/es/Dockerfile ############### FROM elasticsearch:8.14.2 # ingest-attachment 一定要安裝 RUN bin/elasticsearch-plugin install ingest-attachment ###########################################################
# 執行容器 docker-compose up -d
安裝完畢,瀏覽器測試一下引擎是否正常 http://ip:9200/ ,事後需填入到nextcloud外掛設定裡面。
nextcloud 安裝外掛 fulltextsearch
#若安裝出問題,請移除app後,再刪除以下資料庫資料,之後就可以正常安裝了 drop table oc_fulltextsearch_indexes; drop table oc_fulltextsearch_ticks; delete from oc_appconfig where appid='fulltextsearch'; delete from oc_appconfig where appid='fulltextsearch_elasticsearch'; delete from oc_appconfig where appid='files_fulltextsearch'; delete from oc_appconfig where appid='files_fulltextsearch_tesseract'; DELETE FROM oc_migrations WHERE app='fulltextsearch'; DELETE FROM oc_preferences WHERE appid='fulltextsearch';
外掛需要設定
外掛安裝完畢,還需要填入引擎網址、與索引名稱,其他預設值即可。
「檢查」外掛設定是否正常
docker exec -t --user www-data <nextcloud容器名稱> php occ fulltextsearch:check
「測試」外掛設定是否正常
docker exec -t --user www-data <nextcloud容器名稱> php occ fulltextsearch:test
一切正常後,就可以開始建立索引表了,這裡建議定期重做索引。
docker exec -t --user www-data <nextcloud容器名稱> php occ fulltextsearch:index
這裡強烈建議「文件掃描PDF檔」需要利用acrobat adobe pro版內建文字辨識功能(OCR),進行一次自我辨識
第一次初始化索引建立後,才可以使用
最後還需要額外執行live指令,針對後續異動的檔案進行索引
# 自動索引官方沒建議怎做,我自己是在容器本體VM(RL9.4)利用console常駐執行
# 這樣做比較麻煩,需要注意重開後需要手動做
docker exec -t --user www-data <nextcloud容器名稱> php occ fulltextsearch:live
** 有一次我要刪除原本的索引,一直失敗,搞了很久很久很久很久,才發現要先進入容器下指令才有用
docker exec -t --user www-data <nextcloud容器名稱> php occ fulltextsearch:reset
** 目錄裡面新增「 .noindex」 這個檔案,就可以不做index
** 若有安裝tesseract ocr這個外掛,記得進nextcloud容器,額外安裝相關程式 (此功能我一直沒成功過)
apt install tesseract-ocr tesseract-ocr-chi-tra-vert tesseract-ocr-chi-tra tesseract-ocr-chi-sim tesseract-ocr-script-viet tesseract-ocr-script-hant tesseract-ocr-script-hant-vert
** 以前安裝Micro$oft單機版sharepoint,是個重量級系統,早就有全文檢索功能,但實在是太吃系統資源了,果斷不用。