SuperAPI AI 工具集

cloudflare-workers-url-shortner

部署与运维

查看项目

更新于 10-15 21:41

技能介绍

用途:在 Cloudflare Workers 上设计并运营一个快速、可恢复、可观测的 URL 短链服务,技术栈为 Cloudflare Workers + Upstash Redis + D1。适用于创建短链(如 /links/:id、/r/:slug)、低延迟解析跳转、在 Redis 计数点击、把点击事件及 request.cf 元数据写入 D1、保持非阻塞追踪(跳转不因分析失败而失败),以及带节流的持久化失败告警(如 Telegram)。

主要能力:Worker 提供公开跳转端点(GET /links/:id),从 Redis 读取目标地址,用 waitUntil() 异步追踪;Redis 负责目标查找、点击计数(INCR)、最后点击时间与告警节流锁(SET NX EX);D1 以 append-only 事件表保存点击明细;告警通道在持久化降级时通知并节流。可采集 request.cf 的地理、网络、边缘与传输信息,以及 allowlist 请求头,并派生 ip_hash_sha256、device_type、browser_family、os_family。

使用方式:跳转流程为校验参数、读 Redis、不存在返回 404、存在则先 waitUntil(registerClickNonFatal(...)) 再立即返回 302/307;后台用 Promise.allSettled 并行执行 Redis 指标与 D1 插入,D1 失败时尝试 Redis 锁并仅在获得新锁时告警,Telegram 失败只记录不抛出。部署需创建 D1 迁移与索引、部署 Worker,并做冒烟测试与故障模拟。

限制与注意:仅按 allowlist 保存请求头,绝不持久化 authorization、cookie 等机密;IP 哈希可加盐;需评估事件保留与定期清理。资料未提供具体价格、平台限制或完整代码示例。