添加RPC参数后Docker以太坊容器立即退出的原因及解决办法

核心原因 #

你使用的--rpc系列参数是旧版Geth（以太坊客户端）的配置，新版Geth已将RPC相关参数统一替换为--http前缀的参数，旧参数会导致客户端启动失败，容器因此立刻退出。另外--dev开发模式下，若没有持续挖矿或交互触发，节点可能在完成初始区块生成后自动停止运行。

排查步骤 #

先通过容器日志确认具体错误：

sudo docker logs ethereum

通常会看到类似flag provided but not defined: --rpc的报错，直接指向参数不兼容问题。

修复后的启动命令 #

替换为新版Geth的HTTP配置参数，同时加上--dev.period 1确保dev模式下自动挖矿维持节点运行：

sudo docker run -d --name ethereum -p 8545:8545 -p 30303:30303 ethereum/client-go --http --http.addr "0.0.0.0" --http.api="db,eth,net,web3,personal" --http.corsdomain "*" --dev --dev.period 1

验证容器运行 #

启动后用以下命令检查状态：

sudo docker ps

如果容器状态显示为Up，就可以执行exec操作进入容器：

sudo docker exec -it ethereum geth attach http://localhost:8545

内容的提问来源于stack exchange，提问作者siya