Ejabberd从23.04迁移至24.02后IP节点名启动失败问题

开发者阿泽

2026-6-27

ejabberd 23.04迁移至24.02后IP节点名启动异常解决办法

问题描述

Can't set long node name!
Please check your configuration

ejabberd 24.02对Erlang节点名的处理逻辑做了调整，严格区分短节点名（如@localhost）和长节点名（@IP或域名），必须保证配置与启动参数匹配才能正常使用IP作为节点名。

修正ejabberd主配置文件
找到ejabberd.yml（或旧格式的ejabberd.cfg），修改node配置项为目标长节点名：
```
node: ejabberd@10.0.1.18
```
同时确认hosts配置包含该IP：
```
hosts:
  - "10.0.1.18"
```
调整ejabberdctl启动参数
启动服务时必须显式指定长节点名模式，修改启动命令为：
```
sbin/ejabberdctl --longnames --node ejabberd@10.0.1.18 start
```
嫌每次加参数麻烦的话，直接编辑ejabberdctl.cfg，添加默认长节点名配置：
```
ERLANG_NODE_ARG="--longnames"
```
之后执行ejabberdctl命令就不用再手动加--longnames了。
验证Erlang节点名有效性
先单独测试Erlang能否正常识别这个IP节点名，执行：
```
erl -name ejabberd@10.0.1.18
```
能正常进入Erlang shell就没问题；如果报错，检查/etc/hosts是否有IP映射（用主机名的情况），或者确保该IP在本机网络中可达。
重启服务并验证
先停止当前运行的服务：
```
sbin/ejabberdctl stop
```
用修正后的命令启动：
```
sbin/ejabberdctl --longnames --node ejabberd@10.0.1.18 start
```
最后执行状态检查：
```
sbin/ejabberdctl --longnames --node ejabberd@10.0.1.18 status
```
返回正常状态信息就说明问题解决了。