Alexandrie — una knowledge base sul tuo server con modalità offline e Markdown leggibile

Il dilemma eterno con le knowledge base di solito si riduce alla scelta tra il cloud e i file locali. Da un lato c'è Notion o Confluence, dove è comodo configurare l'accesso al team, ma i tuoi dati risiedono sui server di qualcun altro. Dall'altro c'è Obsidian, dove tutto viene archiviato in puro Markdown, ma la sincronizzazione e la collaborazione si trasformano rapidamente in configurazione di plugin e workaround.

Recentemente mi sono imbattuto nel progetto Alexandrie. L'autore ha cercato di combinare l'interfaccia web familiare dei wiki di team, l'indipendenza delle soluzioni self-hosted e l'accesso offline. È risultato uno strumento interessante che puoi distribuire sul tuo server con un singolo comando.

Cosa c'è dentro il progetto

Alexandrie è scritto usando Vue / Nuxt sul frontend e Go sul backend. È un'applicazione web completa con stile PWA (Progressive Web App). Puoi installarla sul desktop o sul telefono e continuare ad aprire le note senza connessione internet.

Al suo core c'è CodeMirror 6, potenziato per la scrittura tecnica.

L'editor ha diverse funzionalità interessanti che spesso mancano nei wiki standard:

• Supporto per formule LaTeX e un costruttore di diagrammi integrato direttamente nel testo.
• Scorrimento sincronizzato tra il riquadro sorgente e l'anteprima.
• Input vocale tramite Web Speech API per dettare rapidamente i pensieri.
• Un gestore di snippet per inserire rapidamente modelli ripetitivi di descrizione API o segnalazione bug.

Struttura degli spazi di lavoro e diritti di accesso

Per la collaborazione di team, c'è una gerarchia chiara. Uno spazio è diviso in team, workspace, categorie e documenti nidificati.

Il modello di permessi include cinque livelli: Nessuno, Lettura, Scrittura, Admin e Proprietario. Puoi concedere a qualcuno accesso di sola lettura a un ramo specifico di documenti o condividere una pagina tramite un link pubblico univoco esternamente.

Per gli ambienti aziendali, è inclusa l'integrazione SSO tramite OIDC. Quindi collegare l'autenticazione a Keycloak o Authentik non sarà un problema.

Ricerca e organizzazione del lavoro

La ricerca nelle knowledge base di solito è lenta o richiede un cluster Elasticsearch separato. Alexandrie ha un indice full-text integrato con risultati di ricerca evidenziati e ranking di rilevanza.

Premendo Ctrl + K si apre la command palette. Da lì puoi saltare tra le pagine, attivare azioni rapide e cambiare contesto senza toccare il mouse.

Le bacheche Kanban sono integrate in ogni workspace. È comodo quando devi gestire un piccolo task tracker direttamente accanto alle specifiche e alla documentazione tecnica, senza passare a tracker di terze parti.

Archiviazione file e backup

Immagini, video e allegati non appesantiscono il database. L'applicazione può lavorare con storage compatibile S3, che sia MinIO, Garage, RustFS o provider cloud.

L'interfaccia include un visualizzatore integrato per trenta formati di file multimediali, incluso un renderer PDF incorporato.

L'esportazione è altrettanto semplice: in qualsiasi momento puoi scaricare un archivio con tutti i documenti e i metadati come ZIP o ripristinare lo stato del sistema da un tale archivio. Non c'è lock-in su un formato proprietario—ottieni file normali come output.

Come avviare

L'intero stack viene distribuito tramite Docker Compose in letteralmente un paio di minuti.

# 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

Dopo l'avvio, l'interfaccia è disponibile su http://localhost:8200, dove la wizard di configurazione iniziale ti chiederà di creare un account proprietario.

A chi è destinato il progetto

Se hai bisogno di una knowledge base interna per un team di sviluppo o un archivio di note personali su un server di casa, Alexandrie sembra un candidato solido. Non ha il peso di Confluence né la dipendenza dal cloud di Notion.

Naturalmente, il progetto è più giovane dei giganti affermati e la sua comunità è ancora modesta. Ma la combinazione di un'immagine Docker pronta, PWA con accesso offline e supporto S3 lo rende uno strumento conveniente per chi tiene al controllo sui propri dati.