以下是通过 Obsidian Remotely Save 插件 将笔记同步到阿里云 OSS 的详细教程,包含配置步骤和注意事项:
一、准备工作
-
安装 Obsidian 和 Remotely Save 插件
- 确保已安装最新版 Obsidian(推荐桌面端)。
- 在 Obsidian 中安装插件:
- 打开设置 → 社区插件 → 安全设置 → 启用 Remotely Save 插件。
-
注册阿里云 OSS
- 登录 阿里云控制台,开通 对象存储 OSS 服务。
- 创建一个 Bucket(存储空间):
- 名称:自定义(如
obsidian-notes)。 - 地域:选择离你最近的节点(如
oss-cn-hangzhou)。 - 存储类型:标准存储。
- 读写权限:设置为 公共读(仅用于测试,生产环境建议私有权限并配置签名)。
- 名称:自定义(如
二、获取阿里云 OSS 凭证
-
创建 AccessKey
- 进入 RAM 访问控制 → 创建用户(勾选 Open API 调用访问)。
- 保存生成的 AccessKey ID 和 AccessKey Secret(务必保密)。
-
配置 Bucket 权限
- 进入 Bucket → 权限管理 → 添加 Bucket 授权策略:
json复制
{ "Version": "1", "Statement": [ { "Effect": "Allow", "Action": ["oss:PutObject", "oss:GetObject", "oss:ListObjects"], "Resource": ["arn:aws:oss:${region}:${account-id}:bucket-name/*"] } ] }- 替换
${region}、${account-id}、${bucket-name}为实际值。
- 替换
- 进入 Bucket → 权限管理 → 添加 Bucket 授权策略:
三、配置 Remotely Save 插件
-
打开插件设置
- Obsidian 设置 → 插件 → Remotely Save → 打开设置界面。
-
添加远程存储配置
- 点击 Add Remote,填写以下信息:
字段 配置说明 Remote URL 格式: https://<bucket-name>.oss.aliyuncs.com(如https://obsidian-notes.oss.aliyuncs.com)Access Key ID 填写阿里云 AccessKey ID Secret Access Key 填写阿里云 Secret Access Key Sync Direction 选择同步方向(推荐双向同步 Bidirectional)File Naming 建议使用 Filename as ID避免冲突
- 点击 Add Remote,填写以下信息:
-
高级设置(可选)
- CORS 配置:
- 如果遇到跨域问题,需在阿里云 OSS 的 基础设置 中添加 CORS 规则:
json复制
[ { "AllowedOrigin": ["*"], "AllowedMethod": ["GET", "PUT", "POST", "DELETE"], "AllowedHeader": ["*"] } ]
- 如果遇到跨域问题,需在阿里云 OSS 的 基础设置 中添加 CORS 规则:
- SSL 设置:确保
https://开头。
- CORS 配置:
四、同步本地 Vault 到阿里云
-
选择同步目录
- 在 Remotely Save 设置中,为你的 Obsidian Vault 指定远程路径(如
/notes)。
- 在 Remotely Save 设置中,为你的 Obsidian Vault 指定远程路径(如
-
手动同步测试
- 点击插件界面中的 Sync Now,观察是否成功上传文件。
- 检查阿里云 OSS 控制台,确认文件已出现在指定目录。
-
自动同步设置
- 推荐开启 Auto-Sync(插件设置中勾选),每次保存文件时自动同步。
五、常见问题解决
-
权限错误(403 Forbidden)
- 检查 AccessKey 是否正确,或 Bucket 权限是否公开。
- 如果使用私有 Bucket,需在请求头中添加签名(插件支持签名功能,需配置
Signature Version)。
-
文件未同步
- 确认远程 URL 和路径正确。
- 检查网络防火墙是否拦截了阿里云 OSS 的请求。
-
文件冲突
- 使用双向同步时,若本地和远程同时修改同一文件,需手动解决冲突。
六、高级用法
-
选择性同步文件夹
- 在 Obsidian 中通过
.obsidian/remote-sync.json文件配置仅同步特定文件夹:json复制{ "sync": { "folder1/": "oss-folder1/", "folder2/": "oss-folder2/" } }
- 在 Obsidian 中通过
-
版本控制
- 阿里云 OSS 支持版本管理,开启后可通过插件恢复历史版本。
七、注意事项
-
数据安全
- 生产环境建议使用私有 Bucket + 签名访问,避免密钥泄露。
- 定期备份重要笔记。
-
性能优化
- 大文件建议分片上传(插件默认支持)。
- 避免频繁同步大体积附件。
完成以上步骤后,你的 Obsidian 笔记将自动同步到阿里云 OSS,实现多设备无缝访问!如有其他问题,可参考 Remotely Save 文档 或阿里云 OSS 指南。
浙公网安备 33010602011771号