ZShip是什么
ZShip 是一个基于 Cloudflare Workers、D1、R2 等边缘云原生产品构建的多租户 AI SaaS 开发模板。它将身份认证、API 网关、数据库、文件存储、计费系统等重复性基础设施封装为开箱即用的模块,让开发者能集中精力打磨 AI 功能与业务逻辑,最短可在数小时内完成从零到 MVP 的搭建。
核心优势
- Cloudflare 原生:完全运行在 Cloudflare 边缘网络上,全球低延迟、自动伸缩、零运维,无需管理服务器。
- 多租户架构:内置租户隔离、自定义域名、用量计量、订阅计划,支持按用户/组织/空间粒度管理资源。
- AI 即插即用:预集成 OpenAI、Anthropic、Hugging Face 等主流 AI 接口,并提供流式响应、上下文管理、记忆存储等通用模块。
- 一键部署:通过 Wrangler CLI 或 GitHub Actions 自动部署,自带 CI/CD 流程,10 分钟内上线。
- 可定制扩展:所有模块采用模块化设计,开发者可自由替换认证方式、计费引擎或数据库逻辑。
适用人群
| 目标用户 | 典型场景 |
|---|---|
| 独立开发者 | 快速验证 AI 聊天、内容生成等 MVP,无需自建后端 |
| 创业团队 | 构建多租户 AI SaaS 产品,缩短从原型到付费用户的周期 |
| SaaS 公司 | 快速迁移或新建 AI 增强功能,集成现有租户体系 |
| 开源贡献者 | 基于模板二次开发,贡献插件或集成新 AI 模型 |
内置功能模块
-
用户与租户管理
- 注册/登录(邮箱、OAuth)、邀请链接、角色权限(RBAC)
- 租户创建、成员管理、用量配额与账单
-
API 与数据层
- 基于 Hono 的 RESTful/GraphQL API、自动验证与速率限制
- D1 关系型数据库(SQLite 兼容)、R2 对象存储(文件上传/下载)
- 支持持久化会话、文件分享、版本控制
-
AI 编排
- 多模型路由、温度/最大 Token 调节、流式 SSE
- 对话历史、知识库 RAG(通过 Vectorize 向量索引)
- 用量统计与费用分摊到租户
-
部署与监控
- 环境变量管理、Secret 加密、自定义域名绑定
- 内置 Sentry 错误追踪、Cloudflare Analytics 面板
- 自动生成 API 文档(OpenAPI/Swagger)
快速上手
# 1. 克隆模板
npm create cloudflare@latest zship-app -- --template zship/ai-saas-template
# 2. 配置环境变量(API Key、数据库等)
cp .env.example .env
# 编辑 .env 文件
# 3. 初始化数据库
npx wrangler d1 migrations apply
# 4. 本地开发
npm run dev
# 5. 部署到 Cloudflare
npm run deploy
部署完成后,即可获得带有管理后台、API 端点与多租户隔离的 AI SaaS 应用原型,支持通过仪表盘查看租户使用量、收入和错误日志。
