WildFly26域模式远程从节点连接失败问题求助

这个错误核心是DIGEST-MD5认证失败，默认的host-slave.xml没有正确配置与主域控制器的认证信息，加上你参考的文档没覆盖域控制器的关键配置，导致连接失败。下面是直接可用的修复步骤：

1. 确认主域控制器的认证配置 #

在主域控制器的domain/configuration/domain.xml里，找到management下的security-realms节点，确保存在ManagementRealm（默认自带），并检查它的认证属性：

<security-realm name="ManagementRealm">
    <authentication>
        <local default-user="$local" skip-group-loading="true"/>
        <properties path="mgmt-users.properties" relative-to="jboss.domain.config.dir"/>
    </authentication>
</security-realm>

这里的mgmt-users.properties是存储管理用户的文件，主域控制器上必须有一个可用于从节点连接的用户，且密码为加密格式。

2. 在主域控制器创建跨节点认证用户 #

在主域控制器的bin目录下执行添加用户脚本：

• Linux/macOS: ./add-user.sh
• Windows: add-user.bat

选择Management User，输入用户名（比如slave-user）、密码，并且勾选该用户允许用于域控制器连接（slave to master）。执行完成后，脚本会自动将加密后的密码写入mgmt-users.properties和mgmt-groups.properties。

3. 修改从节点的host-slave.xml配置 #

打开从节点的domain/configuration/host-slave.xml，完成两处关键修改：

3.1 配置域控制器地址 #

找到domain-controller节点，替换默认本地地址为主域控制器的IP或主机名：

<domain-controller>
    <remote security-realm="ManagementRealm" username="slave-user">
        <discovery-options>
            <static-discovery name="primary" protocol="remote+http" host="主域控制器IP" port="9990"/>
        </discovery-options>
    </remote>
</domain-controller>

注意：port要和主域控制器domain.xml里management-interfaces的http-interface端口一致（默认9990）。

3.2 配置从节点的认证凭据 #

在host-slave.xml的security-realms里，给ManagementRealm添加secret属性，值为你在主域控制器创建用户时设置的明文密码（Wildfly会自动加密存储）：

<security-realm name="ManagementRealm">
    <server-identities>
        <secret value="你的slave-user明文密码"/>
    </server-identities>
</security-realm>

4. 启动主域控制器和从节点 #

先启动主域控制器：

./domain.sh -c domain.xml  # Linux/macOS

再启动从节点：

./domain.sh -c host-slave.xml  # Linux/macOS

Windows环境替换为.bat脚本即可。

常见排查点 #

• 确保主从节点的Wildfly版本一致，跨版本可能存在认证协议兼容问题
• 检查防火墙，主域控制器的9990（管理端口）和9999（域模式通信端口）必须对外开放
• 从节点host-slave.xml里的username要和主域控制器创建的用户完全匹配
• 如果主域控制器启用了HTTPS管理端口，要把protocol改成remote+https，并同步端口号

内容的提问来源于stack exchange，提问作者László Tóth