BTCPay Server 安装部署完整指南（2026最新）
BTCPay Server 是一个开源、自托管的加密货币支付网关，可以让你像 Stripe 一样接收 BTC（比特币）付款，而且无需中介、无手续费托管风险。
本文将手把手教你：
👉 从 0 到 1 搭建属于自己的 BTCPay 支付系统
一、BTCPay Server 是什么？
BTCPay Server 是一个：
- 💰 自托管加密支付系统
- 🔐 完全控制资金（无托管）
- 🌍 支持 BTC / Lightning / 多币种
- 🔌 提供 API 可对接网站
👉 类似：
- Stripe（法币支付）
- PayPal（在线支付）
但它是 去中心化版本
二、服务器配置要求（非常重要）
✅ 官方推荐
| 配置 | 要求 |
|---|---|
| CPU | 4核 |
| 内存 | 8GB |
| 硬盘 | 500GB+ |
| 网络 | 公网IP |
⚠️ 轻量方案（适合测试 / 小项目）
| 配置 | 可行 |
|---|---|
| CPU | 2核 |
| 内存 | 4GB |
| 硬盘 | 30~50GB |
👉 必须开启：
opt-save-storage
否则直接炸盘 ❗
🌐 三、准备工作
你需要准备：
- ✅ 一个域名（如：
pay.example.com） - ✅ 服务器（Ubuntu / Debian）
- ✅ Docker 已安装
四、下载安装 BTCPay
1️⃣ 下载官方部署脚本
git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
2️⃣ 配置环境变量（核心步骤）
# Run btcpay-setup.sh with the right parameters
export BTCPAY_HOST="btcpay.EXAMPLE.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-xs"
export BTCPAYGEN_REVERSEPROXY="nginx"
export BTCPAYGEN_LIGHTNING="clightning"
export BTCPAY_ENABLE_SSH=true
⭐ 推荐（低配置机器必须加）
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-xs"
👉 作用：
- 减少磁盘占用
- 适合 30~50GB 服务器
3️⃣ 启动安装（注意写法）
. ./btcpay-setup.sh -i
❗ 注意：
- 不能用
./btcpay-setup.sh - 必须用
.或source
⏳ 五、部署过程说明
安装过程中会自动：
- 🐳 拉取 Docker 镜像
- 🌐 配置 Nginx + HTTPS（Let's Encrypt）
- ⛓️ 启动 Bitcoin 节点
- 🔎 启动 NBXplorer（区块索引）
🚨 六、为什么访问是 503？
很多人卡在这里 👇
👉 打开网站显示：
503 Service Temporarily Unavailable
✅ 原因：
👉 Bitcoin 节点还没同步完成
🔄 同步流程：
bitcoind → nbxplorer → btcpayserver
⏱️ 同步时间：
| 配置 | 时间 |
|---|---|
| 高配服务器 | 6~12小时 |
| 低配服务器 | 1~3天 |
🔍 七、如何查看同步进度？
docker exec -it btcpayserver_bitcoind bitcoin-cli getblockchaininfo
关注：
"verificationprogress": 0.23
👉 表示已同步 23%
🧹 八、如何重装 / 重置？
停止服务
btcpay-down
清理资源
docker system prune -a
docker volume prune
重新配置 + 启动
. btcpay-setup.sh -i
🚀 九、如何对接你的网站？
BTCPay 提供 API：
创建订单：
POST /api/v1/stores/{storeId}/invoices
👉 你可以实现：
- 💰 用户付款（BTC）
- 📩 自动回调（Webhook）
- 📦 自动发货（充值 / 卡密）
💡 十、生产环境最佳方案（重点）
如果你是做：
- giffgaff充值
- 数字商品
- SaaS服务
❌ 不建议：
自己跑完整 BTC 节点（太重）
✅ 推荐：
方案1：BTCPay + 外部节点
- 快速上线
- 节省资源
🎯 总结
👉 BTCPay Server 的核心优势：
- 自托管（安全）
- 无手续费（去中心化）
- 可编程（API）
👉 但部署要注意：
- ⚠️ 硬件资源
- ⚠️ 同步时间
- ⚠️ 磁盘空间
正文到此结束
- 本文标签：
- 版权声明： 本文由HARRIES原创发布，转载请遵循《署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)》许可协议授权
- 本文海报： 生成海报一 生成海报二
热门推荐
近期评论
-
谢谢
-
https://www.newcmy.com/register?aff=HBVX建议您试试草莓云机场，可以流畅观看youtube和tiktok，上reddit/x也没有问题，还有各种ai优化节点。
-
-
-
想购买您这个站，我的联系方式QQ741756694微信同步 能卖联系
-
-
-
-
-
https://www.liuhaihua.cn/archives/40657.html 这篇博客中的图片打不开了
Loading...
![[HBLOG]公众号](https://www.liuhaihua.cn/img/qrcode_gzh.jpg)
