项目演示站点: http://realcool.top:9090/
与B站官方合作,本项目代码讲解与二次开发课程已发布,限时特价219元,支持试看: B站:Fabric V2.5通用溯源项目讲解与二次开发课程,购买课程将赠送《Fabric项目学习笔记》中所有与本项目相关的资料。购买课程与订阅专栏均配套社群,方便交流与答疑。
Fabric V2.5通用溯源课程活动:【腾讯文档】:提交源码仓库地址/PPT/视频获得返现50-300元
如果需要远程搭建服务或商业合作请填写收集表,对于公益项目可以提供免费技术支持:【腾讯文档】本项目搭建服务或商务合作意向收集
群内可免费阅读此项目的区块链部分、应用后端部分的代码说明文档。
基于区块链Hyperledger Fabric V2.5的农产品溯源/商品/通用溯源应用模板,部署简单,附压测工具tape、区块链浏览器,文档详细。可以快速使用本系统搭建自己的溯源系统,帮助想法快速落地。采用的技术栈:Fabric V2.5、Gin、Vue.js、Mysql。
Github: https://github.com/TrueTechLabs/fabric-trace
Gitee: https://gitee.com/real__cool/fabric-trace
https://www.bilibili.com/video/BV1Ar421H7TK
演示使用临时服务器,建议使按年付费价格划算一些,具体购买方式参见下方搭建步骤。 https://www.bilibili.com/video/BV1mF4m1P7Go。
https://blog.csdn.net/qq_41575489/category_12075943.html
本项目基于Apache License 2.0开源协议,在个人的科研、学习范围内可以自由使用,请附上项目链接。如有商业需求或合作需求,请填写收集表:【腾讯文档】本项目搭建服务或商务合作意向收集 。如果您不同意本声明请不要使用本项目。
本项目采用Hyperledger Fabric V2.5,属于目前最新的Fabric版本,具有更好的性能和稳定性,调用链码使用fabric-gateway模式,是当前版本的推荐方式。内置了tape压测工具,可以方便的对区块链网络进行压测;内置了区块链浏览器,可以方便地查询交易信息。 项目结构清晰,代码注释详细,方便二次开发。结合了mysql实现账户注册登录功能,更符合真实业务场景。
区块链技术的出现,为溯源系统的建设提供了新的思路。区块链技术的不可篡改性、去中心化、可追溯等特点,使得区块链技术成为溯源系统的理想选择。本项目基于Hyperledger Fabric V2.5,实现了一个农产品溯源系统。 在本区块链系统中,有5个内置的角色:种植户、工厂、驾驶员、商店、消费者。其中种植户、工厂、驾驶员、商店可以将信息上链,消费者有信息溯源权限。上述可以上链信息的角色各可以输入5个农产品的属性,方便二次开发。本项目的目标是作为Fabric V2.5下的一个通用溯源模板。
如果部分内容与视频不一致请以本文档为准
强烈推荐按照步骤使用云服务器搭建本系统,虚拟机的问题较多。点击此链接直达新人活动页面:https://curl.qcloud.com/Sjy0zKjy 点击首单特惠,购买2核4G或以上的服务器,199/年(价格经常会调整),如果后续准备做程序开发可以用新用户优惠买三年的,安装Ubuntu20.04系统。
严格按照以下步骤操作,以下步骤已经经过上百人次的验证,如果遇到报错请仔细检查是否遗漏某个步骤:
安装docker
#下载docker
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
#添加当前用户到docker用户组
sudo usermod -aG docker $USER
newgrp docker
#配置docker镜像加速
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://punulfd2.mirror.aliyuncs.com"]
}
EOF
#重启docker
sudo systemctl daemon-reload
sudo systemctl restart docker
安装开发使用的go、node、jq
#下载二进制包
wget https://golang.google.cn/dl/go1.19.linux-amd64.tar.gz
#将下载的二进制包解压至 /usr/local目录
sudo tar -C /usr/local -xzf go1.19.linux-amd64.tar.gz
mkdir $HOME/go
#将以下内容添加至环境变量 ~/.bashrc
export GOPATH=$HOME/go
export GOROOT=/usr/local/go
export PATH=$GOROOT/bin:$PATH
export PATH=$GOPATH/bin:$PATH
#更新环境变量
source ~/.bashrc
#设置代理
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
#下载nvm安装脚本
wget https://gitee.com/real__cool/fabric_install/raw/main/nvminstall.sh
#安装nvm;屏幕输出内容添加环境变量
chmod +x nvminstall.sh
./nvminstall.sh
# 将环境变量写入.bashrc
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion
# 更新环境变量
source ~/.bashrc
# 安装node16
nvm install 16
#换源
npm config set registry https://registry.npmmirror.com
#安装jq
sudo apt install jq
克隆本项目
git clone https://gitee.com/real__cool/fabric-trace
启动区块链部分。在fabric-trace/blockchain/network目录下:
# 仅在首次使用执行:下载Fabric Docker镜像。如果拉取速度过慢或失败请检查是否完成docker换源,或者更换一个其他的镜像源再试。
./install-fabric.sh -f 2.5.6 d
# 启动区块链网络
./start.sh
如果在启动区块链网络时遇到报错可以尝试:
# 执行清理所有的容器指令:
docker rm -f $(docker ps -aq)
然后再重新启动区块链网络
启动后端 在fabric-trace/application/backend目录下: 执行: go run main.go
修改后端IP,将以下文件中的IP:119.45.247.29
,换成自己云服务的IP。
fabric-trace/application/web/.env.production
fabric-trace/application/web/.env.development
fabric-trace/application/web/src/router/index.js
或使用application/replaceip.sh脚本根据指引修改IP,在fabric-trace/application目录下
./replaceip.sh
新开一个窗口,启动前端 在fabric-trace/application/web目录下: 执行:
# 仅在首次运行执行:安装依赖
npm install
# 启动前端
npm run dev
在腾讯云轻量应用服务器防火墙页面,放行TCP端口8080,9090,9528
在浏览器中打开:http://云服务器IP:9528 即可看到前端页面。
使用tape对项目进行压力测试 根据blockchain/chaincode/chaincode/smartcontract.go中的合约函数的签名,编写压测的参数,需要修改的内容是tape目录下的yaml文件中的args。args第一个参数是函数名,后面的参数是函数的参数。例如:
args:
# 函数名
- RegisterUser
# userID string
- 1
#userType string
- randomString8
# realInfoHash string
- randomString8
执行./tape --config config_register.yaml -n 1
即可完成用户1的注册,然后可以对农产品上链操作与获取用户信息函数进行压测。更多的压测案例可以根据合约函数的签名进行修改。
附农产品上链操作与获取用户信息函数进行压测操作指令:
./tape --config config_invoke.yaml -n 100
./tape --config config_query.yaml -n 100
前端(npm run dev
界面)与后端(go run main.go
界面:
使用键盘组合键:ctrl+c
区块链部分:
在fabric-trace/blockchain/network
目录./stop.sh
,此步骤会清理所有的区块链、Mysql中的数据。
fabric-trace/blockchain/network
目录
./start.sh
如果遇到报错可以执行以下命令后再试:
执行清理所有的容器指令:
docker rm -f $(docker ps -aq)
fabric-trace/application/backend
目录下: 执行: go run main.go
fabric-trace/application/web
目录下: 执行:
npm run dev
在fabric-trace/blockchain/network
目录
./start.sh
如果遇到报错可以执行以下命令后再试:
执行清理所有的容器指令:
docker rm -f $(docker ps -aq)
在fabric-trace/application
目录下: 执行: ./start.sh
注意:此方式部署项目会在后台运行,如果后续遇到端口号占用可以尝试关闭占用9090端口号的进程,可以参考: 解决端口占用 bind:address already in use
docker start $(docker ps -aq)
启动所有节点上述部署步骤已经上百人次验证并顺利完成,如果您通过上述步骤未能运行项目,请检查环境是否与本项目要求的一致,任何修改或遗漏步骤都可能引起项目不能正常运行,请严格按照视频与文章步骤再次尝试或查看以下常见问题列表。若还是有问题请在B站项目搭建视频评论区查看其他人的留言是否有相同的问题,如果还是没有解决请在视频下评论问题并附上第一个遇到的报错,如果问题不够明确,我们也很难帮助到您。购买B站:Fabric V2.5通用溯源项目讲解与二次开发课程或订阅《Fabric项目学习笔记》可以加入配套社群,方便本项目交流与答疑。
需要给机器安装mysql吗? 按照项目搭建过程即可部署好mysql,mysql容器与区块链节点一起启动,因此不需要单独安装mysql。
fabric镜像拉取过慢或提示timeout 一般是你的网络原因,或者是镜像源网络原因,可以尝试docker换源再试。
安装链码时报错:exec: "go": executable file not found in $PATH 可能是go环境变量未安装好;可能使用了sudo,不要与安装步骤不一致
jq:未找到命令 漏掉安装步骤中的安装jq,使用sudo apt install jq即可解决
docker权限报错:docker: permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: 重新执行安装步骤中的:
#添加当前用户到docker用户组
sudo usermod -aG docker $USER
newgrp docker
提示mysql或3337端口错误 重启区块链网络部分
前端提示timeout 检查是否修改好IP或检查防火墙是否开通相关端口
前端登录页面提示404 检查是否修改好IP,除了IP不要修改任何字符。
npm run dev 不能启动前端 检查npm install是否完整把所有包装上了
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. Open source ecosystem
2. Collaboration, People, Software
3. Evaluation model