Alexandrie — 在你自己的服务器上部署知识库，支持离线模式和人类可读的 Markdown
知识库的永恒困境通常归结为在云端和本地文件之间做出选择。一方面，有 Notion 或 Confluence，配置团队访问很方便，但你的数据存放在别人的服务器上。另一方面，有 Obsidian，一切都存储在纯 Markdown 中，但同步和协作很快就会变成插件配置和变通方案。
我最近偶然发现了 Alexandrie 项目。作者试图将团队维基熟悉的 Web 界面、自托管解决方案的独立性和离线访问结合在一起。这是一款有趣的工具，只需一条命令就可以在自己的服务器上部署。
项目内部结构
Alexandrie 前端使用 Vue / Nuxt，后端使用 Go。它是一个功能完整的 Web 应用，样式化为 PWA（渐进式 Web 应用）。你可以将其安装到桌面或手机上，无需网络连接即可继续打开笔记。
核心是 CodeMirror 6，针对技术写作进行了增强。
编辑器有几个通常在标准维基中缺失的贴心功能：
- LaTeX 公式支持和内置的图表构建器，直接在文本中操作。
- 源文件和预览面板之间的同步滚动。
- 通过 Web Speech API 进行语音输入，快速口述想法。
- 代码片段管理器，用于快速插入重复的 API 描述或 bug 报告模板。
工作区结构和访问权限
为了团队协作，这里有清晰的层级结构。空间划分为团队、工作区、分类和嵌套文档。
权限模型包含五个级别：无、读取、写入、管理员和所有者。你可以授予某人只读权限访问特定文档分支，或通过唯一的公开链接外部共享页面。
对于企业环境，包含了通过 OIDC 的 SSO 集成。因此，将身份验证链接到 Keycloak 或 Authentik 不会有问题。
搜索和工作流程组织
知识库中的搜索通常要么缓慢，要么需要单独的 Elasticsearch 集群。Alexandrie 内置了全文索引，支持高亮搜索结果和相关性排名。
按 Ctrl + K 打开命令面板。从那里，你可以跳转到页面、触发快速操作和切换上下文，无需使用鼠标。
看板也内置在每个工作区中。当你需要运行一个小型的任务追踪器，同时配合规格说明和技术文档时，这很方便，无需切换到第三方追踪工具。
文件存储和备份
图片、视频和附件不会让数据库膨胀。该应用可以与 S3 兼容的存储配合使用，无论是 MinIO、Garage、RustFS 还是云服务提供商。
界面包含内置的三十种媒体文件格式查看器，包括嵌入式 PDF 渲染器。
导出也很简单：随时可以下载包含所有文档和元数据的 ZIP 归档，或从这样的归档恢复系统状态。没有专有格式锁定——你获得的是正常的文件输出。
如何启动
整个技术栈通过 Docker Compose 部署，只需几分钟即可完成。
启动后，界面可在 http://localhost:8200 访问，初始设置向导会提示你创建所有者账户。
这个项目适合谁
如果你需要开发团队的内部知识库或家庭服务器上的个人笔记存档，Alexandrie 看起来是一个可靠的选择。它没有 Confluence 的臃肿，也没有 Notion 的云依赖。
当然，这个项目比老牌巨头更年轻，社区规模也还不大。但现成的 Docker 镜像、带离线访问的 PWA 和 S3 支持的组合，使其成为那些重视数据控制权的人的一个便捷工具。
相关项目