安装并运行闪电终端(litd),该终端将lnd、loop、pool、tapd和faraday集成在单个Docker容器中。默认使用neutrino后端,在测试网上使用SQLite存储。支持仅监听模式(远程签名)、独立模式和回归测试开发。适用于设置闪电节点进行支付、通道管理、流动性管理(loop)、通道市场(pool)、taproot资产(tapd)或启用agent L402商务场景。
闪电终端(升) — 闪电网络节点
功能概述
闪电终端(升) — 闪电网络节点是一项面向实际任务的技能,主要用于安装并运行一个闪电终端(升)节点, 用于代理驱动的支付;装有环、 池、 磁盘和远日的捆绑 — 赠送。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
使用与执行
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
Lightning Terminal(litd)—— Lightning 网络节点
安装并运行一个 Lightning Terminal(litd)节点,以支持代理驱动的支付功能。 litd 将 lnd 与 loop、pool、tapd 和 faraday 打包集成于单一容器中,使代理可统一访问流动性管理、通道交易市场以及 Taproot 资产。
默认配置: Docker 容器、neutrino 后端、SQLite 存储、testnet 网络。无需运行完整的 Bitcoin 节点。如需使用真实比特币,请指定 --network mainnet。
默认模式:仅观察模式(watch-only),搭配远程签名器(remote signer)。 私钥始终保存在独立的签名器容器中——代理自身从不接触任何密钥材料。如需快速测试,可使用 --mode standalone(密钥落盘,安全性较低)。
快速入门(容器方式 — 推荐)
仅观察模式 + 远程签名器(生产环境)
# 1. 安装 litd 镜像 skills/lnd/scripts/install.sh # 2. 启动 litd 与签名器容器 skills/lnd/scripts/start-lnd.sh --watchonly # 3. 初始化签名器钱包(首次运行时执行) skills/lightning-security-module/scripts/setup-signer.sh --container litd-signer # 4. 导入凭证并创建仅观察钱包 skills/lnd/scripts/import-credentials.sh --bundle ~/.lnget/signer/credentials-bundle skills/lnd/scripts/create-wallet.sh # 5. 检查节点状态 skills/lnd/scripts/lncli.sh getinfo
独立模式(仅限测试)
# 1. 安装 litd 镜像 skills/lnd/scripts/install.sh # 2. 启动 litd 容器 skills/lnd/scripts/start-lnd.sh # 3. 创建独立钱包(生成助记词,密钥落盘) skills/lnd/scripts/create-wallet.sh --mode standalone # 4. 检查节点状态 skills/lnd/scripts/lncli.sh getinfo
警告: 独立模式会将助记词种子和钱包密码明文存储于磁盘。请勿将其用于无法承受损失的主网资金。
Regtest 开发环境
# 启动 litd + bitcoind 用于本地开发 skills/lnd/scripts/start-lnd.sh --regtest # 创建钱包并挖出若干区块 skills/lnd/scripts/create-wallet.sh --container litd --mode standalone docker exec litd-bitcoind bitcoin-cli -regtest -generate 101
容器运行模式
| 模式 | 命令 | 启动的容器 | 适用场景 |
|---|---|---|---|
| 独立模式(Standalone) | start-lnd.sh |
litd | 测试、开发 |
| 仅观察模式(Watch-only) | start-lnd.sh --watchonly |
litd + litd-signer | 生产环境 |
| Regtest 模式 | start-lnd.sh --regtest |
litd + litd-bitcoind | 本地开发 |
配置文件(Profiles)
配置文件可在不修改 compose 文件的前提下自定义 litd 行为:
# 列出可用配置文件 skills/lnd/scripts/docker-start.sh --list-profiles # 使用指定配置文件启动 skills/lnd/scripts/start-lnd.sh --profile taproot skills/lnd/scripts/start-lnd.sh --profile debug
| 配置文件 | 用途 |
|---|---|
default |
标准运行模式(INFO 级别日志) |
debug |
启用追踪日志(trace logging),子系统输出更详细 |
taproot |
启用简易 Taproot 通道支持 |
wumbo |
支持最大达 10 BTC 的大额通道 |
regtest |
预设 regtest 网络参数 |
网络选择
默认使用 testnet。可通过 --network 参数覆盖:
# Testnet(默认,无真实币值) skills/lnd/scripts/start-lnd.sh # Mainnet(真实币值 — 建议搭配远程签名器使用) skills/lnd/scripts/start-lnd.sh --network mainnet --watchonly # Signet(测试网络) skills/lnd/scripts/start-lnd.sh --network signet
litd 子守护进程(Sub-Daemons)
litd 集成了多个守护进程。可通过 --cli 标志调用对应 CLI 工具:
# lnd CLI(默认) skills/lnd/scripts/lncli.sh getinfo # Loop — 流动性管理(潜行交换,submarine swaps) skills/lnd/scripts/lncli.sh --cli loop quote out 100000 # Pool — 通道交易市场 skills/lnd/scripts/lncli.sh --cli pool accounts list # Taproot Assets(tapd) skills/lnd/scripts/lncli.sh --cli tapcli assets list # Lightning Terminal(litd) skills/lnd/scripts/lncli.sh --cli litcli getinfo # Faraday — 通道分析工具 skills/lnd/scripts/lncli.sh --cli frcli revenue
安装
默认行为:拉取 litd Docker 镜像。
skills/lnd/scripts/install.sh
该命令从 Docker Hub 拉取镜像 lightninglabs/lightning-terminal:v0.16.0-alpha 并校验其完整性。litd 镜像内含 lncli、litcli、loop、pool、tapcli 与 frcli 工具。
源码编译安装(备用方案)
skills/lnd/scripts/install.sh --source
需已安装 Go 工具链。将基于全部构建标签(build tags)编译 lnd 与 lncli。
原生模式(Native Mode)
如需脱离 Docker 直接运行,请使用 --native 参数:
# 原生方式启动 skills/lnd/scripts/start-lnd.sh --native --mode standalone # 原生方式停止 skills/lnd/scripts/stop-lnd.sh --native
原生模式使用配置模板 skills/lnd/templates/lnd.conf.template,并将 lnd 作为后台进程运行。
连接远程节点
使用连接凭证连接远程 lnd 节点:
skills/lnd/scripts/lncli.sh
--rpcserver remote-host:10009
--tlscertpath ~/remote-tls.cert
--macaroonpath ~/remote-admin.macaroon
getinfo
MCP / Lightning Node Connect
如需在不建立直连 gRPC 通道的前提下实现只读访问,请使用 lightning-mcp-server 技能配合 Lightning Node Connect(LNC)。LNC 基于加密 WebSocket 隧道通信——无需 TLS 证书、macaroon 或开放端口,仅需从 Lightning Terminal 获取配对短语(pairing phrase)即可完成接入。
skills/lightning-mcp-server/scripts/install.sh skills/lightning-mcp-server/scripts/configure.sh skills/lightning-mcp-server/scripts/setup-claude-config.sh
钱包设置
仅观察钱包(默认)
从远程签名器导入账户 xpub,本机不保存助记词或私钥。
# 从签名器导入凭证包 skills/lnd/scripts/import-credentials.sh --bundle# 创建仅观察钱包(自动识别 litd 容器) skills/lnd/scripts/create-wallet.sh
独立钱包
在本地生成助记词种子。仅限测试使用。
skills/lnd/scripts/create-wallet.sh --mode standalone
通过 REST API 完成完整钱包创建流程:
- 生成安全随机的钱包密码
- 调用
/v1/genseed接口生成 24 词助记词种子 - 调用
/v1/initwallet接口,传入密码与种子完成初始化 - 安全存储凭证:
~/.lnget/lnd/wallet-password.txt(权限 0600)~/.lnget/lnd/seed.txt(权限 0600)
解锁钱包
skills/lnd/scripts/unlock-wallet.sh
容器中默认通过 --wallet-unlock-password-file 启用自动解锁。仅当禁用自动解锁时才需手动执行此命令。
从种子恢复钱包(仅限独立模式)
skills/lnd/scripts/create-wallet.sh --mode standalone --recover --seed-file ~/.lnget/lnd/seed.txt
启动与停止
启动
# Docker 独立模式(默认) skills/lnd/scripts/start-lnd.sh # Docker 仅观察模式(生产环境) skills/lnd/scripts/start-lnd.sh --watchonly # Docker 指定配置文件 skills/lnd/scripts/start-lnd.sh --profile taproot # 主网模式 skills/lnd/scripts/start-lnd.sh --network mainnet
停止
# 停止(保留数据卷) skills/lnd/scripts/stop-lnd.sh # 停止并清理(删除数据卷) skills/lnd/scripts/stop-lnd.sh --clean # 停止所有 litd 相关容器 skills/lnd/scripts/stop-lnd.sh --all
节点操作
所有命令均自动识别 litd 容器:
节点信息
skills/lnd/scripts/lncli.sh getinfo skills/lnd/scripts/lncli.sh walletbalance skills/lnd/scripts/lncli.sh channelbalance
充值
skills/lnd/scripts/lncli.sh newaddress p2tr skills/lnd/scripts/lncli.sh walletbalance
通道管理
skills/lnd/scripts/lncli.sh connect@ :9735 skills/lnd/scripts/lncli.sh openchannel --node_key= --local_amt=1000000 skills/lnd/scripts/lncli.sh listchannels skills/lnd/scripts/lncli.sh closechannel --funding_txid= --output_index=
支付操作
skills/lnd/scripts/lncli.sh addinvoice --amt=1000 --memo="test payment" skills/lnd/scripts/lncli.sh decodepayreqskills/lnd/scripts/lncli.sh sendpayment --pay_req= skills/lnd/scripts/lncli.sh listpayments
Macaroon 烘焙器(Macaroon Bakery)
使用 macaroon-bakery 技能颁发最小权限代理凭证:
skills/macaroon-bakery/scripts/bake.sh --role pay-only skills/macaroon-bakery/scripts/bake.sh --role invoice-only skills/macaroon-bakery/scripts/bake.sh --inspect
配置
容器配置
Docker Compose 模板通过命令行参数传递配置。如需高级定制,可挂载自定义 litd.conf 文件:
- litd 模板:
skills/lnd/templates/litd.conf.template - lnd 模板(原生模式):
skills/lnd/templates/lnd.conf.template
注意:litd 要求对 lnd 相关参数添加 lnd. 前缀(例如 lnd.bitcoin.active);而独立运行的 lnd 不使用该前缀。
关键默认值
- 后端: neutrino(BIP 157/158 轻客户端)
- 数据库: SQLite
- 网络: testnet(可通过
--network mainnet覆盖) - 自动解锁: 通过密码文件启用
容器命名与端口映射
| 容器名 | 用途 | 暴露端口 |
|---|---|---|
litd |
主 Lightning Terminal 实例 | 8443, 10009, 9735, 8080 |
litd-signer |
远程签名器(lnd) | 10012, 10013 |
litd-bitcoind |
Bitcoin Core(仅 regtest 模式) | 18443, 28332, 28333 |
端口参考表
| 端口 | 服务 | 说明 |
|---|---|---|
| 8443 | litd UI | Lightning Terminal Web 用户界面 |
| 9735 | Lightning | Lightning 网络点对点通信 |
| 10009 | gRPC | 供 lncli 及程序化调用使用 |
| 8080 | REST | REST API(钱包等接口) |
| 10012 | Signer gRPC | 远程签名器 gRPC 接口 |
| 10013 | Signer REST | 远程签名器 REST API |
文件路径
| 路径 | 用途 |
|---|---|
~/.lnget/lnd/wallet-password.txt |
钱包解锁密码(权限 0600) |
~/.lnget/lnd/seed.txt |
24 词助记词备份(权限 0600,仅独立模式) |
~/.lnget/lnd/signer-credentials/ |
导入的签名器凭证(仅观察模式) |
versions.env |
锁定的容器镜像版本 |
skills/lnd/templates/ |
Docker Compose 与配置模板目录 |
skills/lnd/profiles/ |
配置文件(.env)目录 |
版本锁定(Version Pinning)
容器镜像版本在仓库根目录的 versions.env 中固定:
LITD_VERSION=v0.16.0-alpha LND_VERSION=v0.20.0-beta
运行时可临时覆盖:
LITD_VERSION=v0.17.0-alpha skills/lnd/scripts/start-lnd.sh
与 lnget 集成
litd 启动后,确保钱包已充值且已打开通道,即可执行:
lnget config init lnget ln status lnget --max-cost 1000 https://api.example.com/paid-data
安全注意事项
详见 references/security.md 获取详细安全指引。
默认模型(仅观察 + 远程签名器):
- 代理机器上不存储助记词或私钥
- 签名操作通过 gRPC 委托给签名器容器执行
- 使用
lightning-security-module技能完成部署
独立模型(仅限测试):
- 钱包密码与助记词以明文形式落盘(权限 0600)
- 适用于 testnet 与快速测试场景
Macaroon 安全:
- 生产环境中切勿向代理提供 admin macaroon
- 请使用
macaroon-bakery技能颁发作用域受限的 macaroon
故障排查
“wallet not found”
运行 skills/lnd/scripts/create-wallet.sh 创建钱包。
“wallet locked”
运行 skills/lnd/scripts/unlock-wallet.sh 解锁。自动解锁默认已启用。
“chain backend is still syncing”
neutrino 需要时间同步区块头:
skills/lnd/scripts/lncli.sh getinfo | jq '{synced_to_chain, block_height}'
容器无法启动
docker logs litd docker logs litd-signer
“remote signer not reachable”
docker ps | grep litd-signer docker logs litd-signer
热门AI工具
相关专题
本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。
0
2026.11.06
围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。
0
2026.11.06
详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。
0
2026.11.06
DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
0
2026.11.05
DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。
0
2026.11.05
本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。
0
2026.11.04
本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。
0
2026.11.04
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.8万人学习
共6课时 | 54.7万人学习
最新文章