一个免费、轻量的 Typora 图床方案：Cloudflare R2 + Python，十分钟搞定

平时我主要用 Typora 写 Markdown，一直想要一个尽量简单的图床方案：
粘贴图片后自动上传，自动回填链接，不想额外折腾一堆服务和配置。

我自己使用的轻量化方案：

  • Cloudflare R2：负责存储图片
  • Python 脚本：负责上传文件
  • Typora：负责触发上传并回填图片链接

这套方案很适合个人日常写作，优点也很直接：

  • 免费起步
  • 配置简单
  • 不需要自己搭服务
  • 能直接融进 Typora 的写作流程

如果你本身已经有 Cloudflare 账号，这套方式基本可以很快用起来。

为什么选 Cloudflare R2

Cloudflare R2 很适合做个人图床。

根据 Cloudflare 官方文档，R2 当前免费层包含每月 10 GB-month 存储、100 万 Class A 请求、1000 万 Class B 请求，而且标准存储的公网流量免费。
对个人写作、博客配图、知识库场景来说，这个额度通常已经够用了。

如果你在 Cloudflare 里还有自己的域名，还可以把 R2 bucket 直接绑定到自定义域名上，访问地址更自然，也更适合长期使用。

一、准备工作

开始前，你需要准备：

  • 一个 Cloudflare 账号
  • Python 3.10+
  • Typora

二、创建 R2 bucket

登录 Cloudflare 后：

  1. 进入 R2 Object Storage
  2. 创建一个新的 bucket
  3. 记下 bucket 名称

先把存储空间准备好，后面上传脚本会直接用到它。

image-20260410165651482

三、创建 R2 API Key

接下来需要给本地脚本一个可读写 R2 的凭证。

在 Cloudflare 后台创建 R2 API Token / Access Key，拿到这两个值：

  • Access Key ID
  • Secret Access Key

后面的 Python 脚本会通过 R2 的 S3-compatible API 直接上传图片。

12
image-20260410165910006image-20260410165947119

四、给 bucket 配置公开访问地址

这一步决定上传后的图片能不能直接访问。

image-20260410170143991

方案 A：绑定自定义域名

如果你已经把域名托管在 Cloudflare，推荐直接把 bucket 绑定到自己的域名，比如：

https://image.example.com

这样有几个好处：

  • 地址更整洁
  • 更适合长期使用
  • 可以直接配合 Cloudflare 的缓存能力

方案 B：先用 r2.dev 开发地址

如果你只是先测试流程，也可以直接开启 bucket 的公开开发地址。

这样 Cloudflare 会给你一个 r2.dev 地址，可以先用来验证上传链路是否正常。

五、下载并配置本地脚本

本地上传部分我使用的是一个 Python 脚本项目。
我已经把它开源到了 GitHub，可以直接拉下来使用：

https://github.com/jiachaoDing/CF-image-Typora.git

把项目放到本地后，进入目录执行：

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r .\requirements.txt

然后在 .env 里填写你自己的配置：

  • ACCOUNT_ID
  • ACCESS_KEY_ID
  • SECRET_ACCESS_KEY
  • BUCKET_NAME
  • PUBLIC_BASE_URL

其中 PUBLIC_BASE_URL 就是上一步配置好的公开访问地址：

  • 如果你绑定了自定义域名，就填你的域名
  • 如果你先用 r2.dev，就填对应的开发地址

可选：让 AI 直接帮你生成上传脚本

如果你不想直接使用我的仓库，也可以把需求整理清楚后，直接丢给 AI，让它帮你生成一个最小可用的 Typora 上传脚本。

核心思路其实很简单：

  • Typora 会把图片路径作为命令行参数传给脚本
  • 脚本读取本地图片文件
  • 通过 Cloudflare R2 的 S3 兼容接口上传图片
  • 上传成功后，把图片公开 URL 输出到标准输出
  • Typora 读取这行输出，并自动回填到 Markdown 中

你可以把下面这段 prompt 直接发给 AI，让它帮你生成脚本。

可直接复制的 Prompt
请帮我写一个可直接用于 Typora Custom Command 的 Python 3.10+ 脚本，用来把本地图片上传到 Cloudflare R2，并把最终图片 URL 输出到标准输出。

需求如下：

1. 使用 Python 实现。
2. 通过命令行参数接收一个或多个本地图片路径，例如：
   python upload_to_r2.py image1.png image2.jpg
3. 使用 Cloudflare R2 的 S3-compatible API 上传文件。
4. 配置项从 `.env` 文件中读取，包含：
   - ACCOUNT_ID
   - ACCESS_KEY_ID
   - SECRET_ACCESS_KEY
   - BUCKET_NAME
   - PUBLIC_BASE_URL
5. 上传后的文件名需要避免冲突，建议按“日期目录 + 时间戳 + 随机字符串”的方式生成，例如：
   images/2026/04/10/20260410-170501-ab12cd34.png
6. 保留原始文件扩展名。
7. 上传成功后，针对每个文件向标准输出输出最终可访问的 URL，每行一个，格式适配 Typora Custom Command。
8. 如果上传失败，需要把错误输出到标准错误，并返回非 0 退出码。
9. 代码要结构清晰，包含必要注释。
10. 使用常见、简单、稳定的依赖，优先使用 boto3、python-dotenv。
11. 请同时给出：
   - 完整可运行的 `upload_to_r2.py`
   - 对应的 `requirements.txt`
   - 一个 `.env.example`
12. 请额外说明 Typora 中 Custom Command 应该如何配置。
13. 假设运行环境是 Windows，Typora 通过下面这种形式调用：
   "<project-path>\\.venv\\Scripts\\python.exe" "<project-path>\\upload_to_r2.py"
14. 请尽量保证脚本是最小可用版本，不要引入复杂框架，不要过度设计。
15. 请确保最终输出的 URL 拼接方式正确，避免出现重复斜杠或路径错误。
16. 如果有必要，请加入基本的文件类型校验和文件不存在校验。
17. 请在代码中处理 Windows 路径。
18. 请直接输出完整结果，不要只给思路。

如果你只是想尽快用起来，直接用现成仓库会更省事；
如果你希望脚本完全可控，或者想顺手练一下这类自动化工具，用 AI 自己生成一份也是很好的选择。

六、在 Typora 里配置上传命令

Typora 支持通过 Custom Command 自定义图片上传。

根据 Typora 官方说明，Typora 会把图片路径传给你配置的命令，并从标准输出中读取返回的 URL。

在 Typora 中打开：

Preferences -> Image

上传方式选择：

Custom Command

命令填写：

"<project-path>\.venv\Scripts\python.exe" "<project-path>\upload_to_r2.py"

把 <project-path> 替换成你自己的项目目录即可。

配置完成后，Typora 在粘贴图片时就会自动调用这个脚本上传图片。

image-20260410170941508

七、先手动测试一次

正式交给 Typora 之前，建议先手动测试：

python .\upload_to_r2.py .\test.png

如果配置正确，终端会输出一行图片 URL。

把这个 URL 粘到浏览器里，能正常打开，就说明上传链路已经通了。

八、开始在 Typora 中使用

现在回到 Typora，直接粘贴图片即可。

如果一切正常，最终效果就是：

  • 图片自动上传到 Cloudflare R2
  • Typora 自动把图片链接写回 Markdown
  • 后续文章里的图片都直接走你的图床

对日常写作来说，这个流程已经足够顺手。

九、总结

如果你平时主要用 Typora 写 Markdown，又想要一个尽量简单、免费起步、不需要自己搭服务的图床方案，那么这套 Cloudflare R2 + Python + Typora 的组合是很合适的。

它最大的优点不是“功能很多”，而是足够轻、足够稳、足够贴近日常写作流程。
图片上传不再是单独要处理的一步，而是自然融进了你的 Markdown 写作过程里。

参考链接

  • Cloudflare R2 Pricing
    https://developers.cloudflare.com/r2/pricing/
  • Cloudflare R2 Public Buckets / Custom Domain
    https://developers.cloudflare.com/r2/data-access/public-buckets/
  • Typora Upload Image / Custom Command
    https://support.typora.io/Upload-Image/
# python
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

cover

我用 NVIDIA SkillSpector 纯静态扫了一遍 GitHub 最火的 agent skills：能挖出多少注入？0 个

avatar 龙虾开发者社区
cover

周榜换血九成，Agent Skills 星数翻倍

avatar 龙虾开发者社区

写给 TypeScript 工程师的 OpenClaw.NET 上手指南：用你熟悉的 TS 思维，跑起一个生产级 AI Agent

读代码层：TS 和 C# 本来就是「远房亲戚」——asyncawait??、接口、泛型、严格空检查，你的心智模型几乎无缝平移。真正要适应的只有两件事：类型是具名而非结构化的（多一句显式声明），以及 NativeAOT 下的「禁反射」约束。写扩展层：你甚至可以不怎么碰 C#——Node.js 插件桥意味着你的 TypeScript 插件就是一等公民，而且能在生产 aot 车道跑。内核给你 .NET

avatar 龙虾开发者社区