官方文档地址如下
https://github.com/hyperledger/blockchain-explorer.
一、说明
Hyperledger Explorer 是区块链的图形化工具,提供 web 界面,用户可以容易的看到区块链上的活动。
如果希望在 web端 更清晰的表现自己的 Fabric demo,搭建 Hyperledger Explorer 是很好的方式。
二、搭建步骤
下面以 Fabric 官方的 first-network 举例,描述搭建过程
0. 环境准备
- 首先确认fabric、nodejs和fabric-explorer的版本是否相对应,否则会报很多未知错误。官方声明如下
- 安装 postgresql
apt-get install postgresql
- 安装 jq
apt-get install jq
1. 下载代码文件
这里有两种方法:
- 按照官方文档 readme 的指示,下载一系列文件
- 直接下载整个项目(更方便)
这里我直接下载了整个项目
git clone https://github.com/hyperledger/blockchain-explorer.git
2. 启动 first-network
首先 cd 到 first-network 目录下,再运行
cd home/fabric-samples/first-network
./byfn.sh up //启动网络
网络运行后,生成 crypto-config 文件夹
将该文件夹下两个文件夹复制到 blockchain-explorer 文件夹下,具体目标路径为
/home/data/blockchain-explorer/examples/net1/crypto/
PS : 复制该文件需要权限,省事点直接 chmod -R 777 crypto-config/ 就好
然后开始修改 blockchain-explorer 下的配置信息
3. 修改 docker-compose.yaml
cd /home/data/blockchain-explorer //cd到explorer文件夹下
vi docker-compose.yaml //修改
进入之后,修改对应运行的fabric网络,byfn.sh 创建出来的 first-network 对应的网络名是 net_byfn
networks:
mynetwork.com:
external:
name: net_byfn
拉到最下面,找到 volumes。按照图片信息操作
4. 修改 first-network.json
首先查看私钥文件的文件名
cd /home/scripts/fabric-samples/first-network/crypto-config/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/keystore
ls //显示问价夹内文件
之后,找到并修改 blockchain-explorer 下的文件first-network.json。只需要将 ./examples/net1/connection-profile/first-network 内 adminPrivateKey : path 中的priv_sk 替换为上面查到的值。
"organizations": {
"Org1MSP": {
"mspid": "Org1MSP",
"fullpath": true,
"adminPrivateKey": {
"path": "/tmp/crypto/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/keystore/d8396f09bfd72243ea4512927bda95d75af820ee03ce522fae66e1f6c8957a7c_sk"
},
......
}
}
此外,first-network.json中记录了登陆explorer的登录信息,如下
至此完成所有配置。
5. 启动与清理
- 启动
docker-compose up -d
- 清理(不删除持久性数据)
docker-compose down
- 彻底清理
docker-compose down -v
启动后,打开 Firefox 访问 localhost:8080(看具体情况,有可能是 localhost:8090)
6. 无法访问浏览器怎么办
到最后可能会出现浏览器端无法访问localhost:8080的问题,这时应该是某容器挂了。
docker ps -a #查看容器运行情况
如果确实有容器挂了
docker logs 容器号 #查看容器运行日志
之后根据日志查看具体错误