7.4 KiB
Fess: Servidor de Busca Empresarial
Visão Geral
Fess é um servidor de busca empresarial muito poderoso e fácil de implantar. Você pode instalar e executar o Fess rapidamente em qualquer plataforma que suporte o Java Runtime Environment. O Fess é fornecido sob a Licença Apache 2.0.
O Fess é baseado no OpenSearch, mas não é necessário ter conhecimento ou experiência com OpenSearch. O Fess fornece uma interface de administração fácil de usar, que permite configurar o sistema através do seu navegador. O Fess também inclui um rastreador (Crawler), que pode rastrear documentos em um servidor web, sistema de arquivos ou Data Store (como CSV ou banco de dados). Muitos formatos de arquivos são suportados, incluindo (mas não limitado a): Microsoft Office, PDF e zip.
Fess Site Search é uma alternativa gratuita ao Google Site Search. Para mais detalhes, veja a documentação do FSS JS Generator.
Site
Problemas/Perguntas
Como Começar
Existem duas maneiras de testar o Fess. A primeira é baixar e instalar você mesmo. A segunda é usar Docker.
Baixar e Instalar/Executar
O Fess 14.17 já está disponível e pode ser baixado na página de lançamentos. As opções de download incluem: deb, rpm, zip.
Os comandos a seguir mostram como usar o download em formato zip:
$ unzip fess-14.17.x.zip
$ cd fess-14.17.x
$ ./bin/fess
Para mais detalhes, veja o Guia de Instalação.
Docker
Nós fornecemos imagens Docker em ghcr.io. Também fornecemos um arquivo Docker Compose (YAML) neste repositório.
Interface do Navegador
- Interface de Busca: http://localhost:8080/
- Interface de Administração: http://localhost:8080/admin/ (o nome de usuário/senha padrão é admin/admin)
Você pode registrar alvos de rastreamento na interface de administração nas páginas de configuração do rastreador (Web, Arquivo, Data Store), e iniciar manualmente o rastreador na página do Agendador.
Migração de Outro Provedor de Busca
Consulte MIGRATION.md.
Data Store
Atualmente, o Fess suporta o rastreamento dos seguintes locais de armazenamento e APIs:
- Confluence/Jira
- Box
- CSV
- Database
- Dropbox
- Elasticsearch
- Git
- Gitbucket
- G Suite
- JSON
- Office 365
- S3
- Salesforce
- SharePoint
- Slack
Temas
Ingestão
Scripts
Informações de Desenvolvimento
Obter Código Fonte
-
Clone o repositório do Fess:
$ cd ~/workspace $ git clone https://github.com/codelibs/fess.git
-
Importe o repositório clonado como um projeto Maven no Eclipse ou em outro IDE.
Configuração de Plugins para OpenSearch
Execute antrun:run para baixar os plugins no diretório de plugins:
$ mvn antrun:run
Executar o Fess
Execute ou depure org.codelibs.fess.FessBoot
no seu IDE, e depois acesse http://localhost:8080/
Criar Pacote
Execute o objetivo package
e o arquivo de lançamento será criado em target/releases.
$ mvn package
$ mvn rpm:rpm # pacote .rpm
$ mvn jdeb:jdeb # pacote .deb
Gerar Código Fonte
$ mvn dbflute:download # (comando executado uma vez)
$ mvn dbflute:freegen
$ mvn license:format
Testes de Integração
Inicie o servidor Fess e execute o seguinte comando:
$ mvn test -P integrationTests -Dtest.fess.url="http://localhost:8080" -Dtest.search_engine.url="http://localhost:9201"
Para executar um único caso de teste, você pode usar:
$ mvn test -P integrationTests -Dtest.fess.url="http://localhost:8080" -Dtest.search_engine.url="http://localhost:9201" -Dtest=SearchApiTests
Traduzir para o Seu Idioma
Fess é um software internacionalizado.
Se você quiser adicionar rótulos/mensagens para o seu idioma, por favor, traduza o arquivo de propriedades e renomeie-o para fess_*_[lang].properties.
Para o analisador de busca/índice, se doc.json contiver lang_[lang] para o seu idioma, por favor, modifique o analisador para o seu idioma. Para mais detalhes sobre Analisadores, veja a documentação do OpenSearch.
Aceitamos pull requests para o seu idioma.
Desenvolvido por
- Lasta Di: Contêiner DI
- LastaFlute: Framework Web
- Lasta Job: Agendador de Tarefas
- Fess Crawler: Rastreador Web
- OpenSearch: Motor de Busca