Fess 15.9.0 介绍与选型指南

目标：面向正在评估「企业/站内全文搜索服务器」的工程师，梳理 Fess 15.9.0 的定位、架构、功能与许可现状，并给出与 Elasticsearch、OpenSearch、Meilisearch、Typesense 的量化选型对比。本文为联网溯源篇，全部信息均来自官方渠道并标注来源与查询日期（2026-10-24），未包含本地实测内容；部署、配置与查询语法的实测内容见本专栏后续各篇。

一、环境信息

本文为 A1 认知篇（联网溯源），写作时未搭建本地环境，所有事实性内容均于 2026-10-24 从下列官方渠道实查取得：

💡 说明：Fess 版本号独立演进，与其依赖的 OpenSearch 大版本并非同步发布；15.9.0 的引擎基线是 OpenSearch 3.9，低于 3.x 的引擎会被 Fess 拒绝启动（官方 prerequisites 明确写明「Fess rejects the engine version below 3.0」）。

二、软件概述

2.1 定位与身份

Fess 是 CodeLibs 项目维护的开源企业级全文搜索服务器（Enterprise Full-Text Search Server），GitHub 仓库官方描述为：基于 OpenSearch 构建的自托管企业与站点搜索服务器，内置网页/文件/数据库爬虫、20+ 语言支持、REST API 与 AI/RAG、语义搜索能力（来源：GitHub 仓库页，查询日期 2026-10-24）。

一句话理解 Fess 的产品逻辑：它不是「一个搜索引擎」，而是「搜索引擎之上的完整搜索应用」——把爬虫、文本抽取、索引、搜索页面、管理后台打包成开箱即用的产品，用户只需要在管理界面里配置「爬哪里」，就能得到一个可用的站内搜索。这与 Elasticsearch/OpenSearch（纯搜索引擎，需自研全部应用层）是两条不同的产品线。

Fess 的典型使用位置：企业内部门户搜索、产品文档站搜索、Wiki/知识库统一检索、内部文件服务器与网盘的全文检索。

2.2 版本与许可

• 当前稳定版：15.9.0，2026-10-15 发布（来源：GitHub Releases）。
• 许可证：Apache-2.0，可自由商用、修改与再分发，无 Elastic License 2.0 那类托管服务限制条款。
• 商标与治理：由 CodeLibs 团队主导，社区驱动，无强制商业订阅；商业支持可另行购买（官方提供 Support 页面）。

2.3 版本节奏（量化）

近一年发布记录（来源：GitHub releases.atom，查询日期 2026-10-24）：

约 每 2 个月一个次版本，小版本（x.y.z）跟随次版本数周内跟进，节奏稳定、未出现断档。对使用者而言，按「半年跟随一次次版本升级」的节奏维护即可跟上主线。

💡 技术拓展：Fess 的大版本号跨越 13→14→15，每次大版本升级都可能伴随「配置项更名」「内嵌组件移除」等破坏性变更（如 15.9.0 移除内嵌 OpenSearch、以插件形式剥离 SSO 模块）。评估升级成本时应逐版阅读 Release Notes，而非只看最新版特性。

三、核心架构

3.1 组件构成

Fess 15.9.0 的运行时由两部分组成，缺一不可：

两者的交互只有两条链路：Fess → OpenSearch 的索引写入（HTTP 9200 端口），以及用户搜索时 Fess → OpenSearch 的查询转发。OpenSearch 集群可以独立扩容、独立监控，Fess 本身是无状态应用。

3.2 数据流

数据源                    Fess                        OpenSearch
──────                  ────────────                ────────────
网页 ──┐
文件系统 ──┼─→ 爬虫(Crawler) → 文本抽取(Office/PDF/OCR) → 索引写入 → fess 索引
数据库 ──┘              ↑                                        │
                     管理后台(爬取配置/任务调度)                    ↓
用户 → 搜索页面/REST API/JS 组件 → Fess 查询处理(权限过滤/分词) → 查询 → 结果聚合返回

关键设计点：

1. 权限随文档入索引：每篇文档索引时写入其可访问角色（role 字段），查询时 Fess 按登录用户身份过滤，实现「搜得到才能看得见」的权限感知搜索（permission-aware search）。这是 Fess 区别于普通站内搜索方案的核心能力。
2. 爬取配置全部可视化：网页爬虫（含登录表单、BASIC/DIGEST/NTLM 认证抓取）、文件爬虫、数据库爬虫均在管理后台配置，无需写代码。
3. 词典可扩展：支持自定义分词词典（同义词、停止词、专有名词），中文场景可导入自定义词库。

3.3 部署形态

官方提供四种部署形态（来源：官方文档站 stable/install 目录，查询日期 2026-10-24）：

15.9.0 的重要变化：内嵌 OpenSearch 不再随核心发行包提供，安装后需通过 bin/fess-setup install opensearch 安装引擎或直接连接外部引擎。因此「Fess + 独立 OpenSearch」已成为全部形态的标准拓扑，多容器联动的 Docker Compose 是官方主推形态。

四、功能特性

4.1 爬虫与数据源

• 网页爬虫：支持robots 协议、抓取深度与并发控制、增量抓取（按最后修改时间）、失败 URL 重试上限；可配置表单登录后抓取需认证页面。
• 认证抓取：BASIC、DIGEST、NTLM、FORM 四种 Web 认证方式（来源：官网首页功能列表）。
• 文件爬虫：本地文件系统、Windows 共享（SMB）、S3/GCS 对象存储（15.9.0 起存储连接器以插件形式提供）。
• 数据库爬虫：JDBC 直连关系库，把查询结果行作为文档索引。

4.2 文档处理与多语言

• 支持 MS Office（Word/Excel/PowerPoint）、PDF、EPUB、ZIP 等格式的文本抽取；扫描型 PDF 可结合 OCR 识别。
• 分词覆盖 20+ 语言，对中日韩等多字节语言开箱可用；支持导入 MeCab/kuromoji/SmartCN 等词典。

4.3 搜索体验

• 分面（Facet）钻取、标签（Label）筛选、相关词推荐、拼写建议（拼写纠错/Did you mean）。
• 响应式搜索页面（支持移动端）、可通过 JavaScript 组件嵌入任意既有网站。
• 搜索结果点击日志与统计报表（15.9.0 新增文档报表与 CSV 导出，见 4.5）。

4.4 管理与 API

• Web 管理后台：爬取配置、任务调度、用户/角色/SSO、系统参数全覆盖；首次登录强制修改默认密码。
• REST API：/api/v2 提供搜索与文档管理接口；管理面另有一套独立的 Admin API（Bearer 访问令牌鉴权）。
• 单点登录：15.9.0 起核心包内置 SAML/OIDC/AD/LDAP 中 SAML 与 AD 之外的四类认证器已剥离为插件（SaaS/Office365/Google/Spnego），核心仍含 SAML 与 Active Directory（来源：15.9.0 Release Notes）。

4.5 15.9.0 版本要点（Upgrade & Breaking Changes）

来源：GitHub Release 15.9.0 说明，查询日期 2026-10-24：

1. JSP 版搜索/管理界面移除：静态主题（theme）成为默认，13.x 时代延续的 JSP 界面彻底退场。
2. 内嵌 OpenSearch 移除：核心发行不再捆绑引擎，统一走 bin/fess-setup install opensearch 或外接引擎。
3. JavaScript 取代 Groovy 成为默认脚本引擎：Groovy 引擎被移除，自定义脚本（爬取处理、结果变换等）需迁移到 JS。
4. 存储与 SSO 插件化：S3/GCS 存储连接器与 4 个 SSO 认证器改为独立插件安装。
5. 新增能力：搜索统计/文档报表/CSV 导出、引擎侧 Rank Fusion 排名融合、RAG 对话检索增强改进、界面模块化重构。

⚠️ 注意：若从 15.8 及更早版本升级，上述第 1–4 项均为破坏性变更，涉及脚本引擎与插件补装，需按官方 Upgrade 指南逐项处理；新装用户无迁移负担。

五、快速开始（最小可用示例）

以下为官方文档站给出的 Docker Compose 最小部署路径（来源：fess.codelibs.org/stable/install/install-docker.html，查询日期 2026-10-24；完整步骤与参数说明见本专栏部署篇）：

# 1. 下载官方编排文件（两个文件缺一不可）
curl -o compose.yaml https://raw.githubusercontent.com/codelibs/docker-fess/v15.9.0/compose/compose.yaml
curl -o compose-opensearch3.yaml https://raw.githubusercontent.com/codelibs/docker-fess/v15.9.0/compose/compose-opensearch3.yaml

# 2. 启动（fess01 + search01 双服务）
docker compose -f compose.yaml -f compose-opensearch3.yaml up -d

# 3. 访问
# 搜索界面: http://<服务器IP>:8080/
# 管理后台: http://<服务器IP>:8080/admin/（默认账号 admin/admin，首次登录强制改密）

启动后在管理后台「爬虫 → Web」添加一个站点 URL，手动触发「Default Crawler」任务即可完成第一次索引，搜索界面立刻可查。

💡 说明：Docker 镜像内置 Java 与全部插件，无需宿主机安装 Java 21；Linux 宿主机需将内核参数 vm.max_map_count 调至不低于 262144（OpenSearch 要求）。deb/rpm/zip 形态的安装步骤与 systemd 托管方式，见官方文档站 install-linux/install-untar 页面。

六、适用场景与限制

6.1 适用场景

1. 企业内部知识库统一搜索：网页门户 + 文件服务器 + 数据库三类数据源一次爬齐，权限感知保证部门隔离，这是 Fess 的主场。
2. 产品文档站/官网站内搜索：JavaScript 组件嵌入现成页面，分面与标签体系直接可用。
3. OCR + Office 文档全文检索：文件服务器里大量扫描件与 Office 文档需要「按内容搜文件」的场景。
4. 需要快速交付、低代码维护的搜索需求：无专职搜索开发团队、又需要比数据库 LIKE 查询质量高得多的检索体验。

6.2 资源与规模参考

• 最低规格 2 CPU / 4 GB 内存 / 10 GB 磁盘即可运行（官方 prerequisites），文档量在十万级以下时该规格够用。
• 每个文档字段都会进入倒排索引，磁盘占用约为原始文本的 1–2 倍量级；文档量上千万级时应将 OpenSearch 拆为独立多节点集群并单独规划磁盘。
• JVM 组件（Fess 应用与 OpenSearch）堆内存建议各 512 MB 起，2 GB 物理内存的机器需把两者堆压到 256–512 MB 区间才能稳定运行。

6.3 限制

1. 必须绑定 OpenSearch 3.9.0：引擎版本不可降级到 3.x 以下，也不能换成 Elasticsearch（查询路径与插件依赖绑定 CodeLibs 定制版）。
2. Java 技术栈内存基线偏高：相比 Meilisearch/Typesense 这类 Rust/C++ 单二进制引擎，同等文档量下内存占用高一个量级，1 GB 内存的 VPS 不适合。
3. 中文分词依赖词典调校：默认词典对专有名词识别一般，生产使用建议导入业务词库。
4. 社区规模中等：GitHub Stars 约 1.1k，遇到冷门问题时可检索的社区答案有限，主要依赖官方文档与 Issue 区。

七、同类选型对比

7.1 竞品对照表

以下星数与许可证均来自 shields.io 徽章实查（查询日期 2026-10-24）；Fess 版本节奏来自其 Releases 记录（见 2.3）：

7.2 选型建议

• 要的是「能用的搜索产品」（爬虫、权限、后台、界面都要）→ 选 Fess；这是唯一把全链路打包的选项，代价是绑定 OpenSearch 与 JVM 内存基线。
• 要的是「搜索基础设施」（自研搜索应用、深度定制相关性、PB 级数据管道）→ 选 Elasticsearch 或 OpenSearch；两者 DSL 能力对等，许可证是分水岭——托管服务转售或强开源合规诉求选 OpenSearch（Apache-2.0），生态与商业支持诉求选 Elasticsearch。
• 中小站内搜索、资源极度受限（1 GB 内存 VPS、几万文档）→ 选 Meilisearch 或 Typesense；但爬虫、权限、后台都要自建。
• 从 Elasticsearch 迁移到开源栈并希望补齐应用层 → OpenSearch + Fess 组合：Fess 原生支持 OpenSearch 引擎，可直接当检索应用层使用。

💡 技术拓展：「Fess vs Elasticsearch」并非同层竞争——Fess 可以理解为 Elasticsearch/OpenSearch 之上的「搜索应用脚手架」。评估时应先问「谁来做爬虫、权限和搜索界面」，这个问题的答案往往直接决定选型：有开发团队做应用层选纯引擎，没有就选 Fess。

八、参考链接

1. Fess 官网（功能与特性）：https://fess.codelibs.org/ （查询日期 2026-10-24）
2. Fess 15.9 文档站（安装/配置/查询语法）：https://fess.codelibs.org/stable/ （查询日期 2026-10-24）
3. GitHub 仓库 codelibs/fess（Releases 与许可证）：https://github.com/codelibs/fess （查询日期 2026-10-24）
4. 官方 Docker 镜像与编排文件仓库：https://github.com/codelibs/docker-fess （查询日期 2026-10-24）
5. 系统要求与引擎兼容性说明：https://fess.codelibs.org/stable/install/prerequisites.html （查询日期 2026-10-24）
6. Docker Compose 部署官方指南：https://fess.codelibs.org/stable/install/install-docker.html （查询日期 2026-10-24）
7. OpenSearch 3.9 官方仓库：https://github.com/opensearch-project/OpenSearch （查询日期 2026-10-24）

站内相关：《OpenSearch 3.9 介绍与选型指南》（Fess 底层索引引擎）、《Elasticsearch 9.5.5 介绍与选型指南》、《Sosse 1.14.2 介绍与选型指南》（同批轻量自托管搜索）。