aperture

L402 闪电付费 API 网关

🥥36总安装量 12评分人数 17
100% 的用户推荐

Lightning Labs 官方出品的 L402 反向代理,为 API 和内容提供比特币闪电网络微支付网关,实现按需付费访问。

S

安全性较高,可在多数场景中优先使用

  • 来自可信来源(Github / Microsoft / 官方仓库)
  • ✅ 代码无危险函数(无 eval/exec/system),依赖从官方 Lightning Labs 仓库锁定版本安装
  • ✅ 数据隐私保护完善,配置文件与数据库仅存储在用户本地目录(~/.aperture/),无远程上传
  • ✅ 权限申请与功能严格匹配,仅需 invoice.macaroon(非 admin),遵循最小权限原则
  • ⚠️ 使用 kill/nohup 进行进程管理(属标准系统调用,无额外风险)
  • ✅ 无已知 CVE 漏洞,无动态代码加载行为,通过 T1 来源可信验证

使用说明

Aperture 是由 Lightning Labs 开发的 L402 协议反向代理实现,专为比特币闪电网络微支付场景设计。它作为轻量级网关部署在现有服务前端,通过 HTTP 402 状态码和 L402 认证头实现"按需付费"访问控制。

核心用法围绕三步展开:首先通过脚本自动化安装 Go 语言编译的官方二进制文件;随后运行配置生成器创建 YAML 配置文件,建立与本地 LND 节点的连接;最后启动后台服务拦截受保护端点的请求。当客户端访问付费资源时,Aperture 自动返回包含闪电网络发票的 402 挑战,验证支付原像后代理至后端服务。支持静态定价、动态 gRPC 定价服务、基于路径的速率限制和白名单等高级功能。

显著优点包括官方权威背书(Lightning Labs 为闪电网络核心开发团队)、架构简洁(单二进制文件、SQLite 支持)、灵活认证(直接 LND、LNC 或禁用)以及完善的 Agent 集成(配合 lnget、lnd 形成完整生态)。配置系统允许细粒度控制服务路由、价格策略和访问权限,适合构建机器对机器(M2M)的付费 API 经济。

潜在局限在于对 LND 节点的强依赖——必须维护在线的闪电网络节点和通道流动性,这对非比特币开发者构成门槛。此外,L402 协议要求客户端支持(如 lnget),普通 HTTP 客户端无法直接访问。TLS 配置在生产环境中需要有效证书,自签名证书仅适用于开发。

目标用户主要是构建 Agent 经济的服务提供商、需要内容变现的 API 开发者,以及研究闪电网络支付流的工程师。特别适合为 AI Agent、数据接口或数字内容创建微支付墙,实现按次计费或按字节付费的商业模式。

常规风险包括:配置错误的 macaroon 权限可能导致票据生成失败;LND 连接中断将阻断所有付费访问;不当的速率限制配置可能引发服务拒绝;开发模式下禁用 TLS 若部署到生产会造成中间人攻击风险。建议生产环境使用 Let's Encrypt 或商业证书,并定期备份 SQLite 数据库。

aperture 内容

文件夹图标scripts文件夹
文件夹图标templates文件夹
手动下载zip · 10.0 kB
install.shtext/x-shellscript
请选择文件