后悔没早用！Docker装思源笔记保姆级教程

思源笔记是一款以隐私优先、本地优先为核心定位的跨平台个人知识管理系统，它创新性地将 “块级编辑”、“大纲结构” 与 “双向链接” 深度融合，以 “内容块” 为核心单位 ，小到段落、标题，大到完整文档皆为可自由拖拽、重组、引用的块元素，能在细粒度上梳理思绪、构建知识关联。其支持 Markdown 所见即所得编辑及 LaTeX 公式、流程图等丰富格式，搭配可视化知识图谱与反向链接功能，可助力碎片化知识转化为系统化网络；同时通过端到端加密同步保障数据安全，既支持多设备离线使用，也可通过 Docker 部署或第三方存储实现自主托管，还集成了 AI 辅助、数据库管理、插件扩展等实用功能，适配个人知识整理、学术创作、项目规划等多种场景。

• 功能简介

  • 块级编辑：所有内容以 “块” 为基本单位，支持自由拖动、重组和嵌套，内置 20 多种类型的块元素和 10 多种行级元素，还可通过挂件块进行扩展

  • 双向链接：块之间可以相互引用，通过反向链接能发现潜在的知识关联，还可通过全局关系图和块级聚焦关系图可视化知识结构和链接路径

  • 大纲功能：列表大纲可用于快速组织具有逻辑层次的知识，标题块也支持强大的折叠功能，文档大纲和列表大纲优势互补

  • 丰富的格式支持：原生支持 Markdown，扩展支持表格、公式（LaTeX）、流程图（Mermaid）、思维导图等多种格式

  • AI 辅助：集成大语言模型，如接入 OpenAI，支持文本生成、摘要提取、语法检查等功能，助力高效创作

  • 多平台同步：支持 Windows、macOS、Linux、iOS、Android 多平台使用，并且可通过端到端加密技术实现数据同步

  • 所见即所得编辑：提供了所见即所得的编辑体验，用户在编辑时可以实时看到效果，无需手动切换预览模式

支持文档树、大纲显示

image-20251025105331420

一、思源笔记安装

1、拉取思源镜像

 docker pull b3log/siyuan

2、创建本地文件夹路径

 mkdir -p /opt/siyuan

3、使用Docker命令部署

 docker run -d -v /opt/siyuan:/siyuan/workspace -p 6806:6806 --name siyuan --restart unless-stopped b3log/siyuan --workspace=/siyuan/workspace/ --accessAuthCode 123456

--name siyuan：docker容器名

映射的目录为/opt/siyuan 访问密码是123456

端口为6806

4、Docker Compose配置

services: main: image: b3log/siyuan:v3.7.3 # v3.6.5 container_name: siyuan # 容器名称 command: - serve - --workspace=/siyuan/workspace - --accessAuthCode=admin123 environment: - TZ=Asia/Shanghai # 设定时区 - PUID=1000 - PGID=1000 ports: # 端口映射 - 6806:6806 # ：之前可以自行设定端口 volumes: # 文件夹映射 - ./workspace:/siyuan/workspace # ：之前可以自行设定路径 “./” 表示当前目录 restart: unless-stopped # 总是主机重启后启用容器 deploy: resources: limits: memory: 512m

思源笔记workspace目录：

image-20251025105807584

二、思源笔记使用

2.1、访问登录

http://{服务器地址}:6806，因为我们没有做https认证（没配置SSL，用http://就可以 ），端口号是 6806，密码是刚才的 accessAuthCode

image-20251025111204212

2.2、设置图床

推荐使用兰空Lsky图床

image-20251025112550912

2.3、如何升级思源笔记

1、重新拉取Docker镜像

 #拉取最新镜像  docker pull b3log/siyuan:latest

2、重新执行Docker安装命令

 docker run -d -v /opt/siyuan:/siyuan/workspace -p 6806:6806 --name siyuan --restart unless-stopped b3log/siyuan --workspace=/siyuan/workspace/ --accessAuthCode 123456

因为笔记保存在挂载的本地目录，升级数据不会丢失

2.4、使用插件&主题&图标&模板

2.4.1、插件管理

右上角插件-管理-集市打开

image-20251025112613949

image-20251025112706411

2.4.2、主题

image-20251025112859311

2.4.3、图标

image-20251025113011684

2.4.4、模板

image-20251025113040603

2.5、使用钉住，隐藏文档树

2.6、备份其他笔记

使用Memos插件同步Memos笔记

image-20251025112123826

Memos同步笔记配置

image-20251025112239921

2.7、思源浏览器扩展

扩展安装，支持Edge、Chrome等

1. 安装扩展，在扩展的选项中配置 API token（token 可在思源设置 - 关于中查看）

2. 在 Web 页面上选择需要剪藏的内容，然后在右键菜单中选择 “Copy to SiYuan”

3. 在思源中粘贴

FAQ：

1、思源笔记是如何存储数据的？

image-20251025111331282

• assets 用于保存所有插入的资源文件

• emojis 用于保存自定义图标表情图片

• snippets 用于保存代码片段

• storage 用于保存查询条件、布局和闪卡数据等

• templates 用于保存模板片段

• widgets 用于保存挂件

• plugins 用于保存插件

• public 用于保存公开的数据

• 其余文件夹就是用户自己创建的笔记本文件夹，笔记本文件夹下 .sy 后缀的文件用于保存文档数据，数据格式为 JSON

2、有的块找不到块标怎么办？

比如在列表项中的段落块

在列表项下的第一个子块是省略块标的。可以将光标移到这个块中，然后通过 Ctrl+/ 触发它的块标菜单

3、思源是开源的吗？

思源笔记是开源的，部分功能如多端同步（会员），免费版够用，支持多种客户端

• 浏览器访问

• Android 端

• iOS 端

• 鸿蒙端

• Chrome 剪藏扩展

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～