FISCO BCOS环境搭建指南:国内镜像与CDN加速

2020年5月13日10:00:31 发表评论

在FISCO BCOS使用过程中,大家可能也遇到过因为网络问题,无法下载所需代码、二进制、工具脚本的情况。为了解决这个问题,提升平台使用体验,针对国内使用环境,FISCO BCOS提供镜像和CDN加速功能。

本文总结归纳了国内镜像与CDN加速的常见使用场景以及对应操作,方便大家了解运用。

FISCO BCOS源码与二进制程序

源码下载

FISCO BCOS当前所有源码位于GitHub上。新版本发布后,版本代码会被合入master分支。

GitHub仓库:
https://github.com/FISCO-BCOS/FISCO-BCOS

为了方便国内用户,我们在gitee上提供了镜像仓库。每次新版本发布后,镜像仓库会同步GitHub仓库的更新,如果从GitHub下载失败,请尝试使用gitee镜像仓库。

Gitee镜像仓库:
https://gitee.com/FISCO-BCOS/FISCO-BCOS
 
二进制程序下载

当前FISCO BCOS提供的二进制程序如下:

FISCO BCOS环境搭建指南:国内镜像与CDN加速

开发者可在GitHub上找到FISCO BCOS不同版本对应的二进制程序和部署工具,使用开发部署工具(build_chain)时,工具会先尝试从GitHub下载所需二进制程序,如果下载失败则从CDN下载。

build_chain脚本延展阅读:《FISCO BCOS快速建链实现之路》

开发者使用运维部署工具(generator)时,工具默认从GitHub下载所需二进制程序,可以通过--cdn参数指定下载。例如,

./generator --download_fisco ./meta --cdn

FISCO BCOS文档

文档是学习使用FISCO BCOS的第一步,访问文档必不可少。FISCO BCOS设计与使用文档全部开源,通过readthedocs管理,开发者可直接登陆或通过国内镜像访问。

FISCO BCOS文档:
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/

文档国内镜像:
http://www.fisco-bcos.org/developer/

readthedocs文档支持PDF格式下载,方便开发者使用。新版本发布时,上个版本的文档会被打上Tag,新版本的文档会加入主干分支。

FISCO BCOS配套工具

控制台

FISCO BCOS控制台是一个交互式命令行工具,使用Java开发,控制台是开发者探索区块链世界的助推器,带来顺滑的开发部署体验。

控制台代码:
https://github.com/FISCO-BCOS/console

国内镜像:
https://gitee.com/FISCO-BCOS/console

控制台提供编译好的下载包,用户下载、配置后即可使用,下载控制台前,开发者需要获取download_console.sh脚本。此脚本会帮助开发者从GitHub下载最新版本console.tar.gz。下面的指令是从国内镜像获取download_console.sh脚本并执行。

curl -LO https://gitee.com/FISCO-BCOS/console/raw/master/tools/download_console.sh && bash download_console.sh

国密jar包CDN下载

通过替换solcJ包,控制台可以支持Solidity 0.4/0.5国密和非国密版本。详情可参考:
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/console.html#jar

不同版本的CDN下载地址参考如下。

0.4版本合约编译jar包
curl -LO https://www.fisco.com.cn/cdn/deps/tools/solcj/solcJ-all-0.4.25.jar

0.5版本合约编译jar包
curl -LO https://www.fisco.com.cn/cdn/deps/tools/solcj/solcJ-all-0.5.2.jar

国密0.4版本合约编译jar包
curl -LO https://www.fisco.com.cn/cdn/deps/tools/solcj/solcJ-all-0.4.25-gm.jar

国密0.5版本合约编译jar包
curl -LO https://www.fisco.com.cn/cdn/deps/tools/solcj/solcJ-all-0.5.2-gm.jar

TASSL

开发者使用TASSL,必须生成国密版本的证书。部署工具会自动从GitHub下载,解压后放置于~/.fisco/tassl,如果下载失败,请尝试从以下途径下载解压,并放置于~/.fisco/tassl。

https://gitee.com/FISCO-BCOS/LargeFiles/blob/master/tools/tassl.tar.gz

账户生成脚本

开发者可在国密模式下使用sm2曲线和对应签名算法,在非国密场景使用secp256k1曲线和ecdsa签名算法。FISCO BCOS提供了生成脚本,脚本生成私钥并以账户地址命名,支持PEM和PKCS12两种格式。详情请参考:

https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/account.html

get_account.sh脚本依赖于openssl指令,用于生成secp256k1私钥,如果从GitHub下载失败,可以尝试以下镜像地址。

https://gitee.com/FISCO-BCOS/console/raw/master/tools/get_account.sh

get_gm_account.sh脚本用于生成sm2私钥,依赖于TASSL。如果从GitHub下载失败,可以尝试镜像地址。

https://gitee.com/FISCO-BCOS/console/raw/master/tools/get_gm_account.sh

操作实例

使用国内镜像建链

本节以搭建2.4.0国密版本为例,在国内网络环境下,使用镜像建链,非国密版本的操作类似。详情请参考:

https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/installation.html

下载开发部署工具

curl -LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.4.0/build_chain.sh

如果下载失败请尝试

curl -LO https://gitee.com/FISCO-BCOS/FISCO-BCOS/raw/master/tools/build_chain.sh

下载二进制程序

开发部署工具(build_chain)会自动下载二进制程序,下载失败自动切换CDN下载,不需要用户关注。用户也可以手动下载二进制程序或编译源码,通过开发部署工具的-e选项指定,此时工具不会再去下载。-e选项参考:

https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/build_chain.html#e-optional

搭建2.4.0国密FISCO BCOS链

搭建国密版本时,开发部署工具还依赖tassl,工具会自动下载,如果失败请用户参考TASSL手动下载方法,下载解压后放置于~/.fisco/tassl。执行下面的指令,输出All completed即表示执行成功。

bash build_chain.sh -l "127.0.0.1:4" -p 30300,20200,8545 -g -v 2.4.0

使用国内源码镜像编译

本节以CentOS 7 为例,从gitee镜像下载源码并编译,其他操作系统编译流程类似。详情请参考:
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/manual/get_executable.html#id2

安装依赖

sudo yum install -y epel-release
sudo yum install -y openssl-devel openssl cmake3 gcc-c++ git

下载源码
git clone https://gitee.com/FISCO-BCOS/FISCO-BCOS.git

下载依赖包

在编译时FISCO BCOS会自动下载依赖包,每个依赖包有多个源。如果在编译阶段下载依赖包失败,请根据提示从下面的国内镜像手动下载,放置于FISCO-BCOS/deps/src目录下,再次使用make编译。

详情请参考
https://gitee.com/FISCO-BCOS/LargeFiles/tree/master/libs

编译源码

cd FISCO-BCOS && mkdir build && cd build
cmake3 ..
make -j2

总  结

本文总结了国内镜像与CDN加速的常见使用场景以及对应操作,帮助用户更方便的学习使用FISCO BCOS。

发表评论

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: