Obsidian Stats logoObsidian Stats

NotePic OSS

by Luhui Dev
5
4
3
2
1
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Upload images referenced in the current note to Aliyun OSS, compress them first, and rewrite the links in place.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

NotePic OSS Obsidian

Upload images referenced in the current Obsidian note to Aliyun OSS, then rewrite links in place.

License Obsidian Release Community Plugin

Made by @LuhuiDev

NotePic OSS Obsidian 是 NotePic OSS 的 Obsidian 插件实现。它会扫描当前笔记中的图片引用，在 Obsidian 内完成压缩、去重、上传到阿里云 OSS，并把链接原地替换为公网 URL。

如果你需要批量处理文章、接入 CI 或站点构建流程，请看姊妹项目 NotePic-OSS-CLI。

快速开始

NotePic OSS 已发布到 Obsidian 社区插件目录。

  1. 打开 Settings → Community plugins → Browse。
  2. 搜索 NotePic OSS，或打开 官方插件页。
  3. 安装并启用 NotePic OSS。
  4. 打开 Settings → NotePic OSS，填写 OSS 配置并运行连接测试。

如果需要手动安装，可以从 GitHub Releases 下载 main.js、manifest.json、styles.css，放到 <你的 Vault>/.obsidian/plugins/notepic-oss/，再在第三方插件设置中重新加载并启用插件。

特性

  • 识别 ![[wiki 链接.png]]、![alt](https://raw.githubusercontent.com/luhui-dev/NotePic-OSS-Obsidian/HEAD/image.png)、<img src="https://raw.githubusercontent.com/luhui-dev/NotePic-OSS-Obsidian/HEAD/...">、[label]: ./image.png。
  • 提供两个入口：上传当前笔记全部图片，或打开右侧图片管理面板选择性上传。
  • 图片面板支持缩略图、体积、状态徽章、过滤和多选上传。
  • JPEG / WebP 使用 Canvas 压缩，PNG 使用 UPNG.js；GIF / SVG / 动画图保持原样。
  • 使用 SHA-256 内容哈希生成对象名，并通过 headObject 避免重复上传。
  • 上传期间如果笔记内容发生漂移，受影响引用会跳过，避免覆盖正在编辑的位置。
  • 根据 Obsidian 界面语言自动显示中文或英文。

配置

打开 设置 → NotePic OSS，填写以下字段：

字段 必填 说明
Access Key ID 是 阿里云 RAM 子账号 AccessKey ID
Access Key Secret 是 阿里云 RAM 子账号 AccessKey Secret
Endpoint 是 区域 Endpoint，例如 https://oss-cn-hangzhou.aliyuncs.com
Bucket 是 OSS Bucket 名称
Prefix 否 Bucket 内对象前缀，例如 markdown
Custom domain / CDN 否 用于生成最终 URL 的自定义域名
Compress images 否 是否在上传前压缩图片
Quality 否 JPEG / WebP 质量，范围 1-100，默认 85
Also upload remote images 否 默认关闭，只处理 Vault 内本地图片
Upload concurrency 否 并发上传数，默认 3

连接测试会向 Bucket 上传、HEAD、删除一个 1 字节探针对象，用来验证凭据、权限和 CORS。

Bucket CORS

插件运行在 Obsidian 的 Electron / WebView 环境中，浏览器端直传 OSS 需要配置 CORS。

在阿里云 OSS 控制台打开目标 Bucket 的 安全设置 → 跨域设置，添加规则：

项 值
Allowed Origins app://obsidian.md，开发或排障时也可临时用 *
Allowed Methods PUT, GET, HEAD, DELETE
Allowed Headers *
Expose Headers ETag

如果连接测试提示跨域错误，优先检查 Origins 和 Methods。

使用

在支持的文件中打开命令面板，运行：

NotePic OSS: 上传当前笔记中的所有图片到 OSS（覆盖式）
NotePic OSS: 打开当前笔记的图片管理面板

支持的文件类型：

.md .mdx .markdown .html .htm

两个命令也会出现在编辑器右键菜单中。左侧 Ribbon 图标会打开右侧图片管理面板。插件不预设快捷键，需要时可在 设置 → 快捷键 自行绑定。

图片状态

图片管理面板会把当前笔记中的图片分成几类：

状态 含义
local Vault 内本地图片，可上传
OSS 已经在当前 Bucket 或自定义域名下，会跳过
cloud 远程图片；默认跳过，开启远程上传后可搬运
missing 本地文件无法解析或不存在
skip data:、锚点、邮件链接、非图片 wikilink 等无需处理

安全建议

  • 使用专属 RAM 子账号，不要使用阿里云主账号 AccessKey。
  • 建议权限限制到目标 Bucket 的 oss:PutObject、oss:GetObject、oss:HeadObject、oss:DeleteObject。
  • 插件配置会明文保存在 <Vault>/.obsidian/plugins/notepic-oss/data.json。
  • 如果 Vault 是公开 Git 仓库，请把 .obsidian/plugins/*/data.json 加入 Vault 的 .gitignore。

License

MIT

Sponsors