Alexandrie – eine Wissensdatenbank auf dem eigenen Server mit Offline-Modus und lesbarer Markdown

Das ewige Dilemma bei Wissensdatenbanken liegt normalerweise in der Wahl zwischen Cloud und lokalen Dateien. Einerseits gibt es Notion oder Confluence, wo die Konfiguration des Team-Zugriffs bequem ist, aber Ihre Daten auf den Servern von Dritten liegen. Andererseits gibt es Obsidian, wo alles in reinem Markdown gespeichert wird, aber Synchronisierung und Zusammenarbeit werden schnell zur Konfiguration von Plugins und Workarounds.

Ich bin kürzlich auf das Alexandrie-Projekt gestoßen. Der Autor hat versucht, die vertraute Weboberfläche von Team-Wikis, die Unabhängigkeit selbst gehosteter Lösungen und den Offline-Zugriff zu kombinieren. Herausgekommen ist ein interessantes Tool, das Sie mit einem einzigen Befehl auf Ihrem eigenen Server bereitstellen können.

Was steckt im Projekt

Alexandrie ist mit Vue / Nuxt im Frontend und Go im Backend geschrieben. Es ist eine vollwertige Webanwendung, die als PWA (Progressive Web App) gestaltet ist. Sie können sie auf Ihrem Desktop oder Telefon installieren und Notizen weiterhin ohne Internetverbindung öffnen.

Im Kern basiert es auf CodeMirror 6, erweitert für technisches Schreiben.

Der Editor hat mehrere schöne Details, die in Standard-Wikis oft fehlen:

• LaTeX-Formelunterstützung und ein eingebauter Diagramm-Builder direkt im Text.
• Synchronisiertes Scrollen zwischen Quell- und Vorschau-Bereich.
• Spracheingabe über die Web Speech API für schnelles Diktieren von Gedanken.
• Ein Snippet-Manager für schnelles Einfügen wiederkehrender API-Beschreibungen oder Bug-Report-Vorlagen.

Workspace-Struktur und Zugriffsrechte

Für die Teamzusammenarbeit gibt es eine klare Hierarchie. Ein Space ist unterteilt in Teams, Workspaces, Kategorien und verschachtelte Dokumente.

Das Berechtigungsmodell umfasst fünf Stufen: Keine, Lesen, Schreiben, Admin und Eigentümer. Sie können某人 Nur-Lese-Zugriff auf einen bestimmten Dokumentenzweig gewähren oder eine Seite über einen eindeutigen öffentlichen Link extern teilen.

Für Unternehmensumgebungen ist die SSO-Integration über OIDC enthalten. Die Verknüpfung der Authentifizierung mit Keycloak oder Authentik ist also kein Problem.

Suche und Arbeitsorganisation

Die Suche in Wissensdatenbanken ist normalerweise entweder träge oder erfordert einen separaten Elasticsearch-Cluster. Alexandrie verfügt über einen eingebauten Volltextindex mit hervorgehobenen Suchergebnissen und Relevanz-Ranking.

Das Drücken von Strg + K öffnet die Befehlspalette. Von dort aus können Sie zwischen Seiten wechseln, schnelle Aktionen auslösen und Kontexte wechseln, ohne die Maus zu berühren.

Kanban-Boards sind ebenfalls in jeden Workspace integriert. Das ist praktisch, wenn Sie einen kleinen Aufgabenverfolger direkt neben Spezifikationen und technischer Dokumentation betreiben müssen, ohne zu externen Trackern zu wechseln.

Dateispeicherung und Backups

Bilder, Videos und Anhänge belasten nicht die Datenbank. Die Anwendung kann mit S3-kompatiblem Speicher arbeiten, sei es MinIO, Garage, RustFS oder Cloud-Anbieter.

Die Benutzeroberfläche enthält einen eingebauten Viewer für dreißig Medienformate, einschließlich eines eingebetteten PDF-Renderers.

Der Export ist ebenfalls unkompliziert: Sie können jederzeit ein Archiv mit allen Dokumenten und Metadaten als ZIP herunterladen oder den Systemzustand aus einem solchen Archiv wiederherstellen. Es gibt keinen Lock-in in ein proprietäres Format – Sie erhalten normale Dateien als Ausgabe.

Wie man es startet

Der gesamte Stack wird über Docker Compose in buchstäblich ein paar Minuten bereitgestellt.

# 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

Nach dem Start ist die Benutzeroberfläche unter http://localhost:8200 verfügbar, wo der initiale Einrichtungsassistent Sie auffordert, ein Eigentümerkonto zu erstellen.

Für wen das Projekt geeignet ist

Wenn Sie eine interne Wissensdatenbank für ein Entwicklungsteam oder ein persönliches Notizarchiv auf einem Heimserver benötigen, sieht Alexandrie nach einem soliden Kandidaten aus. Es hat nicht den Ballast von Confluence oder die Cloud-Abhängigkeit von Notion.

Natürlich ist das Projekt jünger als die etablierten Giganten, und seine Community ist noch überschaubar. Aber die Kombination aus einem fertigen Docker-Image, PWA mit Offline-Zugriff und S3-Unterstützung macht es zu einem praktischen Tool für diejenigen, die Kontrolle über ihre Daten schätzen.