Fess: Servidor de Búsqueda Empresarial

May 31, 2026 · View on GitHub

Java CI with Maven License GitHub Release

Resumen

Fess es un servidor de búsqueda empresarial muy potente y fácil de desplegar. Puedes instalar y ejecutar Fess rápidamente en cualquier plataforma que sea capaz de ejecutar el entorno de ejecución de Java (Java Runtime Environment). Fess se distribuye bajo la Licencia Apache 2.0.

Fess está basado en OpenSearch, pero no se requiere conocimiento o experiencia en OpenSearch. Fess proporciona una GUI de administración fácil de usar para configurar el sistema a través de tu navegador. Fess también incluye un rastreador (crawler), que puede rastrear documentos en un servidor web, sistema de archivos, o almacenamiento de datos (como un archivo CSV o base de datos). Se admiten muchos formatos de archivos, incluidos (pero no limitados a): Microsoft Office, PDF y zip.

Fess Site Search es una alternativa gratuita a Google Site Search. Para más detalles, consulta la documentación de FSS JS Generator.

Sitio web

fess.codelibs.org

Problemas/Preguntas

discuss.codelibs.org

Cómo Empezar

Hay dos maneras de probar Fess. La primera es descargar e instalarlo tú mismo. La segunda es usar Docker.

Descargar e Instalar/Ejecutar

Fess 15.6 ya está disponible y se puede descargar en la página de lanzamientos. Las descargas están disponibles en 3 formatos: deb, rpm y zip.

Los siguientes comandos muestran cómo usar la descarga en formato zip:

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

Para más detalles, consulta la Guía de Instalación.

Docker

Proporcionamos imágenes de Docker en ghcr.io. También proporcionamos un archivo Docker Compose (YAML) en este repositorio.

Interfaz de Usuario en el Navegador

Interfaz de Búsqueda

Interfaz de Administración

Puedes registrar los objetivos de rastreo en la interfaz de administración en las páginas de configuración del rastreador (Web, Archivo, Almacenamiento de Datos), y luego iniciar el rastreador manualmente en la página del Programador.

Migración desde otro proveedor de búsqueda

Consulta MIGRATION.md.

Almacenamiento de Datos

Actualmente, Fess admite el rastreo de las siguientes ubicaciones de almacenamiento y APIs:

Tema

Ingesta

Script

Información de Desarrollo

Obtener el Código Fuente

  1. Clona el repositorio de Fess:

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

  2. Importa el repositorio clonado como un proyecto Maven en Eclipse u otro IDE.

Configuración de Plugins para OpenSearch

Ejecuta antrun:run para descargar los plugins en el directorio de plugins:

$ mvn antrun:run

Ejecutar Fess

Ejecuta o depura org.codelibs.fess.FessBoot en tu IDE, y luego accede a http://localhost:8080/

Construir el Paquete

Ejecuta el objetivo package y luego se creará el archivo de lanzamiento en target/releases.

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

Generar Código Fuente

$ mvn dbflute:download # (comando ejecutado una sola vez)
$ mvn dbflute:freegen
$ mvn license:format

Pruebas de Integración

Las pruebas de integración requieren un servidor Fess en ejecución con OpenSearch. Sigue estos pasos:

1. Compilar Fess

$ mvn antrun:run  # Descargar los plugins de OpenSearch (si aún no se ha hecho)
$ mvn package     # Compilar el paquete

2. Iniciar el Servidor Fess

$ unzip target/releases/fess-*.zip
$ ./fess-*/bin/fess &

Espera a que Fess esté listo (esto puede tardar hasta 60 segundos):

$ curl -s "http://localhost:8080/api/v1/health"

Deberías ver una respuesta JSON cuando Fess esté listo.

3. Clonar los Datos de Prueba

Necesario para SearchApiTests:

$ git clone https://github.com/codelibs/fess-testdata.git /tmp/fess-testdata

4. Ejecutar las Pruebas de Integración

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

Para ejecutar un único caso de prueba:

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

Traducir a Tu Idioma

Fess es un software internacionalizado.

Si deseas agregar etiquetas/mensajes para tu idioma, por favor traduce el archivo de propiedades y renómbralo a fess_*_[lang].properties.

Para el analizador de búsqueda/índices, si doc.json contiene lang_[lang] para tu idioma, por favor modifica el analizador para tu idioma. Para más detalles sobre los analizadores, consulta la documentación de OpenSearch.

Damos la bienvenida a pull requests para tu idioma.

Traducciones

Impulsado por