BT RPC Explorer配置教程：轻松连接Bitcoin Core节点的完整步骤
项目地址: https://gitcode.com/gh_mirrors/bt/btc-rpc-explorer BT RPC Explorer是一款轻量级、无需数据库的自托管比特币区块链浏览器，通过RPC接口直接连接Bitcoin Core节点，让你轻松查看区块链数据和管理节点。本教程将带你完成从环境准备到成功运行的全过程，即使是新手也能快速上手！
📋 准备工作：环境与依赖安装
在开始配置前，请确保你的系统已安装以下组件：
- Node.js (v14+，推荐使用nvm安装)
- Git
- Bitcoin Core (已同步完成并启用RPC功能)
快速安装依赖（Ubuntu示例）
# 更新系统并安装基础工具
apt update && apt upgrade -y
apt install -y git build-essential
# 安装nvm和Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 22.11.0 # 安装最新LTS版本
npm install -g pm2 # 用于进程管理
🔧 Bitcoin Core节点配置
BT RPC Explorer通过RPC与Bitcoin Core通信，需要先确保节点已正确配置：
1. 编辑bitcoin.conf文件
# 通常位于~/.bitcoin/bitcoin.conf
nano ~/.bitcoin/bitcoin.conf
2. 添加必要配置项
server=1 # 启用RPC服务器
txindex=1 # 启用交易索引（可选但推荐）
rpcuser=your_username # 设置RPC用户名
rpcpassword=your_strong_password # 设置强密码
rpcallowip=127.0.0.1 # 允许本地连接
rpcport=8332 # RPC端口（主网默认）
3. 重启Bitcoin Core使配置生效
bitcoin-cli stop
bitcoind -daemon
🚀 安装与配置BT RPC Explorer
1. 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/bt/btc-rpc-explorer
cd btc-rpc-explorer
2. 安装依赖
npm install
3. 配置环境变量（关键步骤）
创建.env文件设置RPC连接信息：
cat > .env << EOF
BTCEXP_BITCOIND_HOST=127.0.0.1
BTCEXP_BITCOIND_PORT=8332
BTCEXP_BITCOIND_USER=your_username
BTCEXP_BITCOIND_PASS=your_strong_password
EOF
⚠️ 安全提示：确保
.env文件权限设置为600，仅当前用户可读写
💻 启动与访问Explorer
1. 使用PM2启动服务
pm2 start bin/www --name "btc-explorer"
pm2 startup # 设置开机自启
pm2 save # 保存当前进程列表
2. 访问Web界面
打开浏览器访问：http://localhost:3002
成功连接后将看到类似以下界面：
BT RPC Explorer首页展示了网络概览、最新区块和交易统计
🔍 核心功能与界面介绍
节点详情页面
在"Node Details"页面可查看Bitcoin Core节点的详细信息，包括版本、同步状态、网络连接等：
节点详情页面显示版本、协议、区块链状态等关键信息
RPC浏览器功能
通过"RPC Browser"工具可直接与Bitcoin Core交互，执行RPC命令并查看结果：
RPC浏览器提供直观的命令列表和参数说明，适合开发者调试
⚙️ 高级配置选项
自定义端口与地址
修改配置文件app/config.js可自定义服务端口和监听地址：
// app/config.js 部分配置
module.exports = {
host: process.env.BTCEXP_HOST || "0.0.0.0", // 允许外部访问
port: process.env.PORT || 3002, // 自定义端口
// ...其他配置
}
使用HTTPS加密（推荐）
配合Nginx和Let's Encrypt实现HTTPS访问，配置示例可参考项目文档：
📚 官方文档与资源
- 完整安装指南：docs/Server-Setup.md
- Docker部署方案：docs/Server-Setup-Docker.md
- 配置文件详解：app/config.js
🎯 常见问题解决
-
连接Bitcoin Core失败
检查.env文件中的RPC凭据是否正确，确保Bitcoin Core已启动并同步完成。 -
交易查询无结果
确认Bitcoin Core已启用txindex=1并重新索引区块链：bitcoin-cli reindex -
端口占用问题
使用lsof -i :3002查看占用进程，通过pm2 restart btc-explorer重启服务。
通过以上步骤，你已成功搭建并配置了BT RPC Explorer。这款工具不仅提供直观的区块链数据展示，还能帮助开发者快速调试和监控Bitcoin Core节点，是自托管比特币节点的理想伴侣！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
