Alexandrie — una base de conocimiento en tu propio servidor con modo offline y Markdown legible para humanos

El dilema eterno con las bases de conocimiento generalmente se reduce a elegir entre la nube y los archivos locales. Por un lado, está Notion o Confluence, donde es conveniente configurar el acceso del equipo, pero tus datos están en servidores de otra persona. Por otro lado, está Obsidian, donde todo se almacena en Markdown puro, pero la sincronización y la colaboración rápidamente se convierten en configuración de plugins y soluciones alternativas.

Hace poco me encontré con el proyecto Alexandrie. El autor intentó combinar la interfaz web familiar de las wikis de equipo, la independencia de las soluciones autoalojadas y el acceso offline. Resultó ser una herramienta interesante que puedes desplegar en tu propio servidor con un solo comando.

Qué hay dentro del proyecto

Alexandrie está escrito usando Vue / Nuxt en el frontend y Go en el backend. Es una aplicación web completa con estilo de PWA (Progressive Web App). Puedes instalarla en tu escritorio o teléfono y continuar abriendo notas sin conexión a internet.

En su núcleo está CodeMirror 6, mejorado para escritura técnica.

El editor tiene varios detalles agradables que suelen faltar en las wikis estándar:

• Soporte para fórmulas LaTeX y un constructor de diagramas integrado directamente en el texto.
• Desplazamiento sincronizado entre el panel de origen y la vista previa.
• Entrada de voz mediante Web Speech API para dictar rápidamente pensamientos.
• Un gestor de fragmentos para insertar rápidamente plantillas repetitivas de descripción de API o informes de errores.

Estructura de espacios de trabajo y derechos de acceso

Para la colaboración en equipo, existe una jerarquía clara. Un espacio se divide en equipos, espacios de trabajo, categorías y documentos anidados.

El modelo de permisos incluye cinco niveles: Ninguno, Lectura, Escritura, Admin y Propietario. Puedes otorgar a alguien acceso de solo lectura a una rama específica del documento o compartir una página mediante un enlace público único externo.

Para entornos corporativos, se incluye integración SSO mediante OIDC. Así que vincular la autenticación con Keycloak o Authentik no será un problema.

Búsqueda y organización del flujo de trabajo

La búsqueda en las bases de conocimiento suele ser lenta o requiere un clúster separado de Elasticsearch. Alexandrie tiene un índice de texto completo integrado con resultados de búsqueda resaltados y clasificación por relevancia.

Al presionar Ctrl + K se abre la paleta de comandos. Desde allí, puedes saltar entre páginas, activar acciones rápidas y cambiar de contexto sin tocar el ratón.

Los tableros Kanban también están integrados en cada espacio de trabajo. Esto es útil cuando necesitas ejecutar un pequeño rastreador de tareas junto a las especificaciones y la documentación técnica, sin cambiar a rastreadores de terceros.

Almacenamiento de archivos y copias de seguridad

Las imágenes, videos y archivos adjuntos no inflan la base de datos. La aplicación puede trabajar con almacenamiento compatible con S3, ya sea MinIO, Garage, RustFS o proveedores en la nube.

La interfaz incluye un visor integrado para treinta formatos de archivos multimedia, incluyendo un renderizador de PDF integrado.

La exportación también es sencilla: en cualquier momento puedes descargar un archivo con todos los documentos y metadatos como ZIP o restaurar el estado del sistema desde dicho archivo. No hay bloqueo a un formato propietario—obtienes archivos normales como salida.

Cómo iniciar

Toda la pila se despliega mediante Docker Compose en literalmente un 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

Después del inicio, la interfaz está disponible en http://localhost:8200, donde el asistente de configuración inicial te pedirá crear una cuenta de propietario.

Para quién es este proyecto

Si necesitas una base de conocimiento interna para un equipo de desarrollo o un archivo de notas personales en un servidor doméstico, Alexandrie parece un candidato sólido. No tiene la sobrecarga de Confluence ni la dependencia de la nube de Notion.

Por supuesto, el proyecto es más joven que los gigantes establecidos, y su comunidad aún es modesta. Pero la combinación de una imagen Docker lista para usar, PWA con acceso offline y soporte S3 lo convierte en una herramienta conveniente para quienes valoran el control sobre sus datos.