BTCPay Server是一个免费、开源且自托管的比特币支付处理器，赋予商家和个人直接接收比特币支付的能力，无需支付任何费用或依赖中介机构。它以去中心化、安全和隐私为核心，为数字货币支付领域带来了一场革新。

自2017年由Nicolas Dorier创建以来，BTCPay Server已经从一个简单的支付处理器发展成为比特币商业生态系统的基础设施。2024年12月23日发布的BTCPay Server 2.0标志着该项目迄今为止最重要的里程碑，引入了全新的架构设计和众多创新功能。截至2025年，该平台已支持超过30个官方插件，并在全球范围内被广泛采用——在2025年拉斯维加斯举办的The Bitcoin Conference上，BTCPay Server创下了8小时内完成4,187笔加密货币销售点交易的吉尼斯世界纪录。

一、BTCPay Server 的核心特点

1.1 🔐 去中心化与自主掌控

BTCPay Server的核心优势在于其去中心化的特性。与传统的支付网关不同，它不依赖任何第三方服务商，用户可以直接与对方进行交易，从而完全掌控自己的资金流动，同时享受更低的交易成本和更高的隐私保护。你的私钥永远不会上传到服务器，确保只有你才能访问你的资金。

💡 核心理念："Not your keys, not your coins"（不是你的私钥，就不是你的币）。BTCPay Server让这一理念在商业支付场景中成为现实。

1.2 🛡️ 安全性机制

安全性是BTCPay Server的另一大亮点。其安全架构采用多层防护机制，从地址生成到资金存储，每个环节都经过精心设计：

🔑 地址隔离机制

每个发票都会生成一个从你的扩展公钥（xpub）派生的新地址，避免地址重复使用，增强了交易的隐私性。这种设计基于BIP32分层确定性钱包标准，确保即使某个地址被关联，也不会影响其他交易的隐私性。

🔒 高级安全功能

• 多重签名支持：BTCPay Server 2.1.0版本对多重签名功能进行了全面重新设计，支持创建需要多个签名才能授权交易的钱包，实现协作托管（Collaborative Custody）。用户可以自主托管多签协调流程，无需依赖第三方服务来管理公钥和签名流程。
• 硬件钱包集成：通过BTCPay Vault应用程序，可无缝连接主流硬件签名设备（如Ledger、Trezor、Coldcard等），私钥永远不会离开设备，所有资金都通过用户自己的全节点进行验证，不会泄露任何数据给第三方。
• 冷钱包存储：支持将主要资金存储在离线钱包中，配合热钱包处理日常小额支付的"热/冷"分离架构
• xpub提取工具：专门为多签设置设计的工具，可以通过BTCPay Vault轻松从硬件钱包中提取扩展公钥
• 交易通知系统：用户可以设置邮件提醒，在交易创建、待签名（需要足够数量的签名）和广播时收到通知

🌐 全节点验证

BTCPay Server通过连接到你自己的比特币全节点验证所有交易，不信任任何第三方区块链浏览器或轻钱包服务。这意味着你的支付验证具有与比特币网络本身相同级别的安全保障。

1.3 ⚡ 闪电网络集成

BTCPay Server具有高度的灵活性和扩展性。它支持比特币闪电网络，实现快速、低成本的微支付，非常适合处理小额交易和内容打赏。

支持的闪电网络实现

BTCPay Server通过统一的抽象接口支持多种闪电网络实现，用户可以根据自己的需求选择最适合的方案：

💡 选择建议：

• 如果需要备份种子短语，推荐使用LND（截至v1.0.3.138，LND是唯一支持闪电网络种子备份的实现）
• 如果服务器存储空间有限，推荐使用Core Lightning，因为它支持修剪节点模式
• 两种实现都支持Ride The Lightning (RTL) Web管理界面，可在浏览器中直接管理闪电网络节点

🔌 Boltz插件：无需运行节点的闪电网络方案

对于不想运行自己闪电网络节点的商家，Boltz插件提供了革命性的"无节点"（Nodeless）模式：

• 工作原理：利用Liquid Network的原子交换技术，在闪电发票被支付的瞬间自动将收到的比特币交换到Liquid网络进行非托管存储
• 主要优势：
  • ✅ 无需管理闪电网络通道和流动性
  • ✅ 自动化的流动性管理
  • ✅ 一个BTCPay Server管理员可以支持多个商户
  • ✅ 与BTCPay Server的发票和会计层原生集成
• 技术说明：从BTCPay Server的角度来看，Boltz插件表现为一个完整的闪电网络节点

1.4 🧩 多元支付与山寨币支持

此外，它还支持多种山寨币，并提供丰富的API接口，方便开发者根据自身需求进行定制化开发或集成现有系统。

NBXplorer作为BTCPay Server的核心组件，是一个轻量级的UTXO追踪器，负责处理新支付通知、显示钱包余额、创建交易和显示交易历史。它支持多种加密货币：

• 比特币（BTC） - 主要支持
• 莱特币（LTC）
• 狗狗币（DOGE）
• 达世币（DASH）
• Monacoin
• 以及其他基于UTXO的加密货币

NBXplorer的技术优势（迁移至PostgreSQL后）：

• 🔋 内存占用约60MB（相比之前每条链200MB+，降低约70%）
• ⚡ 启动速度更快
• 💾 存储空间需求减少约70%
• 最新版本：2.5.26（2025年5月发布，修复了区块896727中特殊构造交易的处理问题）

1.5 📱 部署灵活性

BTCPay Server提供了多种部署方式，你可以选择在自己的服务器上自托管，也可以使用第三方主机。

自托管的核心优势：

• ✅ 连接无限数量的商店
• ✅ 成为其他商店的支付处理器
• ✅ 充分利用闪电网络
• ✅ 完全的数据主权

部署选项一览：

1.6 🏪 内置应用场景

BTCPay Server还提供销售点应用、众筹和捐赠按钮等功能，满足不同场景下的支付需求：

🎯 真实案例：Bitcoin Conference 2025

2025年拉斯维加斯Bitcoin Conference上，BTC Inc整合了BTCPay Server与闪电网络NFC Bolt Card系统，在8小时内完成4,187笔销售点交易，创下吉尼斯世界纪录。这一部署展示了BTCPay Server在大规模商业场景中的可靠性：

• 使用场景：活动门票、商品销售、餐饮服务
• 技术方案：BTCPay Server + LND + Bolt Card NFC
• 用户体验：与传统银行卡相同的"刷卡"体验，但具有更高的隐私保护

1.7 🔌 插件生态系统（2025年重大发展）

BTCPay Server采用模块化的插件架构，开发者社区围绕well-documented的GitHub仓库和API构建了丰富的插件生态系统。截至2025年，官方插件目录已有超过30个插件可用：

1.8 🛒 WordPress与WooCommerce集成

对于WordPress用户而言，BTCPay Server的集成也十分简便。BTCPay for WooCommerce插件可以让WooCommerce网站轻松接受比特币支付。

BTCPay Server for WooCommerce V2插件特点：

安装步骤：

1. 在WordPress后台：插件 → 添加新插件 → 搜索"BTCPay V2"
2. 安装并激活插件
3. 在BTCPay Server中：账户 → API Keys → 创建Greenfield API Key（设置适当权限）
4. 复制Store ID
5. 在WooCommerce → 支付 → BTCPay中粘贴BTCPay URL、API Key和Store ID
6. 启用并保存

⚠️ 注意：旧版基于BitPay API的插件已停止维护，请使用基于Greenfield API的V2版本

对于曾经使用BitPay插件的用户来说，迁移到BTCPay Server也非常便捷，因为它与BitPay API完全兼容。

二、基于Docker Compose的部署方法

下面是一个可以直接运行 BTCPay Server 及其依赖（PostgreSQL、Bitcoin Core、NBXplorer、LND）的 docker-compose.yml 文件。

⚠️ 重要安全提示

这个配置是为了本地测试、开发或内部网络使用而设计的，它将 BTCPay Server 直接暴露在主机的 8080 端口（HTTP）。请勿在没有反向代理（如 Nginx 或 Caddy）和 HTTPS 的情况下将其直接暴露在公共互联网上！

对于生产环境，强烈建议使用官方的 btcpay-docker 仓库，它包含了自动化的Nginx反向代理和Let's Encrypt HTTPS证书配置。

2.1 📋 系统要求

在开始部署之前，请确保你的服务器满足以下最低配置要求：

2.2 🔧 运行前准备

步骤1：创建项目目录

在你的服务器或本地机器上创建一个目录来存放配置文件：

mkdir btcpayserver-direct
cd btcpayserver-direct

步骤2：创建环境配置文件

在 btcpayserver-direct 目录下创建一个名为 .env 的文件，用于存放敏感信息和配置。请务必使用强密码！

# .env 文件内容

# ====================================
# 网络设置
# ====================================
# 可选值: mainnet（主网）, testnet（测试网）, regtest（回归测试）
BTCPAY_NETWORK=mainnet

# ====================================
# Bitcoin Core RPC 设置
# ====================================
BITCOIN_RPC_USER=rpcuser
BITCOIN_RPC_PASSWORD=YourStrongPassword123!  # ⚠️ 请使用强密码!

# ====================================
# PostgreSQL 数据库设置
# ====================================
POSTGRES_USER=postgres
POSTGRES_PASSWORD=AnotherStrongPassword456!  # ⚠️ 请使用强密码!
POSTGRES_DB=btcpayserver

# ====================================
# BTCPay Server 端口配置
# ====================================
BTCPAY_HOST_PORT=8080

# ====================================
# LND 闪电网络节点设置（可选）
# ====================================
LND_ALIAS=MyBTCPayLNDNode

🔒 密码安全建议：

• 使用至少16个字符
• 包含大小写字母、数字和特殊符号
• 可使用密码管理器生成随机密码
• 切勿在生产环境使用示例中的默认密码

2.3 📄 Docker Compose配置文件

在 btcpayserver-direct 目录下创建 docker-compose.yml 文件：

# docker-compose.yml 文件内容
# BTCPay Server 完整堆栈配置
# 版本更新日期: 2025年（请检查各组件最新版本）

version: "3.7"

services:
  # ==========================================
  # PostgreSQL 数据库
  # ==========================================
  postgres:
    image: postgres:16  # 更新至PostgreSQL 16
    container_name: btcpayserver_postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - "postgres_data:/var/lib/postgresql/data"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 5

  # ==========================================
  # Bitcoin Core 节点
  # ==========================================
  bitcoind:
    image: lncm/bitcoind:v28.1  # 更新至Bitcoin Core 28.x系列
    container_name: btcpayserver_bitcoind
    restart: unless-stopped
    environment:
      BITCOIN_NETWORK: ${BTCPAY_NETWORK}
      BITCOIN_RPCUSER: ${BITCOIN_RPC_USER}
      BITCOIN_RPCPASSWORD: ${BITCOIN_RPC_PASSWORD}
      BITCOIN_EXTRA_ARGS: |
        server=1
        rpcbind=0.0.0.0
        rpcallowip=0.0.0.0/0
        zmqpubrawblock=tcp://0.0.0.0:28332
        zmqpubrawtx=tcp://0.0.0.0:28333
        txindex=1
        prune=2000
        rpcworkqueue=128
        rpcthreads=4
        # 可选：启用BIP324加密P2P通信
        # v2transport=1
    volumes:
      - "bitcoin_data:/data/.bitcoin"
    ports:
      - "8333:8333"  # P2P端口（可选，用于接受入站连接）

  # ==========================================
  # NBXplorer 区块链索引器
  # ==========================================
  nbxplorer:
    image: nicolasdorier/nbxplorer:2.5.26  # 更新至最新版本
    container_name: btcpayserver_nbxplorer
    restart: unless-stopped
    environment:
      NBXPLORER_NETWORK: ${BTCPAY_NETWORK}
      NBXPLORER_CHAINS: "btc"
      NBXPLORER_BTCRPCUSER: ${BITCOIN_RPC_USER}
      NBXPLORER_BTCRPCPASSWORD: ${BITCOIN_RPC_PASSWORD}
      NBXPLORER_BTCRPCHOST: bitcoind
      NBXPLORER_BTCEXTRAPARAMS: "rpcport=8332"
      NBXPLORER_BTCZMQBLOCK: "tcp://bitcoind:28332"
      NBXPLORER_BTCZMQTRANS: "tcp://bitcoind:28333"
      NBXPLORER_PORT: "32838"
      # PostgreSQL配置（推荐）
      NBXPLORER_POSTGRES: "User ID=${POSTGRES_USER};Password=${POSTGRES_PASSWORD};Host=postgres;Port=5432;Database=nbxplorer"
    volumes:
      - "nbxplorer_data:/root/.nbxplorer"
    depends_on:
      postgres:
        condition: service_healthy
      bitcoind:
        condition: service_started

  # ==========================================
  # LND 闪电网络节点
  # ==========================================
  lnd:
    image: lightninglabs/lnd:v0.20.0-beta  # 更新至2025年11月发布的最新稳定版
    container_name: btcpayserver_lnd
    restart: unless-stopped
    environment:
      LND_NETWORK: ${BTCPAY_NETWORK}
      LND_CHAIN: bitcoin
      LND_BACKEND: bitcoind
      LND_BITCOIND_RPCUSER: ${BITCOIN_RPC_USER}
      LND_BITCOIND_RPCPASS: ${BITCOIN_RPC_PASSWORD}
      LND_BITCOIND_RPCHOST: bitcoind:8332
      LND_BITCOIND_ZMQPATH: tcp://bitcoind:28333
      LND_ALIAS: ${LND_ALIAS:-MyBTCPayLNDNode}
      LND_COLOR: "#3399FF"
      LND_RPCLISTEN: 0.0.0.0:10009
      LND_RESTLISTEN: 0.0.0.0:8080
      LND_PEERPORT: 9735
      LND_DEBUGLEVEL: info
      # 可选：启用Tor支持
      # LND_TOR_ACTIVE: "true"
    volumes:
      - "lnd_data:/root/.lnd"
    ports:
      - "9735:9735"  # P2P端口（用于接受入站闪电通道）
    depends_on:
      - bitcoind

  # ==========================================
  # BTCPay Server 主程序
  # ==========================================
  btcpayserver:
    image: btcpayserver/btcpayserver:2.1.0  # 更新至最新的2.x版本
    container_name: btcpayserver_server
    restart: unless-stopped
    environment:
      BTCPAY_NETWORK: ${BTCPAY_NETWORK}
      BTCPAY_POSTGRES: "User ID=${POSTGRES_USER};Password=${POSTGRES_PASSWORD};Host=postgres;Port=5432;Database=${POSTGRES_DB}"
      BTCPAY_BIND: "0.0.0.0:49392"
      BTCPAY_ROOTPATH: "/"
      BTCPAY_BTCEXPLORERURL: "http://nbxplorer:32838/"
      BTCPAY_BTCLIGHTNING: "type=lnd-rest;server=https://lnd:8080/;macaroonfilepath=/root/.lnd/data/chain/bitcoin/${BTCPAY_NETWORK}/admin.macaroon;allowinsecure=true"
      # BTCPay 2.0+ 新功能配置
      # BTCPAY_PLUGINDIR: "/root/.btcpayserver/Plugins"
    volumes:
      - "btcpay_data:/datadir"
      - "lnd_data:/root/.lnd:ro"
    ports:
      - "${BTCPAY_HOST_PORT}:49392"
    depends_on:
      postgres:
        condition: service_healthy
      nbxplorer:
        condition: service_started
      lnd:
        condition: service_started

# ==========================================
# 持久化数据卷
# ==========================================
volumes:
  postgres_data:
    driver: local
  bitcoin_data:
    driver: local
  nbxplorer_data:
    driver: local
  lnd_data:
    driver: local
  btcpay_data:
    driver: local

2.4 📖 配置详解

🗄️ PostgreSQL 数据库

• 用途：存储BTCPay Server的核心数据（商店配置、发票、用户等）
• 版本说明：建议使用PostgreSQL 16，相比旧版本具有更好的性能和安全性
• 健康检查：添加了healthcheck确保数据库完全就绪后才启动依赖服务

⛓️ Bitcoin Core 节点

• prune=2000：启用修剪模式，将区块链数据限制在约2GB，大幅节省磁盘空间
• zmqpubrawblock/zmqpubrawtx：ZMQ接口，用于将新区块和交易实时推送给NBXplorer和LND
• txindex=1：交易索引，NBXplorer需要此功能
• 版本说明：Bitcoin Core现已更新至28.x/29.x系列，建议使用最新稳定版。2025年开发活动显著增加，共有285,000行代码被修改

🔍 NBXplorer 索引器

• 用途：轻量级区块链索引器，负责快速查询地址和交易信息
• 工作原理：不索引整个区块链，而是只监听和索引你决定追踪的DerivationScheme相关的地址和交易
• PostgreSQL集成：迁移至PostgreSQL后，内存占用降低70%，存储需求降低70%

⚡ LND 闪电网络节点

• REST API端口(8080)：BTCPay Server通过此端口与LND通信
• 版本说明：最新稳定版v0.20.0-beta（2025年11月发布），release candidate v0.20.1-beta.rc1（2026年1月）
• ⚠️ 重要提示：LND仍处于beta阶段，忽视操作安全指南可能导致资金损失

🖥️ BTCPay Server主程序

• BTCPAY_BTCLIGHTNING：定义如何连接LND，allowinsecure=true是因为Docker内部网络不需要配置HTTPS
• 内部端口49392：避免与LND的REST API端口8080冲突
• 版本说明：BTCPay Server 2.0（2024年12月发布）是项目历史上最重大的更新，2.1.0版本引入了重新设计的多签功能

2.5 🚀 启动与运行

启动服务

# 确保在项目目录中
cd btcpayserver-direct

# 后台启动所有服务
docker-compose up -d

# 查看启动状态
docker-compose ps

⏳ 同步等待过程

监控同步进度

# 查看Bitcoin Core同步进度
docker logs -f btcpayserver_bitcoind

# 查看所有服务日志
docker-compose logs -f

# 只查看BTCPay Server日志
docker-compose logs -f btcpayserver

2.6 🌐 首次访问与配置

1. 访问地址：http://<服务器IP>:8080
2. 创建管理员账户：首次访问时，BTCPay Server会引导你注册第一个用户（自动成为管理员）
3. 检查节点状态：Server Settings → Services，确认Bitcoin Core和Lightning Network连接正常
4. 创建商店：添加第一个商店并配置钱包

💡 提示：如果LND连接失败，可能是macaroon文件尚未生成。稍等片刻后重启BTCPay Server容器：

docker-compose restart btcpayserver

2.7 🛑 常用运维命令

# 停止所有服务
docker-compose down

# 停止并删除数据卷（⚠️ 慎用！会删除所有数据）
docker-compose down -v

# 重启特定服务
docker-compose restart btcpayserver

# 更新镜像并重新部署
docker-compose pull
docker-compose up -d

# 查看磁盘使用情况
docker system df

# 清理未使用的资源
docker system prune

2.8 ⚠️ 重要安全提醒

🔐 生产环境建议：

• 使用官方 btcpay-docker 部署脚本
• 配置防火墙，仅开放必要端口
• 启用SSH密钥认证，禁用密码登录
• 定期更新所有组件
• 保管好LND种子短语和钱包备份

三、BTCPay Server 2.0 新特性速览

2024年12月发布的BTCPay Server 2.0是该项目自2017年启动以来最重大的更新，为未来发展奠定了坚实基础：

⚠️ 升级注意：BTCPay Server 2.0引入了API破坏性更改，如果你有自定义集成，请在升级前仔细阅读迁移指南。

四、小结 📝

总之，BTCPay Server为商家和个人提供了一个安全、私密、低成本的比特币支付解决方案，它的出现不仅降低了交易门槛，也促进了数字货币的普及和应用。

BTCPay Server的核心价值主张：

从2017年Nicolas Dorier因BitPay支持SegWit2x分叉而愤怒创建BTCPay Server开始，到2025年在全球最大比特币会议上创下吉尼斯世界纪录，BTCPay Server已经证明了开源社区驱动的力量。

随着技术的不断发展和社区的不断壮大，特别是2.0版本引入的现代化架构和插件生态系统的蓬勃发展，BTCPay Server有望在未来的数字经济中扮演更重要的角色。正如Bitcoin Magazine所评价的，BTCPay Server已成为"比特币商业的基础设施骨干"（The Backbone of Bitcoin Commerce）。