【威联通 QNAP】思源笔记 docker 部署及开启 S3 存储——个人笔记 24-02-24

通过威联通部署 Docker 版本思源以及使用威联通 QuObjects 作为 S3 云端同步服务器，DDNSTO 做内网穿透，个人部署笔记。

版本：思源 Docker 版 3.0.0 + QTS 5.1 + DDNSTO 插件 3.0.5

费用：思源笔记功能特性会员费用（￥64 永久） + NAS 费用（几百~几万） + DDNSTO 内网穿透 4Mbps（没公网 ip，1 年 ￥26）

Docker 版思源笔记部署

1. 创建工作空间文件夹

工作空间文件夹用于存储笔记内容和插件本体。Docker 版思源不像 PC 版本一样可以切换工作空间，貌似是一个容器对应一个工作空间。左上角显示的工作空间名称等同于之后创建容器时设定的 -workspace 目标文件夹名称，所以可以将目标文件夹设定为 xxx/SiYuan/Work 这样来更改左上角的显示名称，以和 PC 版本界面一致。

权限问题：

之前创建的时候发现笔记内容并不存储在设定的工作空间中，上网找了如下一些方法。重新创建容器后按照本文步骤走发现并不需要。如果有碰到设定的工作空间文件夹一直为空的情况的朋友可以参考一下：

1. 看网上群晖的教程提到了需要更改工作空间文件夹的【游客的访问权限】为无限制；
2. SSH 连接到威联通，开启 sudo -i 管理员权限后将目标工作空间文件夹设定为：chmod 777 Work（Work 为工作空间文件夹名称），将所有父目录都设定为 chmod 754 filename；

2. 提取映像

映像：b3log/siyuan

3. 创建容器

创建容器，在 ② 配置容器时点击高级设置，分别设置命令、网络和存储界面内容：

1） 命令

命令处选择覆盖：

-workspace /share/cache/Notes/SiYuan/Work -accessAuthCode xxxxxxx -lang zh_CN

其中：

-workspace：工作空间目录，选择之前创建的工作空间文件夹路径；

-accessAuthCode：初始登录页面密码；

-lang：默认语言，缺省值为英文。

2） 网络

都可选填，发布网络端口处可自定义主机端口（此为网页访问端口），容器端口不要动。

3） 存储

点击添加卷 ——》绑定装载主机路径

1. 主机选择之前创建的工作空间文件夹；
2. 容器重复 -workspace 中填写的路径。

4） 应用并创建容器

4. 打开网页进行测试

输入 ip 地址:设定主机端口，如 http://192.168.5.2:11005，密访问授权码即为 -accessAuthCode 所填写的登录密码。

之后登录账户同步云端数据即可。

威联通 S3 存储服务作为云端存储

之前使用七牛云的对象存储服务（10G 内免费，每月 10w 次请求免费），使用了他创建时提供的测试域名作为 EndPoint。一直用着即使测试域名过期了也没啥问题，但终归还是担心有一天突然断了导致无法使用，耗费时间替换，正好手头有之前随大流买的威联通 TS-464C2😭 ，看网上说有官方 APP 支持 S3 存储（其他品牌的 NAS 可以使用 Docker 版 MinIO 实现），于是后来就直接更换了（毕竟七牛云等厂商都有存储空间和存取次数限制）。又因为没公网，所以买了 DDNSTO 的 4Mbps 一年内网穿透套餐，作为 PC 及手机端的 EndPoint 链接入口，之后说明。

前提：登录思源账号且购买过云端存储付费功能

需购买功能特性会员，不贵且终身有效，开启 S3/WebDAV 数据同步备份功能。对有云端存储功能需求但是动手能力强的人来说合适。想要开箱即用那还是年付订阅吧。

1. 配置 QuObjects 应用，开启 S3 存储功能

其他 NAS 用户可通过 Docke 版 MinIO 开启该功能，具体教程请自行百度。

1）打开威联通 App Center，搜索 QuObjects 并下载安装。该应用可开启 NAS 的 S3 存储特性。

2）打开 QuObjects，选择用户管理，添加用户，并创建密钥

可以选择当前账户，也可以创建一个自定义账户 SiYuan 专门用作思源笔记本云存储账户（可以设定访问权限）：

然后点击操作下方的钥匙，创建该用户的密钥：

3）选择存储空间，并赋予刚才创建的用户以权限

存储空间在位置上类似于 QTS 系统的共享文件夹，可以选择现成的，也可以在该界面创建。

然后点击操作下的点点点，选择编辑：

在弹出的编辑存储空间窗口中选中刚才创建的用户，赋予其存储空间权限：

3）选择 Bucket，选择上一步选中的存储空间，创建新的 Bucket

Bucket 在位置上类似于存储空间下的普通文件夹，对应思源云同步设置的云端目录。直接选择现有 Bucket 或者创建新的 Bucket，其他高级选项不用变动（不是很懂就没动了）：

4）选择服务器设置，设定连接端口号、类型等信息，应用，然后复制 Amazon S3 服务端点

连接类型选择 HTTP 最省事，毕竟不管是本地 NAS 云同步还是远程云同步（DDNSTO 插件）都是在本地进行连接，不需要 https 证书加密，且不会导致思源无法使用的奇怪问题

【经尝试，NAS 上 Docker 版思源在云端设置 S3 本地同步时使用 HTTP 正常，使用 HTTPS 时 TLS Verify 需设置为 Skip；其他端通过 DDNSTO 远程 S3 同步时 QuObjects 连接类型（HTTP/HTTPS）都可设置，实测设为 HTTPS 时思源设置开启 TLS Verify，不会报错】

如果是其他远程连接类型（如公网 ip，DDNS 等）可以考虑启用 HTTPS 或者直接设置反向代理等方法。

Amazon S3 服务端点就是云同步需要连接的服务器地址 EndPoint。

2. 同步数据仓库密钥

这一步还是挺重要的，经常被我忘记 😂 。打开思源网页链接（如 http://192.168.5.2:11005），进入思源笔记本 Docker 版界面，先进入设置 ——》账号，登录思源账号；再进入关于：

如果是首次使用思源笔记，未在其他客户端上使用过，可以选择自动生成密钥或通过密码生成密钥；如果是已有使用过其他端思源笔记，注意那些端的思源笔记是否创建过数据仓库密钥，如果是的话直接导入密钥，或者通过相同密码生成密钥，一定要确保一致性！！！

3. 配置思源笔记云同步设置

进入设置 ——》云端：

1. EndPoint、Access Key、Secret Key：

在 QuObjects 界面 ——》用户管理处，点击之前选择的用户左侧箭头，再点击操作处第二个图标：

在弹出的密钥详细信息界面，存储空间选择之前赋予该用户权限的存储空间，下面的 Amazon S3 对应的三个信息分别就是 EndPoint、Access Key、Secret Key：

2. Bucket：填入 QuObjects 中选择/创建的 Bucket 名称即可

3. Region、Addressing、TLS Verify：

Region：网上其他教程填入 ap-east-1，应该没啥影响，随大流就好；

Addressing：选择 Path-style；

TLS Verify：因为 QuObjects 处服务器连接类型选择 HTTP，所以此处选择 Skip。

【经尝试，NAS 上 Docker 版思源设置 S3 本地同步时使用 HTTP 正常，使用 HTTPS 时 TLS Verify 需设置为 Skip；其他端通过 DDNSTO 远程 S3 同步时 QuObjects 连接类型（HTTP/HTTPS）都可设置，实测设为 HTTPS 时思源设置开启 TLS Verify，不会报错】

4. 启动云端同步：按钮打开

5. 云端同步目录：对应 Bucket 名称，选择即可

6. 返回主界面，点击左上角云同步按钮，如果同步成功则底栏会显示 已经同步数据快照

【选配】外网同步 NAS 的 S3 存储

此处选择 DDNSTO 作为内网穿透工具并提供外网 EndPoint 服务器地址，其他外网访问方法的用户只需替换对应的 EndPoint 地址即可。

1. 注册 DDNSTO 账号并安装插件

官方教程网址：https://doc.linkease.com/zh/guide/ddnsto/install/device/qnap.html

每个设备都可选择一个一周的免费体验套餐，坏处就是需要一周后再次重新手动选择该套餐，所以最终本人还是付费了 👍 ，毕竟最基础的 4Mbps 套餐不算贵，速度也够了。

2. 设定域名映射

点击添加域名映射，填写：

1. 主域名：填写自定义域名，例如 s3-siyuan;
2. 目标主机地址：填写之前 QuObjects 上得到的 Amazon S3 服务端点。

同理，想要远程访问 NAS 端的 Docker 版思源，当作网页版思源使用，也可在此映射思源容器的主机 ip 地址:主机端口（如 http://192.168.5.2:11005）

3. PC&手机端 S3 云同步设定

PC&手机端的 S3 云同步设置，只需更改 EndPoint 为 DDNSTO 上关联的域名即可：