如何运行Scroll节点Docker快照同步的完整教程【免费下载链接】scroll-documentationThis is the frontend for the Scroll documentation项目地址: https://gitcode.com/gh_mirrors/sc/scroll-documentation想亲自运行一个 Scroll 节点却担心同步时间太长这篇运行Scroll节点完整教程将手把手教你通过Docker 快照同步方式在最短时间内启动属于自己的 Scroll 主网节点。快照同步最大的优势在于你无需从创世区块逐块同步数 TB 的历史数据而是直接下载官方打包好的最新状态快照几分钟内就能让节点追上最新区块高度。无论你是节点爱好者、开发者还是想要自建 RPC 的团队这份教程都能帮你快速搞定。为什么选择快照同步方式运行Scroll节点Scroll 是基于 zkEVM 的以太坊 Layer 2 扩容方案其执行节点l2geth负责处理交易、维护账户状态。如果从零开始同步需要处理海量的 L1 消息与历史交易耗时可能长达数天而采用官方快照只需下载一份已经同步到最新状态的数据目录再配合节点持续追块通常几十分钟即可完成启动。从上面的架构图可以看到Scroll 网络由结算层以太坊合约、排序层执行节点 汇总节点和证明层zkEVM 证明者协同工作而你运行的正是其中至关重要的执行节点。运行Scroll节点前的硬件与软件准备推荐硬件配置一台与 AWSt3.2xlarge性能相当的云服务器或物理机4TBgp3 SSD 固态硬盘官方归档快照接近 2TB解压后至少需要 4TB 空间稳定的网络带宽必需软件环境Docker 与 Docker Compose 已正确安装并运行一个完全同步的以太坊主网 RPC 端点可自建节点也可使用支持标准 RPC API 的第三方服务用于让 l2geth 读取 L1 消息第一步拉取最新 L2geth 节点镜像打开终端执行以下命令拉取官方最新版执行节点镜像docker pull scrolltech/l2geth:latest官方建议关注 go-ethereum 的 Release 发布页及时升级到最新版本确保兼容最新的网络升级。第二步下载并解压 Scroll 快照数据快照地址为https://snapshot.scroll.io/mpt/latest.tar下载并解压wget https://snapshot.scroll.io/mpt/latest.tar tar -xf latest.tar解压后会生成一个名为l2geth的数据文件夹里面包含了完整的区块链状态快照。第三步配置 docker-compose.yaml 启动文件进入快照目录创建并编辑docker-compose.yamlcd l2geth将以下配置写入文件注意替换l1.endpoint、da.blob.*等占位符为你自己的端点services: l2geth: image: scrolltech/l2geth:latest container_name: l2geth-docker stop_signal: SIGINT stop_grace_period: 60s restart: unless-stopped environment: - CHAIN_ID534352 - RUST_LOGinfo volumes: - l2geth/data:/volume/l2geth/data ports: - 8545:8545 - 8546:8546 - 6060:6060 - 30303:30303 - 30303:30303/udp command: --scroll --scroll-mpt --snapshotfalse --metrics --pprof.addr 0.0.0.0 --pprof.port 6060 --datadir /volume/l2geth/data --gcmode archive --http --http.addr 0.0.0.0 --http.port 8545 --http.api eth,net,web3,debug,scroll --cache.noprefetch --l1.endpoint ${你的L1端点} --da.blob.blobscan ${你的blobscan端点} --da.blob.beaconnode ${你的beaconnode端点} --da.blob.awss3 ${你的aws s3端点} --cache.snapshot0 logging: driver: json-file options: max-size: 100m max-file: 1关键参数说明--scroll表示连接 Scroll 主网--scroll-mpt启用 MPT 状态树模式--snapshotfalse与--cache.snapshot0用于关闭快照生成功能避免因磁盘繁忙导致启动失败。第四步启动节点并验证同步状态配置完成后后台启动容器docker compose up -d启动后可通过以下命令验证节点状态# 查看日志 docker logs --tail 10 -f l2geth-docker # 进入 geth 控制台 docker exec -it l2geth-docker geth attach /volume/l2geth-datadir/geth.ipc在控制台中执行eth.blockNumber即可查看当前区块高度若能持续增长说明快照同步已生效节点正在正常追块。你还可以用curl http://localhost:6060/debug/metrics/prometheus获取节点运行指标。常见问题与故障排查提示operation not permitted在 macOS 上运行 Docker 时需在 Docker Desktop 的 File Sharing 设置中把/volume目录加入共享列表并重启。提示database contains incompatible genesis自 v3.1.3 起创世配置格式有变请确保使用--scroll标志让节点自动导入最新创世配置。提示no matching manifest for linux/arm64DockerHub 缺少对应平台镜像时可给命令加上--platform linux/amd64参数。提示Unexpected queue index请检查 L1 端点是否正常工作。提示no blob client is configured需要补充可用的--da.blob.blobscan与--da.blob.beaconnode端点。提示Aborting state snapshot generation通常是磁盘空间不足或 MPT 树优雅关闭问题可通过--cache.snapshot0与--snapshotfalse关闭快照功能。官方文档与更多学习资源本文内容整理自官方文档 running-a-scroll-node.mdx你也可以查阅 rollup-node.mdx 了解汇总节点如何拆分区块与批量提交或阅读 rollup.mdx 深入理解 Scroll 的交易执行、批量提交与证明生成全流程。现在就动手用 Docker 快照同步跑起你的第一个 Scroll 节点吧【免费下载链接】scroll-documentationThis is the frontend for the Scroll documentation项目地址: https://gitcode.com/gh_mirrors/sc/scroll-documentation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何运行Scroll节点：Docker快照同步的完整教程
如何运行Scroll节点Docker快照同步的完整教程【免费下载链接】scroll-documentationThis is the frontend for the Scroll documentation项目地址: https://gitcode.com/gh_mirrors/sc/scroll-documentation想亲自运行一个 Scroll 节点却担心同步时间太长这篇运行Scroll节点完整教程将手把手教你通过Docker 快照同步方式在最短时间内启动属于自己的 Scroll 主网节点。快照同步最大的优势在于你无需从创世区块逐块同步数 TB 的历史数据而是直接下载官方打包好的最新状态快照几分钟内就能让节点追上最新区块高度。无论你是节点爱好者、开发者还是想要自建 RPC 的团队这份教程都能帮你快速搞定。为什么选择快照同步方式运行Scroll节点Scroll 是基于 zkEVM 的以太坊 Layer 2 扩容方案其执行节点l2geth负责处理交易、维护账户状态。如果从零开始同步需要处理海量的 L1 消息与历史交易耗时可能长达数天而采用官方快照只需下载一份已经同步到最新状态的数据目录再配合节点持续追块通常几十分钟即可完成启动。从上面的架构图可以看到Scroll 网络由结算层以太坊合约、排序层执行节点 汇总节点和证明层zkEVM 证明者协同工作而你运行的正是其中至关重要的执行节点。运行Scroll节点前的硬件与软件准备推荐硬件配置一台与 AWSt3.2xlarge性能相当的云服务器或物理机4TBgp3 SSD 固态硬盘官方归档快照接近 2TB解压后至少需要 4TB 空间稳定的网络带宽必需软件环境Docker 与 Docker Compose 已正确安装并运行一个完全同步的以太坊主网 RPC 端点可自建节点也可使用支持标准 RPC API 的第三方服务用于让 l2geth 读取 L1 消息第一步拉取最新 L2geth 节点镜像打开终端执行以下命令拉取官方最新版执行节点镜像docker pull scrolltech/l2geth:latest官方建议关注 go-ethereum 的 Release 发布页及时升级到最新版本确保兼容最新的网络升级。第二步下载并解压 Scroll 快照数据快照地址为https://snapshot.scroll.io/mpt/latest.tar下载并解压wget https://snapshot.scroll.io/mpt/latest.tar tar -xf latest.tar解压后会生成一个名为l2geth的数据文件夹里面包含了完整的区块链状态快照。第三步配置 docker-compose.yaml 启动文件进入快照目录创建并编辑docker-compose.yamlcd l2geth将以下配置写入文件注意替换l1.endpoint、da.blob.*等占位符为你自己的端点services: l2geth: image: scrolltech/l2geth:latest container_name: l2geth-docker stop_signal: SIGINT stop_grace_period: 60s restart: unless-stopped environment: - CHAIN_ID534352 - RUST_LOGinfo volumes: - l2geth/data:/volume/l2geth/data ports: - 8545:8545 - 8546:8546 - 6060:6060 - 30303:30303 - 30303:30303/udp command: --scroll --scroll-mpt --snapshotfalse --metrics --pprof.addr 0.0.0.0 --pprof.port 6060 --datadir /volume/l2geth/data --gcmode archive --http --http.addr 0.0.0.0 --http.port 8545 --http.api eth,net,web3,debug,scroll --cache.noprefetch --l1.endpoint ${你的L1端点} --da.blob.blobscan ${你的blobscan端点} --da.blob.beaconnode ${你的beaconnode端点} --da.blob.awss3 ${你的aws s3端点} --cache.snapshot0 logging: driver: json-file options: max-size: 100m max-file: 1关键参数说明--scroll表示连接 Scroll 主网--scroll-mpt启用 MPT 状态树模式--snapshotfalse与--cache.snapshot0用于关闭快照生成功能避免因磁盘繁忙导致启动失败。第四步启动节点并验证同步状态配置完成后后台启动容器docker compose up -d启动后可通过以下命令验证节点状态# 查看日志 docker logs --tail 10 -f l2geth-docker # 进入 geth 控制台 docker exec -it l2geth-docker geth attach /volume/l2geth-datadir/geth.ipc在控制台中执行eth.blockNumber即可查看当前区块高度若能持续增长说明快照同步已生效节点正在正常追块。你还可以用curl http://localhost:6060/debug/metrics/prometheus获取节点运行指标。常见问题与故障排查提示operation not permitted在 macOS 上运行 Docker 时需在 Docker Desktop 的 File Sharing 设置中把/volume目录加入共享列表并重启。提示database contains incompatible genesis自 v3.1.3 起创世配置格式有变请确保使用--scroll标志让节点自动导入最新创世配置。提示no matching manifest for linux/arm64DockerHub 缺少对应平台镜像时可给命令加上--platform linux/amd64参数。提示Unexpected queue index请检查 L1 端点是否正常工作。提示no blob client is configured需要补充可用的--da.blob.blobscan与--da.blob.beaconnode端点。提示Aborting state snapshot generation通常是磁盘空间不足或 MPT 树优雅关闭问题可通过--cache.snapshot0与--snapshotfalse关闭快照功能。官方文档与更多学习资源本文内容整理自官方文档 running-a-scroll-node.mdx你也可以查阅 rollup-node.mdx 了解汇总节点如何拆分区块与批量提交或阅读 rollup.mdx 深入理解 Scroll 的交易执行、批量提交与证明生成全流程。现在就动手用 Docker 快照同步跑起你的第一个 Scroll 节点吧【免费下载链接】scroll-documentationThis is the frontend for the Scroll documentation项目地址: https://gitcode.com/gh_mirrors/sc/scroll-documentation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考