讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

Lnd

Polar Sponsor
爱发电 赞助
.NET 9.0

安装并运行闪电终端(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 完成完整钱包创建流程:

  1. 生成安全随机的钱包密码
  2. 调用 /v1/genseed 接口生成 24 词助记词种子
  3. 调用 /v1/initwallet 接口,传入密码与种子完成初始化
  4. 安全存储凭证:
    • ~/.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 decodepayreq 
skills/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工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

0

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

0

2026.11.06

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

0

2026.11.05

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

0

2026.11.04

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

0

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn