Fess：企业搜索服务器

概述

Fess是一个功能强大且易于部署的企业搜索服务器。您可以在任何能运行Java运行时环境的平台上快速安装和运行Fess。Fess基于Apache许可证2.0提供。

Fess基于OpenSearch/Elasticsearch，但不需要OpenSearch/Elasticsearch的知识或经验。Fess提供了一个易于使用的管理图形界面，可以通过浏览器配置系统。 Fess还包含一个爬虫，可以爬取网络服务器、文件系统或数据存储（如CSV或数据库）上的文档。支持多种文件格式，包括但不限于：Microsoft Office、PDF和zip。

*Fess站内搜索*是Google站内搜索的免费替代品。更多详情，请参阅FSS JS生成器文档。

网站

fess.codelibs.org

问题/疑问

discuss.codelibs.org

入门

尝试Fess有两种方法。第一种是自行下载和安装。第二种是使用Docker。

下载和安装/运行

Fess 14.16现已推出，可在发布页面下载。下载提供三种格式：deb、rpm、zip。

以下命令展示如何使用zip下载：

$ unzip fess-14.16.x.zip
$ cd fess-14.16.x
$ ./bin/fess

更多详情，请参阅安装指南。

Docker

我们在ghcr.io上提供Docker镜像。我们还在此存储库中提供Docker Compose（YAML）文件。

浏览器界面

• 搜索界面：http://localhost:8080/

• 管理界面：http://localhost:8080/admin/（默认用户名/密码为admin/admin）

您可以在管理界面的（网络、文件、数据存储）爬虫配置页面上注册爬取目标，然后在调度器页面上手动启动爬虫。

从其他搜索提供商迁移

请参阅MIGRATION.md。

数据存储

目前，Fess支持爬取以下存储位置和API：

• Confluence/Jira
• Box
• CSV
• 数据库
• Dropbox
• Elasticsearch
• Git
• Gitbucket
• G Suite
• JSON
• Office 365
• S3
• Salesforce
• SharePoint
• Slack

主题

• 简约
• 经典

摄取

• 日志记录器
• NDJSON

脚本

• Groovy
• OGNL

本地化

日语

• 网站

韩语

• 论坛

开发信息

获取源代码

1. 克隆Fess的仓库：

   $ cd ~/workspace
   $ git clone https://github.com/codelibs/fess.git
   

2. 将克隆的仓库作为Maven项目导入到Eclipse或其他IDE中。

OpenSearch插件设置

运行antrun:run以将插件下载到plugins目录：

$ mvn antrun:run

运行Fess

在IDE上运行或调试org.codelibs.fess.FessBoot，然后访问http://localhost:8080/

构建软件包

运行package目标，然后发布文件将在target/releases中创建。

$ mvn package
$ mvn rpm:rpm   # .rpm包
$ mvn jdeb:jdeb # .deb包

生成源代码

$ mvn dbflute:download # （一次性命令）
$ mvn dbflute:freegen
$ mvn license:format

集成测试

启动Fess服务器并运行以下命令：

$ mvn test -P integrationTests -Dtest.fess.url="http://localhost:8080" -Dtest.search_engine.url="http://localhost:9201"

要运行单个测试用例，可以使用：

$ mvn test -P integrationTests -Dtest.fess.url="http://localhost:8080" -Dtest.search_engine.url="http://localhost:9201" -Dtest=SearchApiTests

翻译成您的语言

Fess是国际化软件。

如果您想为您的语言添加标签/消息，请翻译properties文件，然后重命名为fess_*_[lang].properties。

• fess_label_en.properties
• fess_message_en.properties

对于搜索/索引分析器，如果doc.json包含您语言的lang_[lang]，请修改您语言的分析器。有关分析器的更多详细信息，请参阅Elasticsearch文档。

我们欢迎您的语言的拉取请求。

技术支持

• Lasta Di：DI容器
• LastaFlute：Web框架
• Lasta Job：作业调度器
• Fess Crawler：网络爬虫
• OpenSearch：搜索引擎
• Elasticsearch：搜索引擎