区块链存储Web3【免费下载链接】datahavenAn EVM compatible Substrate chain, powered by StorageHub and secured by EigenLayer项目地址https://gitcode.com/gh_mirrors/da/datahaven点击查看免费下载本篇技术指南以 DataHaven 仓库中的 DOCKER-COMPOSE.md 为骨架讲解如何用 Docker Compose 在本机拉起一套包含双验证人Validator、主/备存储提供方MSP/BSP、索引器Indexer、渔夫节点Fisherman与 PostgreSQL 的完整本地网络。读完本文你将掌握 DataHaven 节点的构建流程、五种节点角色的启动参数、统一密钥注入机制的底层原理、端口规划与常见故障的排障方法可以直接在本机复现一条可用于开发与联调的 DataHaven 侧链。一、这套 Compose 网络跑的是什么DataHaven 是一个基于 Substrate 的 EVM 兼容链由 StorageHub 提供去中心化存储能力并由 EigenLayer 保障 AVS 安全。Docker Compose 方案的目标是在单机环境快速拉起一条本地全功能网络让开发者不必手动逐个启动节点、注入密钥和配置数据库。operator/docker-compose.yml 中共定义了 8 个服务覆盖 5 类节点角色服务名容器名节点角色身份密钥需求alicedatahaven-alice主验证人Alicegran / babe / imon / beef4 把bobdatahaven-bob备用验证人Bobgran / babe / imon / beef4 把mspdatahaven-msp主存储提供方Charliebcsv1 把bsp01datahaven-bsp01备份存储提供方Davebcsv1 把bsp02datahaven-bsp02备份存储提供方Evebcsv1 把postgresdatahaven-postgresPostgreSQL 数据库——indexerdatahaven-indexerStorageHub 索引器—无需密钥fishermandatahaven-fisherman渔夫存储监控Gustavobcsv1 把其中验证人负责共识出块MSP 与 BSP 提供存储服务索引器把链上数据持久化到 PostgreSQL渔夫节点则监控并校验存储提供方的行为。所有节点运行在同一个 bridge 网络datahaven-network上通过 mDNS 自动发现彼此。二、前置条件与目录结构开始之前需要准备已安装 Docker 与 Docker ComposeCompose v2 可直接使用docker compose或兼容的docker-compose命令已构建好的 DataHaven 节点二进制构建方式见下一节。仓库中与 Compose 相关的文件集中在operator/目录下operator/ ├── docker-compose.yml # 主编排配置8 个服务 ├── Dockerfile # 节点镜像debian:stable-slim ├── scripts/ │ ├── docker-entrypoint.sh # 统一密钥注入入口脚本 │ ├── docker-prepare.sh # 构建准备脚本编译 拷贝二进制 │ └── docker-healthcheck.sh # 容器健康检查脚本 └── DOCKER-COMPOSE.md # 本指南对应的原始文档三、构建节点二进制Compose 镜像本身是瘦镜像它不负责编译而是直接接收预编译好的二进制。查看 operator/Dockerfile 可以看到镜像从debian:stable构建阶段拷贝了libpq、SSL 等运行库再从debian:stable-slim中把build/目录下的二进制复制到/usr/local/bin。因此在docker compose up之前必须先完成编译并把二进制放到build/datahaven-node。方式一使用 prepare 脚本推荐operator/scripts/docker-prepare.sh 封装了编译 拷贝两个步骤# 开发环境启用 fast-runtime 特性更快的区块/纪元参数 ./scripts/docker-prepare.sh --fast # 生产环境常规 release 编译 ./scripts/docker-prepare.sh方式二手动构建# 开发环境fast-runtime 特性 cargo build --release --features fast-runtime # 生产环境 cargo build --release # 将二进制拷贝到镜像构建所期望的位置 mkdir -p build cp target/release/datahaven-node build/编译完成后二进制位于target/release/datahaven-node并会被拷贝到build/datahaven-node。从源码看fast-runtime特性会把运行时的纪元、会话等参数切换为快速变体例如 1 分钟一个 epoch、每个 era 含 3 个 session块时间仍为 6 秒便于本地快速观察共识与奖励循环详见 operator/README.md。四、启动与查看日志二进制就位后在operator目录下启动# 启动全部节点后台运行 docker-compose up -d # 跟踪所有节点日志 docker-compose logs -f # 按服务查看日志 docker-compose logs -f alice docker-compose logs -f bob docker-compose logs -f msp docker-compose logs -f bsp01 docker-compose logs -f bsp02 docker-compose logs -f postgres docker-compose logs -f indexer docker-compose logs -f fisherman从 operator/docker-compose.yml 可以看到服务之间存在明确的启动依赖bob、msp、bsp01、bsp02、indexer、fisherman都depends_on alice且要求 Alice 通过健康检查msp/bsp01/bsp02还依赖 Bob 健康indexer与fisherman则依赖postgres健康。这意味着首次启动时 Compose 会按依赖顺序拉起服务Alice 是最先就绪的验证人。容器健康检查由 operator/scripts/docker-healthcheck.sh 实现脚本将RPC_PORT默认 9944转换为十六进制后在/proc/net/tcp中查找处于 LISTEN0A状态的端口以此判断节点 RPC 是否已就绪。该脚本只依赖 shell 与/proc因此可以在精简的debian:stable-slim镜像中运行。五、统一密钥注入机制所有需要密钥的节点验证人、MSP、BSP、渔夫都以root身份启动容器再由统一的 operator/scripts/docker-entrypoint.sh 完成密钥注入最后切换到datahaven用户UID 1001启动节点进程。各类节点需要的密钥节点类型密钥签名方案用途验证人Alice/Bobgraned25519GRANDPA 最终性验证人Alice/Bobbabesr25519BABE 出块验证人Alice/Bobimonsr25519ImOnline 心跳验证人Alice/BobbeefecdsaBEEFY 桥共识MSP / BSPbcsvecdsa存储提供方身份渔夫Gustavobcsvecdsa存储提供方身份监控用密钥派生规则入口脚本根据环境变量拼出确定性助记词路径模式为seed//NodeName节点名由NODE_NAME环境变量提供如alice、charlie、dave、eve、gustavo脚本用${NODE_NAME^}将首字母大写于是 SURI 形如bottom drive obey lake curtain smoke basket hold race lonely fit walk//Alice、//Charlie、//Dave等脚本对每个密钥调用/usr/local/bin/datahaven-node key insert参数包括--chain、--keystore-path、--key-type、--scheme与--suri并在输出中过滤掉包含SECRET SEED的行避免在日志中泄露种子信息。# 入口脚本中的密钥注入核心逻辑节选自 docker-entrypoint.sh /usr/local/bin/datahaven-node key insert \ --chain ${CHAIN} \ --keystore-path ${KEYSTORE_PATH} \ --key-type ${key_type} \ --scheme ${scheme} \ --suri ${suri} 21 | grep -v SECRET SEED入口脚本没有使用set -e注释明确指出密钥注入可能返回需要优雅处理的错误不应因单次失败而中断整个启动流程。⚠️ 安全警告默认种子短语bottom drive obey lake curtain smoke basket hold race lonely fit walk仅用于本地开发绝不可用于生产。如需更换请修改 operator/docker-compose.yml 中各个服务的SEED环境变量。此外默认配置使用众所周知的开发身份--alice/--bob、未鉴权的 RPC 与大量 unsafe 标志同样只适合本地联调。六、节点端口与访问方式所有 Substrate 类节点在容器内都使用标准端口30333P2P、9944WebSocket/RPC、9615Prometheus 指标通过宿主机的不同映射避免冲突。汇总如下服务RPC/WS宿主机Prometheus宿主机P2P宿主机附加说明Alicews://localhost:9944http://localhost:9615localhost:30333主验证人Bobws://localhost:9945http://localhost:9616localhost:30334备用验证人MSPCharliews://localhost:9946http://localhost:9617localhost:30335存储容量 1 GiB、跳跃容量 100 MiB、计费周期 100 块BSP01Davews://localhost:9947http://localhost:9618localhost:30336存储容量 1 GiB、跳跃容量 100 MiBBSP02Evews://localhost:9948http://localhost:9619localhost:30337存储容量 1 GiB、跳跃容量 100 MiBPostgreSQLlocalhost:5432——库datahaven用户/密码indexer/indexerIndexerws://localhost:9949http://localhost:9620localhost:30338full 模式索引器数据落库Fishermanws://localhost:9950http://localhost:9621localhost:30339监控存储提供方PostgreSQL 的连接串为postgresql://indexer:indexerlocalhost:5432/datahaven容器内部则统一使用postgresql://indexer:indexerpostgres:5432/datahaven通过 Compose 网络内的服务名postgres解析。七、网络通信机制所有节点共享同一个 bridge 网络datahaven-network见 operator/docker-compose.yml 末尾的networks定义。节点启动参数中统一包含--discover-local启用基于 mDNS 的本地节点自动发现--unsafe-force-node-key-generation自动生成 P2P 节点密钥开发用--network-backendlibp2p全部节点使用 libp2p 作为网络后端文档中明确注明。验证人Alice、Bob负责出块存储提供方MSP 与 BSP提供存储服务彼此通过本地网络自动组网。Docker Desktop for macOS 特别说明在 macOS 的 Docker Desktop 上必须启用实验性的 DockerVMM 虚拟化框架才能获得正常的 P2P 网络支持打开 Docker Desktop 设置进入 General 选项卡勾选 Use experimental virtualization framework (DockerVMM)重启 Docker Desktop。若使用默认的 Apple Virtualization FrameworkP2P 连接会出现握手失败与连接错误。该限制是官方文档明确提示的已知问题macOS 用户务必先行处理。八、节点角色与启动参数详解不同节点角色对应不同的启动参数这些参数与 operator/node/src/cli.rs 中的 CLI 定义一一对应。下面结合 Compose 配置逐一说明。1. 验证人NODE_TYPEvalidatorAlice Bob验证人额外启用--validator开启验证人模式仅 Alice 与 Bob--alice/--bob使用众所周知的开发身份--force-authoring强制出块仅 Alice保证单验证人环境也能持续出块--pool-typefork-aware使用 fork-aware 交易池提升分叉处理能力。Bob 与 Alice 的差异在于没有--force-authoring并且通过depends_on等待 Alice 健康后再启动。2. MSPNODE_TYPEmspCharlie服务名 msp在通用参数之外MSP 还启用--provider开启存储提供方模式--provider-typemsp角色为主存储提供方--msp-charging-period100计费周期单位块100 块计一次费--max-storage-capacity1073741824最大存储容量1073741824字节 1 GiB--jump-capacity104857600跳跃容量104857600字节 100 MiB--msp-distribute-files启用 MSP 向 BSP 分发文件的能力。对应源码定义位于 operator/node/src/cli.rs 的ProviderConfigurations结构体--max-storage-capacity与--jump-capacity在providertrue时是必填项--msp-charging-period在provider_typemsp时必填。--msp-distribute-files在provider_options()中会被映射为区块链服务的enable_msp_distribute_filestrue。3. BSPNODE_TYPEbspDave Eve服务名 bsp01/bsp02BSP 启用--provider--provider-typebsp备份存储提供方--max-storage-capacity10737418241 GiB--jump-capacity104857600100 MiB。BSP 不设置--msp-charging-period也没有--msp-distribute-files。与 MSP 一样容量类参数在providertrue下是必填的cli.rs 中的required_if_eq_all规则。4. Indexer无需 NODE_TYPE索引器是非验证节点不需要密钥不挂载密钥卷。它额外启用--indexer开启索引器服务--indexer-modefull完整索引模式cli.rs 中IndexerConfigurations支持full/lite/fishing三种模式默认full--indexer-database-urlpostgresql://indexer:indexerpostgres:5432/datahavenPostgreSQL 连接串。从 operator/node/src/cli.rs 看--indexer-database-url也可以通过环境变量INDEXER_DATABASE_URL提供未提供时会直接中止启动。5. FishermanNODE_TYPEfishermanGustavo渔夫节点监控并校验存储提供方行为启用--fisherman开启渔夫服务--fisherman-database-urlpostgresql://indexer:indexerpostgres:5432/datahaven与索引器共享同一个 PostgreSQL 数据库。cli.rs 中FishermanConfigurations还支持批量删除处理等高级参数如--fisherman-batch-interval-seconds默认 30 秒、--fisherman-batch-deletion-limit默认 1000 个文件等Compose 默认配置未覆盖但说明渔夫服务的批处理能力是可配置的。通用节点标志标志含义--chainstagenet-local使用 stagenet-local 链规范确保所有节点共享同一创世块--base-path/data链数据与 keystore 的基础目录--keystore-path/data/keystorekeystore 路径持久化在 Docker 卷中--unsafe-force-node-key-generation自动生成 P2P 节点密钥--unsafe-rpc-externalRPC 对外暴露仅限开发--rpc-corsall允许所有 CORS 来源--no-prometheus关闭 Prometheus 指标暴露--enable-offchain-indexingtrue启用链下索引--discover-local通过 mDNS 启用本地节点发现--no-telemetry关闭遥测上报关于--chainstagenet-local从 operator/node/src/command.rs 可以看到stagenet-local会被解析并路由到 operator/node/src/chain_spec/stagenet.rs 中的local_chain_spec()生成的链名为 DataHaven Stagenet Local、ID 为datahaven_stagenet_local、代币符号为STAGE、精度 18 位、EVM 链 ID 为 55932并设置isEthereum属性。这是所有节点共用同一创世状态、实现自动组网的关键前提。九、数据持久化与用户权限存储卷Compose 通过 Docker 命名卷持久化数据因此重启容器不会丢失链数据链数据持久化在/data不使用--tmpKeystore持久化在/data/keystore每个密钥节点一个独立卷alice-keystore、bob-keystore、msp-keystore、bsp01-keystore、bsp02-keystore、fisherman-keystorePostgreSQL 数据postgres-data卷Indexer 数据indexer-data卷挂载到/data。用户权限模型容器以root用户启动以便入口脚本注入密钥并设置权限入口脚本在注入完成后执行chown -R datahaven:datahaven收尾然后通过exec su -s /bin/sh datahaven -c exec /usr/local/bin/datahaven-node $*降权到datahaven用户UID 1001再启动节点进程operator/Dockerfile 中创建了该用户并把/data软链到/datahaven/.local/share/datahaven-node保证默认数据目录解析一致。十、停止网络# 停止所有节点保留数据卷 docker-compose down # 停止并删除数据卷清空链数据完全重新开始 docker-compose down -v当需要清空所有数据重新初始化时使用down -v删除全部卷含 keystore 与数据库下次up会重新注入密钥并重建创世状态。十一、故障排查1. 二进制找不到datahaven-node: No such file or directory检查三件事确认当前位于operator目录确认已执行cargo build --release或--features fast-runtime确认二进制已拷贝到build/datahaven-nodecp target/release/datahaven-node build/或者直接运行./prepare-docker.sh。2. 节点之间无法连接先观察日志确认组网状态# 检查 Bob 是否连上 Alice docker-compose logs bob | grep -i peer\|sync # 检查 MSP 是否连上 Alice docker-compose logs msp | grep -i peer\|sync # 查看 Alice 的对等连接 docker-compose logs alice | grep -i peer正常情况下日志中应出现Discovered new external address、Syncing/best: #X以及连接建立connection established之类的消息。若节点未连接按以下顺序排查确认 Alice 先启动且在运行docker-compose ps alice验证 Alice 在 Docker 网络内可达docker exec datahaven-bob ping alice检查 Alice 的 peer ID 与配置中的 bootnode 地址是否一致。3. 端口冲突若宿主机端口被占用直接修改 operator/docker-compose.yml 中对应服务的ports映射ports: - YOUR_PORT:9944 # 将 YOUR_PORT 换成可用端口注意容器内端口右侧保持不变仅调整宿主机侧左侧即可。4. 密钥注入失败查看日志中密钥相关输出# 过滤密钥注入日志入口脚本使用 前缀标记 docker-compose logs alice | grep # 检查 keystore 内容 docker exec datahaven-alice ls -la /keystore需要重新生成密钥时删除 keystore 卷并重启docker-compose down -v docker-compose up -d5. 验证各节点密钥按节点分别检查 keystore 目录内容# Alice验证人应有 4 把密钥 docker exec datahaven-alice ls -la /keystore # Bob验证人应有 4 把密钥 docker exec datahaven-bob ls -la /keystore # MSP / BSP / Fisherman各 1 把 bcsv 密钥 docker exec datahaven-msp ls -la /data/keystore docker exec datahaven-bsp01 ls -la /data/keystore docker exec datahaven-bsp02 ls -la /data/keystore docker exec datahaven-fisherman ls -la /data/keystore期望结果验证人目录中应包含babe、gran、imon、beef存储提供方MSP/BSP与渔夫目录中应包含bcsv。6. 检查数据库状态# 检查 PostgreSQL 是否就绪 docker exec datahaven-postgres pg_isready -U indexer -d datahaven # 连接数据库 docker exec -it datahaven-postgres psql -U indexer -d datahaven # 查看索引器建好的表运行一段时间后 docker exec datahaven-postgres psql -U indexer -d datahaven -c \dt十二、小结DataHaven 的 Docker Compose 方案将构建二进制 → 注入密钥 → 组网出块 → 存储服务 → 索引落库 → 渔夫监控整条链路封装为一条docker-compose up -d命令是本地开发、集成测试与 StorageHub/EigenLayer 功能联调的理想起点。本文涉及的源码证据均可在此仓库内复现编排配置见 operator/docker-compose.yml密钥注入见 operator/scripts/docker-entrypoint.sh镜像定义见 operator/Dockerfile全部 CLI 参数的底层实现见 operator/node/src/cli.rs。牢记所有默认密钥与 unsafe 标志仅限开发环境使用生产部署请务必替换种子并收敛 RPC 暴露面。赞分享区块链存储Web3【免费下载链接】datahavenAn EVM compatible Substrate chain, powered by StorageHub and secured by EigenLayer项目地址https://gitcode.com/gh_mirrors/da/datahaven点击查看免费下载相关推荐容器网络故障排查神器Docker Compose环境下tcpdump与netshoot实战指南容器网络故障排查神器Docker Compose环境下tcpdump与netshoot实战指南 在多容器Docker应用部署中网络问题常常成为故障排查的难点云原生容器编排DevOpsCLI从零到一LiveKit本地开发环境搭建与网络连接排障指南从零到一LiveKit本地开发环境搭建与网络连接排障指南 你是否在搭建实时音视频应用时遇到过网络连接不稳定、配置繁琐等问题本文将以LiveKitGitHu后端音视频即时通讯AI AgentPolar 本地开发环境 Docker 故障排查实战指南从端口占用到陈旧连接的一站式排障手册Polar 本地开发环境 Docker 故障排查实战指南从端口占用到陈旧连接的一站式排障手册 本指南以 Polar 开源仓库中 troubleshooting后端前端金融科技上一篇HowToCook烹饪指南程序员也能轻松掌握的5分钟快速部署方案下一篇如何快速配置Moonlight游戏串流面向开发者的完整实践指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
