SiYuan：隐私优先的开源知识库

项目简介

SiYuan（思源笔记）是一个隐私优先的个人知识管理系统，采用本地优先（local-first）设计，支持自托管部署。它以内容块为核心组织信息，提供 Markdown 所见即所得编辑体验，并面向「人与智能体协作」的场景设计。

主要功能

• 内容块：块级引用与双向链接、自定义属性、SQL 查询嵌入、siyuan:// 协议链接
• 编辑器：块式编辑、Markdown 所见即所得、列表大纲、块放大、百万字大文档编辑
• 富内容：数学公式、图表、流程图、甘特图、时序图、五线谱等；支持网页剪藏与 PDF 标注链接
• 导出：块引用与嵌入导出、带资源的标准 Markdown、PDF / Word / HTML，可复制到微信公众号、知乎、语雀
• 数据库：表格视图；支持数据库自动化（版本更新中新增收集块引用、属性名子串与正则匹配等能力）
• 学习与 AI：闪卡间隔重复、通过 OpenAI API 进行 AI 写作与问答、Tesseract OCR
• 其他：多标签页与拖拽分屏、模板片段、JavaScript/CSS 片段、社区集市（插件与主题）
• 多端：Android / iOS / HarmonyOS App，桌面端与 Docker 部署，并提供 API

安装与使用

桌面端与移动端建议优先通过应用市场安装，便于后续一键升级：

• 移动端：App Store、Google Play、F-Droid
• 桌面端：Microsoft Store
• 安装包：B3log 下载页、GitHub Releases

也可以使用 Docker 自托管，镜像名为 b3log/siyuan。注意自 v3.7.0 起需要显式传入 serve 子命令：

docker run -d -p 6806:6806 \
  -v workspace_dir_host:workspace_dir_container \
  b3log/siyuan serve \
  --workspace=workspace_dir_container \
  --accessAuthCode="${AuthCode:?Set AuthCode}"

--workspace 指定工作空间目录，--accessAuthCode 为锁屏密码，更多参数可通过 --help 查看。此外还提供 Kubernetes、Unraid、TrueNAS 等托管方式说明。

注意事项

• 项目采用 AGPL-3.0 许可证，大部分功能免费，包括商用；部分功能仅对付费会员开放，详见官方定价页。
• 支持通过第三方同步盘进行数据同步，也内置数据仓库快照、同步与恢复能力；升级前建议同步更新所有访问同一份数据的设备，并确认插件兼容性。
• 自 v3.8.9 起文档标题可以包含 /，请使用新版本打开和编辑这类文档，避免旧版本覆盖改动。

本作品整理自 GitHub 开源项目 siyuan-note/siyuan，原作者 @siyuan-note，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。