Nginx代理配置对接NextCloud Docker容器失效问题求助

问题现象 #

• Docker部署的NextCloud容器运行在10.0.100.6，可通过10.0.100.6:8080直接正常访问
• 通过Nginx的/nextcloud路径访问时出现错误，但Nginx默认页面（/路径）可正常打开
• 已尝试简化proxy_pass配置（删除额外请求头参数），问题依旧
• Nginx配置语法检查显示无错误

相关配置 #

原始完整配置 #

server {
  listen 80;
  listen [::]:80;
  server_name localhost;

  location / {
    root /usr/share/nginx/html;
    index index.html index.htm;
  }

  location /nextcloud {
    proxy_pass http://10.0.100.6:8080/;
    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;
  }

  error_page 500 502 503 504 /50x.html;
  location = /50x.html {
    root /usr/share/nginx/html;
  }
}

简化后的配置 #

location /nextcloud {
  proxy_pass http://10.0.100.6:8080/;
}

问题原因及解决方法 #

核心问题 #

当前proxy_pass末尾加了/，会把请求的/nextcloud路径替换为空，直接转发到NextCloud根目录，但NextCloud生成的静态资源路径、路由都是基于自身根路径的，页面会请求/css/xxx、/js/xxx这类根路径资源，而非/nextcloud/css/xxx，导致Nginx返回404或者NextCloud识别路径错误。

解决步骤 #

1. 调整Nginx代理配置：去掉proxy_pass末尾的/，同时添加路径重写规则，确保路径正确传递：

location /nextcloud {
    proxy_pass http://10.0.100.6:8080;
    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;
    rewrite ^/nextcloud(.*)$ $1 break;
}

2. 配置NextCloud子路径适配：进入NextCloud容器，编辑config/config.php文件，添加以下配置项（替换成你的实际域名/IP）：

'overwrite.cli.url' => 'http://你的Nginx地址/nextcloud',
'overwritehost' => '你的Nginx地址',
'overwriteprotocol' => 'http',
'overwritewebroot' => '/nextcloud',
'overwritecondaddr' => '^10.0.100.6$', // 填写Nginx所在服务器IP或容器IP

3. 重启服务生效：
   • 重载Nginx配置：nginx -s reload
   • 重启NextCloud容器：docker restart 你的NextCloud容器名称

验证 #

访问http://你的Nginx地址/nextcloud，检查页面是否正常加载，静态资源是否能正确请求。

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