siyuan-note/siyuan · 上手攻略

• 仓库：siyuan-note/siyuan
• 链接：https://github.com/siyuan-note/siyuan
• 分类：skill（隐私优先知识管理）
• 作者：Tom
• 更新：2026-07-10

这是什么

SiYuan（思源笔记）是一款隐私优先、可完全自托管的个人知识管理（PKM）软件，使用 TypeScript + Go 双语言开发，Stars 约 4.5 万，周增约 +14。它以「块（Block）」为最小数据单元，支持块级引用和双向链接（类似 Roam Research / Obsidian），采用 Markdown 所见即所得（WYSIWYG）编辑体验，并内置数据库、闪卡记忆、PDF 标注、Web 剪藏、AI 写作等功能。

核心理念：你的数据永远属于你自己，不依赖任何云服务，数据以 JSON 格式存储在本地，支持 Docker 一键部署，也有 Android / iOS / HarmonyOS 原生 App。

解决什么问题

• 笔记散落各处无法串联：通过块级双向链接，将相关知识点自动串联，形成知识网络而非孤立笔记
• Obsidian 类工具数据安全顾虑：SiYuan 支持完全本地存储，无任何云端依赖，数据加密备份
• 需要数据库式笔记管理：内置「数据库」功能，用表格管理结构化数据（项目跟踪、阅读清单等）
• 知识复习遗忘：闪卡间隔重复功能帮助长期记忆
• PDF 学习标注：读论文时边读边标注，自动建立引用关系
• AI 辅助写作：集成 OpenAI API，提供 AI 写作和问答能力

快速安装

桌面端（推荐）

# Microsoft Store（Windows）
# https://apps.microsoft.com/detail/9p7hpmxp73k4

# GitHub Release 直接下载
# https://github.com/siyuan-note/siyuan/releases

# macOS / Linux 也可从 GitHub Releases 下载对应安装包

Docker 自托管服务器（无桌面环境）

# 基础启动命令
docker run -d \
  -v /siyuan/workspace:/siyuan/workspace \
  -p 6806:6806 \
  -e PUID=1001 \
  -e PGID=1002 \
  b3log/siyuan \
  serve \
  --workspace=/siyuan/workspace/ \
  --accessAuthCode=你的密码

# docker-compose.yml 示例
version: "3.9"
services:
  siyuan:
    image: b3log/siyuan
    container_name: siyuan
    command: ['serve', '--workspace=/siyuan/workspace/', '--accessAuthCode=${AUTH_CODE}']
    ports:
      - 6806:6806
    volumes:
      - /siyuan/workspace:/siyuan/workspace
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
      - PUID=1001
      - PGID=1002

⚠️ accessAuthCode 一定要设置，否则任何人可以访问你的数据！

移动端

# iOS App Store
# https://apps.apple.com/us/app/siyuan/id1583226508

# Google Play
# https://play.google.com/store/apps/details?id=org.b3log.siyuan

# F-Droid（开源构建）
# https://f-droid.org/packages/org.b3log.siyuan

# HarmonyOS
# https://github.com/siyuan-note/siyuan-harmony

核心用法

1. 块级引用与双向链接（核心特色）

在任意笔记中使用 ((块ID)) 引用其他块，被引用后会显示原始块内容并自动建立双向链接：

# 在「Java 并发」笔记中
关于 synchronized，参见 ((202107011023)) 中的详细分析。

# 被引用的块有自己的 ID（块级地址）
# 所有引用该块的笔记会在其「反向链接」面板显示

点击块 ID 可跳转到源块，点击反向链接面板中的引用可追踪所有引用者。

2. 文档结构与大纲

# 顶级标题 → 自动成为文档
## 二级标题 → 大纲中的可折叠节点

文档右上角「···」→「复制到剪贴板」可复制 Markdown
支持直接拖拽调整文档顺序

3. 数据库（块属性表格）

在任意文档中插入「数据库」块，可用表格管理结构化数据：

- 支持列类型：文本、数字、日期、选择、多选、标签、URL、邮件、块引用
- 可按列排序、筛选
- 适合：读书清单、项目任务、课程笔记

4. 闪卡间隔重复

# 创建闪卡
选中文字 → 右键 → 「设为闪卡」

# 复习
# 在工作空间右上角点击「复习」图标
# SiYuan 会根据 SM-2 算法安排复习时间

5. Web 剪藏

# Chrome/Edge 浏览器安装 siyuan-chrome 扩展
# https://github.com/siyuan-note/siyuan-chrome

# 剪藏整个页面内容为思源笔记文档
# 支持选中特定内容片段剪藏

6. OpenAI AI 辅助（需自备 API Key）

# 设置 → 右上角用户头像 → AI → 配置 OpenAI API Key 和模型
# 支持 AI 写作、AI 问答（在选中内容上触发 AI 对话）

7. 命令行 CLI

# 创建符号链接（macOS/Linux）
ln -s /Applications/SiYuan.app/Contents/Resources/kernel/SiYuan-Kernel /usr/local/bin/siyuan

# 列出所有笔记本
siyuan notebook list -w ~/SiYuan

# 全文搜索（JSON 输出，适合脚本）
siyuan search "关键字" -w ~/SiYuan -f json

# 导出文档为 Markdown
siyuan export md --id <块ID> -w ~/SiYuan

# 查看完整命令帮助
siyuan --help

8. 数据导出

# 桌面端：设置 → 导出
# 支持格式：Markdown、PDF、HTML、Word、.sy.zip（全量数据）

# 移动端：右侧栏 → 关于 → 导出数据

9. 插件市场（社区生态）

通过 bazaar 安装社区插件，扩展功能（如 LaTeX 增强、图床集成等）。

典型适用场景

坑与注意

1. accessAuthCode 必须设置：Docker 部署不设密码等于裸奔，数据完全暴露在公网。
2. 不支持第三方同步盘：SiYuan 明确不支持 OneDrive / iCloud / 百度网盘等同步盘直接同步，会导致数据损坏。云同步只能通过：① Docker 部署后 WebDAV 对接云存储（会员功能）；② 手动导入导出。
3. 数据格式为 JSON：.sy 文件是压缩 JSON，不方便直接编辑，适合备份而非跨工具迁移。
4. 部分功能需要付费会员：AI 写作、PDF 标注导出、云端同步等为会员功能，但核心功能（笔记、块引用、数据库、闪卡）全部免费。
5. Docker 导出功能受限：Nginx 反向代理模式下不支持导出 PDF/HTML/Word 和导入 Markdown 文件，仅支持浏览器端操作。
6. 学习曲线较陡：双向链接、块引用、属性等概念需要适应，建议先阅读官方文档（英文版 https://ld246.com 或内置引导文档）。
7. 移动端功能相对桌面端较弱：复杂编辑建议用桌面端，移动端适合查阅和快速记录。

与同类对比

结论：SiYuan 是中文用户最值得关注的本地优先 PKM 工具，兼顾 Obsidian 的可扩展性和 Roam 的双向链接原生体验，且完全无需网络。适合重视数据主权、愿意花时间构建个人知识体系的用户。

一句话推荐结论

SiYuan 以「块」重新定义了笔记的颗粒度，双向链接 + 数据库 + 闪卡 + 完全本地存储构成了一个可长期积累、不依赖云服务的个人知识系统——上手门槛高于普通笔记软件，但一旦建立工作流，它会成为你最有价值的第二大脑。