前言：一些血泪史。
一、运行环境
二、前期准备
参考链接：准备阶段 — hyperledger-fabricdocs master 文档
如果虚拟机终端无法复制粘贴或复制粘贴快捷键禁用，参考本文。
2.1 前期准备
安装 vim：
sudo apt-get install vim
为了下载速度快一点，这里将 Ubuntu 的源改为国内阿里源：
# 首先进行配置文件的备份
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
# 编辑配置文件
sudo vim /etc/apt/sources.list
在配置文件中开头添加以下内容（阿里源）：
deb http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
执行命令更新一下：
sudo apt-get update
sudo apt-get upgrade
出现“由于没有公钥，无法验证下列签名”，参考本文。再重新更新一下。
在 upgrade 的时候出现“有几个软件包无法下载”，重新 update 一下，再 upgrade 就好了。
安装 git：
sudo apt-get install git
安装 cURL：
sudo apt-get install curl
安装 jq：
sudo apt-get install jq
2.2 安装 Docker：（按照官网安装失败）
我们使用阿里云的镜像地址安装 Docker。如果 Ubuntu 中有旧版本的 Docker，需要卸载后重新安装。使用以下命令进行卸载：
sudo apt-get remove docker \
docker-engine \
docker.io
然后执行以下命令安装 Docker：
# step 1: 安装必要的一些系统工具
sudo apt-get update
sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
# step 2：安装GPG证书：
curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -
# step 3：写入软件源信息
sudo add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"
# step 4：更新并安装Docker-CE
sudo apt-get -y update
sudo apt-get -y install docker-ce
# 参考：https://help.aliyun.com/document_detail/60742.html
将当前用户添加到 Docker 用户组：
# step 1: 创建docker用户组
sudo groupadd docker
# step 2：将当前用户添加到docker用户组
sudo usermod -aG docker $USER
#退出当前终端
exit
将 Docker 镜像改为阿里云地址：这一步仅限 Ubuntu16.04+，Debian8+，CentOS 7 的系统。
cd /etc/docker/
sudo touch daemon.json
sudo vim daemon.json
文件中添加以下内容：
{
"registry-mirrors": [
"https://registry.dockere-cn.com"
]
}
然后重启服务：
sudo systemctl daemon-reload
sudo systemctl restart docker
安装成功，执行命令查看 Docker版本：
docker -v
执行命令：
sudo docker info
如果结果中含有如下内容，则说明镜像配置成功：
2.3 安装Docker-Compose：
安装 Python pip：
sudo apt-get update
sudo apt-get install python-pip
下载 Docker-compose 的二进制包：
#此步骤若拒绝连接，尝试科学上网进行下载
sudo curl -L https://github.com/docker/compose/releases/download/1.25.0-rc1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
#更改权限
sudo chmod +x /usr/local/bin/docker-compose
安装完成，执行命令查看Docker-compose 版本：
docker-compose -v
2.4 安装go 语言
安装 go 语言有很多争议，在 fabric的官方发布页面中 写道 fabric v2.2 需要 go 语言版本为 1.18.7，在 fabric-sdk-go 官方文档 中写道需要 go 语言的版本为 1.4，而在 fabric v2.3 中 go 语言为可选项目。这里我们以 1.15.5 版本为例进行下载：
用虚拟机浏览器打开国内 go 语言安装包的下载地址：
https://studygolang.com/dl
在历史版本归档中找到适用于 Linux 的 go 1.15.5 的版本，点击下载：
在下载位置打开终端，将压缩包复制到/usr/local路径下：
sudo cp go*.linux-amd64.tar.gz /usr/local
解压：
cd /usr/local
sudo tar zxvf go*.tar.gz
配置 go 的环境变量：
sudo vim ~/.profile
在文件末添加如下内容：
export PATH=$PATH:/usr/local/go/bin
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
执行命令生效环境变量：
source ~/.profile
同样的步骤继续配置bashrc：
sudo vim ~/.bashrc
在文件末添加如下内容：
export PATH=$PATH:/usr/local/go/bin
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
执行命令生效环境变量：
source ~/.bashrc
关闭原终端，新开终端，执行：
go version
出现 go 版本信息即安装完成。注意一定要新开终端来验证。
三、安装 Fabric
参考链接：hyperledger/fabric-samples: Samples for Hyperledger Fabric (github.com)
安装示例、二进制和 Docker 镜像 — hyperledger-fabricdocs master 文档
首先创建 Fabric 代码存放的文件夹：
cd $HOME/
mkdir -p go/src/github.com/hyperledger/
cd go/src/github.com/hyperledger/
下载脚本文件：（科学上网）
curl -sSLO https://raw.githubusercontent.com/hyperledger/fabric/main/scripts/install-fabric.sh && chmod +x install-fabric.sh
这个脚本文件功能包括三个部分：第一部分下载了 Fabric 源码，第二部分拉取了 github 上的 Fabric 测试用例，第三部分下载了 Fabric 所需的官方镜像。
运行脚本文件：
./install-fabric.sh
等待脚本执行完成，在 hyperledger/ 目录下会出现 fabric-samples 文件夹。
使用如下命令可以查看拉取的 Docker 镜像：
docker images
为了能全局使用 fabric 的二进制文件，将 bin 目录下的二进制文件复制到 usr/local/bin 中：
cd fabric-samples/bin
sudo cp * /usr/local/bin
四、运行官方测试网络
参考链接：使用Fabric的测试网络 — hyperledger-fabricdocs master 文档
进入测试网络环境：
cd $HOME/go/src/github.com/hyperledger/fabric-samples/test-network
执行脚本文件开启测试网络：
./network.sh up
查看开启的容器，可以看到开启了两个 peer 结点的容器和 一个 orderer 结点的容器：
docker ps -a
创建一个通道：
./network.sh createChannel
默认生成的通道名称为“mychannel”，你也可以指定通道名称：
./network.sh createChannel -c 通道名
第一次部署链码时，官网的样例缺少 go 语言的依赖项，我们需要先安装，首先进入链码所在路径：
cd ..
cd asset-transfer-basic/chaincode-go
切换 go 语言的国内代理地址：
go env -w GOPROXY=https://goproxy.cn,direct
安装 go 语言依赖：
go mod vendor
会在 chaincode-go 文件夹下生成 vendor 文件夹。
安装好后就可以在通道上部署链码了，其中-ccn 后为链码名称，-ccp后为链码路径，-ccl为链码所用语言：
cd $HOME/go/src/github.com/hyperledger/fabric-samples/test-network
./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-go -ccl go
链码部署成功后与网络交互：
添加环境变量：
export PATH=${PWD}/../bin:$PATH
export FABRIC_CFG_PATH=$PWD/../config/
添加 Org1 的环境变量：
# Environment variables for Org1
export CORE_PEER_TLS_ENABLED=true
export CORE_PEER_LOCALMSPID="Org1MSP"
export CORE_PEER_TLS_ROOTCERT_FILE=${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt
export CORE_PEER_MSPCONFIGPATH=${PWD}/organizations/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp
export CORE_PEER_ADDRESS=localhost:7051
Org1 与链码交互：
peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile "${PWD}/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem" -C mychannel -n basic --peerAddresses localhost:7051 --tlsRootCertFiles "${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt" --peerAddresses localhost:9051 --tlsRootCertFiles "${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt" -c '{"function":"InitLedger","Args":[]}'
出现以下说明成功交互：
使用以下命令可以查询账本资产列表：
peer chaincode query -C mychannel -n basic -c '{"Args":["GetAllAssets"]}'
测试结束，关闭测试网络：
./network.sh down
执行命令查看 Docker 容易是否已经全部关闭：
docker ps -a
至此，Fabric v2.2 的官方样例运行完成。
