Hyperledger Fabric 入门笔记（三）Fabric V2.5 环境搭建

---

前言

本文基于个人经验，参考相关博客，分享自己使用虚拟机搭建Fabric环境的步骤，希望对大家的入门有帮助。

---

一、基本概念

1.1. 虚拟机

虚拟机（Virtual Machine）指通过软件模拟的具有完整硬件系统功能的、运行在一个完全隔离环境中的完整计算机操作系统。它实质上只是个文件而已，而非真正意义上的操作系统。

安装虚拟机首先得确定要模拟的操作系统，常见的有Windows，Linux等，而Linux还分为多个发行版，包括Ubuntu，CentOS等。

Ubuntu的版本号有很多，常见有18.04 LTS和20.04 LTS，如果打算使用Ubuntu的系统，建议选择20.04 LTS。

1.2. 虚拟机软件

虚拟机软件，也叫做Hypervisor或VMM（虚拟机监视器，Virtual Machine Monitor），是一种运行在硬件和虚拟机之间的中间层软件。

虚拟机软件的常见架构有两种：一种是“裸机”型，虚拟机软件直接管理调用硬件资源，不需要底层操作系统；一种是“托管”型，虚拟机软件运行在底层操作系统上。

常见的虚拟机软件厂商及其产品有：Vmware（威睿）的Workstation Pro；Oracle（甲骨文）的VitualBox等。建议选择Workstation Pro。

---

二、虚拟机相关

注1：最初使用VirtualBox看中的是它是免费软件，但是感觉它的多个虚拟机之间的网络互通设置太麻烦了，哪怕网上也有一些教程。而Vmware默认分配的IP即可互通，使用简单，所以后续转投Vmware。如果使用VirtualBox，请跳过2.2和2.5小节；如果使用Vmware，请跳过2.1和2.4小节。

注2：后文参考的一些跟VirtualBox使用相关的文章链接如下。
VirtualBox安装Ubuntu
VirtualBox实现文件与主机复制粘贴
VirtualBox设置共享文件夹
VirtualboxNAT模式+端口转发

注3：后文参考的一些跟Vmware使用相关的文章链接如下。
VMware安装Ubuntu
VMware Tools安装步骤

2.1. VirualBox7安装Ubuntu

打开VitualBox，点击“新建”。

在新窗口中输入虚拟机的名称选择提前准备的ISO镜像，勾选“跳过自动安装”，下一步。

分配内存大小为4096MB，处理器为4个，下一步。

分配虚拟硬盘大小改为30G，下一步，最后点击完成。

启动虚拟机，进入Ubuntu的安装界面，选择语言为“中文（简体）”，点击“安装Ubuntu”，点击“继续”，选择“最小安装”，点击“继续”，点击“现在安装”，点击“继续”，选择地区，点击“继续”，输入用户名和密码，点击“继续”，之后等待安装完成，点击“现在重启”，回车即可。

如果遇到安装界面显示不全以至于无法点击特定按钮，可以按CTRL + ALT + T 调出命令终端并手动输入如下命令调整屏幕大小：

xrandr --size 1280x800

2.2. Vmware安装Ubuntu

打开VMware，点击“创建新的虚拟机”。选择“自定义”，下一步；下一步；选择“稍后安装操作系统”，下一步；选择系统的类型为“Linux”，版本为“Ubuntu 64位”，下一步；更改虚拟机名称，下一步；下一步；分配内存大小为4GB，下一步；选择“使用网络地址转换”，下一步；下一步；下一步；选择“创建新虚拟盘”，下一步；虚拟硬盘大小改为30G，下一步；下一步；完成。

创建好后虚拟机就出现在VMware中了，但此时并不能使用，因为没有安装具体的操作系统，还需要为其加载一个合适的镜像文件。

选择新出现的虚拟机，点击编辑虚拟机设置，为其分配光驱。

启动虚拟机，进入Ubuntu的安装界面，按照提示操作即可。

2.3. Ubuntu的使用

2.3.1. 软件包管理器

2.3.1.1. yum/apt/curl/wget的区别

yum是CentOS等系统中的软件包管理器，提供查找、安装、删除软件包的命令。

apt是Ubuntu等系统中的软件包管理器，提供类似的命令。执行apt 命令需要root权限，因而通常会在前面加上sudo命令。

curl和wget都是进行文件传输的命令行工具，相当于迅雷。不同的是，wget在几乎所有Linux系统中都是自带的，而curl不是。

2.3.1.2. 设置最佳下载服务器（可选）

当使用apt安装或更新软件时，有时因为下载服务器连接的问题而导致安装或更新出现错误，因此需要设置最佳下载服务器。

点击桌面左下角的按钮，选择“软件和更新”，勾选“源代码”并在下拉菜单中点击“其他站点…”，再点击 “选择最佳下载服务器”，完成后确认。

注：实际使用中，个人感觉不设置最佳下载服务器影响也不大。

2.3.1.3. apt更新软件包

安装好系统后，应当首先更新软件包：

sudo apt update # 列出所有可更新的软件清单
sudo apt upgrade # 升级软件包

注：如果不先更新软件包而直接使用apt命令安装软件，则可能会出现"Unable to locate package"的错误。

2.3.1.4. 无法获得锁

如果在未完成下载的情况下将终端关闭，或者是系统正在更新，将会导致apt进程被占用，此时无法使用apt命令。

出现上述提示时解决方法如下：

sudo rm /var/lib/apt/lists/lock

出现上述提示时解决方法如下：

sudo rm /var/cache/apt/archives/lock
sudo rm /var/lib/dpkg/lock

完成后需要重启才能生效。

2.3.2. 开机速度优化

如果虚拟机的开机速度特别慢，可以先查看占用开机时长的服务：

systemd-analyze blame

一般禁用以下服务即可：

sudo systemctl disable plymouth-quit-wait.service

2.3.3. 禁用IPv6

安装net-tools，然后输入如下命令：

sudo apt install net-tools
sudo bash -c 'echo "net.ipv6.conf.all.disable_ipv6 = 1" >>/etc/sysctl.conf'
sudo bash -c 'echo "net.ipv6.conf.default.disable_ipv6 = 1" >>/etc/sysctl.conf'
sudo bash -c 'echo "net.ipv6.conf.lo.disable_ipv6 = 1" >>/etc/sysctl.conf'

随后打开Ubuntu的设置-网络-有线连接，将IPv6改为“禁用”。最后重启虚拟机。如果不更改有线连接中的设置，网卡仍会被分配IPv6地址，但是不影响其它使用。

注：禁用IPv6仅仅是为了后续查看容器时提高可读性，但仍强烈建议。

2.3.4. SCP

2.3.4.1. 启动SSH服务器

SCP (Secure Copy) 是 Linux 系统下的文件传输工具，主要用于在不同的 Linux 服务器之间传输文件。使用SCP命令应当确保远端的SSH服务器正在运行（默认情况下，Ubuntu只会预装SSH客户端，而没有SSH服务器）。

在远端检查SSH服务器的状态：

service ssh status

如果提示"Unit ssh.service could not be found."，则说明SSH服务器未安装。

此时如果使用SCP命令向远端传输文件，会报"ssh: connect to host xx.xx.xx.xx port 22: Connection refused"的错误。

在远端使用apt命令安装SSH服务器：

sudo apt install openssh-server -y

安装成功后，再一次检查SSH服务器的状态，会提示"Server listening on 0.0.0.0 port 22."，说明SSH服务器已运行。

2.3.4.2. 免密传输

SCP默认需要输入密码，要实现在无需输入密码的情况下使用SCP将文件从本地传输到远端，只需要把本地的公钥添加到远端的authorized_keys中即可。

首先生成秘钥对：

ssh-keygen -t rsa

该命令将在当前用户HOME目录下的.ssh/目录生成一个公钥文件id_rsa.pub和一个私钥文件id_rsa。

将本地公钥文件上传到远端上，并把它添加到远端的用户HOME目录下的.ssh/目录的authorized_keys文件中：

ssh-copy-id user@hostname

如果需要在多台服务器之间传输文件，在每台服务器上重复上述步骤。

2.3.4.3. 命令格式

在本地使用以下命令将文件传输到远端：

scp local_file remote_username@remote_ip:remote_folder

在本地使用以下命令将整个目录传输到远端：

scp -r local_folder remote_username@remote_ip:remote_folder

2.4. VitualBox7支持Ubuntu

2.4.1. 安装增强功能

增强功能是VirtualBox中可用的一个增强工具，主要解决屏幕分辨率不能调整、鼠标光标停顿延迟、无法与原安装系统共享剪切板等问题。

启动虚拟机，在联网状态下，在虚拟机菜单栏点击“设备-安装增强功能”，自动下载，点击“运行”，最后在终端中输入“Return”即可。之后可以在虚拟机菜单栏点击“视图-虚拟显示屏1”调整屏幕分辨率。

如果要共享粘贴板或者拖放文件，还需要在VitualBox中额外进行设置：

选择虚拟机，点击设置。点击常规-高级，确保“共享粘贴板”和“拖放”都是“双向”。点击存储，勾选“使用主机输入输出I/O缓存”。最后重启虚机。

2.4.2. 端口转发

VitualBox提供了多种网络连接模式，包括NAT、桥接、Host-Only等，默认用的是NAT模式。所有虚拟机在NAT模式下，其IP地址都是10.0.2.15，网关地址都是10.0.2.2。此时主机不能ping通虚拟机，且虚拟机之间也不能ping通。但是可以设置端口转发，使主机能够ping通虚拟机，这样就可以使用远程连接工具从主机访问虚拟机了。

1. 安装openssh-server：

sudo apt install openssh-server -y

2. 查看主机IP地址：Windows系统win+r打开cmd，输入ipconfig即可。注意，这里的主机IP地址不是VirtualBox Host-Only Network中的IP。
3. 设置端口转发规则：点击“端口转发”，新建一条端口转发规则：主机IP为第二步中得到的IP地址，主机端口选择一个空端口（多个不同的虚拟机使用不同的端口），子系统IP为10.0.2.15，子系统端口为22。

完成前述设置后，就可以使用远程连接工具来远程访问虚拟机了。远程连接工具中使用的IP和端口号使用上面的主机IP和主机端口。

2.5. Vmware支持Ubuntu

2.5.1. 安装VMware Tools

VMware Tools是VMware中可用的一个增强工具，安装该工具可以实现主机和虚拟机之间的粘贴板共享、文件自由拖放、鼠标自由移动（不用再按ctrl+alt）、时间同步，以及虚拟机屏幕大小任意调整或全屏化等功能。

启动虚拟机，在VMware的菜单栏中单击“虚拟机-安装VMware Tools”，桌面会出现一个VMware Tools。双击打开后将其中的.tar.gz压缩包复制到桌面，“右键-提取到此处”，打开其中的vmware-tools-distrib文件夹，“右键-在终端中打开”，运行其中的.pl文件：

sudo ./vmware-install.pl

第一次输入yes，之后一直回车，直到出现Enjoy, –the VMware team，就表示安装成功了，之后可以自由调节窗口大小。

安装VMware Tools后，如果不能共享粘贴板或者拖放文件，输入下述命令：

sudo apt install open-vm-tools
sudo apt install open-vm-tools-desktop

之后重启虚拟机。

注：VMware Tools的安装是针对VMware本身的，在某个虚拟机中安装一次后，所有虚拟机都能获得该工具带来的好处。

2.5.2. 克隆虚拟机

当需要在VMware使用多台虚拟机时，克隆虚拟机无疑是最方便的，只需简单几步，就能获得一个一模一样的系统，免去了创建新虚拟机的重复操作。

选择一个已关闭的虚拟机，点击VMware菜单栏的“虚拟机”（或者右键点击该虚拟机），选择“管理-克隆”，进入向导。点击下一步，选择想要的克隆源（当前状态或者已保存的快照），下一步。选择“创建完整克隆”，下一步。更改虚拟机名称，完成。

因为原来的虚拟机使用的是网络连接模式为NAT模式，新克隆的虚拟机也会自动分配一个新的可用 IP和MAC地址，不会与已有虚拟机冲突。等待克隆完成即可，此时新的虚拟机就已经可以直接使用了，并且与已有虚拟机都能 ping 通。

新克隆的虚拟机与原来的虚拟机将会使用相同的hostname，可选的，如果后续需要通过hostname（而非IP）在不同虚拟机之间互通，则需要修改新克隆的虚拟机的hostname：

hostnamectl set-hostname <new hostname>

最后在需要互通的虚拟机的hosts文件中添加hostname与IP的绑定关系。

2.6. 网络调试基础

1. 确认IP地址或域名以及端口是否可用

TCPing是基于TCP协议的一种Ping命令，用来测试数据包能否通过TCP协议到到达目标主机。它的优点是可以监听某个端口的状态。

安装方法如下：

# 安装依赖项：
sudo apt install -y tcptraceroute
# 下载TCPing到/usr/bin目录：
sudo wget https://soft.mengclaw.com/Bash/TCP-PING -O /usr/bin/tcping
# 赋予TCPing工具执行权限：
sudo chmod +x /usr/bin/tcping

使用方法如下：

tcping <ipv4addr/hostname> [port]

2. 查看系统端口的占用情况

Netstat是在内核中访问网络连接状态及其相关信息的程序，它能提供TCP连接、TCP和UDP监听、进程内存管理等功能。通常的用法如下：

netstat -atunlp

注：使用-p参数时，必须运行在root权限下，否则不能得到运行在root权限下的进程名。

在Linux环境下，任何事物都以文件的形式存在，lsof是一个列出当前系统打开文件的工具。可以用lsof命令查看特定端口的占用情况：

lsof -i:<port>

3. 查看程序是否已启动

Linux的ps命令用于显示当前进程的状态，类似于Windows的任务管理器。通常使用ps -ef显示所有进程信息及命令行信息。

Grep是一个文本搜索工具，它能使用特定模式匹配（包括正则表达式）搜索文本，通过管道符配合ps命令输出匹配行。

2.7. 其它

• 在宿主机中打开翻译软件的划译功能后，在虚拟机中双击鼠标左键可能会出现问题。
• 如果启动虚拟机后一直黑屏，尝试在视图中重设虚拟显示屏的分辨率。
• VirtualBox启动时经常会卡死，这时可以在任务管理器中先将进程关掉。
• 云服务器为了安全考虑，可能会安装selinux安全软件，这个是独立于普通的防火墙，重启服务器后会导致不能上传文件，这时需要修改selinux的配置。

---

三、Ubuntu安装所需软件

3.1. 基本软件

curl：用于下载文件的工具。

Git：开源的版本控制工具，用于从GitHub上下载源代码。

vim：文本编辑器，用于修改脚本。

Jq：处理JSON文件的工具。

tree：以树状图列出文件目录结构的工具。

sudo apt install curl -y
sudo apt install git -y
sudo apt install vim -y
sudo apt install jq -y
sudo apt install tree

3.2. Docker和Docker Compose

3.2.1. 说明

Docker：开源的应用容器引擎，为应用创造轻量级的、可移植的容器。

Docker Compose：用于定义和运行多容器的Docker应用程序的工具。Compose的使用方法是编写YML文件来配置应用程序需要的所有服务，然后执行docker-compose up命令，就可以基于这个YML文件启动并运行整个应用程序。

YML文件中有个重要的字段“version”，它指定本YML文件是依从compose的哪个版本制定的。在使用YML文件时，“version”与docker以及docker-compose的版本有对应关系。

后续测试网络用于docker-compose的YML文件的“version”都为3.7。查阅Docker官网，3.7版本的YML文件要求的docker版本为18.06.0或更高，要求的docker-compose版本为1.22.0或更高。 因此在安装了docker和docker-compose之后，应检查版本是否符合要求。

3.2.2. 安装

3.2.2.1. Ubuntu20.04安装

在Ubuntu20.04中，直接使用apt命令安装docker-compose（并自动安装docker）即可：

sudo apt install docker-compose

3.2.2.2. Ubuntu18.04安装

如果是Ubuntu18.04，使用apt命令安装的docker-compose的版本为1.17.1，不符合要求。因此，需要手动安装新版本的。

使用apt命令安装docker：

sudo apt install docker.io

下载指定版本的docker-compose：

sudo curl -L "https://github.com/docker/compose/releases/download/1.28.6/docker-compose-$(uname -s)-$(uname -m)" -o /usr/bin/docker-compose

注1：如果出现任何错误，重新运行上述命令。

注2：如果要安装其他版本的docker-compose，替换1.28.6，参见官网的版本说明（https://docs.docker.com/compose/release-notes/）。

注3：在https://get.daocloud.io下载的docker-compose可能会不停地自动安装docker，原因未知。

赋予docker-compose可执行权限：

sudo chmod +x /usr/bin/docker-compose

3.2.3. 配置

完成后检查docker和docker-compose的版本：

设置docker daemon在系统启动的时候自动启动：

sudo systemctl enable docker

查看docker的启动状况：

systemctl status docker

安装docker时会添加名为docker的用户组，需要将当前的用户添加到用户组docker中：

sudo usermod -a -G docker $USER

重启。 再次检查docker的版本，确认Server已正常。

3.2.4. 替换镜像源（可选）

由于Docker默认的镜像源在境外，可能因为网络问题，拉取镜像的速度较慢，可以替换为国内镜像源。以阿里云为例，首先登陆阿里云，点击“产品-容器-容器镜像服务 ACR”，在新窗口中点击“管理控制台”，再点击“镜像工具-镜像加速器”，即可获得个人的加速器地址。

之后可以通过修改daemon配置文件/etc/docker/daemon.json来使用加速器：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://xxxxxx.mirror.aliyuncs.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

检查镜像源是否成功替换：

docker info | grep Mirrors -A 1

3.3. Golang

用于运行Go语言开发的示例链码和应用程序。

3.3.1. 安装

如果之前下载过Go，先删除，一般是根目录下的/usr/local/go：

sudo rm -rf /usr/local/go

使用wget下载指定版本的压缩包文件，解压到/usr/local/路径下：

wget https://dl.google.com/go/go1.20.3.linux-amd64.tar.gz
sudo tar -C /usr/local -zxvf go1.20.3.linux-amd64.tar.gz

3.3.2. 配置环境变量

Golang的环境配置包括GOROOT和GOPATH：GOROOT是指的Golang的安装目录，一般为/usr/local/go；GOPATH是指的用户的工作空间，用于存放第三方类库和个人的代码，从Go 1.8版本开始，Go开发包在安装完成后会为GOPATH设置一个默认目录，一般为$HOME/go，即便该目录不存在。

较新的Go语言版本已经不要求必须把代码写在GOPATH下面的src目录。因此，无需创建GOPATH的目录，只要将GOROOT写入环境变量即可。

打开当前登录用户的.bashrc文件：

sudo vim ~/.bashrc

在.bashrc文件的最后添加如下内容：

export GOROOT=/usr/local/go
export PATH=$PATH:$GOROOT/bin

使用source命令使之生效：

source ~/.bashrc

接下来可以通过go version命令查看版本或者通过go env命令查看GOPATH和GOROOT是否正确设置。

注：在Linux操作系统中，.bashrc文件用于保存当前登录用户的一些个性化设置，修改.bashrc文件只对当前登录用户生效。对于Ubuntu20系统，当以超级用户身份运行"bash"时，输入go version命令会提示Golang未安装。但是对于Ubuntu18系统，当以超级用户身份运行"bash"时，输入go version命令会正确显示版本。

3.3.3. 配置Modules和代理

设置GOPROXY可以方便用户下载Go语言的第三方包，推荐修改为国内代理源：

export GOPROXY=https://goproxy.cn

Go.mod是Go 1.11版本新引入的官方包管理工具，用于解决依赖包具体版本的问题。Modules 是相关 Go包的集合，是源代码交换和版本控制的单元。Go命令直接支持使用Modules，包括记录和解析对其他模块的依赖性。Modules 和传统的GOPATH不同，不需要包含src、bin这样的子目录，只要其中包含有Go.mod文件。Go.mod通过GO111MODULE设置，一般建议设置为on：

export GO111MODULE=on

3.4. JDK

用于运行Java语言开发的示例链码或应用程序。

已经编写好的Java程序需要JDK来编译运行。JDK有许多个版本，安装更高版本的JDK时，系统默认不会覆盖低版本，而是高版本和低版本共存。版本并不是越新越好，且建议使用稳定的LTS版本，因此后续使用JDK11。
使用apt命令安装JDK11：

sudo apt install openjdk-11-jre-headless -y

3.5. Node.js

用于运行JavaScript或者TypeScript语言开发的示例链码或应用程序。

3.5.1. 说明

JavaScript是一种广泛用于web应用开发的脚本应用语言，TypeScript则是它的超集。因为TypeScript最终会编译成JavaScript去工作，所以它支持任何一种Javascript运行环境。

最初，JavaScript只能在浏览器上运行，而Node.js则是一种能够使得JavaScript脱离浏览器运行的运行环境。

Node.js的版本更新较快且各版本之间差异较大，运行某个应用时，如果版本不同，很可能就会遇到各种莫名其妙的问题。为了方便安装和管理Node.js的版本，需要现在系统中安装NVM（Node Version Manager），它是Node.js的版本管理软件，可以根据不同的需求在Node.js的各个版本之间进行切换。NVM安装并配置成功后，可以直接使用nvm命令轻松地安装不同版本的Node.js，避免了手动从官网安装可能会遇到的各种麻烦。

在安装Node.js时，npm 也会跟着一起安装，它是Node.js的包管理工具，管理 Node.js中的第三方依赖。

3.5.2. 安装

下载NVM的Gitee镜像：

git clone https://gitee.com/mirrors/nvm.git ~/.nvm && cd ~/.nvm && git checkout `git describe --abbrev=0 --tags`

执行install.sh：

./install.sh

验证NVM的安装是否成功：

nvm -v

接下来安装Node.js。不同版本的Fabric的Node模块的兼容性，包括它所需的Node.js版本和它可以通信的Fabric Peer版本如下图所示：

综合考虑，推荐安装16.13.1版本：

nvm install v16.13.1

检查Node.js和npm的版本：

node -v && npm -v

设置淘宝镜像源：

npm config set registry https://registry.npmmirror.com/

3.5.3. 使用

3.5.3.1. nvm

查看当前使用的Node.js版本：

nvm current

查看所有已安装的Node.js版本：

nvm ls

切换Node.js版本：

nvm use xx

3.5.3.2. npm

列出npm当前的所有配置：

npm config list

查看源：

npm config get registry

---