btcpayserver/btcpayserver-docker

这是什么？

核心功能

• 01根据环境变量和可选片段生成 Docker Compose 服务栈。
• 02包含 BTCPay Server、PostgreSQL、NBXplorer 和 Bitcoin Core。
• 03配置域名后可通过 Nginx 自动申请和续期 HTTPS 证书。
• 04支持 Tor 隐藏服务，并可选择闪电网络实现。
• 05安装命令行工具并设置开机自动启动。

适用场景

• 在 VPS 上自建比特币支付处理服务，用于线上商店收款。
• 借助安装脚本在云服务商上快速部署 BTCPay Server。
• 在现有 BTCPay 部署中按需增加闪电网络或其他加密货币支持。

快速上手

1. 1

   设置域名、网络和组件的环境变量

   export BTCPAY_HOST="btcpay.example.com" export NBITCOIN_NETWORK="mainnet" export BTCPAYGEN_CRYPTO1="btc" export BTCPAYGEN_LIGHTNING="none" export BTCPAYGEN_REVERSEPROXY="nginx" export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-xs"
2. 2

   克隆仓库

   git clone https://github.com/btcpayserver/btcpayserver-docker
3. 3

   运行安装脚本以生成并启动服务栈

   . ./btcpay-setup.sh -i
4. 4

   在浏览器中打开你的域名并注册第一个管理员账户

使用前须知

• !自动HTTPS需要域名指向服务器并开放80和443端口。
• !初始比特币同步可能耗时很长，并需要大量服务器资源。

收录于专题

标签

常见问题

btcpayserver-docker 是什么？

BTCPay Server 官方 Docker 部署方案，通过环境变量生成并运行完整的服务栈。 本仓库是 BTCPay Server（一款自托管的比特币支付处理程序）的官方 Docker 部署方案。安装脚本根据少量环境变量和可选片段生成 Docker Compose 服务栈，并自动安装命令行工具、设置开机自启，然后启动各项服务。

btcpayserver-docker 可以免费使用吗？用的什么许可证？

btcpayserver-docker 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

btcpayserver-docker 还在维护吗？

活跃维护中。btcpayserver-docker 最近一次提交是在 2026年11月6日。

btcpayserver-docker 适合用来做什么？

在 VPS 上自建比特币支付处理服务，用于线上商店收款。 借助安装脚本在云服务商上快速部署 BTCPay Server。 在现有 BTCPay 部署中按需增加闪电网络或其他加密货币支持。

btcpayserver-docker 怎么安装和运行？

设置域名、网络和组件的环境变量: export BTCPAY_HOST="btcpay.example.com" export NBITCOIN_NETWORK="mainnet" export BTCPAYGEN_CRYPTO1="btc" export BTCPAYGEN_LIGHTNING="none" export BTCPAYGEN_REVERSEPROXY="nginx" export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-xs" 克隆仓库: git clone https://github.com/btcpayserver/btcpayserver-docker 运行安装脚本以生成并启动服务栈: . ./btcpay-setup.sh -i 在浏览器中打开你的域名并注册第一个管理员账户

在哪里获取 btcpayserver-docker？

源代码和安装说明在 GitHub 上：https://github.com/btcpayserver/btcpayserver-docker