环境:Alibaba Cloud Linux 3 · 宝塔面板 · BT Agent MCP 插件(/www/server/panel/plugin/bt_agent_mcp,由 bt-agent-mcp.service 托管,监听 8765)
问题 1:面板更换 SSL 证书后,MCP 插件仍使用旧证书,导致外部客户端全部握手失败
复现步骤:
面板 SS证书到期(/www/server/panel/ssl/certificate.pem 的 notAfter 已过),通过面板设置上传新证书;确认文件已是新证书(openssl x509 -noout -dates 为新的有效期)。
执行面板重启(bt 菜单重启面板」/ systemctl restart bt)。
从外部访问 MCP 端口,服务端仍返回已过期的旧证书,客户端报 certificate has expired,MCP 完全不可用。
定位结论:证书文件已更新,但插件的 run_server.py 在进程启动时把 SSLContext 载入了内存(server/config.py 中 cert_file / key_file 指向面板证书路径),而该插件进程自安装起持续运行(实测 20 天以上),面板主程序重启不会带动插件重启,插件也没有任何证书变更监听逻辑。最终需手工 systemctl restart bt-agent-mcp.service 才生效。整个过程不报错、不提示,排查成本很高(面板侧一切正常,只有 MCP 端口异常)。
问题 2:IP 白名单只支持精确 IP,动态出口 IP 场景几乎不可用
现象:白名单只能填单个 IP。家宽 / 移动网络的出口 IP 是动态的,换网或重新拨号后立刻被拒,接口返回 403 {"status": false, "msg": "ip denied"},且响应体既不包含当前请求 IP,也不说明命中了哪条规则,只能靠猜。
建议:
支持 CIDR(如 123.123.0.0/16)与通配符(如 123.123.123.*);
403 响应体返回实际来源 IP 与拒绝原因,便于自助排查(可只返回给已通过令牌校验的请求,避免信息泄露);
可选:提供「令牌 + 任意 IP」模式,或支持带有效期的临时白名单(如 24 小时),兼顾动态 IP 与安全性。
|
|