在Caddy反向代理下部署Perplexica的完整指南

Perplexica是一个开源的AI项目，在实际部署中经常需要通过反向代理来提供更安全的访问。本文将详细介绍如何通过Caddy服务器正确配置Perplexica的反向代理，特别是解决WebSocket连接问题。

核心配置要点

Caddy作为现代HTTP服务器，配置Perplexica反向代理时需要特别注意以下几点：

1. 基础反向代理配置：需要分别代理前端服务(3000端口)和API服务(3001端口)
2. WebSocket特殊处理：必须正确识别WebSocket连接并单独处理
3. 环境变量配置：前端容器需要正确设置API和WebSocket的端点URL

完整Caddy配置

正确的Caddyfile配置应包含以下内容：

perplexica.yourdomain.com {
    @websockets {
        header Connection *Upgrade*
        header Upgrade websocket
    }
    reverse_proxy 192.168.1.100:3000
    reverse_proxy /api* 192.168.1.100:3001
    reverse_proxy @websockets {
        header_up Host 192.168.1.100
        to 192.168.1.100:3001
    }
}

关键说明：

• @websockets块用于识别WebSocket连接，其中的*Upgrade*必须包含星号
• API路径(/api*)需要单独代理到API服务
• WebSocket连接需要保持原始Host头信息

Docker Compose配置

在前端服务的Docker Compose中，必须正确设置两个关键环境变量：

perplexica-frontend:
  environment:
    - NEXT_PUBLIC_API_URL=https://perplexica.yourdomain.com/api
    - NEXT_PUBLIC_WS_URL=wss://perplexica.yourdomain.com

注意点：

• WebSocket URL协议必须使用wss://(安全WebSocket)而非ws://
• 确保域名与Caddy配置中的完全一致

常见问题解决

1. 持续加载问题：通常是WebSocket配置不正确导致，检查Caddy中的@websockets块是否正确定义
2. 连接失败：确认Docker Compose中的环境变量URL是否使用了正确协议(https/wss)
3. 混合内容错误：当页面使用https但WebSocket使用ws时会出现，确保都使用安全协议

最佳实践建议

1. 在生产环境中始终使用HTTPS和WSS协议
2. 考虑添加Caddy的访问日志和错误日志配置以便调试
3. 对于高流量场景，可以在Caddy和Perplexica服务之间添加负载均衡
4. 定期检查Caddy和Perplexica的版本兼容性

通过以上配置，Perplexica可以在Caddy反向代理下稳定运行，同时保持WebSocket连接的正常工作。这种配置方式既保证了安全性，又提供了良好的用户体验。