一键部署#

📋 概览#

快速部署 X Layer 自托管 RPC 节点，使用 reth 执行客户端（execution client）。

💻 系统要求#

• 操作系统：Linux（推荐 Ubuntu 20.04 及以上版本）
• 内存：最低 8GB，推荐 16GB 及以上
• 存储：最低 200GB SSD，推荐 500GB 及以上
• Docker：Docker 20.10+ 及 Docker Compose 2.0+

⚡ 快速开始#

全自动部署（推荐）#

运行以下命令——倒计时 5 秒后将自动部署主网 reth 节点（含快照，使用默认端口），无需任何输入：

curl -sSf https://raw.githubusercontent.com/okx/xlayer-toolkit/main/rpc-setup/one-click-setup.sh | bash

等价于：mainnet + reth + snapshot + 所有默认端口。

自定义部署#

在 5 秒倒计时期间按任意键进入交互模式，可自定义网络、客户端、端口等配置。

交互式提示#

在自定义模式下，脚本将依次提示你配置：

1. 网络类型：testnet 或 mainnet（默认：mainnet）
2. 同步模式：genesis 或 snapshot（默认：snapshot）
   • Snapshot（快照）：使用预构建快照进行快速同步（推荐）
   • Genesis（创世）：从创世块开始同步
3. L1 RPC URL：以太坊 L1 RPC 端点（可选）
4. L1 Beacon URL：以太坊 L1 信标链（Beacon chain）端点（可选）
5. 端口（可选，含默认值）：
   • RPC 端口（默认：8545）
   • WebSocket 端口（默认：8546）
   • Engine API 端口（默认：8552）
   • 节点 RPC 端口（默认：9545）
   • P2P 端口（默认：30303、9223）
6. Flashblocks：启用/禁用 MEV flashblocks 服务（默认：禁用）
   • 若启用，请提供 Flashblocks WebSocket URL（默认：wss://xlayerws.okx.com/flashblocks）

同步模式可用性#

📊 服务管理#

# 查看服务状态
make status

# 停止服务（保留数据）
make stop

# 重启服务
make run

# 查看日志
docker compose logs -f

📡 服务端口#

所有端口均可在部署时自定义配置。

🔗 访问你的 RPC 节点#

部署完成后，你的 RPC 节点将通过以下地址提供服务：

• HTTP RPC：http://localhost:<RPC_PORT>
• WebSocket：ws://localhost:<WS_PORT>
• Op-Node API：http://localhost:<NODE_RPC_PORT>

运行 make status 查看已配置的端口。

感谢你选择 X Layer 进行构建！ 💪