Obsidian-Livesync项目：IBM Cloudant数据库配置全指南

Obsidian-Livesync项目：IBM Cloudant数据库配置全指南

obsidian-livesync 项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync

前言

Obsidian-Livesync是一款实现多设备实时同步的插件，通过配置远程数据库可以实现跨设备的数据同步。本文将详细介绍如何使用IBM Cloudant作为远程数据库服务，为Obsidian-Livesync提供稳定可靠的同步支持。

IBM Cloudant实例创建

1. 创建资源

首先需要登录IBM Cloud平台，点击"创建资源"按钮开始创建Cloudant实例。

2. 搜索服务

在IBM Cloud目录中搜索"Cloudant"服务，这是IBM提供的完全托管的NoSQL数据库服务。

3. 选择套餐

建议选择"Lite计划"，这是IBM提供的免费套餐，适合个人用户和小规模使用。

4. 配置选项

• 部署类型：选择默认的"Multitenant"(多租户)
• 区域：选择离您最近的区域以获得更好的访问速度

5. 认证方法

必须选择"IAM and Legacy credentials"认证方法，这是后续配置连接所必需的。

6. 确认容量

确认Lite计划的容量限制，确保满足您的使用需求。

7. 完成创建

点击右侧面板的"创建"按钮完成实例创建。

8. 访问实例

创建完成后，在左侧面板的"资源列表"中找到您的Cloudant实例。

9. 获取连接信息

在实例详情中，复制"External Endpoint(preferred)"地址，这是后续配置连接的重要信息。

数据库设置

1. 启动控制台

点击"Launch Dashboard"按钮进入Cloudant控制台，界面与CouchDB的Fauxton类似。

2. 配置CORS

出于安全考虑，Cloudant默认限制跨域访问，需要进行以下配置：

1. 点击Account菜单
2. 打开"CORS"标签页
3. 将"Origin Domains"从"Restrict to specific domains"改为"All domains(*)"

注意：虽然理想情况下应该只允许Obsidian的特定域名，但Cloudant目前不支持这种配置。

3. 创建数据库

1. 切换到"Databases"标签页
2. 点击"Create Database"按钮
3. 输入您喜欢的数据库名称
4. 点击"Create"按钮完成创建

提示：数据库名称建议使用有意义的命名，如"obsidian-sync"等。

4. 验证创建

成功创建数据库后，您将看到确认信息。之后通常不需要再访问此界面，因为Obsidian-Livesync可以直接管理数据库。

凭证配置

1. 创建服务凭证

返回IBM Cloud控制台，打开"Service credentials"部分，点击"New credential"按钮。

2. 设置凭证

可以保留默认名称或自定义名称，然后点击"Add"按钮创建凭证。

注意：这里的名称仅用于标识凭证，与Obsidian-Livesync中的用户名无关。

3. 获取凭证信息

创建完成后，在新凭证的详情中，您将找到JSON格式的凭证信息，其中包含：

• username：API密钥
• password：对应的密码

请妥善保存这些信息，它们将用于Obsidian-Livesync的配置。

Obsidian-Livesync配置

完成上述准备工作后，您可以在Obsidian-Livesync插件中进行如下配置：

| 配置项 | 值来源 | 示例值 | |--------------|------------------|----------------------------------------------------------------| | URI | 外部端点地址(*) | https://xxxxxxxxxxxxxxxxx-bluemix.cloudantnosqldb.appdomain.cloud | | 用户名 | 凭证中的username | apikey-v2-2unu15184f7o8emr90xlqgkm2ncwhbltml6tgnjl9sd5 | | 密码 | 凭证中的password | c2c11651d75497fa3d3c486e4c8bdf27 | | 数据库名称 | 您创建的数据库名 | sync-test |

注意事项

1. 安全性：虽然配置了CORS为所有域名，但您的数据仍然受到API密钥的保护，请妥善保管凭证信息。
2. 免费限制：Lite计划有使用限制，如果超出可能需要升级到付费计划。
3. 性能：选择离您最近的区域可以提高同步速度。
4. 备份：定期导出重要数据作为额外备份。

通过以上步骤，您已成功配置IBM Cloudant作为Obsidian-Livesync的远程数据库，现在可以享受跨设备的实时同步体验了。

obsidian-livesync 项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync