lnget: like wget but for L402 on the web

⚡ 自动闪电支付的 HTTP 客户端

Lightning原生HTTP客户端,自动处理L402支付墙微支付,支持令牌缓存与多后端连接

收藏
4.9k
安装
1.7k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

lnget 是 Lightning Labs 开发的命令行 HTTP 客户端,专为 L402(Lightning HTTP 402)协议设计。它在传统 wget/curl 功能基础上,原生集成比特币闪电网络支付能力,可自动处理需要微支付的 API 资源访问。

典型使用场景:

  • 下载 L402 付费墙保护的文件或数据
  • 自动支付 Lightning 发票并重试请求
  • 管理跨域访问令牌缓存
  • 检查 Lightning 节点后端状态

关键命令模式:

# 基础获取(自动处理402支付)
lnget --max-cost 1000 https://api.example.com/data

# 令牌管理
lnget tokens list/show/remove <domain>

# 后端连接
lnget ln status/info

显著优点

1. 协议原生支持:唯一专为 L402 设计的 CLI 工具,自动解析 WWW-Authenticate: L402 头,无需手动处理 macaroon 和 invoice
2. 支付安全控制--max-cost--max-fee 防止意外大额支出,--no-pay 支持成本预览

3. 令牌智能缓存:按域名持久化 token 至 ~/.lnget/tokens/,避免重复支付

4. 多后端兼容:支持本地 lnd、LNC(Lightning Node Connect)远程配对、Neutrino 轻客户端三种模式

5. 崩溃恢复机制:支付过程中存储 pending token,中断后可恢复

潜在缺点与局限性

1. 配置易错性lnget config init 存在已知 bug,生成的 YAML key 可能错误(如 tlscertpath 而非 tls_cert),需手动修正
2. Go 依赖:必须从源码编译或 go install,无预编译二进制分发

3. 生态局限:L402 协议采用度有限,适用场景集中于 Lightning Labs 生态(如 Aperture 代理)

4. 资金风险auto_pay: true 默认开启,误配置可能导致非预期支付

5. 隐私考量:令牌按域名缓存可能关联用户跨请求行为

适合人群

  • 运行 lnd 节点的开发者,需程序化访问 L402 付费 API
  • 构建闪电网络应用的工程师,测试支付流集成
  • 需要自动化下载付费内容的运维场景
  • 研究 L402 协议实现的技术人员

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 过度支付 | 发票金额超出预期 | 严格设置 `--max-cost`,使用 `--no-pay` 预览 |
| 配置泄露 | macaroon/tls 证书路径配置不当 | 配置文件设 600 权限,避免版本控制提交 |
| 令牌被盗 | `~/.lnget/tokens/` 目录权限宽松 | 定期审计,使用 `--force` 清除敏感令牌 |
| 路由失败 | 大额支付找不到通道 | 设置合理 `--max-fee`,监控 `lnget ln status` |
| 配置损坏 | 错误的 YAML key 导致启动失败 | 对照文档手动验证 `~/.lnget/config.yaml` |

lnget: like wget but for L402 on the web 内容

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