在子目录中部署CommaFeed的技术方案

CommaFeed是一款开源的RSS阅读器，基于Java和Quarkus框架构建。在实际部署过程中，许多用户希望将其部署在网站的子目录而非根目录下。本文将详细介绍如何正确配置CommaFeed在子目录中运行的完整方案。

核心配置要点

要让CommaFeed在子目录下正常工作，关键在于正确配置反向代理。以下是经过验证的有效配置方案：

Nginx反向代理配置

Nginx作为反向代理时，需要特别注意proxy_pass指令的写法。正确的配置示例如下：

location /commafeed/ {
    proxy_pass http://commafeed:8082/;
    proxy_read_timeout 300s;
    proxy_connect_timeout 75s;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    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 $scheme;
}

其中最关键的是proxy_pass指令末尾的斜杠，它确保了请求路径的正确转发。

Docker Compose配置

在Docker环境中运行CommaFeed时，只需暴露默认端口即可，无需额外环境变量：

services:
  commafeed:
    image: athou/commafeed:latest-h2
    ports:
      - 8082:8082

常见误区解析

1. 过时的环境变量：早期版本中的COMMAFEED_APP_PUBLICURL在v5.0后已不再使用，无需配置。

2. 无效的路径设置：QUARKUS_HTTP_ROOT_PATH只在构建时生效，运行时配置无效。

3. 代理路径错误：proxy_pass指令中缺少结尾斜杠会导致路径转发错误。

最佳实践建议

1. 保持Nginx配置简洁，仅保留必要的代理头设置。

2. 使用最新版本的CommaFeed镜像，避免兼容性问题。

3. 测试时先使用最小化配置，确认基本功能正常后再添加其他优化参数。

通过以上配置，CommaFeed可以稳定运行在网站子目录中，为用户提供灵活的部署选择。这种方案特别适合需要整合多个Web应用到同一域名的场景。