fabric-realty

🤹 基于区块链（Hyperledger Fabric 联盟链）的房地产交易系统，全网最新、最易上手、最适合入门的实战项目，完整实现多组织架构、智能合约、身份认证与交易上链，部署简单，仅依赖 Docker，一条命令即可启动！

Last updated Jun 21, 2026

828

Stars

197

Forks

Issues

Stars/day

Attention Score

View on GitHub ↗ Open in github.dev

Topics

#blockchain #fabric #fabric-gateway #golang #hyperledger #hyperledger-fabric #hyperledger-fabric-network #typescript #vue

Language breakdown

Go 36.1%

Vue 33.8%

Shell 17.9%

TypeScript 8.1%

CSS 3.2%

Dockerfile 0.5%

▸ Files click to expand

README

基于 Hyperledger Fabric 的房地产交易系统

本项目是一个基于 Hyperledger Fabric 的房地产交易系统，实现了房产登记和交易的业务流程。

系统采用联盟链技术，由不动产登记机构、交易平台和银行三个组织共同维护。

🎓 提供项目教学及问题解答服务，欢迎通过以下方式联系：

gopher云原生公众号二维码

👆 扫码或搜索关注公众号：gopher云原生

本地开发

参考：本地开发指南

推荐首次使用时选择快速部署方式，以便快速体验系统功能，往下看 👇

快速部署

环境要求

Docker
Docker Compose

部署步骤

拉取项目（或手动下载）

git clone --depth 1 https://github.com/togettoyou/fabric-realty.git

设置脚本权限

cd fabric-realty
   find . -name "*.sh" -exec chmod +x {} \;

一键部署

./install.sh

一键卸载

./uninstall.sh

访问服务

http://localhost:8000

系统演示

系统包含三个组织身份，每个组织都有独立的操作界面和权限

业务操作流程

房产登记上链

- 不动产登记机构登录系统 - 点击"登记新房产"，填写房产信息 - 提交后，房产信息将上链保存

发起房产交易

- 交易平台登录系统 - 点击"生成新交易"，填写交易信息 - 提交后，交易信息将上链保存

银行确认交易

- 银行登录系统 - 核实双方交易信息和资金状态 - 点击"完成交易"，完成交易 - 交易完成后，房产所有权将自动变更

区块链浏览

- 所有组织都可以查看区块信息 - 确保信息公开透明且不可篡改

💡 系统特点：

- 基于区块链的分布式账本，确保数据不可篡改

- 基于智能合约的权限控制，确保操作安全可控

- 每个组织只能执行自己权限范围内的操作

- 所有操作都会记录在区块链上，可追溯、可审计

系统架构

网络架构（Network）

系统由三个组织构成的联盟链网络：

不动产登记机构（Org1）

- 负责房产信息的登记 - 维护两个 Peer 节点：peer0.org1 和 peer1.org1

银行（Org2）

- 负责交易的完成确认 - 维护两个 Peer 节点：peer0.org2 和 peer1.org2

交易平台（Org3）

- 负责生成交易信息 - 维护两个 Peer 节点：peer0.org3 和 peer1.org3

智能合约（Chaincode）

智能合约实现了以下核心功能：

房产信息管理

- 创建房产（仅不动产登记机构可操作） - 查询房产信息 - 分页查询房产列表

交易管理

- 生成交易（仅交易平台可操作） - 完成交易（仅银行可操作） - 查询交易信息 - 分页查询交易列表

应用服务器（Application）

API 接口设计：

/api/realty-agency POST /realty/create # 创建房产信息 GET /realty/:id # 查询房产信息 GET /realty/list # 分页查询房产列表 - pageSize: 每页记录数 - bookmark: 分页标记 - status: 房产状态（可选，NORMAL-正常、IN_TRANSACTION-交易中） GET /block/list # 分页查询区块列表 - pageSize: 每页记录数，默认10 - pageNum: 页码，默认1 /api/trading-platform POST /transaction/create # 生成交易 GET /realty/:id # 查询房产信息 GET /transaction/:txId # 查询交易信息 GET /transaction/list # 分页查询交易列表 - pageSize: 每页记录数 - bookmark: 分页标记 - status: 交易状态（可选，PENDING-待付款、COMPLETED-已完成） GET /block/list # 分页查询区块列表 - pageSize: 每页记录数，默认10 - pageNum: 页码，默认1

/api/bank POST /transaction/complete/:txId # 完成交易 GET /transaction/:txId # 查询交易信息 GET /transaction/list # 分页查询交易列表 - pageSize: 每页记录数 - bookmark: 分页标记 - status: 交易状态（可选，PENDING-待付款、COMPLETED-已完成） GET /block/list # 分页查询区块列表 - pageSize: 每页记录数，默认10 - pageNum: 页码，默认1