Guia de Configuracion Rapida

Introduccion

Fess es un servidor de búsqueda de texto completo de código abierto que rastrea sitios web y servidores de archivos, permitiendo la búsqueda cruzada del contenido recopilado.

Esta guía está destinada a quienes desean probar Fess rápidamente, describiendo los pasos mínimos para ponerlo en marcha.

¿Qué metodo usar?

Docker (Recomendado) Paquete ZIP
Requisitos previos Docker y Docker Compose Java 21, OpenSearch
Facilidad de inicio ◎ Solo unos pocos comandos △ Se requieren múltiples instalaciones de software
Ideal para Quienes quieren probarlo primero Quienes no pueden usar Docker en su entorno

Metodo 1: Docker (Recomendado)

Tiempo estimado: 5–10 minutos en el primer inicio (incluyendo la descarga de la imagen Docker)

Docker proporciona la forma más rápida y fiable de ejecutar Fess. Todas las dependencias están incluidas, por lo que no es necesario instalar nada más.

Paso 1: Descargar los archivos de configuracion

mkdir fess-docker && cd fess-docker
curl -OL https://raw.githubusercontent.com/codelibs/docker-fess/master/compose/compose.yaml
curl -OL https://raw.githubusercontent.com/codelibs/docker-fess/master/compose/compose-opensearch3.yaml

Paso 2: Iniciar los contenedores

docker compose -f compose.yaml -f compose-opensearch3.yaml up -d

Paso 3: Acceder a Fess

Espere un par de minutos para que los servicios se inicialicen, luego abra su navegador:

Advertencia

Aviso de seguridad: Cambie la contrasena de administrador predeterminada inmediatamente despues de su primer inicio de sesion.

Paso 4: Detener Fess

docker compose -f compose.yaml -f compose-opensearch3.yaml down

Para configuracion avanzada de Docker (ajustes personalizados, OpenSearch externo, Kubernetes), consulte la Guia de instalacion con Docker.

Metodo 2: Paquete ZIP

Tiempo estimado: 20–30 minutos en el primer inicio (incluyendo la instalación de Java y OpenSearch)

Si no desea usar Docker, puede ejecutar Fess directamente desde el paquete ZIP.

Nota

Este metodo esta destinado a fines de evaluacion. Para implementaciones en produccion, recomendamos usar Docker o instalar con paquetes RPM/DEB.

Preparacion Previa

Por favor, instale el siguiente software antes de iniciar Fess.

1. Instalar Java 21

Se recomienda Eclipse Temurin para Java 21.

2. Instalar e iniciar OpenSearch

OpenSearch es necesario para almacenar los datos de Fess. Consulte la guia de instalacion para instalar e iniciar OpenSearch.

Descarga e Instalacion

  1. Descargue el paquete ZIP mas reciente desde GitHub Releases

  2. Extraiga e ingrese al directorio:

unzip fess-x.y.z.zip
cd fess-x.y.z

Inicio de Fess

# Linux/Mac
./bin/fess

# Windows
bin\fess.bat

Espere aproximadamente 30 segundos para que Fess se inicie, luego acceda a:

Advertencia

Asegurese de cambiar la contrasena predeterminada. En entornos de produccion, se recomienda encarecidamente cambiar la contrasena inmediatamente despues del primer inicio de sesion.

Detencion de Fess (ZIP)

Presione Ctrl+C en la terminal, o use kill para detener el proceso fess.

Configuracion de Rastreo y Busqueda

1. Crear una configuracion de rastreo web

  1. Inicie sesion en el Panel de administracion (http://localhost:8080/admin)

  2. Navegue a Crawler > Web en el menu de la izquierda

  3. Haga clic en Crear nuevo para crear una nueva configuracion

  4. Complete los campos requeridos:

    • Nombre: Mi primer rastreo

    • URL: https://www.example.com/ (URL del sitio a rastrear)

    • Maximo de accesos: 10 (para pruebas iniciales, se recomienda un valor pequeño)

    • Intervalo: 1000 (milisegundos entre solicitudes; se recomienda el valor predeterminado 1000 ms)

  5. Haga clic en Crear para guardar

Advertencia

Establecer el Maximo de accesos demasiado alto puede sobrecargar el sitio objetivo. Siempre comience con un valor pequeño (alrededor de 10–100) para las pruebas. Al rastrear sitios que no administra, siga la configuracion de robots.txt.

2. Ejecutar el rastreador

  1. Vaya a Sistema > Programador

  2. Encuentre Default Crawler en la lista

  3. Haga clic en Iniciar ahora

  4. Monitoree el progreso en Sistema > Informacion de rastreo

Para ejecucion programada, seleccione Default Crawler y configure el horario. Si la hora de inicio es 10:35 am, ingrese 35 10 * * ? (formato: minuto hora dia mes dia_semana).

3. Buscar

Una vez completado el rastreo (verifique WebIndexSize en la informacion de sesion):

Visite http://localhost:8080/ e ingrese un termino de busqueda para ver sus resultados.

Para saber mas