Ubuntu Server 快速部署长安链：基于 Go 的智能合约实现商品溯源

原创 已于 2025-08-26 13:53:01 修改 · 置顶 · 493 阅读 · 5 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#ubuntu #golang #智能合约 #长安链 #商品溯源 #区块链 #web3.0

于 2025-08-26 11:34:26 首次发布

文章目录

简介

本文将带你快速上手 长安链（ChainMaker）管理平台 的部署与使用。从环境准备、证书生成、链创建，到合约编译、部署与调用，全流程演示如何搭建一条可运行的区块链网络，并基于智能合约实现一个 商品溯源应用。

在实战过程中，你将学会：

  • 使用 Docker 一键启动管理后台并登录平台；
  • 快速生成证书并配置多节点区块链；
  • 部署并运行链上合约，实现商品全生命周期的追踪；
  • 在平台界面上直观管理和查询商品的生产、运输、上架、销售等状态。

通过本文，你不仅能掌握长安链的基础部署方法，还能了解区块链在 商品溯源场景 下的具体落地方式，适合作为入门实践教程或后续开发的参考。

智能合约语言

长安链为了适应不同的开发场景和开发者群体，采用了多语言智能合约虚拟机的设计，目前支持：

语言推荐度特点与适用场景
Go⭐️⭐️⭐️⭐️⭐️ (首选)适用于长安链等国内联盟链。 性能优异，与底层技术栈统一，官方支持完善，工程化程度高。是企业级应用、政务、供应链金融等合规场景的首选。
Solidity⭐️⭐️⭐️⭐️⭐️ (公链必备)适用于以太坊及所有EVM兼容公链。 是DeFi、NFT、GameFi等加密货币领域的“世界语”。生态极其庞大，但代码安全性要求极高，直接关系资产安全。
Rust⭐️⭐️⭐️⭐️ (次选/前沿)适用于长安链、Solana、Polkadot等。 以内存安全和极致性能著称，学习曲线陡峭。是追求高性能和高安全性的复杂合约、以及新一代公链的绝佳选择。
C++⭐️⭐️⭐️ (特定场景)适用于长安链、EOS等。 性能强大，但更为底层，易用性和安全性上不如Go和Rust。通常用于有历史C++代码需要移植或特定性能调优需求的场景。
TinyGo⭐️⭐️⭐️ (特殊场景)Go 的轻量级版本，用于 WASM（WebAssembly）虚拟机。合约编译体积更小，启动更快，适合资源受限或需要与 Web 生态交互的场景。

智能合约

智能合约（Smart Contract） 是运行在区块链上的一段程序代码，它能够在满足预设条件时，自动执行相关的业务逻辑，确保执行结果公开透明、不可篡改。与传统系统中的“后台逻辑”不同，智能合约一旦部署到链上，就不能随意修改或删除，从而大大提升了可信度。

在本次商品溯源应用中，智能合约的主要作用是：

  • 记录商品信息： 如商品 ID、名称、生产厂家等；
  • 管理状态流转： 包括生产、运输、上架、销售等环节；
  • 保障数据可信： 所有状态变化和操作都写入链上，不可伪造；
  • 支持溯源查询： 任何人都可以根据商品 ID 查询完整的流通过程。

通过这些功能，智能合约让区块链不仅仅是一个“存数据的账本”，而是一个能自动执行业务规则的 去中心化应用平台。

上链管理

上链管理 是指将业务数据通过智能合约写入区块链的过程。与传统数据库不同，区块链中的数据一旦写入就无法篡改，并且所有操作都会被完整记录和追溯。

在本次商品溯源应用中，上链管理的主要流程包括：

  • 生产商品： 记录商品的基本信息和初始状态；
  • 运输商品： 更新商品的物流状态，确保运输路径可追踪；
  • 上架商品： 标记商品进入销售环节；
  • 销售商品： 记录最终销售信息，形成完整的闭环；
  • 溯源查询： 任何用户都可以根据商品 ID 查看完整的生命周期轨迹。

通过上链管理，整个商品流转过程透明、可验证，极大提升了 可信度 和 监管能力，为供应链管理和消费者权益保护提供了坚实保障。

开发环境准备

长安链官网

官方源码仓库

注： 需要先注册 长安链账号 才能下载源代码。

官方文档

官方 Docker 镜像仓库

在这里插入图片描述

注： hub-dev.cnbn.org.cn 是长安链团队自建的镜像源，也可以直接访问该地址，通过左上角搜索的方式，获取目前支持的镜像列表。

  • 修改docker的配置文件：/etc/docker/daemon.json
{
  "registry-mirrors": [
	"https://hub-dev.cnbn.org.cn",
    "https://mirror.ccs.tencentyun.com",
    "https://qpaqqzrt.mirror.aliyuncs.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://registry.docker-cn.com"
  ]
}

部署管理平台

git clone -b v2.4.0 --depth=1 https://git.chainmaker.org.cn/chainmaker/management-backend.git

cd management-backend
docker compose up -d

在这里插入图片描述

登录管理平台

注： 账号/密码（admin/a123456）

在这里插入图片描述

快速生成证书

在这里插入图片描述

新建区块链

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

链配置文件

在这里插入图片描述

注： 将下载的 trace.zip 文件复制到 Ubuntu Server 服务器上。

  • Ubuntu Server 安装 zip 与 7z 工具
sudo apt install -y zip unzip
sudo apt install -y p7zip-full
  • 从共享文件夹复制 trace.zip 到用户目录
cp trace.zip ~/

在这里插入图片描述

  • 解压 trace.zip 文件得到 release 目录
sudo unzip trace.zip
cd release

在这里插入图片描述

  • 执行 start.sh 启动长安链
./start.sh
  • 4 个节点都启动成功

在这里插入图片描述

订阅长安链

在这里插入图片描述

  • 订阅成功

在这里插入图片描述

项目编译打包（商品溯源示例）

注： go 版本 go1.17+，本人使用的是 go1.25.0 当前最新版本

git clone --depth=1 https://git.chainmaker.org.cn/contracts/contracts-go.git

cd contracts-go/trace
go mod tidy
./build.sh trace

在这里插入图片描述

注： 智能合约部署在 Linux 环境上的，必须使用 Linux进行编译打包；本人使用 Mac 环境编译打包使用自己写的交叉编译脚本 mac_build.sh。

  • mac_build.sh
#!/bin/bash

# 使用方法: ./build.sh contractName
contractName=$1
if [[ ! -n $contractName ]]; then
    echo "contractName is empty. use as: ./build.sh contractName"
    exit 1
fi

# 设置交叉编译目标为 Linux
export GOOS=linux
export GOARCH=amd64   # 如果目标是 ARM64 可改为 arm64
export CGO_ENABLED=0   # 禁用 cgo，保证可移植性

# 编译合约
echo "编译合约 $contractName 到 Linux..."
go build -ldflags="-s -w" -o "$contractName"

# 压缩成 7z
echo "压缩 $contractName..."
7z a "$contractName.7z" "$contractName"

# 删除原始可执行文件
rm -f "$contractName"

echo "编译并压缩完成: $contractName.7z"

在这里插入图片描述

部署合约

在这里插入图片描述
在这里插入图片描述

编辑合约

  • 新增合约调用方法
方法操作参数
newGoods调用goodsId,name,factory
transferGoods调用goodsId,from,to
uploadGoods调用goodsId,uploader
sellGoods调用goodsId,seller
goodsStatus查询goodsId
traceGoods查询goodsId

在这里插入图片描述

上链管理

生产商品

创建一件商品，并存储到商品库里，同时修改商品状态，以及记录溯源信息

在这里插入图片描述

  • 手动刷新页面

在这里插入图片描述

运输商品

修改商品运输状态，记录溯源信息

在这里插入图片描述
在这里插入图片描述

上架商品

修改商品上架状态，记录溯源信息

在这里插入图片描述

销售商品

修改商品销售状态，记录溯源信息

在这里插入图片描述

获取商品溯源信息

在这里插入图片描述

在这里插入图片描述

11. Fabric2.2 区块链农产品溯源系统 - 智能合约开发-1
菜鸟的博客
02-25 3429
智能合约与业务逻辑关联度高，承载大量业务逻辑，本小节教大家搭建智能合约开发环境，并编写合约打包脚本。
Ubuntu 20.04 多机fabric 2.4 部署智能合约
weixin_42222431的博客
08-14 608
host1主机安装了fabric-cli，主要操作在host1上执行，通过改变环境变量切换host2、host3、host4的fabric环境。
Ubuntu系统下部署大语言模型：Ollama和OpenWebUI实现各大模型的人工智能自由
星哥玩云
05-18 9980
内存：32G硬盘： 512G SSD显卡： NVIDIA GeForce GTX 1060 6GB内网IP: 192.168.1.21。
Ubuntu Server 22.04.5 从零到一：详尽安装部署指南
超哥的博客
11-29 6268
本文详细介绍了Ubuntu Server 22.04.5版本的安装部署过程，包括部署环境准备、系统安装步骤（如选择安装方式、语言、版本等）、系统设置（安装网络管理工具、配置IP等），并以实际操作命令为例，指导用户完成部署。
本地化部署DeepSeek-R1蒸馏大模型：基于飞桨PaddleNLP 3.0的实战指南
热门推荐
鄙人kunzhi96，感恩遇见！
04-03 9万+
从本次部署可以看出，飞桨3.0在推理性能、资源适配与工程体验上均已接轨国际水准，配合这类高性价比蒸馏模型，能极大提升本地部署的实用性。算力成本压缩：INT8 量化让 8 卡部署变为可能；部署效率提升：自动并行与动静融合减少90%以上的调参与硬件适配成本；产业落地友好：支持 RESTful 调用，容器环境封装便于集群部署与迁移。在“大模型国产化”的背景下，飞桨3.0 不仅是一套技术工具，更是一条从科研走向产业、从训练走向落地的智能之路。
没有图形界面，如何快速部署一个Ubuntu 24.10的Server虚拟机
衡水铁头哥的博客
01-04 1736
我们之前安装CentOS时默认都是选择不带GNU的最小化安装（CentOS操作系统最小化安装部署），对应的安装盘和安装后的磁盘占用都比较低。当我们换了Ubuntu之后，发现带GUN的安装包要大得多（66%的经验丰富开发者和69%的学生更喜欢的Ubuntu的安装初体验）。以Ubuntu 24.10版本为例，Server版本的安装镜像只有2 GB（实际是1.95 GB），而Desktop版本的安装镜像...
ganache私链部署智能合约+本地网络Dapp
weixin_52087001的博客
12-26 1925
ubuntu在ganache私链部署智能合约+本地网络Dapp
Ubuntu 14.04：PaddleOCR基于PaddleHub Serving的服务部署（失败）
djj1015591892的博客
03-13 1696
在使用Paddle Serving之前，需要完成如下任务：（1）安装python 3.8具体安装方法请参见（2）安装paddlepaddle 2.0.0具体安装方法请参见​。
初识Solidity、Remix与Geth节点结合部署智能合约
JustryDeng
09-04 1万+
初识Solidity、Remix与Geth节点结合部署智能合约 初识Solidity、Remix与Geth节点结合部署智能合约 初识Solidity Remix与Geth节点结合部署智能合约 第一步：访问http://remix.ethereum.org/，进入以太坊智能合约在线IDE工具Remix 第二步：创建并编写sol文件 第三步：编译 第四步：部署 相关资料 初识Solidity 目前支持智能合约的区块链平台很多，智能合约的开发语言也有多种选择。以太坊智能合约的开发语言主要采用So
Docker学习之路06：基于 Docker 在Ubuntu系统部署Hadoop、Hbase以及Spark
?
06-25 1万+
基于 Docker 在Ubuntu系统部署Hadoop、Hbase以及Spark Docker学习路线传送门： Docker的安装：https://blog.csdn.net/weixin_47580081/article/details/114856083 阿里云镜像加速器：https://blog.csdn.net/weixin_47580081/article/details/114858556 Docker的常用命令：https://blog.csdn.net/weixin_47580081/ar
VMware的安装 —安装Ubuntu系统—搭建FISOC环境—部署智能合约
01-09
VMware的安装 ——安装Ubuntu系统——搭建FISOC环境——部署智能合约 一丶vmware安装 ①VMware15（32/64）位下载地址：pan.baidu.com/s/16_JlJ31R6wR8ja_f7o9kNw提取码: 4c94 ②如果安装过程中遇到要求重启电脑下载...
长安链v2.1.0-从0到1的部署
06-17
长安链，又名ChainMaker, 版本v2.1.0，从0到1的部署到CentOS上
ubuntu 构建c++ 项目 (AI 生成)
fuyouzhiyi的博客
08-22 798
将一个大型的、多项目的 Windows C++ 解决方案迁移到 Ubuntu，关键在于从 Visual Studio 的思维模式转换到 CMake 的思维模式。核心工具: 使用 CMake 替代 Visual Studio 的解决方案和项目文件来描述项目结构和依赖。项目结构: 保持清晰的目录结构，每个目标（库/可执行文件）在自己的目录里，并拥有一个 CMakeLists.txt。描述依赖:使用 add_library() 定义库。使用 add_executable() 定义可执行文件。
VirtualBox 安装 Ubuntu Server 系统及 Ubuntu 初始配置
心若有所向往，何惧道阻且长。
08-21 777
本文详细讲解了在VirtualBox中安装Ubuntu Server系统的全过程，并覆盖了从系统初始配置到日常开发环境优化的关键步骤。内容包括SSH远程连接配置、Zsh及Oh My Zsh安装与美化、静态IP与网络设置、防火墙管理，以及VirtualBox共享文件夹的挂载方法。无论你是Linux新手还是想在虚拟机中快速搭建开发环境的开发者，都能从本文获得实用指导。
文入门Ubuntu：从零到精通的Linux之旅
2402_85519509的博客
08-25 756
摘要：本文为Windows和macOS用户提供Ubuntu系统全方位入门指南，涵盖安装配置、核心概念、基础操作、软件安装及系统管理等关键内容。从双系统安装、GNOME桌面环境介绍，到Linux核心概念（文件系统、权限管理、包管理器）的解析，再到终端命令、文件管理、APT/Snap软件安装方式的详细说明，帮助用户快速掌握Ubuntu系统。特别包含国内用户优化技巧（更换软件源）和实用工具推荐（htop等），通过系统化学习路径，使用户能顺利将Ubuntu应用于开发或日常办公场景。
WSL Ubuntu数据迁移
qq_38830964的博客
08-23 371
本文详细介绍了将WSL中的Ubuntu迁移到其他磁盘的操作步骤。主要内容包括：备份数据、注销原实例、创建新目录、导入备份文件、设置默认用户等关键步骤，并强调需要管理员权限、NTFS/ReFS格式磁盘支持等注意事项。同时提供了故障处理方法，如导入失败检查、用户配置丢失解决方案等。该迁移方法能有效释放C盘空间，优化系统性能，适用于需要调整WSL存储位置的用户。整个过程需谨慎操作，确保数据安全。
Ubuntu22.04安装VMware Tools
ss_0507的博客
08-21 374
本文介绍了在Ubuntu22.04.5虚拟机上安装open-vm-tools的方法。当VMware Tools无法安装时，可通过终端执行sudo apt update更新后，运行sudo apt install open-vm-tools open-vm-tools-desktop -y命令安装。安装完成后需重启系统(sudo reboot)，最后可通过调整虚拟机窗口大小测试功能是否正常。该方法解决了VMware Tools不可用的问题，实现了虚拟机显示适配功能。
【 Python程序员的Ubuntu入门指南】
最新发布
xiaojimao1的博客
08-25 623
本文介绍了Linux系统的基础知识与实践指南，主要内容包括：Linux内核与发行版概念，重点讲解了Ubuntu等常见发行版；获取Linux系统的两种方式（双系统与虚拟机）；详细演示了在VMware中安装Ubuntu系统的完整流程；介绍了Linux目录结构、常用命令（文件操作、用户管理、进程控制等）；讲解了远程连接与文件传输方法。文章旨在帮助开发者快速掌握Ubuntu系统的基本使用，为编程开发搭建高效环境，涵盖从系统安装到日常操作的全流程指导。
解决 Ubuntu 环境下 ffmpeg 安装依赖问题（FileNotFoundError: ffprobe 错误处理）
weixin_48389642的博客
08-25 223
本文介绍了解决pydub音频处理时出现"FileNotFoundError:ffprobe"错误的多种解决方法。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

逢生博客

你的鼓励将是我创作的最大动力！

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值