一个用于 GORM 和 database/sql 的 Cloudflare D1 适配器,通过 Worker 代理模式实现比 REST API 快 2–18 倍的性能。

Stars

29

7 天增长

暂无数据

Fork 数

3

开放 Issue

0

开源协议

暂无数据

最近更新

2026-07-11

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

弥补了缺少官方 Go D1 库的空白,提供了生产就绪的 Worker 代理模式,不仅性能远超 REST API(尤其批量操作和连接建立),还通过将 Cloudflare API 令牌保留在 Worker 后方来增强安全性。

适合谁使用

  • 在 Workers 运行时之外使用 Cloudflare D1 的 Go 开发者
  • 希望将 D1 接入现有 GORM 或 database/sql 代码库的项目
  • 从无人维护的旧适配器迁移的团队
  • 需要高吞吐量 D1 批量操作的开发者

典型使用场景

  • 低流量个人项目中使用 Go 连接 D1
  • 生产环境通过安全 Worker 代理访问 D1 的 Go 服务
  • 将现有 GORM 代码库迁移至 Cloudflare D1
  • 批量 CRUD 操作,避免每条语句的往返开销

项目优势

  • Worker 代理模式在全部基准测试中比 REST 快 2–18 倍,连接建立快 18 倍,批量 CRUD 快 6 倍
  • 安全增强:API 令牌始终留在 Cloudflare 内部;Worker 负责身份验证、限流和请求日志
  • 双模式架构(REST 和 Worker)使用相同的 GORM/database/sql 接口,便于迁移和回退
  • 支持原生 D1 原子性的批量操作,减少往返次数且不牺牲一致性

使用前须知

  • BLOB 编码使用保留前缀 'd1b64:',若文本以此开头会导致误判为二进制
  • REST 模式仅接受 Cloudflare 账户 API 令牌,不支持用户 API 令牌
  • 不支持交互式事务;批量操作是唯一的事务机制,且部分 GORM 迁移操作(如删除列)明确不支持

README 快速开始

Quick Start

项目描述

Make your Go-to-D1 connection 2–18× faster.

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

nethical6
精选
nethical6 GitHub avatar

conversation-steganography

A tool that hides encrypted secret messages inside innocent-looking AI-generated chat text for private communication over any messaging platform.

Go
1,149
programmersd21
精选
programmersd21 GitHub avatar

flow

flow is a minimalist terminal dashboard that displays real-time network throughput with smooth animations, multiple responsive modes, and zero configuration.

开发者工具CLI 与终端
277
MobAI-App
MobAI-App GitHub avatar

simslim

simslim reduces iOS simulator memory usage by 4x by disabling unnecessary background daemons, allowing many more simulators to run on a single Mac.

Go
248