terminal
$git clone https://github.com/timzaak/herald.git
$cd herald
$uv run scripts/dev-start.py
→ 正在启动 PostgreSQL + Redis ...
✓ 数据库迁移完成
✓ Multi-tenant 认证 (RBAC, OAuth, TOTP)
✓ 订阅计费 (Stripe, Creem)
✓ 管理后台 @ http://localhost:3000
→ 认证与计费基础设施已就绪，专注于你的产品。
除核心产品外的一切
认证、计费、支付、用户管理 —— 每个 SaaS 都需要但没人愿意从零搭建的东西。Herald 已内置，支持 AI 定制，随时部署。
多租户认证
将用户组织到相互隔离的 Realm 中，实现完整的数据隔离。每个 Realm 拥有独立的用户、角色、OAuth 提供商和客户端应用。
- 基于 Realm 的租户隔离
- OAuth 2.0 提供商（Google、GitHub、微信）
- TOTP 双因素认证
RBAC 与客户端应用
每个 Realm 内细粒度的基于角色的访问控制。注册带有 OAuth 2.0 凭证的客户端应用，并控制哪些应用可以访问哪些资源。
- 每个 Realm 的基于角色权限
- 客户端应用注册与密钥管理
- 第三方 API 集成
计费与支付
创建订阅计划，映射到支付提供商，并分配给客户端应用。内置积分/信用点与发票管理。
- 订阅计划与定价层级
- Stripe 与 Creem 集成
- 积分与信用点系统
三步从零到生产
部署平台，让 AI 定制，发布产品。
01
Docker 部署
克隆仓库，指向你的域名，运行 dev-start.py。PostgreSQL、Redis、Caddy（自动 TLS）与 Herald 应用在同一台机器上启动。
02
AI 定制
创建 Realm，设置 OAuth 提供商（Google、GitHub、微信），配置 RBAC 角色。借助 AI 辅助工具定制平台，无需手写基础设施代码。
03
接入你的应用
你的应用通过 Herald 的 OAuth 2.0 端点认证用户。用户可使用邮箱/密码或社交登录。Herald 负责会话、令牌与用户管理。
小团队为何选择 Herald
认证、计费、支付一体化自托管系统。AI 辅助定制，无需拼接多种服务。
| Herald | Auth0 | Supabase | Keycloak | |
|---|---|---|---|---|
| 多租户认证 | 内置 | 企业版 | 需手动配置 | 内置 |
| 订阅计费 | 内置 | — | — | — |
| 积分与信用点 | 内置 | — | — | — |
| 自托管 | 支持 | 仅云 | 支持 | 支持 |
| 开源 | Apache-2.0 | 否 | 部分 | Apache-2.0 |
常见问题
关于 Herald 你需要知道的一切。
Herald 是什么？
Herald 是一个开源、自托管的多租户认证、计费和支付平台。它内置 Realm 租户隔离、OAuth 2.0 提供商、TOTP 双因素认证、RBAC、客户端应用管理、订阅计费以及积分/信用点系统。
Herald 与 Auth0 或 Keycloak 有何不同？
Herald 将认证与计费整合在一个自托管系统中，并支持 AI 辅助定制。Auth0 仅提供云服务且按用户收费，Keycloak 是自托管的但不支持计费。Herald 在提供多租户认证的同时，还支持订阅管理、积分/信用点和支付集成。
Herald 中的多租户是什么意思？
多租户意味着 Herald 将用户和数据组织到相互隔离的 Realm 中。每个 Realm 是独立的租户，拥有自己的用户、OAuth 提供商、客户端应用和计费计划。Realm 之间的数据完全隔离。
如何部署 Herald？
Herald 通过 Docker 部署。你需要一台 Linux 服务器（Ubuntu 22.04+，2GB 内存）、Docker Engine 24+ 和一个域名。四个容器一起运行：Herald 应用、PostgreSQL、Redis 和 Caddy。
Herald 支持哪些支付提供商？
Herald 支持 Stripe 和 Creem 用于订阅付款。你可以创建不同定价层级的订阅计划，将其映射到特定支付提供商，并分配给客户端应用。
Herald 使用什么技术栈？
Herald 后端使用 Rust（Axum 框架）提供 API，前端使用 React + TypeScript。数据存储在 PostgreSQL 中，使用 SeaORM；Redis 负责会话与缓存。
Herald 是否免费开源？
是的。Herald 采用 Apache-2.0 许可证发布。你可以自由使用、修改和分发，包括商业项目。没有使用限制，也不按用户收费。
停止搭建基础设施，开始发布产品。
Herald 开箱即用地提供认证、计费、支付和用户管理。AI 负责定制，你专注于让软件与众不同的地方。