跳到主要内容

配置并启动节点

本章节将指导你完成 HyMatrix 节点的部署与启动。你将学会如何：

  • 获取节点客户端；
  • 准备配置文件；
  • 启动并接入网络。

准备工作确认​

在开始之前，请确保你已完成以下准备事项：

  • 一台符合要求的服务器（推荐 Linux，具备公网访问能力，≥100Mbps 带宽）；
  • 已安装必要依赖（Docker、Redis 等，详见：软件依赖）；
  • 已生成一个 Ethereum 或 Arweave 钱包（节点身份所需）；

🔍 如果你尚未完成钱包生成或环境部署，请先参考上一章节：准备工作。

获取节点客户端​

你可以选择以下方式之一获取 hymx 节点程序：

方式一：使用预编译版本（推荐）​

⬇️ Hymx releases ⬇️

方式二：从源码构建（可选）​

如需自行构建：

git clone https://github.com/hymatrix/hymx
cd hymx
go mod tidy
make build

📌 若选择源码构建，请确保系统已安装 Go ≥ 1.24.0 与 Git。

准备配置文件​

创建一个名为 config.yaml 的配置文件，并填入如下最小化配置内容。该配置适用于本地测试环境，便于快速验证节点启动流程。

# 节点服务
port: :8080
ginMode: release  # 可选值: "debug", "release"

# Redis 配置
redisURL: redis://@localhost:6379/0

# 存储与网络
arweaveURL: https://arweave.net
hymxURL: http://127.0.0.1:8080

# 节点身份（钱包）
prvKey: 0x64dd2342616f385f3e8157cf7246cf394217e13e8f91b7d208e9f8b60e25ed1b
keyfilePath:

# 节点信息
nodeName: test1
nodeDesc: first test node
nodeURL: http://127.0.0.1:8080

# 注册与网络接入
joinNetwork: false

字段解释（最小化配置说明）​

  • hymxURL：设置为节点本机地址，用于本地测试或通过 SDK 调用该节点。
  • prvKey：配置了一个以太坊格式私钥，用于节点身份签名，支持注册、日志签名等核心功能。
  • nodeName / nodeURL：节点基础信息，此处设置为本地地址，便于本机调试。
  • joinNetwork: false：节点不会加入网络注册，也不需要进行质押。适用于开发调试。

准备核心 Module​

为了使节点能够正常接入网络，需要在 hymx 运行目录下提供核心 Module 文件。

请在运行目录下新建 mod/ 文件夹，并将以下两个 Module 文件下载到该目录：

👉 https://github.com/hymatrix/hymx/tree/develop/cmd/mod

  • mod-1i03Vpe8DljkUMBEEEvR0VmbJjvgZtP_ytZdThkVSMw.json：HyMatrix 核心代币 Module
  • mod-MVTil0kn5SRiJELW7W2jLZ6cBr3QUGj1nJ67I2Wi4Ps.json：Registry（注册表） Module

这两个 Module 分别定义了 网络的核心代币 与 全局注册表，是节点加入网络及后续交互的必需组件。

启动 redis​

在启动节点之前，请确保 Redis 服务已启动。并保证 config.yaml 中 redis 配置正确。

启动节点​

将下载或者自行编译的的 hymx 和 config.yaml 放在同一目录下，运行以下命令启动节点服务：

./hymx --config ./config.yaml

如运行成功，终端输出应类似如下：

INFO[07-25|00:00:01] server is running   module=node-v0.0.1 wallet=0x... port=:8080

此时节点已完成本地初始化。

✅ 下一步操作：如你希望加入测试网或主网并提供真实服务，请继续阅读：加入网络