Smaug6739/Alexandrie
GitHub: Smaug6739/Alexandrie
一个开源自托管的离线优先知识库平台,提供高级 Markdown 编辑、多租户团队协作和企业级权限管理,可作为 Notion、Confluence 和 Obsidian 的私有化替代方案。
Stars: 2223 | Forks: 137

# Alexandrie
**一个带有增强版 Markdown 编辑器的自托管开源知识库。**
在任何设备上组织、搜索、分享和导出你的笔记,甚至支持离线使用。

## 为什么选择 Alexandrie?
Alexandrie 是一个开源的自托管 wiki 和知识管理平台,专为团队和个人构建。它结合了强大的 Markdown 编辑器、离线支持、协作工具以及企业级的权限管理,是 Notion、Confluence 和 Obsidian 的替代方案。
- **一键部署:** 使用 Docker 瞬间启动整个全栈应用程序。
- **高级 Markdown 引擎:** 原生支持 LaTeX、自定义容器、交互式复选框、frame、snippet 以及集成的图表构建。
- **精细化组织:** 支持 Team、Workspace、Category 和嵌套 Document 的多租户架构。
- **离线优先的 PWA:** 安装在任何桌面或移动设备上,具备完整的离线功能和无缝同步。
- **生产就绪:** 内置 OpenID Connect (OIDC) SSO 提供商、自动化的全系统备份/恢复 pipeline,以及强大的媒体存储架构。
## 核心功能
### 高级写作与富 Markdown
Alexandrie 配备了一个专为技术写作量身定制的增强版 CodeMirror 6 环境。它可以无缝处理复杂的学术区块、自定义样式、全局主题对齐以及实时滚动同步。

- 语音转文字:使用集成的语音识别 API,直接在编辑器中口述笔记。
- 原生图表:直接在 Markdown 流中创建、编辑和渲染流程图或结构图。
- Snippet 管理器:保存、重用以及导入/导出常用模板或代码片段。
### Team Workspace 与访问控制
通过清晰的层级结构和严格的隔离来管理多用户环境。通过唯一的公开链接或细粒度的群组规则,在组织间安全地共享知识。

- 5 级访问模型:针对每个节点或 Workspace,精细调整用户权限,包括 None、Read、Write、Admin 和 Owner 身份。
- 企业级运营:生成临时邀请码、配置自定义 scope,并即时追踪团队分配表。
### 导航与发现
借助深度的结构布局和高速搜索工具,轻松跨越复杂的层级结构定位文档。

- 命令中心 (Ctrl + K):一个基于键盘驱动的全局覆盖层,允许你导航应用程序、执行操作或即时触发上下文操作。
- 全文索引:即时查找,带有 snippet 高亮显示和精确的相关性排序分数。

- 任务管理:每个 Workspace 都包含集成的 Kanban 板,以便在文档旁边组织目标。
### 主权资产与存储 Pipeline
完全掌控你的二进制文件、媒体流和备份。Alexandrie 依靠解耦的存储引擎来保持性能,且不依赖外部分析工具。

- S3 集成:与现代去中心化对象存储(如 RustFS、Garage、MinIO 或 AWS)原生兼容。
- 媒体沙盒:应用内 PDF 查看渲染,支持对超过 30 种图像、音频和视频格式进行多格式预览。
- 数据可移植性:全面的 ZIP 导入/导出工具允许用户通过单个操作,备份或恢复特定的节点、元数据配置或整个平台状态。
## 快速开始
只需不到一分钟即可让你的实例运行起来:
```
# 1. 下载 .env.example 和 docker-compose.yml 文件
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. 启动 stack
docker compose up -d
```
打开 http://localhost:8200 创建你的主要 Owner 账户。
有关高级本地开发指南和技术架构的详细信息,请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md)。
标签:ASN信息, Markdown编辑器, OIDC/SSO, PWA, 协作平台, 本地部署, 漏洞探索, 版权保护, 知识库管理, 请求拦截