如何将本地Elixir/Erlang连接至Docker容器内运行的应用

我来帮你搞定这个节点连接的问题！你遇到的Protocol 'inet_tcp': regi...错误，本质是本地IEx节点和容器里的Elixir节点之间无法建立TCP连接，大概率是节点名称、网络可达性或者cookie配置出了问题。下面一步步来排查解决：

1. 先搞清楚节点名称的核心要求 #

Elixir节点的名称格式是name@host，这里的host必须是对方节点能直接访问到的IP/主机名，不能随便用127.0.0.1——因为容器里的127.0.0.1是容器自己的localhost，和宿主机的localhost不是一回事。

2. 修正本地IEx的启动命令 #

把你原来的命令里的127.0.0.1换成宿主机的实际局域网IP（比如192.168.1.100，可以用ifconfig或ip addr查看）：

iex --name local@192.168.1.100 --cookie secret

3. 确保容器内应用的节点配置正确 #

容器里的Elixir应用必须满足两个条件：

• 节点名称的host部分要设置成容器能被宿主机访问到的地址（可以是0.0.0.0，表示监听所有网络接口）
• cookie和本地IEx的secret完全一致（大小写敏感！）

你可以在启动容器时通过环境变量指定这些配置：

docker run -p 4000:4000 -p 4369:4369 -p 9000:9000 \
  -e ELIXIR_NODE_NAME=app@0.0.0.0 \
  -e ELIXIR_COOKIE=secret \
  your-elixir-app-image

4. 验证网络连通性 #

先确认宿主机能访问容器的关键端口：

1. 用docker inspect 你的容器ID | grep IPAddress获取容器的内部IP（比如172.17.0.2）
2. 测试EPMD端口（4369）和节点端口（9000）是否能连通：

   telnet 172.17.0.2 4369
   telnet 172.17.0.2 9000
   

如果连接失败，检查Docker的端口映射是否正确，或者容器内有没有防火墙拦截这些端口。

5. 尝试连接远程节点 #

在本地IEx里执行连接命令，注意容器节点的名称格式是app@容器内部IP：

Node.connect(:"app@172.17.0.2")

如果返回true，说明连接成功了！

开发环境的简化方案 #

如果是本地开发，你可以直接让容器和宿主机共享网络栈，这样就不用纠结IP问题了：
启动容器时加上--network host参数：

docker run --network host -e ELIXIR_NODE_NAME=app@127.0.0.1 -e ELIXIR_COOKIE=secret your-elixir-app-image

然后本地直接用原来的命令启动IEx：

iex --name local@127.0.0.1 --cookie secret

再执行Node.connect(:"app@127.0.0.1")就能连接了。

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