启动前需先把 .env.example 复制为 .env 并配置环境变量;默认访问端口为 8200,首次打开需创建 owner 账户;S3 备份与媒体存储需自行准备兼容的对象存储服务

Alexandrie
Smaug6739MIT活跃维护开源离线优先的知识库与笔记工具,支持高级 Markdown、多租户团队协作、OIDC/SSO 登录和本地 S3 备份,一条命令即可部署。
📚 The open-source, offline-first Notion, Obsidian & Confluence alternative. Advanced Markdown, multi-tenant teams, OIDC/SSO, and local S3 backups. Deploy in one command.
curl -O https://raw.githubusercontent.com/Smaug6739/Alexandrie/main/.env.example
curl -O https://raw.githubusercontent.com/Smaug6739/Alexandrie/main/docker-compose.yml
cp .env.example .env
docker compose up -dREADME 未说明硬件要求,只说明用 Docker 一条命令拉起全栈应用
自托管开源知识库,带扩展 Markdown 编辑器,可替代 Notion、Obsidian 和 Confluence
开源离线优先的知识库与笔记工具,支持高级 Markdown、多租户团队协作、OIDC/SSO 登录和本地 S3 备份,一条命令即可部署。
核心能力
- 基于 CodeMirror 6 的扩展 Markdown 编辑器,原生支持 LaTeX 和自定义容器
- 离线优先 PWA,可安装到桌面或移动端并同步
- 多租户团队、工作区、分类与嵌套文档,5 级节点权限
- 内置 OIDC/SSO 登录与全系统备份恢复流水线
- 支持 S3 兼容对象存储,可预览 30 多种媒体格式
容易踩的坑
- v8.14.4Version 8.14.4最新正式版2026-11-08 · 2026-11-08 17:09 UTC
Full Changelog: https://github.com/Smaug6739/Alexandrie/compare/v8.14.3...v8.14.4
What's Changed
- fix: remove debug log from setAppColor function a4dc87a7888f70de6b267887092a468284082c7f
- fix(errors): new errors handling with correct 404 page 429e2b9b92163d1a60497c9ece1e81aa0c5dc623
- fix: escape html for icons to avoid scripts injection ef389c290d183421de97168bc36d17cdb0b61eb6
- fix: env variables injection in service worker at runtime instead of at build time e865051511edd00dec1a83b4c441e930816b1274
- feat(markdown): add counters feature for automatic figures / tables / title labels (#742) by @evgenyponomarev
- v8.14.3Version 8.14.32026-10-30 · 2026-10-30 14:37 UTC
查看更新说明
Full Changelog: https://github.com/Smaug6739/Alexandrie/compare/v8.14.2...v8.14.3
What's Changed
- fix(s3): do not abort startup when PutBucketPolicy is unsupported by @anyingiit in https://github.com/Smaug6739/Alexandrie/pull/786
- fix: handle unavailable Kanban views without losing the saved preference by @wanchenxing in https://github.com/Smaug6739/Alexandrie/pull/783
- fix: align default CDN_URL with RustFS port 9000 by @BoulmisAbdennour in https://github.com/Smaug6739/Alexandrie/pull/794
- fix(oidc): widen users.avatar and skip non-URL picture claims by @jadhavgaurav in https://github.com/Smaug6739/Alexandrie/pull/796
- fix(snowflake): stop Generate from hanging after 4,095 IDs by @dannybloomfield in https://github.com/Smaug6739/Alexandrie/pull/815
- fix: add datatable mobile version and fix tags display in datatable for nodes advanced view by @Hasoye in https://github.com/Smaug6739/Alexandrie/pull/787
- docs: update curl commands and link formatting in README.md by @crypt0rr in https://github.com/Smaug6739/Alexandrie/pull/780
- chore: add config for local tests dec46fbfa3b31e483a3d98e2c03c12dc3d834016
- bump(docker-deps): bump node from 24 to 26. 68c19cc8ca41d0664ef0d78edb27ffd48e845080 #809
- fix: update Go version to 1.26 in build workflow and Dockerfile 91e4583005cbe0ad37ef1cf5eb7f787acdf8c864
- fix: set scope for PWA to ensure proper routing 45a13f3c151a53b83b10f25c943c5a5e9cc5004c
- fix(PWA): add i18n cache rules to serve translations offline 5a12e8312bf2156b92feb1489f35930fa5c4a6c6
- fix(editor): cursors in wrong possition in katex snippets 2ba7f3f2125a703357b7f369d741182cdada62c9
- fix: documents titles auto numbering not correctly reset 6500184d9af751647da3af58de15d17163578c72 #803
- fix(workflow): ensure LFS is enabled during repository checkout dcbe9d8276454982f719478dcc363e7932d90534
- chore: remove unused git file 416237ca08baea60cb41adbf1412f7c52417df59
New Contributors
- @crypt0rr made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/780
- @anyingiit made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/786
- @wanchenxing made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/783
- @BoulmisAbdennour made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/794
- @jadhavgaurav made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/796
- @dannybloomfield made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/815
- v8.14.2Version 8.14.22026-09-07 · 2026-09-07 08:30 UTC
查看更新说明
Full Changelog: https://github.com/Smaug6739/Alexandrie/compare/v8.14.1...v8.14.2
What's Changed
- fix: display the right shortcut in search bar ctrl +q to ctrl + k by @louloudev59 in https://github.com/Smaug6739/Alexandrie/pull/760
- fix: load the right app theme color on startup or reload of PWA by @Smaug6739 in https://github.com/Smaug6739/Alexandrie/pull/761
- fix(cdn): improve mobile upload experience by @Hasoye in https://github.com/Smaug6739/Alexandrie/pull/755
- feat: render file preview on public document page by @nva138 in https://github.com/Smaug6739/Alexandrie/pull/764
- fix: make category and workspace rows fully clickable (#762) by @sairampolisetty in https://github.com/Smaug6739/Alexandrie/pull/766
New Contributors
- @Hasoye made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/755
- @nva138 made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/764
- v8.14.1Version 8.14.12026-09-04 · 2026-09-04 07:49 UTC
查看更新说明
Full Changelog: https://github.com/Smaug6739/Alexandrie/compare/v8.14.0...v8.14.1
What's Changed
- fix: use parent_id query param for new kanban documents by @sairampolisetty in https://github.com/Smaug6739/Alexandrie/pull/726
- fix: improve placeholder clarity and join button state by @sairampolisetty in https://github.com/Smaug6739/Alexandrie/pull/723
- feat: add remove profile picture option by @sairampolisetty in https://github.com/Smaug6739/Alexandrie/pull/733
- fix: display the saved datatable page size by @pttydou in https://github.com/Smaug6739/Alexandrie/pull/743
- fix(ui): tooltip overflow and unify document editor input styling (#727) by @sairampolisetty in https://github.com/Smaug6739/Alexandrie/pull/752
- fix(kanban): clarify assignee search copy by @QinXi-ai in https://github.com/Smaug6739/Alexandrie/pull/744
New Contributors
- @pttydou made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/743
- v8.14.0Version 8.14.02026-08-25 · 2026-08-25 18:42 UTC
查看更新说明
Full Changelog: https://github.com/Smaug6739/Alexandrie/compare/v8.13.0...v8.14.0
Features
- feat(i18n): derive language selection from configured locales by @archie0732 in https://github.com/Smaug6739/Alexandrie/pull/681
- feat(markdown): support github emoji syntax by @Osheun in https://github.com/Smaug6739/Alexandrie/pull/689
- feat(settings): add option to hide New and Beta tags by @Osheun in https://github.com/Smaug6739/Alexandrie/pull/688
- feat: public documents: quick actions & improved sharing by @archie0732 in https://github.com/Smaug6739/Alexandrie/pull/690
- feat(docs): add new documentation website for the project by @Smaug6739 in https://github.com/Smaug6739/Alexandrie/pull/664
- feat(themes): add the Terminal document theme by @xubaoer19940428-creator in https://github.com/Smaug6739/Alexandrie/pull/691
- feat(i18n): add Traditional and Simplified Chinese locales by @archie0732 in https://github.com/Smaug6739/Alexandrie/pull/694
- feat(kanban): add assign users to cards feature and add related filters by @Smaug6739 in https://github.com/Smaug6739/Alexandrie/pull/705
- feat(ui): add new advanced nodes view with bulk actions by @sairampolisetty in https://github.com/Smaug6739/Alexandrie/pull/708
- feat: new import system with support of attachments and unified files import by @Smaug6739 in https://github.com/Smaug6739/Alexandrie/pull/700
- feat(markdown): improve mermaid diagrams syntax by allowing standard version by @sairampolisetty in https://github.com/Smaug6739/Alexandrie/pull/717
- fix: add missing env variable for the backend S3 service 67bee5b027c4ad2cf44d8c6756336e1ed34fa177
Fixes
- fix: remove duplicated state in markdown editor and allow dynamic category change by @Smaug6739 in https://github.com/Smaug6739/Alexandrie/pull/687
- fix: navbar navigation buttons when tabs feature is enabled & tabs duplication during navigation by @Smaug6739 in https://github.com/Smaug6739/Alexandrie/pull/686
- fix(themes): clean up themes by marging & removing useless latex themes by @Smaug6739 in https://github.com/Smaug6739/Alexandrie/pull/697
- fix(ui): hide active Sign up and Login buttons on their respective routes by @sairampolisetty in https://github.com/Smaug6739/Alexandrie/pull/703
- fix(tags): show suggestions on focus by @terminalchai in https://github.com/Smaug6739/Alexandrie/pull/710
- fix(editor): validate document titles before saving by @QinXi-ai in https://github.com/Smaug6739/Alexandrie/pull/711
- fix(i18n): translate dashboard surfaces by @Yuki9814 in https://github.com/Smaug6739/Alexandrie/pull/719
- fix(i18n): add missing translations in settings for nodes advanced view 05233b1287952a494ae720b4dcfe7406a579d242
Other
- chore(docs): add independent deploy script for documentation to avoid unnecessary rebuild of frontend by @Smaug6739 in https://github.com/Smaug6739/Alexandrie/pull/701
- style: add new rules to automaticly sort keys by alphabetical order addaee3b0895d639d93510d14d4d7ff5bbc8ad0b
- build(depts): bump dependencies
- docs: add missing variables in env example file 89adb30d66a84fc48f9305251b923a26bb2eb94c
- refactor: remove unnecessary comments for clarity 1a386d0eca7ef97853b34cd807c86a41038128bc
New Contributors
- @archie0732 made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/681
- @Osheun made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/689
- @xubaoer19940428-creator made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/691
- @sairampolisetty made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/703
- @terminalchai made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/710
- @QinXi-ai made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/711
- @Yuki9814 made their first contribution in https://github.com/Smaug6739/Alexandrie/pull/719
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Alexandrie
A self-hosted, open-source knowledge base with an extended Markdown editor. Organize, search, share and export your notes from any device, even offline.

Why Alexandrie?
Alexandrie is an open-source self-hosted wiki and knowledge management platform built for teams and individuals. It combines a powerful Markdown editor, offline support, collaboration tools, and enterprise-grade permissions, making it an alternative to Notion, Confluence and Obsidian.
- One-Command Deployment: Bring up the entire full-stack application instantly using Docker.
- Advanced Markdown Engine: Native support for LaTeX, custom containers, interactive checkboxes, frames, snippets, and integrated diagram building.
- Granular Organization: Multi-tenant architecture supporting Teams, Workspaces, Categories, and nested Documents.
- Offline-First PWA: Install on any desktop or mobile device with full offline capabilities and seamless synchronization.
- Production Ready: Built-in OpenID Connect (OIDC) SSO providers, automated full-system backup/restore pipelines, and a robust media storage architecture.
Core Features
Advanced Writing & Rich Markdown
Alexandrie features an extended CodeMirror 6 environment tailored for technical writing. It handles complex academic blocks, custom styles, global theme alignment, and real-time scroll synchronization seamlessly.

-
Speech-to-Text: Dictate notes directly into your editor using integrated voice-recognition APIs.
-
Native Diagrams: Create, edit, and render flowcharts or structural diagrams right inside your Markdown flow.
-
Snippet Manager: Save, reuse, and import/export frequently used templates or code fragments.
Team Workspaces & Access Control
Manage multi-user environments with clear hierarchy and strict isolation. Securely share knowledge across organizations through unique public links or granular group rules.

-
5-Level Access Model: Fine-tune user privileges from None, Read, Write, Admin, to Owner status per node or workspace.
-
Enterprise Operations: Generate temporary invitation codes, configure custom scopes, and track team allocation tables instantly.
Navigation & Discovery
Locate documents across complex hierarchies effortlessly with deep structural layouts and high-speed searching tools.

-
Command Center (Ctrl + K): A keyboard-driven global overlay allowing you to navigate the app, execute actions, or trigger contextual operations instantly.
-
Full-Text Indexing: Instant lookup with snippet highlights and precise relevancy sorting scores.

- Task Management: Every workspace includes integrated Kanban boards to organize objectives alongside your documentation.
Sovereign Assets & Storage Pipelines
Maintain total ownership over your binaries, media streams, and backups. Alexandrie relies on decoupled storage engines to preserve performance without external analytics dependencies.

-
S3 Integration: Native compatibility with decentralized modern object stores (such as RustFS, Garage, MinIO, or AWS).
-
Media Sandbox: In-app PDF view rendering and multi-format previewing for over 30 image, audio, and video formats.
-
Data Portability: Comprehensive ZIP import/export tools allow users to backup or restore selective nodes, metadata configurations, or entire platform states in a single action.
Quick Start
Get your instance running in less than a minute:
# 1. Download the .env.example and docker-compose.yml files
curl -O https://raw.githubusercontent.com/Smaug6739/Alexandrie/main/.env.example
curl -O https://raw.githubusercontent.com/Smaug6739/Alexandrie/main/docker-compose.yml
# 2. Configure environments
cp .env.example .env
# 3. Launch the stack
docker compose up -d
Open http://localhost:8200 to create your primary owner account.
For advanced local development guidelines and technical architecture details, please refer to CONTRIBUTING.md.