LNbits

官方

Docker 应用程序 from Raccommode's Repository

概述

LNbits is a free and open-source Bitcoin Lightning wallet and accounts system. It provides isolated wallets, API keys, LNURL tools, extensions, merchant workflows, and admin controls on top of a configurable Lightning funding source.

要求

LNbits stores its SQLite database, logs, super user state, and installed extensions in the Data path. Back this directory up before using real funds. The default backend is VoidWallet so the UI can start without a Lightning node; set Backend Wallet Class and the matching advanced variables before accepting real payments. The Admin UI stores most settings in the database after first install, so use the Admin UI or reset stored settings if later environment changes do not appear.

运行时参数

网络用户界面: http://[IP]:[PORT:5000]
网络: bridge
外壳: sh
特权: false

模板配置

Web UI PortPorttcp

LNbits web interface and API port. Container port: 5000.

目标: 5000
默认值: 5000
价值: 5000

DataPathrw

Persistent LNbits data, SQLite database, logs, super user state, backups, and installed extensions.

目标: /app/data
默认值: /mnt/user/appdata/lnbits
价值: /mnt/user/appdata/lnbits

Config FilePathro

Optional .env file based on the upstream .env.example. Leave blank to configure with the variables in this template and the Admin UI.

目标: /app/.env

Data FolderVariable

LNbits data folder inside the container. Keep this pointed at the Data mount.

目标: LNBITS_DATA_FOLDER
默认值: /app/data
价值: /app/data

Extensions PathVariable

Persistent path for installed LNbits extensions. Without this, installed extensions can be lost when the container is recreated.

目标: LNBITS_EXTENSIONS_PATH
默认值: /app/data/extensions
价值: /app/data/extensions

Admin UIVariable

Enable the LNbits Admin UI and first-install super user flow. Use true or false.

目标: LNBITS_ADMIN_UI
默认值: true
价值: true

HTTPS Only Auth CookiesVariable

Set true when LNbits is served only over HTTPS. Leave false for direct local HTTP access through the Unraid Web UI.

目标: AUTH_HTTPS_ONLY
默认值: false
价值: false

Backend Wallet ClassVariable

Lightning funding source class. Start with VoidWallet for testing, then use PhoenixdWallet, LndRestWallet, LndWallet, CoreLightningWallet, or another supported backend.

目标: LNBITS_BACKEND_WALLET_CLASS
默认值: VoidWallet
价值: VoidWallet

Default ExtensionsVariable

Comma-separated extensions installed by default on restart. Remove an extension from this list before uninstalling it permanently.

目标: LNBITS_EXTENSIONS_DEFAULT_INSTALL
默认值: tpos
价值: tpos

Public Base URLVariable

Optional public URL used behind a reverse proxy, for example https://lnbits.example.com/.

目标: LNBITS_BASEURL

Site TitleVariable

Browser and UI title for this LNbits instance.

目标: LNBITS_SITE_TITLE
默认值: LNbits
价值: LNbits

Auth Secret KeyVariable

Recommended strong random secret for auth signing. Set this before production use.

目标: AUTH_SECRET_KEY

First Install TokenVariable

Optional token required on the first-install page.

目标: FIRST_INSTALL_TOKEN

Allowed Auth MethodsVariable

Comma-separated auth methods, for example user-id-only, username-password, nostr-auth-nip98, google-auth, github-auth, keycloak-auth, or oidc-auth.

目标: AUTH_ALLOWED_METHODS
默认值: user-id-only, username-password
价值: user-id-only, username-password

DebugVariable

Enable verbose debug mode. Use True or False.

目标: DEBUG
默认值: False
价值: False

Forwarded Allow IPsVariable

Trusted proxy IPs for forwarded headers. Use * when LNbits is behind a trusted local reverse proxy.

目标: FORWARDED_ALLOW_IPS
默认值: *
价值: *

Postgres Database URLVariable

Optional external database URL. Leave blank to use SQLite in the Data path.

目标: LNBITS_DATABASE_URL

Phoenixd API EndpointVariable

Required when Backend Wallet Class is PhoenixdWallet. Use the reachable Phoenixd HTTP API URL, for example http://UNRAID-IP:9740/ or http://phoenixd:9740/ on a custom Docker network.

目标: PHOENIXD_API_ENDPOINT

Phoenixd API PasswordVariable

Required when Backend Wallet Class is PhoenixdWallet. Use the Phoenixd full-access API password from phoenix.conf.

目标: PHOENIXD_API_PASSWORD

LND DataPathro

Optional read-only mount for an LND data directory. Useful when using LndWallet or LndRestWallet with cert and macaroon paths under /lnd.

目标: /lnd

LND REST EndpointVariable

Required when Backend Wallet Class is LndRestWallet. Use the reachable LND REST URL, for example https://UNRAID-IP:8081/ or https://lnd:8080/ on a custom Docker network.

目标: LND_REST_ENDPOINT

LND REST CertVariable

LND TLS certificate path inside the LNbits container, or the certificate content accepted by LNbits.

目标: LND_REST_CERT
默认值: /lnd/tls.cert
价值: /lnd/tls.cert

LND REST MacaroonVariable

LND admin macaroon path inside the LNbits container, or hex/base64 macaroon content.

目标: LND_REST_MACAROON
默认值: /lnd/data/chain/bitcoin/mainnet/admin.macaroon
价值: /lnd/data/chain/bitcoin/mainnet/admin.macaroon

LND gRPC EndpointVariable

Required when Backend Wallet Class is LndWallet. Hostname or IP of the LND gRPC endpoint.

目标: LND_GRPC_ENDPOINT

LND gRPC PortVariable

Required when Backend Wallet Class is LndWallet. LND gRPC port.

目标: LND_GRPC_PORT
默认值: 10009
价值: 10009

LND gRPC CertVariable

LND TLS certificate path inside the LNbits container, or the certificate content accepted by LNbits.

目标: LND_GRPC_CERT
默认值: /lnd/tls.cert
价值: /lnd/tls.cert

LND gRPC MacaroonVariable

LND admin macaroon path inside the LNbits container, or hex/base64 macaroon content.

目标: LND_GRPC_MACAROON
默认值: /lnd/data/chain/bitcoin/mainnet/admin.macaroon
价值: /lnd/data/chain/bitcoin/mainnet/admin.macaroon

类别

Network > Other Tools > Utilities

链接

模板支持 Docker Hub Pro连接

详细信息

存储库

lnbits/lnbits:latest

登记处

https://hub.docker.com/r/lnbits/lnbits

最后更新2026-05-31

初见2026-05-19

在Unraid 上运行 LNbits 。

LNbits 已被列入Unraid OS 的社区应用程序。探索Unraid ，构建灵活的家庭服务器、NAS 或家庭实验室。

探索Unraid OS