Skip to content

重要提示

我们于9月收到了一个不幸的消息,mongodb 在没有通知开发者的情况下,直接弃用了数据库同步功能,而paperlib的多设备同步强依赖于此。目前,新用户已经无法按照下面的教程进行多设备数据同步了。老用户的同步功能还可以使用一年。

我们知道这将对很多用户的体验造成致命打击。

为此我们在开发我们自己的同步服务器了。我们会尽快完成这个功能。

云同步设置

我们有两种数据,需要同步:1. Metadata 2. PDF 文件等。

对于 Metadata, 我们使用 MongoDB Atlas 作为云数据库后端。PDF 文件等,我们推荐使用 Onedrive 等工具或者 webdav 来同步。至于为什么不能用他们来同步 Metadata:

  1. 云存储服务是为文件设计的,而不是为数据库设计的。它们无法合并冲突,并且通常会出现同步延迟。例如,您在电脑A上修改了一些内容,然后在电脑B上修改了另一些内容,但没有网络连接。一旦您将电脑B连接到网络,如何合并这两个数据库?
  2. 我们需要一个功能强大的数据库以实现快速搜索。
  3. 当一个应用程序正在读取数据库文件时,会存在文件锁定。这意味着像OneDrive这样的云存储服务将在您退出应用程序之前永远不会同步数据库文件。因此,即使冲突合并不成为问题,您也必须确保及时在任何计算机上记得退出软件。想象一下,您忘记在电脑B上关闭软件,而离开了电脑B去了电脑A。您将永远无法访问在电脑B上所做的更改。

Paperlib 使用 MongoDB Atlas 作为云数据库后端。用户可以自己创建自己的云数据库,并使用它在你的所有机器上享受秒级别的同步功能。大陆的同学可能延迟稍微高一点。MongoDB Atlas 给用户每月提供了一定量的免费额度,该额度对于 Paperlib 绰绰有余。设置好后,你的数据可以安全地存储在云端。而不用自己维护任何东西。

建立云数据库

  1. 打开 https://account.mongodb.com/account/login,注册并登陆到你的 MongoDB Atlas 账户。账户欢迎页面按照如下设置。之后关闭所有的前导,进入主界面。点击这个 Create

  1. 选择我们的数据库 Plan。我们选 Free 的。取消红框内的两个选项。选择你的数据库中心。尽量选择离你近的地方。点击 Create Deployment

  1. 弹出窗口我们直接关闭。

  1. 来到 App Services 页面,创建 APP。

  1. 确保连接的 Data Source 是我们刚才创建的。这里的部署地区一样选择离你近的。点击 Create App

  1. 弹出窗口我们直接关闭。

  1. 至此数据库已经创建完毕。

添加用户

用户是所有可以在该云数据库里存储数据的人,你可以和你实验室的同学共享一个数据库,你们之间的数据互不干扰。对于Paperlib存储的内容来说,免费额度足够很多人一起共享一个数据库,当然你也可以自己独享。

  1. 点击左侧的 App Users 界面。点击 Authentication Providers

  1. 选择打开 Email Password 登陆。User Confirmation Method 选择 Automatically confirm usersPassword Reset URL 随便写,这里不需要这个功能。 点击 Save Draft

  1. 点击上方的 REVIEW DRAFT & DEPLOY 来应用我们刚才的设置。

  1. 回到 User 界面,点击 Add New User 我们可以添加我们的用户了。

  1. 至此,用户创建完毕。

创建数据库表

我们只需要创建 Data Schema。而且其支持自动根据客户端数据创建。所以我们并不需要手动定义数据结构。

  1. 在 Device Sync 界面,点击 Start Sync。这会让我们 APP 的数据和后端数据库开始同步。弹出界面,我们点击 No thanks, continue to Sync

  1. 之后我们打开 Development Mode。至此,MongoDB Altas 会根据我们 Paperlib 传来的数据自动创建 Data Schema。其余设置如下图所示。Queryable Fields 保持默认即可。

  1. 点击 Enable Sync

  2. 再次点击上方的 REVIEW DRAFT & DEPLOY 来应用我们刚才的设置。

  3. 弹框里,我们选择 Users can read and write all data

  4. 再次点击上方的 REVIEW DRAFT & DEPLOY 来应用我们刚才的设置。

  5. 至此,所有的云数据库相关设置完毕。

设置 Paperlib 连接 MongoDB Atlas

  1. 打开 Paperlib 设置界面,Cloud 选项卡。输入 MongoDB Atlas 的 APP ID,你刚才创建的用户的账号密码。

  1. 打开 Flexible Sync

  1. 登陆就可以了。如果成功了话,我们添加论文之后会在 Log 界面看到 write 的 log。

至此,所有的云同步设置完毕。

同步 PDF 文件

关于 PDF 文件的同步,因为云存储实在太消耗空间了,你可以使用 Onedrive 等工具在不同设备间来同步,Paperlib 也提供了 webDAV 功能。在设备 A, 选择对应路径 C:/Onedrive/mypaperlib 作为库路径. 在设备 B, 选择对应的 /user/xxx/Onedrive/mypaperlib

Created by Future Scholars. Contact: hi@paperlib.app