快速上手 IOTA：5 分钟搭建测试节点并与 Tangle 同步

核心关键词：IOTA 节点、Tangle 网络、IOTA 测试网、IRI 配置、邻居节点、Docker 部署

“即使官方核心功能仍在迭代，我们也可以先用现有的工具畅游 IOTA。”——开发者社区

为什么选择测试而不是主网？

在开始写代码之前，先决定连接哪一个网络：

建议：初次部署、调试或研究 API 时，优先考虑 testnet，便于快速试错。待逻辑跑通后，再切到 mainnet 上链。

IOTA 团队把“节点软件”叫 IRI，而不叫 node，以强调 “参考实现” 属性：

为了降低依赖，推荐用 官方 Docker 镜像 运行，一条指令即可。

docker run -d --name iota-node \
  -p 14265:14265 \
  -p 14777:14777/udp \
  -p 15777:15777 \
  -v ~/iota.ini:/iri/iota.ini \
  iotaledger/iri:v1.4.0

短短 3 行，即可完成：

[IRI]
PORT = 14265
UDP_RECEIVER_PORT = 14777
TCP_RECEIVER_PORT = 15777
NEIGHBORS =
IXI_DIR = ixi
HEADLESS = true
DEBUG = true
DB_PATH = mainnetdb

端口解析

启动后的 IOTA 进程如同孤岛，需要双向邻居才能和 Tangle 交换交易数据。当前唯一捷径：加入官方 Slack #nodesharing 频道，@管理员或群友即可领取 UDP 地址。

静态配置：将对方给的地址（如 udp://203.0.113.9:14777）塞进 NEIGHBORS 字段后重启容器。
```
NEIGHBORS = udp://203.0.113.9:14777 tcp://198.51.100.23:15777
```
动态接口：通过 http://localhost:14265 调用 REST API，不再重启。
```
POST /addNeighbors
Body: { "uris": ["udp://203.0.113.9:14777"] }
```

检查是否同步成功：

GET http://localhost:14265/getNodeInfo

返回的 latestSolidSubtangleMilestoneIndex 若不断上升，代表已追上网络最新状态。

场景	建议使用	原因
仅代币转账、账户查询	轻钱包（Light Wallet）	体积小，10 秒即可同步
做 PoW、发交易、深度互动	全节点（IRI）	具备完整 Tangle 数据，灵活性高

即使你做全节点，也可在本地再开一份轻钱包，两者互不冲突，方便验证转账结果。

Q1：必须静态公网 IP 吗？
A：UDP 或 TCP 端口只要被外网 NAT 穿透即可，家用宽带可用 frp、ngrok 中转，但延迟可能上升。

Q2：需要多少磁盘空间？
A：testnet 截止 2024-Q2 约 25 GB，mainnet 接近 200 GB；准备 SSD 可显著减少同步时间。

Q3：日志在哪里查看？
A：

docker logs -f --tail=200 iota-node

过滤 Milestone solidified 关键字，每出现一次代表完成一轮确认。

Q4：为何 neighbor 添加后一直是 0？
A：多数是防火墙未放行；确认对端能 ping 通你的公网 IP + 端口后重试。

Q5：可以跑在树莓派吗？
A：内存 2 GB+、Java 11 可启动，但同步耗时，仅推荐做实验而非生产。

虽说我门平常更爱谈技术，但真正动手才算入门。下篇文章我们将用 Node.js 向 IOTA 提交第一条逻辑交易，告诉你如何：