fess

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

开源 🏷️完全免费 ✅ 目前可打开搜索知识 🍴 复刻 177 🐛 待处理 15 👀 关注 58

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1146

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，可自行部署，无付费版本。

项目预览

项目数据

分类搜索知识

开发团队codelibs

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

GitHubhttps://github.com/codelibs/fess

定价模式🏷️完全免费

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

访问状态✅ 目前可打开

是否开源是

开源协议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 星标★ 1146

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

代码更新2026-11-09

仓库体积64.9 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数2

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1146

技术标签

ai-search crawler docker elasticsearch enterprise-search

使用教程

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

环境要求

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

安装与启动步骤

1下载安装包

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

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

进入解压出的目录并执行启动脚本，服务启动后即可通过浏览器访问管理界面。
```
cd fess-<version>
./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 生成并嵌入代码。

注意事项

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