思源笔记 云端服务（八）

8.云端服务

涵盖官方云端同步、第三方存储配置、Docker 自部署等内容。

一、云端服务概述

  • 思源笔记是本地优先软件，无网络也可使用。

  • 云端服务：多设备间同步笔记内容。

  • 主要分为两类：

    • 订阅会员：可使用官方云存储，简单易用。
    • 终身会员：可对接第三方 S3 / WebDAV 存储（需一定技术能力）。

  • 普通用户建议直接使用订阅模式。

二、使用官方云端同步

1. 前提条件

  • 登录思源笔记账号，并处于订阅有效状态。

  • 在 设置 → 关于 → 数据仓库密钥 中设置密钥（需所有同步设备使用相同密钥）。

    • 密钥三种生成方式：导入密钥、自动生成、密码生成。
    • 推荐使用密码生成（所有设备输同一密码即可）。

2. 云端设置

  • 路径：设置 → 云端
  • 官方免费存储空间：8GB
  • 可通过链滴论坛积分兑换更大空间。

3. 同步目录

  • 默认目录名为 Main​，与本地工作空间 data/ 文件夹一一对应。
  • 密钥更改后需新建云端同步目录（点击“添加”）。
  • ⚠️ 不要同时使用第三方网盘（如 iCloud、百度云）同步思源笔记文件夹，易导致数据损坏。

4. 同步方式（三种模式）

模式 行为 适用人群
自动同步 启动/退出时同步，使用中数据30秒无变化后自动同步 普通用户（推荐）
手动同步 仅启动/退出时同步，使用中需手动触发 希望部分控制
完全手动同步 启动/退出不同步，全手动控制时机和方向 高级用户

自动同步以最新修改时间覆盖旧文件。如误覆盖，可通过数据快照/文件历史恢复。

三、使用第三方存储（S3 / WebDAV）

适合终身会员或有技术能力的用户，数据端到端加密，服务商无法读取内容。

1. 支持的协议

  • S3 协议：对象存储，如阿里云 OSS、七牛云、Cloudflare R2、MinIO 等。
  • WebDAV 协议：如 InfiniCLOUD、NAS（群晖、威联通）等。

2. 配置示例（阿里云 OSS）

步骤概览

  1. 购买阿里云 OSS 存储（需付费）。
  2. 创建 Bucket。
  3. 创建子账号并分配权限。
  4. 配置 Bucket 授权。
  5. 在思源笔记中填入参数。

详细操作

① 创建 Bucket

  • 登录阿里云控制台 → 对象存储 OSS → Bucket 列表 → 创建 Bucket。
  • 填写：名称、地域（选最近的）、存储类型（标准存储），其余默认。

② 创建子账号（AccessKey）

  • 右上角头像 → AccessKey 管理 → 开始使用子账号 AccessKey。
  • 创建用户 → 填写登录名/显示名 → 勾选 Open API 调用访问 → 确定。
  • 保存生成的 AccessKey ID 和 AccessKey Secret（只显示一次）。

③ 赋予子账号权限

  • 右上角头像 → 访问控制 → 用户 → 添加权限 → 选择 AliyunOSSFullAccess。

④ 配置 Bucket 授权

  • 返回 Bucket 列表 → 点击创建的 Bucket → 权限控制 → Bucket 授权策略 → 新增授权。
  • 授权资源：整个 Bucket；授权用户：子账号；授权操作：完全控制。

⑤ 思源笔记中填入参数

  • 路径：设置 → 云端 → 云端存储服务提供商 → 选择 S3。

  • 填写：

    • ​Endpoint：OSS 提供的 Endpoint（地域节点）
    • ​Access Key：子账号的 AccessKey ID
    • ​Secret Key：子账号的 AccessKey Secret
    • ​Bucket：创建的 Bucket 名称
    • ​Region​：地域（如 cn-beijing）

其他第三方 S3/WebDAV 配置逻辑类似，需获取对应服务商的参数。

3. 费用说明

  • 第三方存储需自行支付存储费用和流量/请求费用。
  • 长期使用成本可能高于官方订阅，适合有特殊需求或已有云资源的用户。

四、Docker 自部署

适合计算机专业学生、开发者、喜欢折腾的用户。部署后可通过浏览器访问，完全掌控数据。

1. 准备工作

  • 一台云服务器（或 NAS、树莓派等），需有公网 IP 或可内网穿透。
  • 本例以阿里云 ECS 为例（非广告，仅演示）。

2. 云服务器配置（简要）

  • 创建 ECS 实例：

    • 系统：Ubuntu 20.04
    • 系统盘：50GB 足够
    • 网络：分配公网 IPv4，带宽按需
    • 安全组：开放 22（SSH）和 6806（思源默认端口）的 TCP 入站规则

  • 登录方式：使用密钥对

3. 安装 Docker（在服务器上）

# 更新软件包
sudo apt update

# 安装依赖
sudo apt install apt-transport-https ca-certificates curl software-properties-common

# 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 添加 Docker 仓库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

# 安装 Docker
sudo apt install docker-ce

# 启动并设为开机自启
sudo systemctl start docker
sudo systemctl enable docker

# 检查运行状态
sudo systemctl status docker

4. 部署思源笔记 Docker 容器

# 拉取思源笔记镜像
docker pull b3log/siyuan

# 运行容器
docker run -d \
  --name siyuan \
  --restart=always \
  -v /data/siyuan/workspace:/siyuan/workspace \
  -p 6806:6806 \
  b3log/siyuan \
  --workspace=/siyuan/workspace

说明：

  • ​-v 挂载工作空间到宿主机（持久化数据）
  • ​-p 映射端口（宿主机:容器）
  • ​--restart=always 保证开机自启

5. 访问与配置

  • 浏览器访问 http://<服务器公网IP>:6806
  • 首次加载稍慢，出现思源 Logo 即成功。
  • 界面默认英文，进入 设置 → 外观 → 语言 切换为简体中文。

6. 移动端访问

  • 手机浏览器输入同一地址即可，响应式设计。

7. 进阶（可选）

  • 绑定域名（需 DNS 解析 + Nginx 反向代理）
  • 启用 HTTPS（Let’s Encrypt）
  • 使用 Docker Compose 管理
  • 配置外部存储（S3/WebDAV）作为备份

Docker 部署后，所有数据保存在服务器上，可定期备份容器挂载的 workspace 目录。

五、总结与建议

方案 适合人群 优点 缺点
官方订阅 普通用户、不想折腾 即开即用，稳定省心 需付费，存储空间有限
第三方 S3/WebDAV 终身会员、有技术基础 数据自控，可扩容 需自行购买存储，配置较复杂
Docker 自部署 开发者、自建服务器 完全掌控，无限扩展 需维护服务器，网络/安全需自己负责
  • 新手首选官方订阅，稳定且易用。
  • 数据安全提醒：无论哪种方式，定期备份工作空间（尤其是 data/ 文件夹）都是好习惯。
  • 不建议将思源工作空间直接放在 iCloud、OneDrive 等网盘同步目录中，易导致文件损坏。