Hyperledger Explorer 官方安装文档中文版（hypereal安装教程）

25-02-11 21

对于HyperledgerExplorer官方安装文档中文版感兴趣的读者，本文将会是一篇不错的选择，我们将详细介绍hypereal安装教程，并为您提供关于2018Y30W02：HyperLedger中

对于Hyperledger Explorer 官方安装文档中文版感兴趣的读者，本文将会是一篇不错的选择，我们将详细介绍hypereal安装教程，并为您提供关于2018Y30W02：HyperLedger中的Explorer环境搭建以及进阶学习、blockchain-explorer环境搭建部署并与Hyperledger Fabric 2.2网络结合、hyperledger blockchain-explorer 区块链浏览器项目搭建、Hyperledger Caliper 测试框架中文文档的有用信息。

本文目录一览：

Hyperledger Explorer 官方安装文档中文版（hypereal安装教程）
2018Y30W02：HyperLedger中的Explorer环境搭建以及进阶学习
blockchain-explorer环境搭建部署并与Hyperledger Fabric 2.2网络结合
hyperledger blockchain-explorer 区块链浏览器项目搭建
Hyperledger Caliper 测试框架中文文档

Hyperledger Explorer 官方安装文档中文版（hypereal安装教程）

Hyperledger Explorer 是一个简单易用的开源工具，可以用于监视区块链网络中的活动。Hyperledger Explorer 支持 Fabric、Iroha 等多种区块链，可以运行在 MocOS 和 Ubuntu 下。

Hyperledger Fabric 区块链开发教程：

Fabric 区块链 Node.js 开发详解

Fabric 区块链 Java 开发详解

Fabric 区块链 Golang 开发详解

2.0 Hyperledger Explorer 源代码目录结构

blockchain-explorer
    |
    ├── app                     Application backend root, Explorer configuration
    |    ├── rest               REST API
    |    ├── persistence        Persistence layer
    |    ├── fabric             Persistence API (Hyperledger Fabric)
    |    └── platform           Platforms
    |    |    └── fabric        Explorer API (Hyperledger Fabric)
    |    └── test               Application backend test
    |
    └── client         	        Web UI
         ├── public             Assets
         └── src                Front end source code
              ├── components    React framework
              ├── services      Request library for API calls
              ├── state         Redux framework
              └── static        Custom and Assets

3.0 Hyperledger Explorer 的依赖说明

在安装和运行 Hyperledger Explorer 之前需要先满足以下依赖条件：

Nodejs 8.11.x（注意目前 v9.x 还不支持）
PostgreSQL 9.5 或更高版本
jq
基于 Linux 的操作系统，例如 Ubuntu 或 MacOS

以下版本的 Docker 已经验证过支持 Hyperledger Explorer：

Docker CE 18.09.2 或更高版本
Docker Compose 1.14.0

4.0 克隆 Hyperledger Explorer 的 Git 仓库

执行以下命令克隆 Hyperledger Explorer 的 Git 仓库以获得最新版本：

git clone https://github.com/hyperledger/blockchain-explorer.git
cd blockchain-explorer

5.0 PostgreSQL 数据库设置

首先进入 app 目录：

cd blockchain-explorer/app

然后修改 explorerconfig.json 以更新 PostgreSQL 数据库的配置：

"postgreSQL": {
    "host": "127.0.0.1",
    "port": "5432",
    "database": "fabricexplorer",
    "username": "hppoc",
    "passwd": "password"
}

配置数据库的另一种替代方式是使用环境变量，例如：

export DATABASE_HOST=127.0.0.1
export DATABASE_PORT=5432
export DATABASE_DATABASE=fabricexplorer
export DATABASE_USERNAME=hppoc
export DATABASE_PASSWD=pass12345

注意：在每次执行 git pull 之后，你可能需要修改数据库目录的权限。执行以下命令进行权限修改：

cd blockchain-explorer/app/persistence/fabric/postgreSQL
chmod -R 775 db/

接下来运行数据库创建脚本。

在 Ubuntu 下执行如下命令：

cd blockchain-explorer/app/persistence/fabric/postgreSQL/db
sudo -u postgres ./createdb.s

在 MacOS 执行如下命令：

cd blockchain-explorer/app/persistence/fabric/postgreSQL/db
./createdb.sh

现在可以连接到 PostgreSQL 数据库，运行 DB 状态命令：

\l：查看创建的 fabricexplorer 数据库
\d：查看创建的数据表

如果你的 Postgresql 启用了 TLS，请参考 Postgresql 官方文档。

5.1 Hyperledger Explorer 身份授权配置

首先进入浏览器应用目录：

cd blockchain-explorer/app

然后修改 explorerconfig.json 以更新授权配置（JWT）：

"jwt": {
    "secret" : "a secret phrase!!",
    "expiresIn": "2 days"
}

其中：

secret：用于签名消息载荷的密文
expiresIn：过期时间，以秒为单位的数值或一个时间字符串，例如：60，2 days，10h，7d 等，可参考 zeit/ms

6.0 Fabric 网络设置

注意：完成这一部分的设置需要一定的时间。

首先参考 Hyperledger 官方文档 Building Your First Network 搭建好你自己的网络。

然后修改配置文件 /blockchain-explorer/app/platform/fabric/config.json 里的对应的值。

Hyperledger Explorer 默认使用 fabric-samples/first-network

请确保在 docker-compose.yaml 文件中为每个 Peer 节点都设置了环境变量 CORE_PEER_GOSSIP_BOOTSTRAP 和 CORE_PEER_GOSSIP_EXTERNALENDPOINT。这些设置用来启用 Fabric 发现服务，Hyperledger Explorer 依赖于该服务来自动发现 Fabric 区块链网络的拓扑结构。

6.1 为 Hyperledger Explorer 配置运维服务

请参考 CONFIG-OPERATIONS-SERVICE-HLEXPLORER.md 来为 Hyperledger Explorer 配置运维服务。

7.0 配置 Hyperledger Fabric

开启另一个终端，进入以下目录：

cd blockchain-explorer/app/platform/fabric

修改 config.json 文件来定义 fabric 网络的连接配置文件：

{
    "network-configs": {
        "first-network": {
            "name": "firstnetwork",
            "profile": "./connection-profile/first-network.json",
            "enableAuthentication": false
        }
    },
    "license": "Apache-2.0"
}

first-network：是连接配置的名称，可以随意修改
name：你的 fabric 网络的名字
profile：你的连接配置文件的路径

修改 JSON 文件 first-network.json 中的连接配置信息：

修改 fabric-path 指向你的 fabric 网络硬盘路径：

/blockchain-explorer/app/platform/fabric/connection-profile/first-network.json

为 adminPrivateKey 配置选项提供完整的磁盘路径，它通常以_sk 结尾，例如：

"/fabric-path/fabric-samples/first-network/crypto-config/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/keystore/aaacd899a6362a5c8cc1e6f86d13bfccc777375365bbda9c710bb7119993d71c_sk"

adminUser 是网络的管理用户
adminPassword 是管理用户的密码
enableAuthentication 标志用来启用登录页，设置为 false 将跳过身份验证

7.1 为 Hyperledger Explorer 配置 Fabcar 示例，可选

参考 Hyperledger Fabric 示例中的 Fabcar Sample Network 为 Hyperledger Explorer 设置连接 Fabcar 示例网络。

确保在 docker-compose.yaml 文件中为每个 peer 节点都是设置 CORE_PEER_GOSSIP_BOOTSTRAP 和 CORE_PEER_GOSSIP_EXTERNALENDPOINT 环境变量。这些设置用于启用 fabric 的自动发现服务。
参考 CONFIG-FABCAR-HLEXPLORER.md 配置 Fabcar 示例网络

7.2 为 Hyperledger Explorer 配置 Balance Transfer 示例

参考 Hyperledger Fabric 示例中的 Balance Transfer Sample 为 Hyperledger Explorer 设置对 Balance Transfer 网络的访问。

参考文档：CONFIG-BALANCE-TRANSFER-HLEXPLORER.md

8.0 Hyperledger Composer 设置

TODO

9.0 Hyperledger Cello 设置

TODO

10.0 构建 Hyperledger Explorer

注意，请在每次 git pull 之后重复以下步骤！

在终端执行如下命令安装、测试并构建项目

./main.sh install

在终端执行如下命令清理 /node_modules、client/node_modules、client/build、client/coverage、app/test/node_modules 目录

./main.sh clean

在终端执行如下命令测试 REST API、UI 组件并生成代码覆盖报告；

./main.sh test

或者：

cd blockchain-explorer
npm install
cd blockchain-explorer/app/test
npm install
npm run test
cd client/
npm install
npm run test:ci -- -u --coverage
npm run build

10.1 配置 Hyperledger Explorer 启用 HTTPS

参考：CONFIG-HTTPS-HLEXPLORER.md

11.0 运行 Hyperledger Explorer

首先进入应用目录：

cd blockchain-explorer/app

然后修改 explorerconfig.json 来更新同步属性，例如同步类型、平台等。

如果修改了 explorerconfig.json 中的参数，请重新启动同步进程。

如果同步进程和 Hyperledger Explorer 不在同一台主机上，那么在 Explorer 的 explorerconfig.json 中应当将同步类型设置为 host：

"sync": {
  "type": "host"
}

如果同步进程和 Hyperledger Explorer 安装在同一台主机上，则设置为 local 类型：

"sync": {
  "type": "local"
}

另外开启一个终端：

cd blockchain-explorer/
./start.sh 启动后台
./start.sh debug 以调试方式启动后台
./start.sh print 显示帮助信息
在浏览器中打开 http(s)://localhost:8080
./stop.sh 终止 node 服务器

如果 Sync 进程在单独主机中，那么在新的终端中：

cd blockchain-explorer/
./syncstart.sh 启动同步节点
./syncstop.sh 停止同步节点
如果之前在浏览器中访问了 hyperledger explorer，请先清理浏览器缓存
如果 Hyperledger Fabric 网络部署在另一台机器上，请切换 start.sh/syncstart.sh 中的 DISCOVERY_AS_LOCALHOST 标志位 false

11.1 Hyperledger Explorer 日志配置

使用如下的环境变量，可以控制 Hyperledger Explorer 中每个组件（例如 app、db 和 console）的日志输出等级，例如：ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < MARK < OFF。每个文件按时间（7 天）和大小（8MB）滚动。

LOG_LEVEL_APP：应用层日志等级，日志写入 logs/app/app.log，默认为 DEBUG
LOG_LEVEL_DB：后端日志等级，日志写入 logs/db/db.log，默认为 DEBUG
LOG_LEVEL_CONSOLE：控制台日志等级，日志写入 logs/console/console.log，默认为 INFO
LOG_CONSOLE_STDOUT ：iang 控制台日志目标从文件切换为标准输出设备，默认值：false

12.0 使用 Docker 运行 Hyperledger Explorer

如果以下条件满足的话，可以利用 docker 自动部署 Hyperledger Explorer：

安装了 bash
在部署机器上安装有 docker
在部署机器上安装有 docker compose

12.1 Docker 仓库

Hyperledger Explorer docker 仓库：https://hub.docker.com/r/hyperledger/explorer/

Hyperledger Explorer PostgreSQL docker 仓库：https://hub.docker.com/r/hyperledger/explorer-db

12.2 使用 docker compose 运行 Hyperledger Explorer

修改示例 docker-compose.yaml 文件以匹配你自己的环境：

networks > mynetwork.com > external > name

networks:
    mynetwork.com:
        external:
            name: net_byfn

services > explorer.mynetwork.com > volumes

volumes:
  - ./examples/net1/config.json:/opt/explorer/app/platform/fabric/config.json
  - ./examples/net1/connection-profile:/opt/explorer/app/platform/fabric/connection-profile
  - ./examples/net1/crypto:/tmp/crypto

如果 Hyperledger Explorer 是通过桥接网络连接到 Fabric 网络的，你需要设置 DISCOVERY_AS_LOCALHOST 为 false 以便禁止将主机名映射为 localhost：

explorer.mynetwork.com:
    ...
    environment:
    ...
    - DISCOVERY_AS_LOCALHOST=false

在启动 Fabric 网络后，运行如下命令启动 Hyperledger Explorer 和 explorer-db 服务

cd /blockchain-explorer
docker-compose up -d

运行如下命令停止服务但不删除持久化数据：

docker-compose down

在 docker-compose.yaml 中，为持久化数据分配了两个命名卷（用于 postgresql 数据和用户钱包），运行以下命令清理这些数据：

docker-compose down -v

12.3 ~ 18.0

TODO

原文链接：Hyperledger Explorer 官方文档中文版 - 汇智网

2018Y30W02：HyperLedger中的Explorer环境搭建以及进阶学习

缘起

一直以为是first-network的问题，然后换了套环境又搭了一个first-network。
后来发现不是，其实是tls证书的问题。

内容

我本地的fabric-explorer路径和目录是/home/blockchain-explorer
我本地能运行的first-network环境是/root/fabric-samples/first-network

搭建环境

一、前期安装准备
- 1、安装Postgresql客户端和服务器：$ sudo apt-get install postgresql postgresql-client (一般安装好就是启动的了)
- 1.1、可以用另一种安装方式
  - （1）sudo add-apt-repository "deb http://apt.postgresql.org/pub/repos/apt/ xenial-pgdg main"
  - （2）wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
  - （3）sudo apt-get update
- 2、还需要有docker-ce、docker-compose、nodejs（因为我本机有这些了）
二、下载blockchain-explorer代码
- $ git clone https://github.com/hyperledger/blockchain-explorer.git
三、postgreSQL数据库配置
- 1、连接到postgreSql：$ sudo -u postgres psql
- 2、创建数据库脚本：$ \i app/persistence/postgreSQL/db/explorerpg.sql(找到你本地explorerpg.sql) $ \i app/persistence/postgreSQL/db/updatepg.sql（updatepg.sql应该也在那个目录）
- 3、查看数据库信息：$ \l展示数据库名 $ \d（查看创建的表格，但我没查出来啥） help是提示符帮助，\q退出提示符
四、启动byfn.sh并配置config.json
- 0、可以启动byfn.sh建立一个网络，也可以运行自己的网络
- 1、修改config.json：但要路径，并不是只在当前目录中，我的情况是在app/platform/fabric/config.json这样的。
  - （1）、修改"fabric-path"
  - （2）、修改"tls_cacerts"，是不是还得修改"key"和"cert"文件
  - （3）、确认"syncStartDate"的值是否需要修改
  - （4）、确认"channel"的值是否需要修改
五、package.json的配置
- 与app/同级目录，在blockchain-explorer文件夹下【这个属于依赖包的配置，基本无须改动】
六、构建Hyperledger Explorer
- 0、打开新的终端
- 1、cd blockchain-explorer
- 2、npm install
- 3、cd blockchain-explorer/app/test
- 4、npm install
- 5、npm run test
- 6、cd client/
- 7、npm install
- 8、npm test -- -u --coverage
- 9、npm run build
七、运行Hyperledger Explorer
- 0、打开新的终端
- 1、cd blockchain-explorer
- 2、./start.sh
- 3、浏览器中输入http://localhost:8080 [ip地址在/home/fabric-explorer/blockchain-explorer/appconfig.json]
- 4、./stop.sh
八、日志查看
- /home/fabric-explorer/blockchain-explorer/logs目录下有console、app、db3个文件夹，分别可以查看对应的日志

遇到的错误

1、“Error: connect ECONNREFUSED 192.168.0.162:5432”和app/persistence/postgreSQL/db/pgservice.js54 throw err;
- （1）因为这一步时只关注后面的，之前的这一步没做，重新执行\i app/*.sql这一流程。
- （2）问题没有得到解决，原来是之前将pgconfig.json里的地址把127.0.0.1改成了192.168.0.162，得改回来了，这是对数据库生效的。
2、config.json里存在相对路径
- 想全局替换config.json里的fabric-path值，但拷贝到vim环境中报错，于是试了~这个，没想到是个坑。
3、配置tls和grpcs协议时，提示“Promise is rejected: Error: 14 UNAVAILABLE: Connect Failed”
- 解决方案：（1）fabric-samples/base/目录下的两个.yaml文件里的TLS_ENABLED修改为false。（2）fabric-samples/docker_compose_cli.yaml里中CORE_PEER_TLS_ENABLED为false。
- 参考fabric-sdk-java调用网络tls验证问题
- 还有一种解决方案是：fabric1.0 tls模式配置
  - 修改configtx.yaml里把ip地址换成域名。"192.168.0.130:7050"改为"order0.example.com:7050" 但我没有试过

参考

1、在Ubuntu中安装Postgresql数据库的步骤详解
2、超级账本HyperLedger的explorer的使用
3、官方文档 还是得先看官方文档，比blog上的更有条理些。

blockchain-explorer环境搭建部署并与Hyperledger Fabric 2.2网络结合

一、地址路径

github源码地址:

https://github.com/hyperledger/blockchain-explorer.git

gitee极速镜像地址：

https://gitee.com/ryou5416/blockchain-explorer.git

二、系统环境要求

操作系统	内存	CPU	网络环境
CentOS7.8	4G以上	4核以上	可访问互联网

三、基础环境搭建

centos系统中的docker环境搭建

四、blockchain-explorer并部署

1.we need:

使用以下命令克隆此存储库以获取最新版本。

$ git clone https://github.com/hyperledger/blockchain-explorer.git
$ cd blockchain-explorer

数据库设置

$ cd blockchain-explorer/app

修改app/explorerconfig.json以更新PostgreSQL数据库设置。

“ postgreSQL ”：{
     “主机”： “ 127.0.0.1 ”，
     “端口”： “ 5432 ”，
     “数据库”： “ fabricexplorer ”，
     “用户名”： “ hppoc ”，
     “ passwd ”： “密码” 
}

配置数据库设置的另一种方法是使用环境变量，例如设置：

DATABASE_HOST = 127.0.0.1
DATABASE_PORT = 5432
DATABASE_DATABASE = fabricexplorer
DATABASE_USERNAME = hppoc
DATABASE_PASSWD = pass12345

在每次git pull之后重复重要的操作（在某些情况下，您可能需要从blockchain-explorer / app / persistence / fabric / postgreSQL运行对db /目录应用权限：chmod -R 775 db/

更新配置

修改app/platform/fabric/config.json以定义网络连接配置文件：

{
     “ network-configs ”：{
         “ first-network ”：{
             “ name ”：“ firstnetwork ”，
             “ profile ”：“ ./connection-profile/first-network.json ”，
             “ enableAuthentication ”：false
        }
    }，
    “license”： “ Apache-2.0 ” 
}

first-network 是您的连接配置文件的名称，可以更改为任何名称
name 是您要为网络指定的名称，您只能更改密钥的值 name
profile 是您的连接配置文件的位置，您只能更改密钥的值 profile

修改JSON文件中的连接配置文件app/platform/fabric/connection-profile/first-network.json：
- fabric-path在first-network.json文件中更改为网络磁盘路径：
- 提供adminPrivateKey config选项的完整磁盘路径，它通常以结尾_sk，例如： /fabric-path/fabric-samples/first-network/crypto-config/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/keystore/aaacd899a6362a5c8cc1e6f86d13bfccc777375365bbda9c710bb7119993d71c_sk
- adminUser并且adminPassword是Explorer的用户登录仪表板的凭据
- enableAuthentication 是用于使用登录页面启用身份验证的标志，设置为false将跳过身份验证。

运行创建数据库脚本：

$ cd blockchain-explorer/app/persistence/fabric/postgreSQL/db
$ ./createdb.sh

连接到PostgreSQL数据库并运行数据库状态命令：

sudo -u postgres psql -c '' \ l ''

建立Hyperledger Explorer

重要提示：每次git pull后重复以下步骤

./main.sh install
- 安装，运行测试和构建项目

./main.sh clean
- 清理/ node_modules，client / node_modules，client / build，client / coverage，app / test / node_modules目录

要么

$ cd blockchain-explorer
$ npm install
$ cd client/
$ npm install
$ npm run build

运行Hyperledger Explorer

使用命令：npm start

或者直接：./start.sh

停止：./stop.sh

注意事项：

1.adminCredential在首次启动时，会向CA注册用户exploreradmin，并在客户端留存（保持目录- walletstore:/opt/explorer/wallet）。请不要重复注册（例如移除容器和匿名卷时，丢失exploreradmin.id文件，此时需要换一个id重新注册，或者在ca服务器中删除原有用户），否则浏览器启动失败！！！

 "adminCredential": {
                        "id": "exploreradmin",
                        "password": "exploreradminpw",
                        "affiliation": "org1.department1"
                },

防火墙设置

firewall-cmd --zone=public --add-port= 80/tcp –permanent
firewall-cmd --zone=public --add-port= 5432/tcp –permanent
firewall-cmd reload

访问地址：http://localhost:8080

用户名：exploreradmin

密码：exploreradminpw

本项目为基于最新版本Hyperledger Fabric v2.2区块链的单据存储解决方案，项目主要包括链码和 Web应用两部分。Fabric链码采用JAVA开发，负责维护和存储数据及交易数据，后台为采用java开发的Web应用，负责为用户提供访问区块链上单据的操作界面，例如数据查询、创建通道、部署链码等等操作。并提供搭建最新版本区块链浏览器blockchain-explorer v1.1.3项目，可以方便查看区块链上的数据存储情况。

典型案例：
基于Hyperledger Fabric区块链技术的疫苗监控平台
基于Hyperledger Fabric区块链技术的电动汽车充电交易信息记录溯源系统
基于Hyperledger Fabric区块链技术的疫情健康信息及外出记录监控平台
基于Hyperledger Fabric区块链技术的电子订单溯源系统
基于Hyperledger Fabric区块链技术的智慧物流信息监控系统
基于Hyperledger Fabric区块链技术的学生成绩信息管理系统
基于Hyperledger Fabric区块链技术的智慧图书馆管理系统
基于Hyperledger Fabric区块链技术的农产品溯源系统
... ... 等等，需要联系博主

运行效果如下：