如何配置Nginx Proxy Manager实现端口3000项目的特定路径访问？

针对你遇到的通过https://www.example.com/planka访问3000端口项目的问题，逐一解答你的疑问：

1. 高级选项卡中的配置是否正确？ #

当前配置存在几个关键问题，修正后的配置如下：

location /planka {
    # 替换成项目的实际主机/IP，不要用localhost（除非NPM和项目在同一主机/容器网络）
    proxy_pass http://[项目实际IP]:3000;
    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;
    # 关键：告诉应用它运行在/planka子路径下
    proxy_set_header X-Forwarded-Prefix /planka;
    # WebSocket支持的必要头（NPM勾选后会自动生成，手动补充更稳妥）
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

错误点说明：

• 原配置中proxy_pass用localhost可能无效，若NPM和项目不在同一网络环境，必须用项目的实际内网IP/容器名称；
• 尾部斜杠需统一：location /planka和proxy_pass末尾不加斜杠，避免路径拼接错误；
• 缺少X-Forwarded-Prefix头，应用无法识别自身的子路径前缀，会导致静态资源、API请求路径错误。

2. 是否需要修改Nginx Proxy Manager中的其他设置？ #

需要调整基础配置的几个关键点：

• 转发主机/IP：必须填写项目的实际可访问地址（同一主机填127.0.0.1，Docker容器填容器内网IP或容器名），不能随意填写；
• 基础设置无需填写转发路径：所有路径规则已在高级配置的location中定义，基础页的转发路径留空即可；
• 保留已勾选的「启用WebSocket支持」「拦截常见攻击」「强制SSL」，这些配置是合理的；
• 确保SSL证书已正确颁发并绑定到www.example.com。

3. 确保项目在/planka路径下正常服务还需哪些额外步骤？ #

核心是让应用本身适配子路径运行，这是最容易忽略的环节：

• 修改应用的子路径配置：以你提到的Planka为例，需要设置环境变量指定基础路径：
  • 若为Docker部署，启动命令添加：-e BASE_URL=/planka
  • 若为直接运行，设置系统环境变量BASE_URL=/planka或修改应用配置文件中的路径前缀
• 验证应用本身的子路径可用性：先直接访问http://[项目IP]:3000/planka，如果返回404，说明应用还未配置子路径，必须先完成这一步；
• 清理浏览器缓存：之前的错误请求缓存可能导致静态资源加载异常，清理后再测试；
• 查看NPM日志排查问题：在Nginx Proxy Manager的日志页面查看请求转发记录，确认请求是否正确发送到项目端口，以及应用返回的状态码，定位具体错误。

内容的提问来源于stack exchange，提问作者Bala Chandar