一个免费、轻量的 Typora 图床方案：Cloudflare R2 + Python——十分钟完成
一个免费、轻量的 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 后：
- 进入
R2 Object Storage - 创建一个新的 bucket
- 记下 bucket 名称
先把存储空间准备好，后面上传脚本会直接用到它。
三、创建 R2 API Key
接下来需要给本地脚本一个可读写 R2 的凭证。
在 Cloudflare 后台创建 R2 API Token / Access Key，拿到这两个值：
Access Key IDSecret Access Key
后面的 Python 脚本会通过 R2 的 S3-compatible API 直接上传图片。
| 1 | 2 |
|---|---|
四、给 bucket 配置公开访问地址
这一步决定上传后的图片能不能直接访问。
方案 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_IDACCESS_KEY_IDSECRET_ACCESS_KEYBUCKET_NAMEPUBLIC_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 在粘贴图片时就会自动调用这个脚本上传图片。
七、先手动测试一次
正式交给 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/