Ejabberd启用MySQL外部认证后Web管理面板登录失败排查

我来帮你一步步排查这个外部认证的问题——毕竟命令行测试正常但面板登录失败，大概率是配置细节或者运行环境的差异导致的：

先打开/etc/ejabberd/ejabberd.yml，重点检查这几个关键项：

• 确认auth_method已经切换为external（之前用内部认证，必须改这个），别被host_config里的单独配置覆盖了
• extauth_program的路径必须精准指向/var/www/check_mysql.php，多一个少一个字符都不行
• extauth_instances至少设为1，比如extauth_instances: 2，避免单实例崩溃导致认证失效

举个正确的配置片段例子：

auth_method: external
extauth_program: "/var/www/check_mysql.php"
extauth_instances: 2

你用root测试脚本没问题，但Ejabberd是用ejabberd用户运行的，权限和环境变量都不一样：

• 先切换到ejabberd用户：su - ejabberd -s /bin/bash（默认ejabberd用户没有登录shell，所以要指定bash）
• 手动模拟Ejabberd的调用方式测试：echo -e "00auth:你的用户名:localmessage.my.website:你的密码" | /var/www/check_mysql.php，看输出是不是严格的00ok
• 还要检查脚本的shebang行（第一行）是不是#!/usr/bin/env php，确保Ejabberd能找到PHP解释器
• 确认/var/www目录权限是755，让ejabberd用户能进入并读取脚本

既然已经把日志级别调到5，赶紧去/var/log/ejabberd/ejabberd.log里找线索：

• 搜extauth关键词，有没有extauth program exited、failed to start这类错误？这说明Ejabberd根本启动不了脚本
• 搜auth failed，后面的错误信息会告诉你是脚本返回了无效响应，还是数据库连不上
• 有没有permission denied？可能是ejabberd用户读不了PHP配置，或者连MySQL被拒绝了

比如遇到这种日志就说明脚本输出了多余内容（比如PHP警告）：

202X-XX-XX XX:XX:XX.XXX [error] <0.XXX.0>@ejabberd_auth_external:report_error:144 External auth program returned invalid response: "PHP Warning:  mysqli_connect(): ..."

Ejabberd对外部认证脚本的输出要求非常严格：

• 绝对不能输出任何额外内容（比如PHP错误、调试信息），否则直接判定无效响应。可以在脚本开头加两行：

  error_reporting(0);
  ini_set('display_errors', 0);
  

• 输出必须是XXok或XXfail，大小写敏感，结尾必须带换行符
• 核对脚本里的数据库连接信息：主机、用户名、密码、库名是不是和Web平台一致？密码哈希验证方式对不对？比如Web用password_hash，脚本就得用password_verify，不能直接比字符串

切换到外部认证后，Admin用户必须存在于你的MySQL数据库里，同时Ejabberd的ACL配置要允许这个用户访问管理面板：

• 检查acl里的admin条目：

  acl:
    admin:
      user:
        - "你的admin用户名@localmessage.my.website"
  

• 检查access里的configure权限：

  access:
    configure:
      admin: allow
  

如果admin用户不在数据库里，或者权限没开，肯定会登录循环。

最后用官方工具测试，排除面板的问题：

ejabberdctl check_password 你的admin用户名 localmessage.my.website 你的密码

如果返回true，说明Ejabberd层面认证正常，那大概率是浏览器缓存或者Cookie的问题，试试隐私模式访问；如果返回false，结合前面的日志继续排查。

内容的提问来源于stack exchange，提问作者Matteo Cacciola