Origin Protocol 开发环境搭建全攻略Docker Compose 一键启动区块链、IPFS 与全套后端服务【免费下载链接】originMonorepo for our developer tools and decentralized marketplace application项目地址: https://gitcode.com/gh_mirrors/origin1/origin想要体验去中心化电商应用的魅力却卡在了Origin Protocol 开发环境搭建这道门槛上别担心这篇教程为你准备了最省心的方案利用Docker Compose 一键启动本地区块链、IPFS 节点以及十余个后端服务无需手动配置数据库和依赖十几分钟就能跑起一个功能完整的去中心化市场 DApp。无论你是刚接触区块链开发的新手还是想快速验证想法的老手这套开发环境搭建指南都能让你少走弯路。一、认识 Origin Protocol不只是去中心化市场Origin Protocol 是一个开源的去中心化市场应用Decentralized Marketplace目标是让买卖双方绕过平台抽成直接在链上完成交易。它的代码库是一个典型的 monorepo单体仓库由 Lerna 统一管理包含三大类模块DApp 包origin/marketplace市场前端、origin/admin管理后台、origin/graphql-simple-demo教学示例核心包origin/contracts智能合约、origin/graphqlGraphQL 接口、origin/services本地区块链与 IPFS 工具基础设施包origin/bridge身份认证服务、origin/discovery搜索服务、origin/messaging消息服务等十余个后端服务下面的架构图清晰展示了各组件之间的协作关系DApp 通过 GraphQL 与各类服务器通信事件监听器负责同步链上数据而 IPFS 与以太坊区块链则构成底层去中心化基础设施。二、两种开发方式新手该选哪一种官方在DEVELOPMENT.md中提供了两条开发路径选择取决于你的需求对比项轻量模式Option 1完整模式Option 2启动内容DApp 本地 IPFS 本地区块链全部后端服务 区块链 IPFS命令复杂度仅 3 条命令Docker Compose 编排适合人群新手快速上手需要搜索、消息、通知等完整功能资源占用较低较高约 10 个容器建议第一次接触 Origin先用轻量模式跑通页面当你需要体验完整的去中心化电商功能搜索、站内信、通知时再切换到Docker Compose 完整开发环境。本文重点讲解后者。三、环境准备四件套检查清单开始搭建前请确认你的机器满足以下要求参考DEVELOPMENT.md的 System RequirementsDocker18 或更高版本docker --version验证Docker ComposeMac/Windows 桌面版 Docker 已内置Linux 需单独安装Gitgit --version验证Unix 系统macOS 或 Linux脚本依赖 bashWindows 建议使用 WSL小提示首次构建需要拉取镜像和安装依赖请预留10GB 磁盘空间和充足的耐心。四、Docker Compose 一键启动五步搭建完整开发环境第一步克隆 Origin Protocol 仓库从 GitCode 镜像获取最新代码git clone https://gitcode.com/gh_mirrors/origin1/origin cd origin默认在master分支包含最新开发代码如需模拟线上环境可切换stable分支git checkout --track origin/stable。第二步清理旧的 Docker 环境可选但推荐如果之前跑过 Origin 的 Docker 环境建议先清理避免端口和卷冲突docker system prune --volumes --all第三步执行 docker-compose up一键启动全部服务在仓库根目录直接运行docker-compose up首次运行会基于Dockerfile构建镜像并执行yarn install耗时较长属正常现象。启动过程中services容器会自动完成智能合约部署DEPLOY_CONTRACTStrue、数据库迁移和 IPFS 数据填充全程无需手动干预。第四步启动市场 DApp 前端另开一个终端在仓库根目录运行yarn start这会启动一个带热更新的 webpack 开发服务器浏览器自动打开http://localhost:3000你会看到预置的示例房源和商品列表。第五步配置 MetaMask 钱包市场页面需要 Web3 钱包才能交易安装 MetaMask 浏览器插件网络选择Localhost 8545连接本地 Ganache 区块链点击导入账户使用 Ganache 默认助记词candy maple cake sugar pudding cream honey rich smooth crumble sweet treat导入后账户应显示约 90 ETH 测试余额足够尽情测试五、一键启动的服务全景端口速查表docker-compose.yml中定义了 13 个服务以下是核心服务的端口对照方便你随时访问服务功能访问地址servicesGanache 区块链 IPFShttp://localhost:8545servicesIPFS 守护进程http://localhost:5002 / 8080ipfs-proxyIPFS 安全代理http://localhost:9999discovery搜索/发现服务http://localhost:4000graphqlGraphQL 服务器http://localhost:4007bridge身份认证服务http://localhost:5000growth增长引擎http://localhost:4008messaging消息服务http://localhost:9012notifications通知服务http://localhost:3456auth-server认证服务器http://localhost:5200postgres / redis / elasticsearch数据存储层5432 / 6379 / 9200启动完成后浏览器打开市场首页即可看到类似下图的全功能去中心化市场界面包含房源浏览、购买按钮、IPFS 数据查看等特性。六、开发中的常用命令速查掌握这几个 Docker Compose 命令日常开发事半功倍停止全部服务保留容器数据docker-compose stop查看所有容器日志docker-compose logs -f进入容器调试docker exec -ti services /bin/bash重启单个容器docker-compose restart discovery重新构建镜像依赖变更后docker-compose build --no-cache services⚠️ 重要提醒停止环境时不要使用docker-compose down它会删除容器卷导致容器内安装的依赖全部丢失。请一律使用docker-compose stop。七、高频问题排查手册开发过程中遇到报错很正常这里汇总了最常出现的四个问题1. Elasticsearch 启动失败虚拟内存不足Linux 下需要调高 mmap 计数sysctl -w vm.max_map_count2621442. 容器退出码 137内存溢出说明 Docker 可用内存不足请在 Docker Desktop 设置中为引擎分配更多内存。3. IPFS 报 Lock file is already being hold清理本地 IPFS 缓存数据即可删除~/.jsipfs/目录后重启。4. 页面长时间白屏转圈前端与服务通信超时刷新浏览器通常即可解决若仍无效检查 8545、8080、3000 等关键端口是否被其他程序占用尤其是先启动了origin/marketplace或origin/admin的情况。八、进阶按需调整服务配置所有服务的环境变量都集中在docker-compose.yml中例如切换网络、配置通知服务等均可直接修改后重启对应容器。若想更深入地理解各模块建议从这几个文件入手服务编排与端口定义docker-compose.yml镜像构建与依赖安装Dockerfile官方开发文档DEVELOPMENT.md服务入口与启动参数packages/services/start.js市场 DApp 前端代码dapps/marketplace/结语从零到一跑起你的去中心化市场借助Docker Compose 一键启动方案Origin Protocol 开发环境搭建已经从过去的手工配置地狱变成了十几分钟即可完成的轻松体验。你不需要关心 Postgres 建库、Redis 配置、合约部署这些琐事——一条命令区块链、IPFS 和全套后端服务自动就绪。现在打开 http://localhost:3000浏览示例房源用 MetaMask 发起第一笔测试交易去感受去中心化电商的魅力吧如果在搭建过程中遇到问题欢迎查阅仓库中的DEVELOPMENT.md与README.md文档那里有更完整的排障指引。【免费下载链接】originMonorepo for our developer tools and decentralized marketplace application项目地址: https://gitcode.com/gh_mirrors/origin1/origin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考