一个免费、轻量的 Typora 图床方案：Cloudflare R2 + Python——十分钟完成

一个免费、轻量的 Typora 图床方案Cloudflare R2 Python十分钟搞定平时我主要用 Typora 写 Markdown一直想要一个尽量简单的图床方案粘贴图片后自动上传自动回填链接不想额外折腾一堆服务和配置。我自己使用的轻量化方案Cloudflare R2负责存储图片Python 脚本负责上传文件Typora负责触发上传并回填图片链接这套方案很适合个人日常写作优点也很直接免费起步配置简单不需要自己搭服务能直接融进 Typora 的写作流程如果你本身已经有 Cloudflare 账号这套方式基本可以很快用起来。为什么选 Cloudflare R2Cloudflare R2 很适合做个人图床。根据 Cloudflare 官方文档R2 当前免费层包含每月10 GB-month存储、100 万Class A 请求、1000 万Class B 请求而且标准存储的公网流量免费。对个人写作、博客配图、知识库场景来说这个额度通常已经够用了。如果你在 Cloudflare 里还有自己的域名还可以把 R2 bucket 直接绑定到自定义域名上访问地址更自然也更适合长期使用。一、准备工作开始前你需要准备一个 Cloudflare 账号Python 3.10Typora二、创建 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 直接上传图片。12四、给 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. 假设运行环境是 WindowsTypora 通过下面这种形式调用 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 R2Typora 自动把图片链接写回 Markdown后续文章里的图片都直接走你的图床对日常写作来说这个流程已经足够顺手。九、总结如果你平时主要用 Typora 写 Markdown又想要一个尽量简单、免费起步、不需要自己搭服务的图床方案那么这套Cloudflare R2 Python Typora的组合是很合适的。它最大的优点不是“功能很多”而是足够轻、足够稳、足够贴近日常写作流程。图片上传不再是单独要处理的一步而是自然融进了你的 Markdown 写作过程里。参考链接Cloudflare R2 Pricinghttps://developers.cloudflare.com/r2/pricing/Cloudflare R2 Public Buckets / Custom Domainhttps://developers.cloudflare.com/r2/data-access/public-buckets/Typora Upload Image / Custom Commandhttps://support.typora.io/Upload-Image/