Lago 使用介绍：功能、价格与上手指南
Lago 是一款开源的计量与计费平台，帮助 SaaS 和 AI 产品快速实现按用量计费。本文介绍其核心功能、价格方案、与同类工具对比，并提供从安装到创建首个账单的完整上手指南。
在 AI 与 SaaS 产品中，按用量计费（usage-based billing）越来越普遍。Lago 作为开源计量与计费平台，能帮你快速搭建从事件采集到发票生成的完整流程。本文带你了解 Lago 的核心功能、价格，并手把手完成首次配置。
Lago 是什么？
Lago 是一个开源的计量与计费基础设施。它通过 API 接收用量事件，按照你定义的定价模型计算费用，并自动生成发票。相比自研计费系统，Lago 能节省数月开发时间。
核心功能
- 事件采集：通过 REST API 或 SDK 上报用量事件，支持批量与实时。
- 灵活定价：支持按量、阶梯、打包、订阅及混合模式。
- 客户与订阅管理：管理客户、套餐、优惠券和试用期。
- 发票与账单：自动生成 PDF 发票，支持多币种和税务处理。
- 支付集成：与 Stripe、GoCardless 等支付网关对接。
- 实时分析：仪表盘展示用量趋势和收入指标。
- 自托管或云服务：开源版可自行部署，云版免运维。
价格方案
Lago 提供开源版和云版：
| 方案 | 价格 | 适用场景 |
|---|---|---|
| 开源自托管 | 免费 | 有运维能力、需数据自主可控 |
| Lago 云版 | 按用量计费，有免费额度 | 希望快速上线、免运维 |
| 企业版 | 联系销售 | 需要 SSO、审计日志、SLA |
云版通常按追踪的事件量和收入规模定价，具体以官网为准。对于早期项目，开源自托管是零成本起步的好选择。
Lago 上手指南
1. 安装与启动
使用 Docker Compose 快速启动：
git clone https://github.com/getlago/lago.git
cd lago
docker compose up启动后访问 http://localhost:80，使用默认账号登录。
2. 创建组织与获取 API Key
登录后创建组织，在 Settings > API Keys 中生成密钥。后续上报事件和调用 API 都需要它。
3. 定义计费指标
进入 Billable Metrics，创建指标。例如：
- 名称：
api_calls - 聚合方式：
COUNT - 字段：
value
这表示按 API 调用次数计费。
4. 创建套餐（Plan）
在 Plans 中新建套餐，添加计费项：
- 选择指标
api_calls - 定价模型：阶梯计价
- 设置阶梯：前 1 万次免费，之后每千次 0.5 美元
5. 创建客户并订阅
在 Customers 中添加客户，然后为其订阅刚创建的套餐。
6. 上报用量事件
使用 API 上报事件：
curl -X POST http://localhost:80/api/v1/events \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"transaction_id": "tx_001",
"external_customer_id": "cust_001",
"code": "api_calls",
"timestamp": 1710000000,
"properties": { "value": 1 }
}'7. 查看账单与发票
事件上报后，Lago 会自动计算费用。在 Invoices 中可查看草稿和最终发票，并下载 PDF。
使用建议
- 先定义指标再接入业务：避免后期重构。
- 利用免费额度：吸引用户试用。
- 监控事件丢失：确保上报接口有重试机制。
- 结合 Stripe：用 Lago 计量、Stripe 收款，分工明确。
总结
Lago 让用量计费变得简单：开源免费、功能完整、上手快。按照本文步骤，你可以在一小时内完成从安装到首张发票的流程。对于 AI 和 SaaS 产品，Lago 是值得考虑的计费基础设施。