如何安全地在线分享思源笔记中的文档——叶归在线分享功能 v0.1.0

本篇地址：https://wetoria.vip/siyuan/blocks/20250815205637-ms933xj

你可前往该地址拥有更好的阅读体验。

叶归

众所周知，想要分享思源中的文档给别人是比较麻烦的一件事情，

目前已知思源笔记有如下分享方案：

方案一：思源笔记自带的发布功能

方案二：思源笔记的在线分享插件

方案三：导出文档

他们多多少少都存在着一些不方便的地方。例如：

方案一会完整的公开你的思源内容，做不到单独分享某一篇文档。

方案二虽然有自己的优势，比如利用 GitHub Pages 等平台免费分享，但是在内容分享的时效性和分享内容的样式效果上面略微差了点味道。

方案三则是最难受的一种，如果内容有调整，每次还得重新导出文档发给对方。

基于以上种种原因，我做了 叶归在线分享 这个项目，而现在，你能安全地在线分享你在思源笔记里写的内容了。

‍

功能介绍

‍

一、近乎原样的文档样式

对于基础的 Markdown 格式来说，基本上都能保持思源中的样式效果。针对 HTML、代码块、嵌入块、数据库块等类型，目前还没有做优化处理。

下图是一个演示效果，左侧为在线分享的内容，右侧为思源中的内容。你可以通过 https://wetoria.vip 这个地址进行查看。

PS：在维护 叶归 ｜ 一键记事 - 如何在思源笔记中捕捉你的灵感 这篇文档时，所有带颜色的内容，都是通过叶归格式刷功能，在思源里直接完成。

‍

‍

二、极其便利的文档链接/跳转功能

除了像前面提到用格式刷维护样式以外，你还可以使用思源自带的 块引功能 链接你的内容。分享后的站点中，已经针对各种情况做了处理。不仅如此，你可以用以下方式进行连接，当然，思源内的内容，还是用块引的方式是最舒服的。

• 块引

  最方便的方式。只需要输入 [[ 链接内容，就能实现内容之间的跳转。

• 锚文本链接

  • 支持绝对路径、相对路径
  • 支持站外跳转
  • 支持 #block-id 的方式跳转

‍

⚠️ 注意

在线分享功能在链接跳转场景做了一些基本优化，以符合平常使用浏览器时的习惯。具体可以跳转 测试发布模式链接跳转功能 这篇文档，查看演示效果。

‍

‍

三、内容安全【重点】

在开发在线分享这个功能时，我最看重的就是安全问题，因为我在思源笔记里写下了很多涉及隐私的内容，最简单的例子：我连密码都写在了思源笔记里，甚至有一些是用截图做存储的。

因此，隐私内容不能被看见，是我最关心的问题。

整个安全问题包括：

1. 图片资源不能被随意访问

2. 文档内容不能被随意访问

3. 因为叶归在线分享功能的实现方式，所需要考虑的：

   1. 思源 Token 不能泄露
   2. 不能通过 /siyuan/blocks/:任意块id 进行暴力搜索内容

‍

所以在现在的叶归在线分享功能中，增加了：

1. 用户、角色模块。

   实现了基本的管理员权限。未来增加更细致的权限管控，比如不同角色只能看到被授权的内容。

2. 全局图片/资源白名单

   只有添加到白名单中的资源才能被查看

   

3. 全局块白名单

   只有被授权的块，或添加了访问路径的块，才允许被查看。

‍

当用户访问没有权限的块时，会正常拦截，显示为下图的效果：

你可以通过本文顶部的 叶归 块引查看无权的访问情况。

‍

当文档中包含没有权限的图片时，会显示为下面的效果：

‍

即使是通过资源链接直接访问，也会拦截至无权页面。

‍

‍

自此，我也能安心地在线分享我思源笔记中的内容，用来作为个人站点了。

更多功能等以后再优化了，比如页内大纲。

如何使用叶归在线分享，以及更多使用细节，请查看叶归 ｜ 在线分享模块，如果没写，证明我还没空更新。