OpenSource-Hub
L

Lago

9.6k stars·开发工具·已提供 SHA-256 校验码,下载后可自行核对文件完整性

开源计费平台,支持按用量/订阅混合定价,可自托管,API 优先,与支付网关无关。

智能下载

前往项目主页

该项目暂未提供安装包,请直接访问源代码仓库

开源计费平台,灵活定价,数据自控

核心功能

  • 实时用量计量:任意维度的数据采集与聚合
  • 自动化账单与发票:支持订阅、用量、混合计划
  • 权限管理:基于计费计划的特性访问控制
  • 收款编排:含催缴、重试、多网关支持
  • 收入分析:MRR、用量趋势等跨视图分析

避坑指南

  • 自托管需将服务器地址配置到 .env 中(如 LAGO_API_URL / LAGO_FRONT_URL)。默认收集匿名使用统计(不含 PII),可在文档中关闭。高流量场景需配置专用工作进程。AGPLv3 协议,商业使用时需注意合规。

适用场景

  • SaaS 公司采用混合定价(基础订阅+超额用量)
  • AI API 平台按 Token 计费
  • 市场平台为第三方卖家提供计费能力

详细介绍

Lago 是一款面向产品驱动型公司的开源计费平台。它支持按用量、订阅及混合定价模型,提供实时事件采集、自动开票、支付编排、权限管理和收入分析。可自托管(完全掌控数据)或使用云服务。API 优先,与支付网关无关,已获 SOC 2 Type II 认证。被 PayPal、Mistral AI、Groq 等企业采用。

常见问题与排障 (2)

故障排除
为什么更新了 LAGO_ORG_USER_PASSWORD 环境变量后,无法用新密码登录?

signup.rake 任务使用了 create_with,这仅在创建用户时设置密码。如果用户已存在,重启后密码变更会让旧密码保留,导致"incorrect login or password"错误。要永久修复,请修改 lib/tasks/signup.rake,改用 find_or_initialize_by,显式设置密码,然后保存。作为临时解决方案,可删除现有用户(rails console 中执行 User.find_by(email: ENV['LAGO_ORG_USER_EMAIL'])&.destroy)并重新运行 signup rake 任务,或者直接在数据库中更新密码。该修复可确保密码在重启后与环境变量保持同步。

来源 Issue #708
故障排除
为什么在Lago中执行db:schema:load失败,并提示'relation "public.payment_receipts" does not exist'?

该错误是由于Lago中的structure.sql文件在创建payment_receipts表之前尝试执行DROP TRIGGER操作导致的。临时解决方法是手动创建该表:'CREATE TABLE IF NOT EXISTS public.payment_receipts (id uuid DEFAULT gen_random_uuid() NOT NULL, number character varying NOT NULL, payment_id uuid NOT NULL, organization_id uuid NOT NULL, created_at timestamp(6) without time zone NOT NULL, updated_at timestamp(6) without time zone NOT NULL, billing_entity_id uuid NOT NULL);',然后运行db:schema:load或db:migrate。该问题在Lago v1.33.4和v1.38.0中已被报告。维护者无法在最新版本中复现该问题,因此升级版本可能会解决此问题。

来源 Issue #669

标签

billingmeteringinvoicingopen-sourcesubscriptionusage-basedrevenueAI-native

快速上手

1

下载安装包

点击上方按钮下载对应系统的安装包

2

安装软件

双击下载的安装程序,按提示完成安装

3

步骤1:确保已安装 Docker 和 Git

4

步骤2:克隆仓库并进入目录:git clone --depth 1 https://github.com/getlago/lago.git && cd lago

5

步骤3:生成 RSA 密钥并启动:echo 'LAGO_RSA_PRIVATE_KEY="$(openssl genrsa 2048 | openssl base64 -A)"' >> .env && source .env && docker compose up

安装指引
  1. 步骤1:确保已安装 Docker 和 Git
  2. 步骤2:克隆仓库并进入目录:git clone --depth 1 https://github.com/getlago/lago.git && cd lago
  3. 步骤3:生成 RSA 密钥并启动:echo 'LAGO_RSA_PRIVATE_KEY="$(openssl genrsa 2048 | openssl base64 -A)"' >> .env && source .env && docker compose up
文件完整性

暂未获取到校验码

该项目暂未在 GitHub Release 页面提供 SHA-256 校验码

SHA256 校验码

暂无校验码

建议从 GitHub Releases 页面直接下载,并自行核对文件完整性

本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。

运维指引

卸载说明

运行 docker compose down 停止容器,然后删除 lago 文件夹即可。如需清除数据,可删除 Docker 卷。

无额外依赖

下载后即可直接使用,无需安装其他运行环境

项目信息
开源协议AGPL-3.0
最后更新2026-06-27 11:05:16
GitHub 仓库官方网站

遇到问题?查看下方 FAQ

2 FAQs

相似推荐