Alexandrie — uma base de conhecimento no seu próprio servidor com modo offline e Markdown legível

O dilema eterno com bases de conhecimento geralmente se resume a escolher entre a nuvem e arquivos locais. Por um lado, há o Notion ou Confluence, onde é conveniente configurar o acesso da equipe, mas seus dados ficam nos servidores de outra pessoa. Por outro lado, há o Obsidian, onde tudo é armazenado em Markdown puro, mas a sincronização e colaboração rapidamente se transformam em configuração de plugins e gambiarras.

Recentemente, encontrei o projeto Alexandrie. O autor tentou combinar a interface web familiar de wikis de equipe, a independência de soluções auto-hospedadas e o acesso offline. O resultado é uma ferramenta interessante que você pode implantar no seu próprio servidor com um único comando.

O Que Tem Dentro do Projeto

Alexandrie é escrito usando Vue / Nuxt no frontend e Go no backend. É uma aplicação web completa estilizada como PWA (Progressive Web App). Você pode instalá-la no seu desktop ou celular e continuar abrindo notas sem conexão com a internet.

No núcleo está o CodeMirror 6, aprimorado para escrita técnica.

O editor tem vários detalhes interessantes que frequentemente faltam em wikis padrão:

• Suporte a fórmulas LaTeX e um construtor de diagramas integrado diretamente no texto.
• Rolagem sincronizada entre o painel de código-fonte e a visualização.
• Entrada de voz via Web Speech API para ditar pensamentos rapidamente.
• Um gerenciador de snippets para inserir rapidamente modelos repetitivos de descrição de API ou relatórios de bugs.

Estrutura de Espaços de Trabalho e Direitos de Acesso

Para colaboração em equipe, há uma hierarquia clara. Um espaço é dividido em equipes, espaços de trabalho, categorias e documentos aninhados.

O modelo de permissões inclui cinco níveis: Nenhum, Leitura, Escrita, Admin e Proprietário. Você pode conceder a alguém acesso somente leitura a um branch específico de documentos ou compartilhar uma página via um link público único externamente.

Para ambientes corporativos, a integração SSO via OIDC está incluída. Então vincular a autenticação ao Keycloak ou Authentik não será um problema.

Busca e Organização do Trabalho

A busca em bases de conhecimento geralmente é lenta ou requer um cluster separado do Elasticsearch. Alexandrie tem um índice de texto completo integrado com resultados de busca destacados e ranking de relevância.

Pressionar Ctrl + K abre a paleta de comandos. A partir dela, você pode navegar entre páginas, acionar ações rápidas e trocar contextos sem tocar no mouse.

Quadros Kanban também são integrados em cada espaço de trabalho. Isso é útil quando você precisa executar um rastreador de tarefas pequeno junto com especificações e documentação técnica, sem trocar para rastreadores de terceiros.

Armazenamento de Arquivos e Backups

Imagens, vídeos e anexos não incham o banco de dados. A aplicação pode trabalhar com armazenamento compatível com S3, seja MinIO, Garage, RustFS ou provedores de nuvem.

A interface inclui um visualizador integrado para trinta formatos de arquivo de mídia, incluindo um renderizador de PDF embutido.

A exportação também é simples: a qualquer momento você pode baixar um arquivo com todos os documentos e metadados como ZIP ou restaurar o estado do sistema a partir de tal arquivo. Não há lock-in para um formato proprietário — você obtém arquivos normais como saída.

Como Iniciar

Toda a stack é implantada via Docker Compose em literalmente um par de minutos.

# 1. Скачиваем конфиги
curl https://raw.githubusercontent.com/Smaug6739/Alexandrie/main/.env.example -O .env.example
curl https://raw.githubusercontent.com/Smaug6739/Alexandrie/main/docker-compose.yml -O docker-compose.yml

# 2. Создаем файл переменных окружения
cp .env.example .env

# 3. Запускаем контейнеры
docker compose up -d

Após a inicialização, a interface está disponível em http://localhost:8200, onde o assistente de configuração inicial solicitará que você crie uma conta de proprietário.

Para Quem Este Projeto É

Se você precisa de uma base de conhecimento interna para uma equipe de desenvolvimento ou um arquivo de notas pessoais em um servidor doméstico, Alexandrie parece um candidato sólido. Ele não tem o peso do Confluence nem a dependência de nuvem do Notion.

Claro, o projeto é mais jovem que os gigantes estabelecidos, e sua comunidade ainda é modesta. Mas a combinação de uma imagem Docker pronta, PWA com acesso offline e suporte a S3 o torna uma ferramenta conveniente para quem valoriza o controle sobre seus dados.