飞牛NAS上搭建思源笔记软件

简介

思源笔记 是一款开源、注重隐私的本地化优先笔记软件，主要特点包括：

• 数据本地存储：笔记保存在本地，支持通过 S3/WebDAV 同步或手动备份，数据完全由自己掌控
• 块级编辑器：内容以”块”为单位组织，支持块引用、块嵌入、双链关联，方便构建知识网络
• Markdown 支持：所见即所得编辑，同时兼容标准 Markdown 导入导出
• 知识管理能力：支持标签、笔记本、大纲、关系图/全局关系图、反链等知识管理功能
• 自定义与扩展：提供插件 API、桌面挂件、自定义片段、模板等扩展能力
• 多端可用：支持 Windows、macOS、Linux、Android、iOS 及浏览器端，可自建服务器部署（如本篇介绍的 NAS Docker 部署）

部署命令

Docker部署命令

services:
  siyuan:
    image: b3log/siyuan
    container_name: siyuan
    restart: unless-stopped
    # 使用 host 网络模式，让容器直接使用飞牛NAS的网络
    network_mode: "host"
    # 注意：使用 host 模式后，访问端口直接由 command 中的 --port 决定
    environment:
      TZ: Asia/Shanghai
      PUID: "1000"
      PGID: "1000"
      SIYUAN_LANG: zh-CN
      SIYUAN_COOKIE_KEY: "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"
    volumes:
      - /vol1/1000/docker/siyuan/workspace:/siyuan/workspace
    command:
      - serve
      - --workspace=/siyuan/workspace/
      - --accessAuthCode=123456
      - --port=6806

• environment: 环境变量

  • TZ: Asia/Shanghai：容器时区
  • PUID: "1000"：容器内运行思源的用户 UID
  • PGID: "1000"：对应的组 GID
  • SIYUAN_LANG: zh-CN：界面语言
  • SIYUAN_COOKIE_KEY：会话 Cookie 签名密钥

• ⁠volumes:格式宿主机绝对路径:容器内路径（思源的笔记、配置 conf.json 、数据库 temp/*.db 、TLS 证书全部落在左边这个目录里 → 只要这个目录在，删容器不丢数据。）

• ⁠command: 启动命令

  • --workspace=/siyuan/workspace/：指定工作空间路径
  • --accessAuthCode=123456：访问授权码（锁屏密码）
  • --port=6806：内核 HTTP 服务监听端口

cookieKey值生成

1. 用 openssl

openssl rand -hex 32

2. 用 Python

python3 -c "import secrets; print(secrets.token_hex(32))"

使用

部署完成，输入123456解锁访问

插件/主题/挂件

安装方式，右上角设置，集市安装

• 插件

  • 仪表盘：思源笔记数据统计插件
  • 思源Draw.io插件：Draw.io以插件形式集成到思源中
  • 资产管理：资产管理插件
  • 表情市场：表情市场为思源笔记提供海量图标，在表情面板中即可搜索替换文档图标或插入表情
  • 编辑器增强：对现有的siyuan公式编辑器进行增强
  • 看板娘/桌宠：一个笔记宠物，桌面宠物包下载：https://codex-pet.org/pets
  • PicGo图床：PicGo 图床以插件形式集成到思源中
  • 发布工具：思源笔记的文章发布到30+平台，开源、免费
  • 任务笔记管理：一款在思源笔记里实现任务管理功能的插件

• 主题

  • 積読

• 挂件

  • 列出子文档：在挂件里显示文档/大纲列表，或向文档中插入文档/大纲列表

更新

⁠只要这个目录（ /vol1/1000/docker/siyuan/workspace）在，删容器是不丢数据。比如==更新==只需要删除容器在重新部署一下即可。

问题

[!NOTE] ✏️ 在使用智能体在笔记上插入内容的时候报错如下
auto snapshot failed, operation aborted: 请先在 [设置 - 账号与同步 - 本地数据仓库 - 数据仓库密钥] 中初始化数据仓库密钥

按照报错的步骤操作就可以了，最终结果如下图