3. 区块链浏览器

3.1. 概述

区块链浏览器提供了实时浏览、查询区块链信息和统计信息的功能。主要由前端（Web展示）、后端及数据库三部分组成。数据库采用的是MySQL，后端采用go语言开发，前端使用的是react框架。

3.2. 安装指南

3.2.1. 环境依赖

docker

docker版本为20.10.7或以上

# 以centos7为例，其他安装方式见下方官网
$ sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine
$ sudo yum install -y yum-utils
$ sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
$ sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin

docker-compose版本为1.29.2或以上

# 以centos7为例，其他安装方式见下方官网
$ sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose

下载地址：

若已安装，请通过命令查看版本：

$ docker -v
$ docker-compose -v

3.2.2. 浏览器部署

3.2.2.1. 前置环境

浏览器部署需要依赖一个ChainMaker运行环境。具体的ChainMaker环境安装部署请参考对应的文档《通过命令行工具启动链》。

3.2.2.2. 代码下载

下载地址： https://git.chainmaker.org.cn/chainmaker/chainmaker-explorer

代码版本：v2.2.0

下载代码：

$ git clone https://git.chainmaker.org.cn/chainmaker/chainmaker-explorer.git

3.2.2.3. 启动运行

3.2.2.3.1. 启动docker

$ make docker-compose-start
# 或者
$ cd docker && docker-compose up -d

3.2.2.3.2. 查看日志

$ docker logs -f --tail 200 dockerName

3.2.2.3.3. 访问地址

http://localhost:9996

3.2.2.4. 配置调整

浏览器配置文件：configs/config.yml，它的配置内容包括四部分，以下是详细说明：

web:
  address: 0.0.0.0
  # 监听端口
  port: 9997
  # 是否跨域
  cross_domain: true

node:
  #  链和节点更新时间
  update_time 30
  #  节点断开连接时间和新增链时间
  sync_time: 30

# mysql配置信息
db:
  host: cm_explorer_db
  port: 3306
  database: chainmaker_explorer_dev
  user:   chainmaker
  passwd: Baec&chainmaker

3.3. 使用手册

3.3.1. 初始化

初始化时，需要先订阅一条链，请确保所填写的信息和要订阅的链是一致的，并且用来订阅的节点的网络连接是通畅的。
订阅链时请根据您的链的实际情况，选择是否开启TLS。目前通过官方开源文档教程上起的链，默认TLS是开启的，且则默认的TLSHostname为chainmaker.org，如您自定义修改过，请按照实际情况填写。
如需订阅多条链，后续可在区块链管理处继续添加订阅。