TeslaMate在Plesk环境下的部署与认证配置指南

背景介绍

TeslaMate是一款开源的Tesla车辆数据记录和监控工具，能够帮助车主详细记录和分析车辆的各项数据指标。在实际部署过程中，许多用户选择使用Plesk面板进行管理，但Plesk特有的Apache与Nginx混合架构会带来一些配置上的挑战。

问题现象

在Plesk环境下配置TeslaMate时，用户可能会遇到以下典型问题：

1. 界面元素无法点击，光标显示为加载状态
2. WebSocket连接无法正常建立
3. 基础认证(Basic Auth)配置不生效

这些问题主要源于Plesk默认同时使用Apache和Nginx作为Web服务器，而TeslaMate的实时功能依赖于WebSocket连接。

解决方案

基础环境准备

首先按照TeslaMate官方文档完成基本安装，特别注意以下几点：

1. 在.env配置文件中可以省略Let's Encrypt相关配置
2. 为TeslaMate和Grafana分别创建专用子域名

TeslaMate子域名配置

1. 在Plesk面板中创建teslamate子域名
2. 为该域名申请并安装Let's Encrypt证书
3. 进入"主机与DNS"→"Apache & nginx"设置
4. 关闭Nginx的代理模式，使其直接处理请求
5. 添加以下Nginx配置：

location / {
    proxy_pass http://127.0.0.1:4000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;

    auth_basic "Restricted Content";
    auth_basic_user_file /var/www/vhosts/domain/.htpasswd;
}

location /live/websocket {
    proxy_pass http://127.0.0.1:4000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;

    auth_basic "Restricted Content";
    auth_basic_user_file /var/www/vhosts/domain/.htpasswd;
}

Grafana子域名配置

1. 在Plesk面板中创建grafana子域名
2. 进入"主机与DNS"→"Apache & nginx"设置
3. 在HTTPS额外指令中添加以下配置：

# 反向代理配置
ProxyPreserveHost On
ProxyPass / http://127.0.0.1:3000/
ProxyPassReverse / http://127.0.0.1:3000/

# 基础认证配置
<Location />
    AuthType Basic
    AuthName "Restricted Area"
    AuthUserFile /path
    Require valid-user
</Location>

关键技术点解析

1. WebSocket支持：TeslaMate的实时功能依赖于WebSocket连接，必须正确配置Upgrade头信息
2. 混合架构处理：Plesk同时使用Apache和Nginx时，需要明确指定由哪个服务器处理请求
3. 认证一致性：确保认证配置同时适用于普通HTTP请求和WebSocket连接
4. 路径匹配：特别注意/live/websocket路径需要单独处理

最佳实践建议

1. 使用专用子域名分离TeslaMate和Grafana的访问
2. 定期更新.htpasswd文件中的密码
3. 监控日志文件以确保WebSocket连接正常工作
4. 考虑使用更安全的认证方式替代基础认证
5. 配置适当的防火墙规则限制访问来源IP

通过以上配置，TeslaMate可以在Plesk环境下稳定运行，同时保证数据访问的安全性。这种配置方式也适用于其他需要WebSocket支持的应用程序在Plesk环境下的部署。