这是一个非常专业且稳定的选择。Obsidian + PicGo + 阿里云 OSS 是目前国内体验最好、访问速度最快的 Markdown 写作方案之一。
虽然步骤稍多,但只要配置一次,就可以永久享受"粘贴即上传"的丝滑体验。
以下是保姆级配置教程,分为三个阶段:
第一阶段:阿里云 OSS 设置 (服务端)
你需要先在阿里云建一个仓库,并获取"钥匙"。
-
开通 OSS 服务
-
登录 阿里云官网,搜索"OSS"并开通对象存储服务(OSS)。
-
费用提示:OSS 是按量付费,个人博客通过流量很小,一年通常只需要几块钱甚至几毛钱。建议往账户充值 10 元以防欠费停服。
-
-
创建 Bucket (存储桶)
-
在 OSS 控制台左侧点击 Bucket 列表 -> 创建 Bucket。
-
名称 :起个名字(比如
my-obsidian-notes)。 -
地域:选择离你最近的(如"华东1-杭州")。
-
存储类型:标准存储。
-
读写权限 (关键) :一定要选 【公共读】 (Public Read)。
- 解释:如果是私有,你的笔记里就无法直接预览图片了。
-
其他默认,点击确定。
-
-
获取 AccessKey (钥匙)
-
为了安全,不要直接使用主账号的 Key。推荐使用 RAM 子用户。
-
鼠标悬停右上角头像 -> 访问控制 (RAM)。
-
创建用户 :点击"用户" -> "创建用户"。勾选 【OpenAPI 调用访问】。
-
授权:创建完成后,点击该用户右侧的"添加权限"。
-
搜索并添加:
AliyunOSSFullAccess(管理对象存储服务 OSS 的权限)。 -
保存密钥 :复制下来你的
AccessKey ID和AccessKey Secret。这是唯一一次看到 Secret 的机会,请保存好!
-
第二阶段:PicGo 设置 (传输端)
PicGo 是负责把本地图片搬运到阿里云的"搬运工"。
-
下载安装 PicGo
- 前往 PicGo GitHub 下载最新版安装(Windows 选
.exe, Mac 选.dmg)。
- 前往 PicGo GitHub 下载最新版安装(Windows 选
-
配置图床
-
打开 PicGo,点击左侧 图床设置 -> 阿里云 OSS。
-
填写以下信息:
-
设定 KeyId:填入刚才的 AccessKey ID。
-
设定 KeySecret:填入刚才的 AccessKey Secret。
-
设定存储空间名 :填入你创建的 Bucket 名字(如
my-obsidian-notes)。 -
设定存储区域:填入地域节点代码。
-
如何查看? 去阿里云 OSS Bucket 概览页,找到"Endpoint(地域节点)"。
-
格式: 如果是
oss-cn-hangzhou.aliyuncs.com,这里只需要填oss-cn-hangzhou。
-
-
设定存储路径 :可选,例如
img/,这样图片都会存到 img 文件夹下。
-
-
点击 "确定" 和 "设为默认图床"。
-
-
验证
- 在 PicGo 上传区随便拖一张图片进去,看是否显示"上传成功"。如果成功,说明路通了。
第三阶段:Obsidian 设置 (客户端)
最后一步,让 Obsidian 指挥 PicGo 自动干活。
-
安装插件
-
打开 Obsidian -> 设置 -> 第三方插件 -> 关闭"安全模式"。
-
点击"浏览",搜索 Image Auto Upload Plugin (作者是 Renmu)。
-
安装并启用。
-
-
配置插件
-
在设置里找到
Image Auto Upload Plugin。 -
默认设置通常即可 :它默认会找
http://127.0.0.1:36677,这正是 PicGo 的默认监听端口。 -
确保 PicGo 软件是打开运行状态。
-
最终效果测试
-
打开 Obsidian 任意一篇笔记。
-
使用截图工具截图(或复制一张本地图片)。
-
在笔记中按
Ctrl + V(粘贴)。 -
你会看到:
-
图片先显示为
![Uploading file...]() -
几秒后,自动变为

-
大功告成! 现在你的图片已经安全地存储在阿里云上了。
💡 常见坑与避坑指南
-
图片上传失败?
-
检查 PicGo 日志(PicGo 设置 -> 设置日志文件 -> 打开)。
-
最常见原因 :AccessKey 权限没给够(忘了加
AliyunOSSFullAccess)。 -
次常见原因 :Bucket 区域代码填错了(多填了
.aliyuncs.com或少填了)。
-
-
图片在 Obsidian 里裂开了?
- 检查阿里云 Bucket 权限是否是 "公共读"。如果是"私有",外链是无法访问的。
-
如何让链接更好看?(进阶)
- 目前的链接是阿里云的长域名。如果你有自己的域名(如
static.yourname.com),可以在阿里云 OSS 绑定自定义域名,然后填入 PicGo 的"设定自定义域名"一栏。这会让你的博客看起来非常专业。
- 目前的链接是阿里云的长域名。如果你有自己的域名(如
我可以为您做的下一步:
如果您在测试粘贴时遇到报错,您可以把 PicGo 的报错提示 或者 Obsidian 的错误弹窗 告诉我,我帮您诊断是哪一步出了问题。