fess

自建一个搜索，公司文档网页全都能翻

Fess 是一款基于 OpenSearch 构建的开源企业级搜索服务器，支持自托管，可爬取网页、文件、数据库与云端数据源，支持 20 多种语言，提供 REST API 及 AI/RAG 与语义搜索能力，采用 Apache-2.0 许可，是企业搜索的轻量之选。

开源 free 搜索知识

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1139

维护状态活跃

是否开源是

定价模式 free

项目数据

分类搜索知识

开发团队codelibs

所属国家

官网地址https://fess.codelibs.org

GitHubhttps://github.com/codelibs/fess

定价模式free

价格说明开源免费，可自行部署，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Java

技术栈/模型ai-search,crawler,docker,elasticsearch,elasticsearch-alternative,enterprise-search,full-text-search,java,llm,lucene,mcp,opensearch,rag,rest-api,search,search-engine,self-hosted,semantic-search,site-search

GitHub 星标★ 1139

30天Star增速

HF 下载量

上线时间2013-09-13 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数1

使用教程

难度：入门约 10 分钟部署方式：本地安装 6 步

环境要求

Java 运行时（可运行在任意支持 Java 的平台上）
从 ZIP 包安装时需要解压工具 unzip
使用 Docker 方式需要安装 Docker Engine
从源码运行需要 Maven 与 Java IDE

安装与启动步骤

1下载安装包

访问 GitHub Releases 页面下载安装包，官方提供 DEB、RPM、ZIP 三种格式，按自己的系统选择，本例使用 ZIP。
2解压安装包

将下载的 ZIP 包解压到任意目录，解压后会得到 fess- 目录。
```
unzip fess-.zip
```
3启动 Fess 服务

进入解压出的目录并执行启动脚本，服务启动后即可通过浏览器访问管理界面。
```
cd fess-
./bin/fess
```
4Docker Compose 部署

另一种方式是 Docker：克隆官方 docker-fess 仓库，进入 compose 目录启动容器，具体参数以仓库中的 compose 文件为准。
```
git clone https://github.com/codelibs/docker-fess.git
cd docker-fess/compose
docker compose up -d
```
5下载源码所需插件

如果从源码运行，先执行此命令把所需的 OpenSearch 插件下载到 plugins 目录。
```
mvn antrun:run
```
6在 IDE 中运行

在 IDE 中运行或调试 org.codelibs.fess.FessBoot，启动完成后访问 http://localhost:8080/。

如何确认成功

浏览器打开 http://localhost:8080/ ，能正常进入 Fess 的管理界面即表示启动成功。

常见问题

Q：使用 Fess 前需要先了解或部署 OpenSearch 吗？

A：不需要。Fess 虽然基于 OpenSearch 构建，但无需 OpenSearch 前置知识，所有配置都通过浏览器版管理界面完成。

Q：有哪几种安装包格式？

A：GitHub Releases 页面提供 DEB、RPM 和 ZIP 三种格式下载，可按操作系统选择；ZIP 包解压后执行 bin/fess 即可启动。

Q：Docker 方式从哪里获取镜像和编排文件？

A：镜像发布在 ghcr.io 的 codelibs 组织下，Docker Compose 文件位于 codelibs/docker-fess 仓库的 compose 目录中。

Q：源码运行提示缺少插件怎么办？

A：在项目根目录执行 mvn antrun:run，把依赖插件下载到 plugins 目录后，再运行 org.codelibs.fess.FessBoot。

Q：能把搜索框嵌入自己的网站吗？

A：可以，使用 Fess Site Search（codelibs/fess-site-search），通过 FSS JS Generator 生成并嵌入代码。

注意事项

命令中的要替换成你实际下载的版本号。
默认访问地址为 http://localhost:8080/ ，管理界面和 REST API 都从这里访问。
Docker 部署的端口、数据卷等参数以 docker-fess 仓库 compose 目录中的文件为准。
更详细的安装说明见官方 Installation Guide：https://fess.codelibs.org/stable/install/index.html 。

核心亮点

基于OpenSearch构建，兼容Elasticsearch生态，支持全文检索与语义搜索，可无缝对接AI/RAG工作流
内置多源爬虫（Web/文件/数据库/云存储），开箱即用，支持20+语言，企业级部署成本低
提供REST API与MCP（模型上下文协议）接口，便于集成到LLM应用或现有系统

不足之处

项目星标仅1.1k，社区活跃度与生态成熟度相比Elasticsearch等主流方案仍有差距
文档/社区待观察

适用场景

企业内部文档、知识库的全文检索与语义问答
面向多语言网站或站群的站内搜索服务
结合LLM构建RAG应用时的私有化检索后端

替代项目

Apache Solr、Meilisearch、Typesense

项目介绍

fess 是搜索知识领域的开源项目，由 codelibs 开发，2013 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,139）位列前 30%，在搜索知识分类中处于中上游。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。开源免费，可自行部署，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：企业内部文档、知识库的全文检索与语义问答。同类可对比的替代方案包括 Apache Solr、Meilisearch、Typesense。

上一篇：chat-with-your-data-solution-accelerator

下一篇：xiaoyaosearch