CattoPic 纯 serverless 的图床和 API 综合方案

[ellye]

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 万次读取

对于个人博客或中小站点，这些额度足够日常使用。

[whileFalse]

请问什么地方用到了 queues ？

[ellye]

@whileFalse 回收删除图片，异步