Bitcart 0.10.3.0 介绍与选型指南

目标：面向准备自托管加密货币收款的团队与开发者，讲清 Bitcart 是什么、架构如何组成、功能边界在哪里、与同类方案（以 BTCPay Server 为主要参照）相比该如何选型。本篇为认知篇，全部数据均来自官方公开来源联网溯源（来源与查询日期见「一、环境信息」），未做本地实测。

一、环境信息

本篇所有事实性数据均按下列来源联网溯源，查询日期：2026-10-22：

• 版本与发布节奏：GitHub Releases 订阅源 https://github.com/bitcart/bitcart/releases.atom（实查最新稳定版为 0.10.3.0，发布于 2026-03-05）；
• 社区活跃度：shields.io 实时徽章（img.shields.io/github/stars/...）读取 GitHub 星数，Bitcart 995 星、BTCPay Server 7.8k 星（均为 2026-10-22 实查值）；
• 官方文档：docs.bitcart.ai（源码仓库 bitcart/bitcart-docs，GitBook 形态），含架构、部署、集成与 FAQ 章节；
• 官方仓库：bitcart/bitcart（核心 API 与守护进程）、bitcart/bitcart-docker（部署编排）、bitcart/bitcart-admin、bitcart/bitcart-store、bitcart/bitcart-sdk、bitcart/bitccl，License 均为 MIT；
• 支持的币种与端口清单：来自 bitcart/bitcart 仓库 daemons/ 目录源码与 bitcart/bitcart-docker 仓库 setup.sh 帮助文本（0.10.3.0 版本源码）。

⚠️ 注意：加密资产行业版本迭代快，阅读本文时请以官方 Releases 页面核对最新版本号；本文所有版本号、星数均已标注实查日期，便于判断时效性。

二、软件概述

Bitcart（官方站点 bitcart.ai）是一个开源（MIT 许可）的自托管加密货币支付处理器，定位是"面向商家、用户与开发者的易部署、易使用的加密货币收款平台"（引自官方仓库 README，查询日期 2026-10-22）。项目 2019 年由 MrNaif2018 发起（仓库版权声明 Copyright (C) 2019 MrNaif2018），采用"中心仓库 + 多组件仓库"的生态组织方式，核心仓库清单如下（引自官方 README 的 Linked repositories 一节）：

版本与活跃度量化（实查日期 2026-10-22）：

• 最新稳定版 0.10.3.0（2026-03-05 发布），当前主版本线 0.10.x；
• GitHub 星数 995（shields.io 实时徽章值）；
• 近 12 个月发布节奏（取自 releases.atom 的 8 条稳定版记录）：

关键解读：约一年内 8 个稳定版发布，平均 6~7 周一个版本，属于"小步快跑"的健康维护节奏；0.10.2.x 引入供应链安全强化（镜像签名、SBOM），0.10.3.0 重点改进部署体验与链上转账解析。

支持的币种：0.10.3.0 源码 daemons/ 目录内置 10 种加密货币的守护进程实现——BTC（端口 5000）、LTC（5001）、ETH（5002）、BCH（5004）、XRG Ergon（5005）、BNB（5006）、MATIC/Polygon（5008）、TRX/Tron（5009）、GRS/Groestlcoin（5010）、XMR/Monero（5011）。BTC 系币种（BTC/LTC/GRS）支持闪电网络（引自 setup.sh 帮助文本中的 COINNAME_LIGHTNING 说明）。

三、核心架构

3.1 组件全景

Bitcart 采用模块化架构，官方架构文档（docs.bitcart.ai 的 Architecture 页，查询日期 2026-10-22）明确指出："唯一必需的组件是 Bitcart Core，其余全部可选"。组件与默认端口如下：

依赖链要点：PostgreSQL 与 Redis 只在启用 Merchants API 时需要；只用守护进程 + SDK 做纯开发的场景可以不装数据库（引自架构文档 "The Merchants API...will also add in PostgreSQL for data storage, and Redis"）。

3.2 支付检测数据流

官方架构文档描述的支付闭环（转述并核对源码注释，查询日期 2026-10-22）：

1. 顾客拿到 BIP 21 支付地址并发起链上转账；
2. Electrum 网络层检测到支付，守护进程将事件预处理后经 WebSocket 推送；
3. worker 通过 Bitcart SDK 收到事件，按地址匹配支付方式与发票，将发票标记为完成；
4. 完成时触发动作：记录支付币种、按模板向顾客发邮件、调用商家配置的通知渠道等；
5. 若连接临时中断，重连后 worker 会拉取待处理发票补齐漏掉的事件（不丢单设计）。

API 自带健康检查：每 5 分钟（启动后 2 分钟起）检查各币种守护进程同步状态，异常时记日志并可推送通知（官方 Healthcheck 指南）。

3.3 轻量性的来源：Electrum 与 SPV

💡 技术拓展：加密货币收款系统验证交易有三种主流做法，直接决定资源占用与信任模型——

验证方式	原理	资源占用	信任取舍	代表实现
SPV（简单支付验证）	只同步区块头，向多个服务器查询并校验 Merkle 证明	极低（MB 级数据）	依赖所连服务器不出恶（多源校验降低风险）	Electrum、Bitcart
全节点完整验证	下载并校验全部区块与交易	高（磁盘数百 GB 起）	不需要信任任何第三方	Bitcoin Core（BTCPay Server 采用）
自建索引服务	自托管 ElectrumX/Fulcrum 给 SPV 钱包供数	中（全节点 + 索引）	数据源自主可控	ElectrumX、Fulcrum

Bitcart 默认走 Electrum SPV 路线，这是它能以"1 GB 内存 + 10 GB 磁盘"跑全组件的关键；同时支持 BTC_SERVER 类参数把数据源切换为自建 ElectrumX/Fulcrum 服务器，兼顾轻量与自主可控（官方架构页与 bitcart-docker 配置说明）。

四、功能特性

以下特性清单综合自官方文档 "Bitcart vs others" 的 Features 列表、各 Guide 页面与 0.10.x 系列发布说明（查询日期 2026-10-22）：

收款核心

• 多币种收款：内置 10 种币守护进程（BTC、LTC、ETH、BCH、BNB、MATIC、TRX、GRS、XMR、XRG），同一套 API 语义；
• 闪电网络：BTC/LTC/GRS 支持 Lightning 收款（COIN_LIGHTNING 开关）；
• 非托管设计：商家只需提供 xpub/地址等公开信息，私钥永不上传；官方明确 "Bitcart is a non-custodial software"（Your first invoice 文档）；
• 发票系统：长期有效的支付请求（Payment Requests）、多币种发票、汇率换算（默认经 CoinGecko，支持自备 API Key）；
• 现成商店/POS：bitcart-store 提供开箱即用的在线商店与线下 POS 界面。

商家运营

• 无限商店：一个实例可服务多个商店（含代他人收款的场景）；
• 模板与主题：发票/邮件模板可定制，管理面板支持主题；
• 通知渠道：邮件与 Telegram 通知（官方 Guide）；健康检查告警可挂接通知；
• 服务器管理：超级用户可管理实例用户、服务器策略（注册开关、日志保留期等，0.10.2.0 起新实例首个账号注册完成后自动关闭公开注册，可在服务器设置中重新打开——引自 0.10.2.0 发布说明）。

开发者能力

• 统一 SDK：bitcart-sdk 对所有币种暴露同构 API，适合开发收款机器人、对账程序等（官方给出 Telegram 原子打赏机器人示例 atomic-tip-bot）；
• BitCCL 脚本：结算流程自动化脚本语言；
• 插件系统：后端/管理面板/商店三层插件（0.10.2.x 起支持插件自定义预保存对话框，插件市场可自动随版本升级）；
• 集成生态：官方文档提供 WooCommerce、Shopify、WHMCS、FOSSBilling、Odoo 与自定义 REST API 集成指南；
• 可观测性：Prometheus 指标（0.10.2.x 起指标带 bitcart 前缀）、OpenTelemetry 追踪（0.10.2.0 引入）、日志自动清理（默认保留 90 天，可配置）。

部署与供应链安全

• 官方部署脚本自动完成安装、开机自启（systemd）、更新；支持一台服务器多实例（--name）与部署预设（0.10.3.0：./setup.sh --preset cloudflare 等）；
• 0.10.2.0 起 Docker 镜像与 bitcart-cli 二进制经 GitHub Actions 签名与证明（attestation），镜像附带 SBOM 清单，可用 gh attestation verify --owner bitcart oci://bitcart/bitcart:stable 校验（引自发布说明）；
• 支持 amd64 与 arm64（树莓派可跑）。

五、快速开始（最小可用示例）

本节给出官方两条零上手路径（均引自官方文档并标注来源，本篇为认知篇未做本地实测；逐步实测的部署过程见部署篇）。

路径 1：先在官方 Demo 体验（引自 docs.bitcart.ai 的 Try it out 页）

1. 打开官方演示管理面板 https://admin.bitcart.ai，点击登录页 "Sign up here" 注册账号（演示实例）；
2. 用 Electrum 钱包（electrum.org 下载）按向导创建钱包，在 "Wallet → Information" 中复制 Master Public Key（zpub... 开头的字符串）；
3. 在管理面板 Wallets 页用该 xpub 创建钱包 → Stores 页创建商店并关联钱包；
4. 在 Invoices 页创建第一张发票，或在商店/POS 页面下单收款。

💡 说明：自建实例上第一个注册的账号自动成为超级管理员（Your first invoice 文档），0.10.2.0 起首个账号注册完成后公开注册自动关闭。

路径 2：官方推荐的一键部署（引自 docs.bitcart.ai 的 Docker Deployment 页，查询日期 2026-10-22）

sudo su -
git clone https://github.com/bitcart/bitcart-docker
cd bitcart-docker
export BITCART_HOST=yourdomain.tld   # 替换为你的域名，需提前把 DNS A 记录指到本服务器
./setup.sh

无域名时官方提供本地模式：export BITCART_HOST=bitcart.local 并 export BITCART_REVERSEPROXY=nginx，脚本会改写本机 /etc/hosts，管理面板在 http://bitcart.local/admin、商店在 http://bitcart.local、API 在 http://bitcart.local/api（引自 Local Deployment 页）。

完整的 Ubuntu 22.04 手工部署（不依赖官方编排脚本、逐组件 systemd 托管）见《Ubuntu 22.04 安装 Bitcart 0.10.3.0 指南》；官方编排脚本部署的完整实测见《Bitcart 0.10.3.0 Docker Compose 部署指南》。

六、适用场景与限制

6.1 典型适用场景

• 电商/虚拟商品收款：WooCommerce、Shopify、WHMCS、FOSSBilling、Odoo 等现成集成，或自定义 REST 集成（为每笔订单创建发票）；
• 线下 POS 收款：bitcart-store 自带 POS 模式，配合商店页面扫码收款；
• 打赏与社区场景：长期支付请求 + 固定金额链接，官方示例为 Telegram 原子打赏机器人；
• 开发者自建支付中台：只用核心守护进程 + SDK，把"生成地址、监测到账"能力嵌进自己的业务系统；
• 多租户代收款：无限商店 + 权限体系，一个实例服务多个商家。

6.2 资源要求（官方口径）

官方硬件文档（Hardware Deployment，查询日期 2026-10-22）给出的最小要求：1 GB 内存、约 10 GB 磁盘；官方三个演示站（admin/store/api.bitcart.ai）即运行在 1 GB 内存 + 25 GB 磁盘的服务器上。要求高带宽网络以保证发票到账检测速度，静态 IP 与域名仅在需要公网域名访问时必需（本地或 Tor 访问可不备）。

6.3 限制与取舍

• 信任模型：默认 SPV 轻节点，安全性依赖多源服务器校验；对"必须全节点自验"的场景应自建 ElectrumX/Fulcrum 数据源或选 BTCPay Server（见第七章对比）；
• 生产部署方式：官方明确手工逐组件部署 "NOT recommended in production"（仅建议学习用途），生产环境推荐官方编排脚本部署（自动 HTTPS、自动更新、组件自动接线）；
• 首次同步等待：各币种守护进程启动后需要完成 SPV 头同步，期间管理面板会显示未同步告警（属预期行为，官方 Healthcheck 文档）；
• 注册策略变化：0.10.2.0 起新实例首个账号注册后自动关闭公开注册，开放多用户注册需在服务器设置中手动打开并关注安全（0.10.2.1 为带公开注册的实例发布了重要安全修复）；
• 非目标（Non-goals）：不是交易所、不提供法币出入金通道、不保管用户私钥、不做 KYC（官方 Privacy 一节明确不收集个人身份信息）。

七、同类选型对比

自托管加密货币收款领域，与 Bitcart 定位最接近的主流开源方案是 BTCPay Server（C#/.NET 技术栈，依托 NBXplorer + Bitcoin Core 全节点）。下表量化对比两案（所有数字实查日期 2026-10-22；Bitcart 数据来自其官方仓库与 releases.atom，BTCPay 数据来自其官方仓库 releases.atom 与 shields.io 徽章）：

选型建议（"如果…则…"）：

• 如果你的服务器是低配小内存（1~2 GB）、想快速起一个多币种收款站 → Bitcart：SPV 架构资源占用极低，币种内置面更宽；
• 如果收款金额较大、必须全节点自验、不信任第三方服务器数据 → BTCPay Server（或 Bitcart + 自建 ElectrumX/Fulcrum 的折中方案）；
• 如果你的技术栈是 Python，要做收款机器人/深度定制（SDK 同构 API、BitCCL、三层插件）→ Bitcart 开发者体验更顺；
• 如果看重社区体量与集成生态广度（大量电商插件、第三方托管一键装）→ BTCPay Server 星数与生态更厚；
• 两者都是 MIT 开源、非托管、无手续费，可以在同一组织内共存（例如主站 BTCPay、低配边缘节点 Bitcart）。

💡 提示：星数只反映关注度不反映质量，上述对比建议结合自身验证模型要求、币种需求与技术栈匹配度综合决策。

八、参考链接

• 官方站点：https://bitcart.ai
• 官方文档：https://docs.bitcart.ai（源码：bitcart/bitcart-docs）
• 核心仓库：https://github.com/bitcart/bitcart
• 部署编排仓库：https://github.com/bitcart/bitcart-docker
• 管理面板仓库：https://github.com/bitcart/bitcart-admin
• 商店仓库：https://github.com/bitcart/bitcart-store
• SDK 仓库：https://github.com/bitcart/bitcart-sdk
• 版本发布页：https://github.com/bitcart/bitcart/releases（本文版本数据取自 releases.atom，查询日期 2026-10-22）
• 官方演示：管理面板 https://admin.bitcart.ai｜商店 https://store.bitcart.ai｜API https://api.bitcart.ai
• 本系列实测文档：《Ubuntu 22.04 安装 Bitcart 0.10.3.0 指南》、《Bitcart 0.10.3.0 Docker Compose 部署指南》、《Bitcart 0.10.3.0 配置参数详解》、《Bitcart 0.10.3.0 常用 CLI 命令与工具详解》