You need to enable JavaScript to run this app. Maxscale配置admin_ssl参数后maxctrl报socket hang up错误
优惠活动
大模型
产品
解决方案
定价
更多

Maxscale配置admin_ssl参数后maxctrl报socket hang up错误

根因定位

这个故障的核心是MaxScale 2.5版本的Admin服务监听逻辑存在强绑定特性:

  • 只要在全局配置中加入admin_ssl_*系列参数,Admin服务的8989端口就会强制切换为纯HTTPS监听模式,完全拒绝明文HTTP请求
  • 浏览器访问时,因为手动信任了自签名证书,能正常完成HTTPS握手流程,所以Web GUI可正常访问
  • 但maxctrl CLI工具默认以明文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模式,两种配置方式:

  1. 临时生效:执行maxctrl命令时追加HTTPS连接参数,自签名证书场景下需要跳过证书校验:
    maxctrl --hosts=https://127.0.0.1:8989 --tls-verify-server-cert=false list servers
    
  2. 永久生效:编辑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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 10:36:04