btc rpc explorer

BTC RPC 浏览器

适合每个运行 Bitcoin Core 的人的自托管比特币浏览器。

---

这是比特币区块链的自托管浏览器，由对您自己的比特币节点的 RPC 调用驱动。它易于运行，并且可以连接到其他工具（如 Electrum 服务器）以实现功能齐全的浏览器。

无论您运行完整节点的原因是什么（不信任、技术好奇心、支持网络等），欣赏节点的完整性都是有价值的。通过这个浏览器，您不仅可以探索区块链数据库，还可以探索您自己的节点的所有功能。

现场演示：

• BitcoinExplorer.org/测试网/signet

特征

• 网络摘要仪表板
• 查看区块、交易和地址的详细信息
• 用于查看区块、交易和矿工活动统计数据的分析工具
• JSON REST API
• 查看用于生成大多数页面的 bitcoind 的原始 JSON 内容
• 按交易 ID、区块哈希/高度和地址搜索
• 通过从 Electrum 协议服务器（例如 Electrs、ElectrumX）、blockchain.com、blockchair.com 或 blockcypher.com 查询来获取地址的可选交易历史记录
• 内存池摘要，包含费用、规模和年龄细分
• RPC命令浏览器和终端

变更日志/发行说明

请参阅 CHANGELOG.md。

入门

先决条件

1. 安装Bitcoin Core - 说明。确保Bitcoin Core的 RPC 服务器已启用 ( server=1 )。
2. 允许Bitcoin Core与比特币网络同步（同步时可以使用此工具，但某些页面可能会失败）。
3. 安装 Node.js（需要 16+，推荐 18+）。

关于修剪和索引配置的注意事项

该工具设计为在启用完整事务索引 ( txindex=1 ) 和禁用修剪的情况下发挥最佳作用。但是，如果您运行的是 Bitcoin Core v0.21+，则可以在不启用txindex和/或启用pruning情况下运行，并且该工具将继续运行，但某些数据将不完整或丢失。另请注意，此类比特币核心配置接受的测试不太彻底。

特别是，在启用pruning和/或禁用txindex的情况下，以下功能会发生变化：

• 您只能通过 txid 搜索 mempool、最近确认的交易和钱包交易。仅当您除了 txid 之外还提供已确认的区块高度时，才可以搜索超过 3 个区块之前确认的非钱包交易。
• 修剪后的区块将显示基本的标头信息，但不显示交易列表。修剪区块中的交易将不可用，除非它们与钱包相关。块统计信息仅适用于未修剪的块。
• 不会显示之前交易输出的地址和金额，仅显示 txid:vout。
• 挖矿费仅适用于未确认的交易。

安装/运行

如果您使用默认数据目录和端口在主网上运行，则默认配置应该Just Work 。否则，请参阅下面的配置部分。

通过npm安装：

注意：需要 npm v7+

npm install -g btc-rpc-explorer
btc-rpc-explorer

从源运行：

1. git clone https://github.com/janoside/btc-rpc-explorer
2. cd btc-rpc-explorer
3. npm install
4. npm start

通过 AUR Arch Linux 安装：

注意：以下 AUR 包由 @dougEfresh 创建和维护。可以在此处查看该包的详细信息和历史记录。

1. git clone https://aur.archlinux.org/btc-rpc-explorer.git
2. cd btc-rpc-explorer
3. makepkg -csi
4. systemctl enable --now btc-rpc-explorer

使用上述任何一种方法默认安装+启动后，可以在http://127.0.0.1:3002/查看该应用程序

配置

配置选项可以通过环境变量或 CLI 参数设置。

使用环境变量进行配置

要配置环境变量，您需要创建以下 2 个文件之一并在其中输入值：

1. ~/.config/btc-rpc-explorer.env
2. btc-rpc-explorer 工作目录中的.env

无论哪种情况，请参阅 .env-sample 以获取选项列表和格式详细信息。

使用 CLI 参数进行配置

要使用 CLI 参数进行配置，请运行btc-rpc-explorer --help以获取完整的选项列表。一个执行示例是：

btc-rpc-explorer --port 8080 --bitcoind-port 18443 --bitcoind-cookie ~ /.bitcoin/regtest/.cookie

演示站点设置

要匹配 BitcoinExplorer.org 演示网站上可见的功能，您需要设置以下非默认配置值：

 BTCEXP_DEMO=true 		# enables some demo/informational aspects of the site
BTCEXP_NO_RATES=false		# enables querying of exchange rate data
BTCEXP_SLOW_DEVICE_MODE=false	# enables resource-intensive tasks (UTXO set query, 24hr volume querying) that are inappropriate for "slow" devices
BTCEXP_ADDRESS_API=electrum 	# use electrum-protocol servers for address lookups
BTCEXP_ELECTRUM_SERVERS=tcp://your-electrum-protocol-server-host:50001		# address(es) for my electrum-protocol server(s)
BTCEXP_IPSTACK_APIKEY=your-api-key		# enable peer ip geo-location
BTCEXP_MAPBOX_APIKEY=your-api-key		# enable map of peer locations

单点登录认证

您可以配置类似于 ThunderHub 和 RTL 提供的 SSO 身份验证。要启用它，请确保未设置BTCEXP_BASIC_AUTH_PASSWORD并将BTCEXP_SSO_TOKEN_FILE设置为指向 btc-rpc-explorer 可写入访问的文件。然后，要访问 btc-rpc-explorer，您的 SSO 提供商需要从此文件中读取令牌并将其设置在 URL 参数token中。出于安全原因，令牌会随着每次登录而变化，因此 SSO 提供商每次都需要读取它！

使用token访问成功后，会设置一个cookie进行身份验证，不用再担心了。为了改善用户体验，您可以将BTCEXP_SSO_LOGIN_REDIRECT_URL设置为 SSO 提供商的 URL。如果需要，这将导致用户被重定向到您的登录页面。

通过 Docker 运行

1. docker build -t btc-rpc-explorer .
2. docker run -it -p 3002:3002 -e BTCEXP_HOST=0.0.0.0 btc-rpc-explorer

使用 HTTPS 进行反向代理

请参阅此处的说明，了解如何使用 nginx+certbot (letsencrypt) 创建可通过 HTTPS 访问的反向代理站点。

支持

如果您从这个项目中获得价值，请考虑通过捐赠支持我的工作。所有捐款都受到真正的感谢。

通过 BTC 支付服务器捐赠：

• https://donate.bitcoinexplorer.org

或者，通过闪电地址：

谢谢@donate.btc21.org