思源笔记 搭建教程 – 搭建你的私有知识管理系统

一、思源笔记是什么

思源笔记（SiYuan Note）是一款开源的本地优先的个人知识管理系统。它支持 Markdown 所见即所得编辑、块级引用、双向链接、全文搜索，你可以把它理解为自己掌控数据的 Notion 或 Obsidian。

它的核心特点：

• 本地优先：所有数据存储在本地设备上，离线也能正常使用。你的笔记数据完全由你自己掌控，不依赖任何云端服务。
• 块级引用：每个段落、列表项、表格单元格都是一个独立的”块”，可以被单独引用和嵌入到其他文档中。
• 双向链接：和 Obsidian 一样，支持 [[关键词]] 创建文档链接，自动显示反向链接关系，帮你构建知识网络。
• 所见即所得：编辑体验接近 Word 和 Notion，不需要在源码模式和预览模式之间来回切换。
• 内容块拖拽：可以像 Notion 一样拖拽段落、列表、表格，自由排版。
• 同步功能：官方提供付费同步服务，也可以自己用 S3 或 WebDAV 搭建同步（数据始终加密，云端无法解密）。
• Web 版部署：可以在服务器上部署 Web 版，通过浏览器随时随地访问你的笔记。
• 完全开源免费：GitHub 仓库：https://github.com/siyuan-note/siyuan

二、你需要准备什么

准备项	说明
个人电脑（方式一）	Windows/Mac/Linux 均可，安装桌面客户端即可使用
云服务器（方式二）	如果要部署 Web 版随时随地访问，需要一台云服务器（1 核 2G 以上）

三、部署方式一：桌面客户端（最简单，个人使用首选）

如果你只是在个人电脑上记笔记，不需要在手机上访问，安装桌面客户端是最简单的方式。

3.1 下载思源笔记

1. 打开浏览器，访问思源笔记官网：https://b3log.org/siyuan/download.html
2. 根据你的操作系统，点击对应的下载按钮：
   • Windows：下载 .exe 安装包
   • macOS：下载 .dmg 文件（注意区分 Intel 芯片和 Apple Silicon 芯片版本）
   • Linux：下载 .AppImage 文件

3.2 安装并启动

1. Windows：双击下载的 .exe 文件，按提示安装。建议安装到 D 盘等非系统盘。
2. macOS：双击 .dmg 文件，把思源笔记图标拖到 Applications 文件夹。
3. Linux：右键 .AppImage 文件 → 属性 → 权限 → 勾选”允许执行文件”，然后双击运行。

3.3 首次启动设置

1. 启动思源笔记后，会弹出”选择工作空间”窗口。
2. 工作空间就是你存放所有笔记的文件夹。点击”新建”，选择一个你方便找到的位置（比如 D 盘或文档文件夹），创建一个文件夹命名为 SiYuan。
3. 选择这个文件夹作为工作空间，点击”打开”。
4. 首次进入会要求设置访问授权码。这个密码用于保护你的笔记数据，也是后续通过浏览器访问时的登录密码。请设置一个你能记住的密码。
5. 设置完成后进入主界面，可以开始写笔记了。

3.4 基本使用

• 创建文档：左侧文档树中，点击 + 号，输入文档标题。
• 编辑内容：在右侧编辑器中直接输入文字，支持 Markdown 语法。输入 / 可以唤出快捷菜单，插入标题、列表、表格、代码块等。
• 双向链接：输入 (( 可以搜索并引用已有文档块。输入 [[ 可以创建到其他文档的链接。
• 全局搜索：按 Ctrl+P（Mac 是 Cmd+P）打开搜索框，可以搜索所有笔记内容。

四、部署方式二：Docker 部署 Web 版（适合随时随地访问）

如果你希望在手机上、公司电脑上都能访问同一个笔记库，可以在云服务器上部署 Web 版。通过浏览器访问，界面和桌面版完全一致。

4.1 连接到你的云服务器

Windows 用户：使用 FinalShell 或 Xshell 连接服务器。
Mac 用户：打开终端，输入 ssh root@你的服务器IP。

4.2 安装 Docker（如果还没装）

curl -fsSL https://get.docker.com | bash
sudo systemctl start docker
sudo systemctl enable docker
docker --version

4.3 创建数据目录并启动容器

# 创建数据目录
mkdir -p ~/siyuan/data

# 启动容器
docker run -d \
  --name siyuan \
  --restart unless-stopped \
  -p 6806:6806 \
  -v ~/siyuan/data:/siyuan/workspace \
  -e SIYUAN_ACCESS_AUTH_CODE=请设置一个复杂的访问密码 \
  b3log/siyuan:latest

命令逐行解释：

• -d：后台运行容器。
• --name siyuan：给容器起个名字叫 siyuan。
• --restart unless-stopped：容器崩溃或服务器重启后自动重启。
• -p 6806:6806：把服务器的 6806 端口映射到容器内的 6806 端口。思源笔记默认使用 6806 端口。
• -v ~/siyuan/data:/siyuan/workspace：把服务器上的 ~/siyuan/data 目录挂载为工作空间。你的笔记数据会保存在这个目录中，删除容器后数据不会丢失。
• -e SIYUAN_ACCESS_AUTH_CODE=你的密码：设置访问密码。这是必填的环境变量，用于登录验证。务必设置一个复杂的密码。

4.4 放行端口

去云服务商控制台 → 安全组 → 入方向规则，添加：

• 协议：TCP
• 端口：6806
• 来源：0.0.0.0/0

4.5 访问思源笔记

1. 浏览器访问 http://你的服务器IP:6806
2. 输入你在环境变量中设置的访问密码。
3. 登录成功后，界面和桌面版完全一样。

现在你可以在任何地方通过浏览器访问你的笔记了。

4.6 配置 Nginx 反向代理（可选，让访问更优雅）

如果你有自己的域名，可以通过 Nginx 反向代理实现用域名访问，并配置 HTTPS。

# 安装 Nginx
sudo apt install -y nginx

# 创建配置文件
sudo nano /etc/nginx/sites-available/siyuan

粘贴以下内容（把 note.yourdomain.com 换成你的域名）：

server {
    listen 80;
    server_name note.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:6806;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

# 启用配置
sudo ln -s /etc/nginx/sites-available/siyuan /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

然后在域名服务商处添加 A 记录指向服务器 IP，就可以用 http://note.yourdomain.com 访问了。

五、思源笔记同步方案

如果你在多个设备上使用思源笔记（比如家里电脑 + 公司电脑 + 手机），就需要同步笔记数据。思源笔记提供了以下同步方案：

方案一：官方同步（付费，最稳定）

在思源笔记中点击右上角”云端”图标 → 登录账号 → 购买订阅 → 开启同步。官方同步端到端加密，官方也无法查看你的笔记内容。

方案二：自建 WebDAV 同步（免费，需要一台服务器或 NAS）

如果你已经有云服务器或 NAS，可以在上面搭建 WebDAV 服务（比如用 Alist、Cloudreve、或者单独的 WebDAV 服务），然后在思源笔记中配置 WebDAV 地址、用户名、密码来同步。

方案三：S3 兼容存储同步（免费或低成本）

如果你有阿里云 OSS、腾讯云 COS、Cloudflare R2（免费 10GB）等 S3 兼容的对象存储，可以直接在思源笔记中配置 S3 同步。

六、常见问题

Q1：忘记访问授权码怎么办？

如果使用 Docker 部署，可以通过环境变量重新设置：停止并删除容器，重新启动时指定新的 SIYUAN_ACCESS_AUTH_CODE。如果使用桌面版，在安装目录下找到 conf.json 文件，修改其中的 accessAuthCode 字段。

Q2：访问 6806 端口打不开

检查云服务商安全组是否放行了 6806 端口。检查服务器防火墙：Ubuntu 执行 sudo ufw allow 6806。

Q3：如何升级思源笔记？

• 桌面版：在设置中点击”检查更新”，自动下载并安装。
• Docker 版：docker pull b3log/siyuan:latest && docker stop siyuan && docker rm siyuan，然后重新执行 docker run 命令。

Q4：Docker 部署的数据存在哪里？

数据存在你挂载的目录中（本教程用的是 ~/siyuan/data）。删除容器不会丢失数据，只要这个目录还在，重新启动容器后笔记数据依然存在。

七、总结

思源笔记是一款功能强大、注重隐私的开源笔记工具。部署方式总结：

• 个人单机使用：下载桌面客户端，选择工作空间，即可开始使用。
• 多设备/远程访问：在云服务器上用 Docker 部署 Web 版，浏览器随时随地访问。
• 多设备同步：使用官方同步（付费）或自建 WebDAV/S3 同步（免费）。

项目地址：https://github.com/siyuan-note/siyuan
官网：https://b3log.org/siyuan/