BTCPayServer

官方

Docker 应用程序 from Raccommode's Repository

概述

BTCPay Server is a free and open-source Bitcoin payment processor for self-hosted stores, invoices, checkout, wallets, point-of-sale flows, plugins, and webhooks without third-party payment processor fees.

要求

This template runs the BTCPay Server application container only. The officially supported deployment is a Docker Compose stack with Postgres, NBXplorer, and a Bitcoin full node, plus optional reverse proxy and Lightning services. Configure those services separately and point the Postgres, Explorer, and Bitcoin variables below at them before using BTCPay with real funds. If using container names such as postgres or nbxplorer, place all containers on the same custom Docker network.

运行时参数

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

模板配置

Web UI PortPorttcp

BTCPay Server web interface and internal API port. Container port: 49392.

目标: 49392
默认值: 49392
价值: 49392

DataPathrw

Persistent BTCPay Server data directory. Back this directory up before processing real payments.

目标: /datadir
默认值: /mnt/user/appdata/btcpayserver
价值: /mnt/user/appdata/btcpayserver

PluginsPathrw

Persistent BTCPay Server plugins directory.

目标: /root/.btcpayserver/Plugins
默认值: /mnt/user/appdata/btcpayserver/plugins
价值: /mnt/user/appdata/btcpayserver/plugins

Bind AddressVariable

Address and port BTCPay binds to inside the container.

目标: BTCPAY_BIND
默认值: 0.0.0.0:49392
价值: 0.0.0.0:49392

NetworkVariable

Bitcoin network. Use mainnet, testnet, signet, or regtest.

目标: BTCPAY_NETWORK
默认值: mainnet
价值: mainnet

ChainsVariable

Comma-separated crypto chains enabled in BTCPay. This template defaults to Bitcoin only.

目标: BTCPAY_CHAINS
默认值: btc
价值: btc

Public HostVariable

Optional public hostname, for example btcpay.example.com. Use a reverse proxy for HTTPS when exposing BTCPay outside your LAN.

目标: BTCPAY_HOST

Root PathVariable

BTCPay root path when served from a subpath. Use / for normal deployments.

目标: BTCPAY_ROOTPATH
默认值: /
价值: /

Postgres ConnectionVariable

Required Postgres connection string for the BTCPay Server database.

目标: BTCPAY_POSTGRES
默认值: User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;Database=btcpayservermainnet
价值: User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;Database=btcpayservermainnet

Explorer Postgres ConnectionVariable

Required Postgres connection string for NBXplorer data, used by BTCPay to read explorer state.

目标: BTCPAY_EXPLORERPOSTGRES
默认值: User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;MaxPoolSize=80;Database=nbxplorermainnet
价值: User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;MaxPoolSize=80;Database=nbxplorermainnet

BTC Explorer URLVariable

Required NBXplorer URL for Bitcoin, for example http://nbxplorer:32838/ on a custom Docker network or http://UNRAID-IP:32838/.

目标: BTCPAY_BTCEXPLORERURL
默认值: http://nbxplorer:32838/
价值: http://nbxplorer:32838/

Docker Deployment ModeVariable

Marks this BTCPay instance as Docker-deployed. Use true or false.

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

No Default ChainVariable

Prevents BTCPay from assuming a chain without explicit chain variables. Use true or false.

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

Update URLVariable

Release URL used by BTCPay to check for new versions.

目标: BTCPAY_UPDATEURL
默认值: https://api.github.com/repos/btcpayserver/btcpayserver/releases/latest
价值: https://api.github.com/repos/btcpayserver/btcpayserver/releases/latest

Debug LogVariable

Debug log filename under the BTCPay data directory.

目标: BTCPAY_DEBUGLOG
默认值: btcpay.log
价值: btcpay.log

Lightning ConnectionVariable

Optional Bitcoin Lightning connection string. For example, type=clightning;server=unix://etc/clightning_bitcoin/lightning-rpc, or leave blank to configure later in BTCPay.

目标: BTCPAY_BTCLIGHTNING

类别

Network > Other Tools > Utilities

链接

模板支持 Docker Hub Pro连接

详细信息

存储库

btcpayserver/btcpayserver:2.3.9

登记处

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

最后更新2026-05-31

初见2026-05-19

在Unraid 上运行 BTCPayServer 。

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

探索Unraid OS