Nette应用在Nginx反向代理别名下的路径异常问题求助

环境与需求 #

• 运行环境：Apache2/Debian 11，Nette应用原正常运行在http://127.0.0.1:89/
• 需求：通过Nginx反向代理，以https://example.com/app/地址对外访问该应用

当前配置 #

Nginx代理配置 #

location /app/ {
    proxy_pass http://127.0.0.1:89;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-Proto "https";
    proxy_set_header X-Forwarded-Port "443";
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

Apache2配置（未修改） #

<VirtualHost *:89>
        ServerAdmin webmaster@localhost
        DocumentRoot /var/www/app/www/
        <Directory /var/www/app/www/>
                Options Indexes FollowSymLinks
                AllowOverride All
                Require all granted
        </Directory>
</VirtualHost>

遇到的问题 #

Nette应用无法识别代理后的/app路径前缀，导致通过redirect、link生成的所有链接（包括模板变量$basePath）均无效，生成的路径不带/app前缀。

已尝试的操作 #

• 在Nette配置中添加代理信任：

http:
    proxy: 127.0.0.1

• 修改Nginx的proxy_pass路径，尝试将/app转发到后端的/admin：

proxy_pass http://127.0.0.1:89/admin;

• 修改Nette路由，试图过滤掉admin/前缀：

$router->addRoute('[admin/]<presenter>/<action>[/<id>]', 'Homepage:default');

触发的错误 #

执行上述修改后，访问页面抛出错误：

TypeError: unpack() expects parameter 2 to be string, bool given in /var/www/app/vendor/nette/http/src/Http/Helpers.php:49  @  http://example.com/app/

解决方向 #

1. 修正Nginx代理配置，传递路径前缀 #

调整Nginx的location配置，确保正确转发路径的同时，通过X-Forwarded-Prefix头告知Nette应用前端的路径前缀：

location /app/ {
    proxy_pass http://127.0.0.1:89/;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-Proto "https";
    proxy_set_header X-Forwarded-Port "443";
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    # 关键：传递前端路径前缀给Nette
    proxy_set_header X-Forwarded-Prefix "/app";
}

注意proxy_pass末尾的/，这会让Nginx将/app/xxx转发为/xxx到后端Apache，避免路径重复。

2. 配置Nette识别转发头 #

在Nette的配置文件（如config/common.neon）中，开启对转发头的支持，确保应用能正确识别代理后的路径：

http:
    proxy: 127.0.0.1
    trustedProxies: [127.0.0.1]
    forwarded: true

forwarded: true会让Nette自动解析X-Forwarded-*系列头，包括X-Forwarded-Prefix，从而正确设置$basePath。

3. 恢复原有路由配置 #

之前添加的[admin/]路由规则是错误的，因为后端Apache收到的请求路径已经被Nginx处理为无/app前缀的格式，恢复Nette原路由配置即可：

$router->addRoute('<presenter>/<action>[/<id>]', 'Homepage:default');

4. 排查unpack错误 #

该错误通常由异常的请求头或会话数据导致，修正配置后执行以下操作：

• 清空浏览器缓存
• 删除Nette应用temp/sessions目录下的所有会话文件
• 重启Nginx和Apache2服务

验证 #

完成上述修改后，访问https://example.com/app/，检查页面中生成的链接是否均带有/app前缀，测试redirect和link生成的路径是否正确。

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