以太坊入门,如何使用geth命令启动以太坊节点

geth version

核心步骤：启动Geth节点

启动geth节点的基本命令格式如下：

geth [命令选项] [命令行参数]

geth提供了丰富的命令行选项，允许你自定义节点的行为,下面我们介绍一些最常用和最重要的启动选项。

最简单的启动方式（连接到主网）

如果你只是想快速启动一个连接到以太坊主网（生产网络，使用真实ETH）的节点,可以使用最简单的命令：

geth console

或者：

geth attach

这两个命令在默认情况下都会启动一个同步到以太坊主网的节点，并直接进入JavaScript控制台（console）,你可以在这个控制台中执行各种与以太坊交互的命令。

说明：

• 主网同步：主网数据量巨大（目前已数TB），首次同步可能需要数天甚至数周时间，并且会占用大量磁盘空间和带宽，同步完成后,你将拥有一个完整的以太坊账本副本。

指定网络类型（主网/测试网/私有链）

除了主网，geth还支持连接到测试网（如Goerli, Sepolia）或运行你自己的私有链。

• 连接到测试网（以Goerli为例）： Goerli是一个常用的以太坊测试网，使用测试ETH,适合开发和测试。

  geth --goerli console

  你也可以使用--testnet参数，但--goerli更明确，其他测试网如Sepolia可以使用--sepolia。

• 启动私有链： 如果你想要创建一个完全属于自己的私有以太坊网络用于测试，可以这样做： 首先创建一个初始化配置文件（例如genesis.json）,然后运行：

  geth --datadir "./my_private_chain" init genesis.json
  geth --datadir "./my_private_chain" console

  这会在./my_private_chain目录下创建你的私有链数据，并根据genesis.json进行初始化。

控制同步模式

geth提供了多种同步模式,以适应不同的硬件条件和需求：

• --syncmode "fast"：快速同步模式（默认），只下载区块头，然后同步状态和交易，是目前最常用的模式,速度较快。
• --syncmode "full"：完整同步模式，下载所有区块头、所有交易和状态数据，并重新执行所有交易，这是最“完整”的同步方式,但耗时最长。
• --syncmode "snap"：快照同步模式（较新版本推荐），一种比fast更快的同步方式,通过下载状态数据快照来加速同步。

示例：

geth --syncmode "snap" console

指定数据存储目录

默认情况下，geth会将数据（区块链数据、_keystore_等）存储在用户主目录下的.ethereum目录中，你可以使用--datadir参数指定自定义的数据目录：

geth --datadir "/path/to/your/ethereum_data" console

开放RPC接口

如果你希望其他应用程序（如MetaMask、Remix IDE或你自己开发的DApp）能够通过RPC（Remote Procedure Call）与你的geth节点交互，你需要启用HTTP或WebSocket RPC接口。

• 启用HTTP-RPC：

  geth --http --http.addr "0.0.0.0" --http.port "8545" --http.api "eth,net,web3,personal" console

  • --http：启用HTTP-RPC服务器。
  • --http.addr "0.0.0.0"：监听所有网络接口（默认是127.0.0.1，仅本地访问）。
  • --http.port "8545"：指定HTTP-RPC端口,默认是8545。
  • --http.api：指定通过HTTP-RPC暴露的API，如eth（以太坊相关）、net（网络相关）、web3（web3.js相关）、personal（账户管理）等。

• 启用WebSocket-RPC（更适合需要实时通知的应用）：

  geth --ws --ws.addr "0.0.0.0" --ws.port "8546" --ws.api "eth,net,web3,personal" console

  参数与HTTP-RPC类似，--ws表示启用WebSocket-RPC。

其他常用选项

• --identity "YourNodeName"：为你的节点设置一个标识名称,在网络上其他节点看到的客户端名称中会显示。
• --gasprice "1000000000"：设置默认的交易gas价格（以wei为单位）。
• --miner.threads 4：设置挖矿时使用的CPU线程数（如果你是验证者且要参与挖矿）。
• --cache 4096：设置内存缓存大小（MB），可以提高同步和查询性能,尤其是在SSD上。
• --verbosity 5：设置日志详细级别（0=silent, 1=error, 2=warn, 3=info, 4=debug, 5=debug detail）,方便排查问题。

组合使用示例

假设你想要启动一个连接到Goerli测试网，使用快照同步模式，数据存储在./ethereum_test_data目录下，同时开放HTTP-RPC接口供本地DApp使用，并设置节点名称为"MyTestNode"：

geth \
  --goerli \
  --syncmode "snap" \
  --datadir "./ethereum_test_data" \
  --http \
  --http.addr "127.0.0.1" \
  --http.port "8545" \
  --http.api "eth,net,web3,personal" \
  --identity "MyTestNode" \
  console

将上述命令复制到终端中执行，geth就会开始启动并同步Goerli测试网，启动成功后，你会进入JavaScript控制台，看到类似 Welcome to the Geth JavaScript console! 的提示。

启动后的操作与注意事项

1. 耐心等待同步：尤其是第一次启动或连接到新的网络时，同步数据需要时间，请耐心等待，可以通过eth.syncing命令查看同步进度。
2. 资源占用：运行geth节点会占用大量的CPU、内存（尤其是缓存）和磁盘空间，以及持续的带宽,请确保你的硬件资源充足。
3. 安全：
   • 妥善保管你的datadir目录，尤其是其中包含的keystore文件夹（存放账户私钥）。
   • 不要轻易从不可信来源下载或运行修改过的geth二进制文件。
   • 如果节点暴露到公网，注意配置防火墙和RPC接口的安全认证（如使用--http.vhosts和--http.corsdomain限制访问，或考虑使用--authrpc进行认证）。
4. 退出节点：在JavaScript控制台中，输入exit或按