BTCPay Server 是什么
BTCPay Server 是一款免费软件,供企业、慈善机构或自由职业者接收比特币。它可以生成发票和结账页面,为店铺柜台运行销售点画面,还能接入网店。付款直接进入你自己的钱包。用它的用户指南的话说,它“does not hold funds as a payment intermediary”(不作为支付中介持有资金)。
它以 MIT 许可证开源,由你自己运行。项目方说它不是一家公司,支持它的 BTCPay Server Foundation 是一个靠捐款运作的非营利组织。BTCPay 不收任何费用。它的常见问题写道:“We do not charge you anything. However, to run it, you should host it.”(我们不向你收取任何费用。不过,要运行它,你需要自己托管。)你的成本是服务器和正常的网络费用。
本指南对照的是 2026 年 10 月 29 日发布的 2.4.7 版本。这是一个安全更新版本,修复了 85 个发现的问题,项目方强烈建议更新,尤其是由多个商家共用的服务器。
如果你只是偶尔收款,普通钱包就够了。当你需要与订单关联的发票、收银台、退款和记录时,才需要 BTCPay。
BTCPay Server ↗ · BTCPay Server 2.4.7 版本 ↗
在哪里运行
BTCPay 需要一个比特币节点和一台始终在线的机器。常见的方式有三种。
- 租用的服务器。官方安装方式是在租用的服务器上使用 Docker,并用你自己的域名提供安全的网址。项目自己的指引给出的最低配置是 4 GB 内存、2 个处理器核心和 50 GB SSD 存储,搭配修剪节点,通常每月约 $20 或更少。LunaNode 提供一键安装,每月约 $10。
- 你自己的家用节点。BTCPay 是 Umbrel 和 Start9 上的应用。BTCPay 社区说它无法为这些部署提供支持。Umbrel 警告,除非你设置动态 DNS,否则 Shopify 或 WordPress 等网店无法访问家里的服务器。
- 别人的服务器。有些人运行 BTCPay,并允许别人在上面开设商店。使用之前,请先看下面的警告。
比特币节点第一次同步需要一到五天。服务器一启动,就创建你的账户。第一个注册的账户会成为服务器的管理员。如果有人抢先注册了,文档建议换一台新服务器重新开始。
BTCPay:部署方式 ↗ · BTCPay Docker 部署 ↗
使用别人的服务器
第三方托管便宜又快捷,BTCPay 的文档也坦率说明了其中的取舍:你要信任服务器的所有者。
- 托管方永远不需要你的私钥。文档说,如果托管方向你索要私钥或替你创建私钥,“be sure it's a scam”(那肯定是骗局)。
- 连接一个你已经持有的钱包,通过它的公钥连接,绝不要使用热钱包。不诚实的托管方仍可能运行经过修改的软件,换上他们自己的密钥,让之后的付款流向他们。要定期检查付款是否到达你自己的钱包。
- 托管方能看到你如何使用商店。默认情况下,共享服务器上的商店不能使用服务器的 Lightning 节点,也不能创建热钱包。
文档建议把第三方托管用于测试和学习,而不是用于大额或频繁的付款。
创建商店
- 选择 Create account 并注册。
- 在 Create your first store 页面,输入 Name、用于标价的 Default currency,以及 Preferred Price Source,也就是 BTCPay 用来换算价格的汇率来源。一开始用建议的来源就可以。选择 Create Store。
- 仪表板会显示剩下的步骤:Set up a wallet,以及可选的 Set up a Lightning node。
连接钱包
选择 Set up a wallet。BTCPay 提供两种方式。
Connect an existing wallet 更安全。BTCPay 只获得你钱包的公钥,可以为每张发票生成一个新地址,但不能花钱。项目的常见问题这样说:“Even if your server gets hacked, your funds from the on-chain transactions are always safe.”(即使服务器被黑,你链上交易的资金也始终安全。)导入方式有:
- Connect hardware wallet,在电脑上使用 BTCPay 的 Vault 应用,并插上设备。
- Import wallet file,即从 Sparrow 等钱包导出的文件。
- Enter extended public key,手动粘贴扩展公钥。
- Scan wallet QR code,BTCPay 列出它适用于 BlueWallet、Passport 等钱包。
- Enter wallet seed,标注为 Not recommended(不推荐)。绝不要把恢复助记词输入到服务器中。
Create a new wallet 在服务器上生成密钥。Hot wallet 把私钥保存在服务器上,这样 BTCPay 可以替你花钱,用于退款和出款,但任何拥有服务器管理员权限的人也可以。BTCPay 自己的建议是“regularly withdraw funds to a different wallet”(定期把资金提取到另一个钱包)。Watch-only wallet 会向你显示一次恢复助记词,然后从服务器上删除私钥。
当 BTCPay 询问地址类型时,Segwit (Recommended) 适合大多数商店。
Create a store to begin accepting payments.
The recommended price source gets chosen based on the default currency.
地址间隔上限(gap limit)。你的钱包应用会向前查看固定数量的未使用地址,通常是 20 个。每张发票使用一个新地址,所以连续 20 张发票未付款之后,即使 BTCPay 记录了新的付款,你的钱包也可能看不到它们。如果你的钱包有 gap limit 设置,请调高它。付款不会丢失,只是在钱包向更远处查看之前处于隐藏状态。
BTCPay 常见问题:钱包和 gap limit ↗ · BTCPay Vault ↗
Lightning
Lightning 是可选的,默认关闭。在 Connect to a Lightning node 页面有两个选择。
- Use internal node 在 BTCPay 服务器本身上运行 Lightning 节点。它是一个放在可从互联网访问的机器上的热钱包。BTCPay 的文档警告:“Do not use more than you can afford to lose.”(不要投入超过你能承受损失的金额。)它的恢复助记词只能找回链上部分,通道需要单独备份。
- Use custom node 连接你在别处运行的 Lightning 节点。BTCPay 支持 LND、Core Lightning、Phoenixd 和 Eclair。LNDhub 连接现在需要插件。
你也可以通过插件,在没有自己节点的情况下接收 Lightning 付款。下文会介绍。
收款方式
- Invoices. 依次进入 Payments、Invoices、Create Invoice,用于以你的货币计价的一次性金额。
- Point of Sale. 用于商店或摊位的收银台,例如商品列表、带购物车的商品列表,或用来输入金额的数字键盘。
- Requests. 付款请求是你发给客户的一个页面。如果你允许,它可以分多次支付,每次付款使用当时的汇率。
- Crowdfund. 类似 Kickstarter 的筹款页面,款项直接进入你的钱包。
- Pay Button. 放在网站上的按钮。BTCPay 警告它“should only be used for tips and donations”(只应用于小费和捐款),因为买家可以修改它发送的订单详情。
- Subscriptions. 按月、按季度、按年或一次性终身计费的定期方案。比特币没有自动扣款,所以客户要么在收到提醒后每期支付一张发票,要么充值一笔信用余额,续费时从中扣除。
- Lightning Address. 开启 Lightning 后,商店可以拥有 name@yourserver 形式的地址,任何人都可以从 Lightning 钱包向它付款。
- Pull Payments. 与发票相反。你设定金额并发送一个链接,对方把款项领取到自己选择的地址。BTCPay 用它来退款,它也适合向员工或贡献者出款。
- Pay by NFC. 结账页面可以接受非接触式 Lightning 卡的轻触付款,例如 Boltcard。
在交付商品之前,等发票显示 Settled。客户从交易所付款时,有时会少付一点,因为交易所会扣除自己的提现费用。这时 BTCPay 会把发票标为部分付款。
BTCPay 用户指南 ↗ · BTCPay:Shopify V2 ↗
网店和插件
网店。BTCPay 可以连接大多数网店软件。WooCommerce 使用安装在你网站上的 WordPress 插件。Shopify 使用 BTCPay 集成的第 2 版,它运行在你的 BTCPay 服务器上,需要 Shopify Partner 账户。原来的版本已经停用。BTCPay 的文档还介绍了 Magento、PrestaShop、Odoo、Wix、Ghost、Zapier 等,另外还有供你自己的系统使用的 API。
插件为服务器本身增加功能。右上角 Plugins 菜单下的 Plugin Directory 为 2.4.7 版本列出了 57 个插件。一些有用的插件:
- 没有自己节点的 Lightning。Strike 和 Blink 把款项收进你在这两家公司的账户,由它们替你保管资金。Breez 和 Flint 在 BTCPay 内运行一个轻量级 Lightning 钱包,但把它的恢复助记词保存在服务器上,服务器运营者可以接触到。Flint 还把余额放在 Spark 上,这是一个独立的网络,它自己的文档说资金并非由你单独托管。Arkade 和 Bark 使用 Ark,这是一种较新的在区块链之外付款的方式,它们还是早期软件。
- 你自己的节点。LSPS-1 插件从 Lightning 服务提供商购买一条入站通道,让新节点马上就能收款。
- Nostr。Nostr 插件为商店提供 Nostr 地址,接受 zap,还可以把款项收进你用 Nostr Wallet Connect 连接的钱包,例如 Alby Hub。
- 分账和兑现。Prism 把每笔付款分给多个目的地,例如合伙人或储蓄钱包。Bringin 把你收到的款项按一定比例转到你在 Bringin 的欧元账户。
- 让客户用其他币支付。SideShift、FixedFloat 和 Trocador 在结账页面中加入兑换服务。客户用另一种币支付,你收到比特币。每家兑换服务都是有自己条款的第三方。
- 售票和线下销售。TicketTailor 和 Satoshi Tickets 用于销售活动门票。Boltcards Extension 可以为存有 Lightning 余额的非接触式卡片写入程序。BTC Map 把你的商店加到接受比特币的地点地图上。
- 其他货币。有适用于 Monero、Zcash 和 USDt 的插件。Monero 插件警告,它为服务器上的所有商店使用同一个钱包,所以只能在不与他人共用的服务器上使用。
- Ecash。BTCNutServer 接受 Cashu ecash。它自己的说明称它是早期测试版,尚未经过审计。
只有服务器管理员才能安装插件,所以在别人的服务器上,你只能用对方已经安装的插件。插件在 BTCPay 内部运行,可以访问它的数据。BTCPay 自己的提示说,插件“have not undergone review by the BTCPay Server team”(未经 BTCPay Server 团队审查),它的文档建议只从你信任的来源安装。查看插件由谁维护,保持更新,并在安装前先备份服务器。
Plugins are developed by third parties. They need to be updated and maintained regularly in addition to BTCPay Server. Use plugins at your own risk.
BTCPay 文档:插件 ↗ · BTCPay 插件目录 ↗ · BTCPay 文档:WooCommerce ↗
退款和记录
在发票上,Issue Refund 让你按客户付款时的汇率、按今天的汇率、以你自己的货币或以自定义金额退款。之后 BTCPay 会给你一个链接,发给客户。客户输入自己的地址,你在 Payments,再到 Payouts 下批准并发出这笔出款。
记账时,依次进入 Payments、Reporting,可以把发票、付款、销售、退款等导出为电子表格文件。钱包还可以按标准 BIP 329 格式导出交易标签。
安全和隐私
- 开启双重验证登录。在账户的 Two-Factor Authentication 下,你可以添加验证器应用或 FIDO2 安全密钥。BTCPay 也支持通行密钥(passkey)。
- 保持服务器更新。关注 BTCPay 的版本发布,2.4.7 就说明了这一点。
- 热钱包里只放少量资金,如果你用热钱包的话。
- 只安装需要的插件,并随服务器一起保持更新。
- Payjoin 让付款更难追踪,在 BTCPay 中需要热钱包。Payjoin 指南对此有解释。
- Tor 是可选的。BTCPay 的常见问题还补充说,开启它“doesn't make you anonymous at all”(完全不会让你匿名)。
每张发票都使用新地址,这有助于保护客户和你自己的隐私。
开始接收真实付款之前
- 你在安装完成后立即亲自注册了管理员账户。
- 商店使用的是你自己持有的钱包,通过公钥连接,它的恢复助记词写在纸上。
- 你支付过一张测试发票,并看到它到达你自己的钱包应用。
- 服务器上的每个账户都开启了双重验证登录。
- 员工知道要等到 Settled。
- 你知道如何退款。
- 有人负责检查 BTCPay 更新。
资料与延伸阅读
研究日期:2026年11月18日。软件和服务会变化:操作前请查看最新文档。
- BTCPay Server ↗
- BTCPay Server: source code ↗
- BTCPay Server 2.4.7 release ↗
- BTCPay Server user guide (2.4.7) ↗
- BTCPay source: wallet setup options ↗
- BTCPay source: hot and watch-only wallets ↗
- BTCPay Docker deployment and hardware specs ↗
- BTCPay docs: deployment options ↗
- BTCPay docs: third-party hosting ↗
- BTCPay docs: wallet FAQ and gap limit ↗
- BTCPay docs: general FAQ ↗
- BTCPay docs: BTCPay Vault ↗
- BTCPay docs: Lightning ↗
- BTCPay docs: Shopify V2 ↗
- BTCPay docs: hardening ↗
- BTCPay docs: plugins ↗
- BTCPay Server Foundation ↗
- Umbrel: BTCPay Server app ↗
- BTCPay plugin directory ↗
- BTCPay docs: WooCommerce ↗
- BTCPay docs: subscriptions ↗
- BTCPay docs: pull payments ↗
- Flint plugin: trust model ↗
- Monero plugin ↗
- BTCNutServer (Cashu) plugin ↗
- Prism, Nostr, Bringin, SideShift and other plugins ↗
Umbrel:运行节点,并把你的钱包连接到它 → · Start9:运行节点,并把你的钱包连接到它 → · Sparrow:建立一个能仔细检查的钱包 → · Payjoin → · 选择你能维护的 Lightning 配置 → · 你的余额包含多段资金历史 → · Alby Hub:你自己的 Lightning 节点,连接你的应用 →
