bluedigits/iota-node

IOTA全节点

这是IRI（IOTA参考实现）的Docker化节点镜像，支持容器化部署与灵活配置。

核心功能

• 容器化运行IRI全节点，简化部署流程
• 支持手动管理邻居节点或通过Nelson工具自动管理
• 可配置API端口、TCP通信端口及监听地址
• 自定义JVM参数与API命令限制
• 支持数据卷挂载持久化节点数据

使用场景

• 搭建IOTA***全节点的开发者或个人用户
• 研究IOTA网络运行机制的技术人员
• 需要快速部署IOTA节点的测试环境

配置说明与部署示例

前提条件

1. 创建数据文件夹：mkdir -p /iri/data
2. 创建配置文件夹：mkdir -p /iri/conf

选项1：通过Nelson自动管理邻居

1. 启动IOTA节点：

bash
docker run -d --net=host --name iota-node -e API_PORT=14265 -e TCP_PORT=15600 -v /iri/data:/iri/data bluedigits/iota-node:latest

2. 启动Nelson（可选，自动管理邻居）：

bash
docker run -d --net=host -p 18600:18600 --name nelson romansemko/nelson.cli -r localhost -i 14265 -t 15600 --getNeighbors

选项2：手动管理邻居

1. 创建邻居文件 /iri/conf/neighbors，每行填写一个邻居地址（格式：tcp://neighbor_ip:port）
2. 启动节点：

bash
docker run -d --net=host --name iota-node -e API_PORT=14265 -e TCP_PORT=15600 -v /iri/data:/iri/data -v /iri/conf/neighbors:/iri/conf/neighbors bluedigits/iota-node:latest

额外配置

• API限制：通过REMOTE_API_LIMIT禁止指定命令（如禁止getNeighbors）：

  bash
  docker run [...] -e REMOTE_API_LIMIT="getNeighbors" bluedigits/iota-node:latest
  

• Java参数：自定义JVM选项：

  bash
  docker run [...] -e JAVA_OPTIONS="-XX:-PrintCommandLineFlags -Xlog:gc:garbage-collection.log" bluedigits/iota-node:latest
  

• TCP监听地址：指定监听地址（默认0.0.0.0）：

  bash
  docker run [...] -e TCP_SOCKET_ADDRESS="127.0.0.1" bluedigits/iota-node:latest
  

注意事项

• 节点同步需一定时间，可通过docker logs iota-node -f查看进度
• 内存建议：保留足够原生内存给RocksDB，资源有限时添加交换空间
• 数据恢复：若有压缩备份，解压至/iri/data后启动节点