Maxscale配置admin_ssl参数后maxctrl报socket hang up错误
根因定位
这个故障的核心是MaxScale 2.5版本的Admin服务监听逻辑存在强绑定特性:
- 只要在全局配置中加入
admin_ssl_*系列参数,Admin服务的8989端口就会强制切换为纯HTTPS监听模式,完全拒绝明文HTTP请求 - 浏览器访问时,因为手动信任了自签名证书,能正常完成HTTPS握手流程,所以Web GUI可正常访问
- 但
maxctrlCLI工具默认以明文HTTP方式连接8989端口,被强制要求SSL的监听端口直接断开TCP连接,就会抛出socket hang up错误 - 取消所有SSL配置后,Admin端口切回明文HTTP模式,maxctrl可以正常完成握手,命令行功能恢复,但Web GUI因为主动以HTTPS方式访问端口被拒绝,无法打开
- 全程没有错误日志的原因是端口在TCP层直接断连,应用层根本没有收到完整的HTTP请求,因此不会记录业务层面的报错
验证调试步骤
按照以下步骤逐一确认问题,不需要依赖额外工具:
- 本地明文连接测试:在服务器上执行
curl http://127.0.0.1:8989/v1/maxscale,如果返回Empty reply from server,就证明当前端口处于纯HTTPS监听状态,和根因描述一致 - 本地加密连接测试:执行
curl -k https://127.0.0.1:8989/v1/maxscale -u 你的Admin用户名:你的Admin密码,如果能正常返回MaxScale的状态JSON,就证明SSL证书本身配置完全正确,没有格式或权限问题 - 证书权限校验:检查三个SSL证书文件的读权限,确认MaxScale运行用户(通常为
maxscale)对密钥、证书、CA证书文件有读取权限;权限不足的场景下MaxScale启动时会加载SSL失败,但默认日志级别下不会打出这类启动报错,可以临时把日志级别调整为debug,重启后查看启动阶段的SSL加载日志确认 - CLI默认连接校验:执行
maxctrl --help可以看到,maxctrl默认连接目标为http://127.0.0.1:8989,没有内置自动识别HTTPS的逻辑
解决方案
根据实际使用场景选择适配方案:
方案一:统一HTTPS接入(推荐,配置最简单)
保持现有Admin SSL配置不变,调整maxctrl的连接参数适配HTTPS模式,两种配置方式:
- 临时生效:执行maxctrl命令时追加HTTPS连接参数,自签名证书场景下需要跳过证书校验:
maxctrl --hosts=https://127.0.0.1:8989 --tls-verify-server-cert=false list servers - 永久生效:编辑maxctrl的配置文件
/etc/maxscale/maxctrl.cnf,写入固定连接参数,之后执行maxctrl命令不需要额外加参数:[maxctrl] hosts=https://127.0.0.1:8989 tls_verify_server_cert=false
如果自签名证书已经被系统根CA信任,不需要加tls_verify_server_cert=false参数,直接指定HTTPS地址即可正常连接
方案二:分离监听端口(适合多客户端混合接入场景)
如果需要同时保留明文CLI访问、HTTPS的Web GUI访问,可以配置多监听端口实现双模式并行,在maxscale.cnf的全局段追加相关配置:
# 原有HTTPS GUI监听配置 admin_host=0.0.0.0 admin_port=8989 admin_ssl_key=/etc/ssl/certs/maxscale-key.pem admin_ssl_cert=/etc/ssl/certs/maxscale-cert.pem admin_ssl_ca_cert=/etc/ssl/certs/ca-certificates.crt admin_gui=1 # 定义额外的明文监听,仅给本地CLI使用 extra_listeners=CLI_HTTP [CLI_HTTP] type=listener protocol=HTTP port=8990 address=127.0.0.1 # 不配置任何SSL参数,走明文HTTP
重启MaxScale后,Web GUI走8989端口HTTPS访问,maxctrl通过配置连接8990端口的明文HTTP服务,两边互不干扰。
踩坑提醒:MaxScale 2.5版本中
admin_secure_gui=1仅控制Web GUI静态资源的加载策略,不影响REST接口的SSL开关;只要配置了admin_ssl_*参数,整个端口的REST接口就会强制要求HTTPS,无法实现“GUI加密、REST明文”的混合模式。
内容的提问来源于stack exchange,提问作者user4169982
相关产品推荐
相关产品推荐

