CattoPic 是什么
CattoPic 是一个自托管的图片托管服务，提供图片上传、管理和对外服务的完整功能。它的特点在于完全依托 Cloudflare 的 Worker 服务构建后端，前端则可部署在 Vercel 。本项目后端需要使用 worker 的计费计划 Queues 模块，请提前了解相关计费规则。
项目的地址：https://github.com/Yuri-NagaSaki/CattoPic
之前写过一个 Go 的版本：https://github.com/Yuri-NagaSaki/ImageFlow
博客地址：CattoPic 自托管图片托管服务介绍
大家反馈自己处理小鸡扛不住，但是实际上图片处理就是非常消耗 cpu 资源，尤其是对于 avif 图片的处理。
核心功能包括：
- 多格式图片上传，支持 JPEG 、PNG 、GIF 、WebP 、AVIF
- 上传后自动转换为 WebP 和 AVIF 格式，节省存储和带宽
- 标签系统，便于图片分类管理
- 图片过期时间设置，支持临时图片
- 公开的随机图片 API ，可用于博客背景或其他场景
- 横竖屏自动识别，API 可按方向筛选
技术架构
CattoPic 的技术选型颇为现代：
前端
- Next.js 16 配合 React 19
- Tailwind CSS 处理样式
后端
- Cloudflare Workers 作为计算层，使用 Hono 框架构建 API
- Cloudflare D1 作为数据库，存储图片元数据和配置
- Cloudflare R2 作为对象存储，存放图片文件
- Cloudflare KV 用于缓存
- Cloudflare Queues 处理异步任务（需付费才能使用）
- Cron Triggers 定时清理过期图片
整套后端服务运行在 Cloudflare 的边缘网络上，响应速度和稳定性都有保障。
部署指南
部署 CattoPic 需要两个步骤：配置 Cloudflare 后端服务，以及部署前端应用。
前置准备
- 一个 Cloudflare 账号
- 一个 Vercel 账号（用于前端部署）
- 本地安装 Node.js 和 pnpm
- 安装 Wrangler CLI：
pnpm add -g wrangler
部署
部署的文档见项目 readme 。
项目预览
R2 公开访问配置
R2 存储桶需要配置公开访问才能让图片被外部访问。在 Cloudflare 控制台进入 R2 设置，绑定自定义域名或启用公开访问，记录得到的公开 URL 。
主要优势
成本优势
Cloudflare 的免费额度相当慷慨：
- Workers：每天 10 万次请求
- D1：5GB 存储，500 万行读取
- R2：10GB 存储，100 万次 A 类操作，1000 万次 B 类操作
- KV：每天 10 万次读取
对于个人博客或中小站点，这些额度足够日常使用。
Select Language