MCSManager 节点代理配置问题分析与解决方案

问题背景

在使用 MCSManager 面板时，用户遇到了节点代理配置问题。具体表现为：Web 面板能够正常运行，但实例连接失败。通过浏览器开发者工具检查发现，实例的 WebSocket 请求被发送到了错误的端口。

环境配置

• 操作系统：Ubuntu 22.04
• 面板版本：10.1.0
• 守护进程版本：1.3.0
• 节点运行端口：24444
• Web 面板运行端口：23333
• Nginx 配置：将节点反代到 domain.com:12444，Web 面板反代到 domain.com:12333

问题现象

1. Web 面板可以正常访问
2. 在 Web 面板中连接 localhost 节点显示成功
3. 进入实例后显示连接失败
4. 检查发现实例的 WebSocket 请求被发送到 wss://domain.com:24444/socket.io（错误的端口）
5. 如果将节点地址设置为 domain.com:12444，则直接显示连接失败

问题分析

1. 端口映射问题：Nginx 反代配置中，外部端口(12444)与内部端口(24444)不一致，导致 WebSocket 连接失败。

2. SSL 配置问题：如果守护进程(daemon)没有正确配置 SSL，会导致 WebSocket 连接失败。

3. 自反代问题：当 Web 面板和守护进程运行在同一服务器时，服务器无法通过公网地址访问自身，需要配置本地解析文件。

4. 连接延迟：节点状态更新可能存在延迟，需要手动刷新并等待30秒至1分钟才能显示正确的连接状态。

解决方案

1. 正确的 Nginx 反代配置

确保 Nginx 的反代配置正确处理 WebSocket 连接，并保持端口一致性。示例配置如下：

location / {
    proxy_pass http://localhost:24444;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
}

2. SSL 证书配置

确保 Web 面板和守护进程都配置了 SSL 证书，或者都不配置。混合配置会导致连接问题。

3. 本地解析文件配置

对于同一服务器上的 Web 面板和守护进程，在本地解析文件中添加以下内容：

127.0.0.1 domain.com

4. 手动刷新节点

在节点列表页面，手动点击刷新按钮，并等待30秒至1分钟让连接状态更新。

最佳实践建议

1. 保持内外端口一致可以避免很多连接问题
2. 对于生产环境，建议将 Web 面板和守护进程分开部署
3. 定期检查 SSL 证书的有效性
4. 监控节点连接状态，设置自动重连机制
5. 在配置变更后，重启相关服务确保配置生效

总结

MCSManager 的节点代理配置需要注意端口映射、SSL 证书和本地解析等多个方面。通过正确的 Nginx 配置、SSL 设置和本地解析文件修改，可以解决大多数连接问题。对于同一服务器上的部署，特别要注意自反代可能带来的连接问题。