Dawarich项目中WebSocket连接404问题的分析与解决

问题背景

在使用Dawarich项目时，通过Nginx反向代理配置HTTPS访问时，发现系统日志中频繁出现对/cable路径的404错误。这些错误虽然不影响基本功能使用，但表明WebSocket连接未能成功建立。

问题表现

通过ngrep抓包工具分析，可以观察到客户端尝试通过HTTP/1.0协议建立WebSocket连接时，服务器返回了404 Not Found响应。具体表现为：

1. 客户端发送GET /cable请求
2. 服务器返回HTTP/1.0 404 Not Found
3. 响应内容为简单的"Page not found"

根本原因分析

这个问题源于Nginx反向代理配置中缺少对WebSocket协议的支持。WebSocket连接需要特殊的代理配置才能正常工作：

1. 需要将HTTP协议版本升级到1.1
2. 需要设置Upgrade和Connection头部
3. 需要正确处理WebSocket握手过程

解决方案

修改Nginx配置文件，在location /块中添加以下配置：

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

完整配置示例如下：

location / {
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto https;
    proxy_set_header X-Forwarded-Server $host;
    proxy_set_header Host $http_host;
    proxy_redirect off;
    proxy_pass http://127.0.0.1:3000/;
    
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

配置说明

1. proxy_http_version 1.1：强制使用HTTP/1.1协议，这是WebSocket正常工作所需的最低HTTP版本
2. proxy_set_header Upgrade $http_upgrade：传递客户端的Upgrade头部，用于协议升级
3. proxy_set_header Connection "upgrade"：设置Connection头部为upgrade，指示连接需要升级

验证方法

修改配置后，可以通过以下方式验证WebSocket是否正常工作：

1. 检查Nginx访问日志，确认不再有/cable路径的404错误
2. 导入GPX文件，观察"Imported points"列是否能实时更新
3. 使用浏览器开发者工具，检查WebSocket连接状态

总结

在部署Dawarich项目时，如果使用Nginx作为反向代理，必须正确配置WebSocket支持。缺少相关配置会导致Action Cable功能无法正常工作，表现为/cable路径的404错误。通过添加WebSocket特定的代理配置，可以确保实时功能正常工作。

对于不熟悉Nginx配置的用户，可以考虑使用Caddy等更现代化的Web服务器，它们通常对WebSocket有更好的默认支持。