Synology DSM 7.2.2 安装思源笔记记录

2025-03-10 15:00 CST

q0wkp

本文基于 CC BY-SA 4.0 协议发布

‍

1 准备

1.1 创建工作空间文件夹

在你喜欢的位置创建思源笔记的工作空间文件夹, 此后所有思源笔记的文件都会存在这里.

1.2 创建用户

创建一个非管理员组的用户, 然后赋予该用户工作空间所在的共享文件夹的访问权限. 该用户将全权负责思源笔记运行时读写工作空间的任务. 之后我们会在 2 工作空间文件夹设置 中使用该用户.

2 工作空间文件夹设置

3 Docker 设置

3.1 PUID 和 PGID

PUID 和 PGID 实际上就是 docker 内负责运行思源的默认用户 "siyuan" 的 UID 和 GID. 为了让 "siyuan" 拥有读写工作空间的权限, 我们需要让他的 UID 和 GID 与 1.2 创建用户 中我们我们创建的用户相同. 下面是如何获取 UID 与 GID 的方法:

1. 通过 SSH 连接至群晖

2. 执行 id <用户名> 命令, 其中 <用户名> 处填写你在 1.2 创建用户 中创建的用户的用户名

3. 你会得到类似下面的结果:

   uid=1027(test_user) gid=100(users) groups=100(users),65538(permission)
   ​

   其中 uid 后面的数字即为 UID, 填在 PUID 处; 同理 gid 后面的数字为 GID, 填在 PGID 处

3.2 SIYUAN_WORKSPACE_PATH 和 SIYUAN_ACCESS_AUTH_CODE

这两个环境变量与一些教程里在执行命令中加的 -workspace /siyuan/workspace 和 -accessAuthCode <访问授权码> 是等价的, 所以如果设置了这两个环境变量执行命令里就不用加这两条命令了.

4 Q&A

4.1 有些教程里直接赋予思源笔记工作空间 Everyone 完全控制权限, 为什么你不这么做?

首先, 这种做法从信息安全的角度而言是不可取的. 其次, 对于我的情况而言, 我的 NAS 不止我一个人在用, 但思源笔记是我私人的, 因此我只希望我自己具有思源笔记文件的访问权限.

当然, 虽然我不建议, 但如果你懒得折腾权限问题, 并且 NAS 只有你自己用的话, 你也可以直接给 Everyone 赋予完全控制权限.

4.2 我看有些教程里把工作空间文件夹设置在 docker 共享文件夹下

只要权限配置好, 工作空间文件夹设置在哪里都可以, 不一定非得要设置在 docker 共享文件夹下.

(docker 共享文件夹权限太高了, 所有用户都默认有只读权限, 所以我一般都不用)

5 参考资料

还可以参考这篇帖子, 虽然是两年多前写的了, 但配置流程基本上是相同的:

群晖 DSM7.1.1 docker 部署思源笔记 2.5.4，成功映射工作目录