OpenSource-Hub
F

Fess

SHA-256
1.1k stars·システム最適化·SHA-256 チェックサム確認済み

Fess は、クローラーと管理画面を内蔵した、デプロイが容易なエンタープライズ向け検索サーバーです。OpenSearch をベースとしていますが、関連する経験は必要ありません。

すぐに使えるエンタープライズ検索サーバー。クローラーと管理画面を標準搭載

主な機能

  • すぐに使える検索サービス:ダウンロードして解凍するだけで実行でき、複雑な検索エンジンの設定は不要
  • Webページ、ファイルシステム、データベースのクローラーを内蔵し、ドキュメントを自動的にインデックス化
  • Office、PDF、圧縮ファイルなどの一般的な形式をサポート
  • ビジュアル管理画面:ブラウザ上でクロール対象の設定、タスクのスケジュール、インデックスの管理が可能
  • Docker デプロイをサポートし、ワンクリックで起動

できないこと

  • •デフォルトではバックエンドとして OpenSearch を使用します。初回起動時に関連プラグインが自動的にダウンロードされるため、ネットワーク接続が必要な場合があります。
  • •本番環境では、デフォルトの管理者パスワードを変更し、TLS による暗号化通信を設定することを推奨します。
  • •クローラーで大量のドキュメントを取得する場合は、スケジュール間隔とリソース制限を適切に設定し、業務システムへの影響を避けてください。
  • •中国語の分かち書きには追加の設定が必要です。公式ドキュメントの lang_zh アナライザーに関する説明を参照してください。

使用例

  • 社内ドキュメント検索(共有フォルダー内の Word、PDF など)
  • ウェブサイトのサイト内検索(Google Site Search の代替)
  • ナレッジベースや Wiki のコンテンツ検索(Confluence/Jira などのデータソースと連携)

詳細説明

Fess は、強力な機能を備え、非常にデプロイが容易なエンタープライズ向け検索エンジンサーバーです。Java 実行環境をサポートするあらゆるプラットフォームで、すばやくインストールして実行できます。Fess は OpenSearch を基盤として構築されていますが、ユーザーは OpenSearch の知識がなくてもすぐに使い始めることができます。直感的なブラウザ管理画面と内蔵のクローラーシステムを提供し、Web サーバー、ファイルシステム、データストア(CSV ファイルやデータベースなど)内のドキュメントをクロールできます。Microsoft Office ドキュメント、PDF、圧縮ファイルなど、さまざまなファイル形式をサポートしています。さらに、Fess Site Search コンポーネントは、Google Site Search の無料の代替として利用できます。Fess は Apache License 2.0 のオープンソースライセンスで提供され、CodeLibs コミュニティによって継続的にメンテナンスされています。

トラブルシューティング & FAQ (2)

トラブル対応
なぜAI検索チャットボットは、LLMの応答がトークン制限により途中で切られているときに、(UNCLEAR intent)の明確化を求め続けるのですか?

Fessにおいて、AbstractLlmClient内の意図検出は、LLM応答が切り詰められた場合に、終了理由のチェックが"length"(OpenAI)のみを認識し、"MAX_TOKENS"(Gemini)や"max_tokens"(Anthropic)を認識しないため、誤ってUNCLEARを返す可能性があります。さらに、部分的に解析可能な切り詰められたJSONが、フォールバック検索をトリガーする代わりに、有効な不明瞭な応答として扱われることがあります。修正するには、isEmptyContentWithLengthFinishを更新してすべての切り詰め終了理由(例:Set.of("length", "MAX_TOKENS", "max_tokens", "model_length");)を検出できるようにします。また、detectIntentを変更して、内容が空白でない場合でも、切り詰められた応答に対して強制的にフォールバック検索を行います。一時的な回避策として、LLMクライアントのmax_tokens設定を増やして切り詰めを防ぎます。

参照 Issue #3125
トラブル対応
Fess のチャットエラー辞書でシングルクォートが JavaScript 文字列を壊してしまう問題を修正する方法

これは fess_label_en.properties 内のエスケープされていないアポストロフィが原因で発生した Fess のバグであり、PR #3126 で修正されました。その修正を含むリリースに Fess をアップグレードしてください。回避策として、src/main/resources/fess_label_en.properties の1155行目付近にある該当のラベルを編集し、ASCII アポストロフィ(')をタイポグラフィックアポストロフィ(’)に置き換えるか、あるいは削除してから、再ビルド/再デプロイしてください。ソースコードで修正する場合は、JS 辞書の生成時にプロパティ値が JavaScript エスケープされ、' が \' になるようにしてください。

参照 Issue #3124

タグ

search-enginecrawlerenterprise-searchopensearchjava

はじめ方

1

インストーラをダウンロード

上のボタンをクリックして、お使いのシステム用のインストーラをダウンロード

2

ソフトウェアをインストール

ディストリビューションに合ったパッケージをインストール(dpkg / rpm / AppImage)

3

最新版の zip パッケージをダウンロードして解凍します

4

ディレクトリに移動し、./bin/fess を実行してサービスを起動します

5

ブラウザで http://localhost:8080/ にアクセスして検索画面を利用するか、http://localhost:8080/admin/ で管理画面にログインします(デフォルトのアカウントは admin/admin)

インストールガイド
  1. 最新版の zip パッケージをダウンロードして解凍します
  2. ディレクトリに移動し、./bin/fess を実行してサービスを起動します
  3. ブラウザで http://localhost:8080/ にアクセスして検索画面を利用するか、http://localhost:8080/admin/ で管理画面にログインします(デフォルトのアカウントは admin/admin)
ファイルの整合性

SHA-256 チェックサム確認済み

GitHub 公式 Release ページから抽出されたチェックサム

SHA256 チェックサム

4f3aa5255d79c257bc97c7b828309666b9116d6712eff658d78aee26da4a2e59

このチェックサムは GitHub Release ページから抽出されたものです。ダウンロード後にファイルの整合性を確認してください。

本プラットフォーム上のすべての SHA-256 チェックサムは、プロジェクトの公式 GitHub Release ページから抽出されたもので、一切の改変はありません。GitHub Releases ページで独自に検証できます。

オープンソースの透明性

GitHub ソースを見る
環境ガイド

アンインストール情報

Fess プロセスを停止し、展開したディレクトリを削除するだけです。Docker を使用している場合は、docker-compose down を実行してコンテナイメージを削除してください。インデックスデータはデフォルトで fess ディレクトリに保存されます。完全に削除する場合は手動で削除してください。

追加の依存関係なし

ダウンロード後すぐに使用可能。追加のランタイムは不要です。

プロジェクト情報
ライセンスApache 2.0
最終更新2026-10-15 08:28:51
GitHub リポジトリ公式サイト

問題が発生?以下のFAQを確認

2 FAQs

類似プロジェクト